Usted debe ser Owner de la cuenta (solo el Owner genera la clave) y el contacto debe existir en AttendTo: cada pedido se asocia con un contacto por teléfono o correo electrónico. Asegure antes la cartera, importando un CSV en "Base de Contatos" (Base de contactos), o deje que los contactos nazcan de las conversaciones de WhatsApp. ¿Prefiere empezar sin programar? El Monitor también acepta la importación de pedidos por CSV.
En el panel, abra "Integrações" (Integraciones) (menú lateral), pestaña Pedidos, y, en la tarjeta "Receber pedidos" (Recibir pedidos), haga clic en "Gerar chave" (Generar clave). Cópiela y guárdela de inmediato: por seguridad aparece una sola vez y después solo en versión enmascarada. Generar una nueva invalida la anterior al instante.
Trate la clave como una contraseña: debe vivir solo en su servidor, nunca en un sitio web, una aplicación ni un repositorio público.
Reemplace SUA_CHAVE y use un teléfono o correo electrónico que exista en sus contactos:
curl -X POST https://api.attendto.com.br/api/integrations/orders \
-H "X-Api-Key: SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{"orders":[{"external_id":"PED-1001","amount_cents":18990,"phone":"5511999990001","status":"pago","ordered_at":"2026-06-15"}]}'Respuesta esperada:
{
"received": 1,
"imported": 1,
"updated": 0,
"matched_customers": 1,
"invalid": 0,
"errors": []
}Abra "Monitor de sucesso" (Monitor de éxito) y vea el pedido reflejado en los grupos.
En tiempo real (dispare el envío cuando el pedido se crea o se paga) o por rutina (un job cada 15 a 60 minutos envía los pedidos nuevos o modificados, en lotes de 100 a 500).
El envío es idempotente por external_id: reenviar el mismo pedido nunca lo duplica, solo lo actualiza. Sirve incluso para cambiar el estado de "pendente" a "pago". Ante la duda, reenvíe.
| Campo | Obligatorio | Descripción |
|---|---|---|
| external_id | sí | El ID del pedido en su sistema. Es la clave de la idempotencia: reenviar el mismo ID actualiza, nunca duplica. |
| amount_cents | sí | Valor total en centavos (entero). R$ 189,90 se convierte en 18990. Alternativa: "amount" como texto ("189,90"). |
| phone / email | al menos uno | Asocia el pedido con el contacto. Teléfono con código de país y de área (ej.: 5511999990001). |
| status | no | Valor predeterminado: "pago". Acepta "pendente"/"aberto" y "cancelado"/"estornado"/"reembolsado", en portugués o inglés. |
| ordered_at | no | Fecha del pedido: ISO (2026-06-15, con o sin hora) o dd/mm/aaaa. Si queda vacío, se usa la fecha de envío. |
| currency | no | Valor predeterminado: "BRL". |
| items | no | Ítems del pedido: {"sku","title","quantity","unit_price_cents"}. Con un SKU registrado en Ofertas, el producto se vincula y el stock se descuenta en los pedidos pagados. |
Cada error incluye el índice del ítem en el lote; los demás pedidos se procesan con normalidad.
| Motivo | Qué hacer |
|---|---|
| external_id ausente | Envíe el ID del pedido de su sistema. |
| amount_cents/amount inválido | El valor debe ser positivo y estar en centavos en amount_cents. |
| cliente no encontrado (teléfono/correo electrónico) | El contacto aún no existe en AttendTo. Importe su cartera en "Base de Contatos" (Base de contactos) o revise el formato del teléfono (código de país + código de área). |
| ordered_at inválido | Use fecha ISO o dd/mm/aaaa. |
| external_id repetido en el lote | El mismo pedido apareció dos veces en la misma solicitud. |
En la misma pantalla de "Integrações" (Integraciones), en la pestaña Webhooks, registre una dirección de su sistema para recibir avisos al instante: cuando entran los pedidos (el aviso Pedidos importados confirma cada lote), cuando un lead se califica, pasa a un agente, cambia de etapa o se convierte en venta. Cada aviso sale firmado, se intenta hasta 6 veces y queda en el registro de entregas.
Ver los 13 eventos en la documentación de los webhooks (en portugués)¿Dudas en la primera integración? Escríbanos por el chat del panel: nuestro equipo la acompaña con usted.
Abrir "Integrações" (Integraciones) en el panel