POST /messages, acá tu sistema solo avisa qué pasó. Qué se le dice al cliente, qué se pregunta y a quién se deriva lo cambia tu equipo desde el editor de automatizaciones, sin tocar código.
Necesitas el plan Escala o Enterprise (por la API) y una clave de API.
Por qué son dos automatizaciones
Cuando tu sistema arranca la automatización, la clienta no te escribió hace poco: la ventana de 24 horas está cerrada. Con la ventana cerrada, WhatsApp solo deja mandar plantillas aprobadas, y una Pregunta fallaría. Por eso se arma en dos partes:- Pedido entregado: la arranca tu sistema. Guarda el número de pedido en el contacto y manda una plantilla con un botón.
- Encuesta: arranca cuando la clienta toca el botón. Como acaba de escribir, la ventana está abierta y se le puede preguntar.
1. Prepara la plantilla y el campo
-
En Contactos › Campos, crea un campo de texto con la clave
ultimo_pedido. -
En Plantillas, crea una de categoría Utilidad con un botón de respuesta rápida Calificar mi compra:
¡Hola [nombre]! Tu pedido [pedido] ya fue entregado. ¿Nos cuentas cómo te fue? Son 10 segundos 🙌
2. Arma la automatización “Pedido entregado”
Publícala. El id de la automatización lo necesitas para la llamada; lo ves en la URL de Ver URL y token si le agregas un disparador Webhook entrante, o en la dirección del editor.
3. Arma la automatización “Encuesta”
Conecta las dos salidas de la solicitud HTTP (Éxito y Error) a la condición: si tu sistema no responde, la clienta igual recibe su respuesta.
Cuerpo de la solicitud HTTP
4. Arranca la automatización desde tu sistema
Cuando un pedido pasa a “entregado”, llama aPOST /automations/{id}/runs con el teléfono y los datos del pedido:
entregas.js
201
5. Recibe la calificación
El paso Solicitud HTTP de la encuesta le manda a tu sistema unPOST firmado con el token de la automatización (ats_…). Verifica la firma igual que un webhook, pero con ese token:
encuestas.js
verificarFirma está en Conectar con tu sistema, en Node y Python.
6. Entérate si algo falló
Si la plantilla no se pudo mandar (por ejemplo, el número no tiene WhatsApp o la plantilla dejó de estar aprobada), la ejecución de Pedido entregado falla. Suscribe tu webhook al eventoautomation.failed y búscala por el runId que guardaste:
Cuida los detalles
Si la clienta está en medio de otra automatización
Si la clienta está en medio de otra automatización
Una conversación tiene una sola automatización en curso a la vez. Si ya hay una, la llamada responde
409 con “Esta conversación ya tiene una automatización en curso.” Reintenta más tarde o deja pasar esa encuesta.Si tu equipo está hablando con ella
Si tu equipo está hablando con ella
Cuando alguien del equipo responde en el chat, las automatizaciones dejan de responder en esa conversación durante 24 horas, para no interrumpir. Si la clienta toca el botón en ese lapso, la Encuesta no arranca: el mensaje le llega a tu equipo en el chat, como cualquier otro.
No mandes dos veces la misma encuesta
No mandes dos veces la misma encuesta
Guarda el
runId junto al pedido y no vuelvas a llamar si ya tienes uno. La API no deduplica por ti.Mide cómo funciona
Mide cómo funciona
Sobre el lienzo de cada automatización ves cuántas ejecuciones pasaron por cada paso: cuántas encuestas arrancaron, cuántas llegaron a la pregunta y cuántas por cada respuesta.

