Tu sistema marca el pedido #1042 como entregado y, a los pocos segundos, la clienta recibe por WhatsApp: “¡Hola Sofía! Tu pedido #1042 ya fue entregado. ¿Nos cuentas cómo te fue?”, con un botón. Si lo toca, una automatización le pregunta cómo fue la experiencia, guarda la respuesta, te la manda a tu sistema y, si algo salió mal, le pasa la conversación a tu equipo. A diferencia de mandar un mensaje con 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:
  1. Pedido entregado: la arranca tu sistema. Guarda el número de pedido en el contacto y manda una plantilla con un botón.
  2. 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
Pruébala con Probar con un contacto en tu propio número antes de publicar. Mira Probar y seguir las ejecuciones.

4. Arranca la automatización desde tu sistema

Cuando un pedido pasa a “entregado”, llama a POST /automations/{id}/runs con el teléfono y los datos del pedido:
entregas.js
201
Si entregas muchos pedidos juntos (por ejemplo, al cerrar el reparto del día), no los mandes todos a la vez: ve de a uno y deja un pequeño intervalo entre llamadas. Mira Límites.

5. Recibe la calificación

El paso Solicitud HTTP de la encuesta le manda a tu sistema un POST firmado con el token de la automatización (ats_…). Verifica la firma igual que un webhook, pero con ese token:
encuestas.js
La función 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 evento automation.failed y búscala por el runId que guardaste:

Cuida los detalles

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.
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.
Guarda el runId junto al pedido y no vuelvas a llamar si ya tienes uno. La API no deduplica por ti.
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.