Un mensaje entra por WhatsApp. Segundos después es un POST en tu backend.

El viaje, paso a paso

Lo que pasa desde que tu cliente escribe hasta que tu sistema responde.

1. 1

   Entra y se convierte en un formato único

   Meta nos llama, verificamos la firma HMAC y transformamos el mensaje — sea de WhatsApp, Instagram o Messenger — al mismo JSON. El media se descarga y re-hostea para que la URL no te caduque.

   mensaje normalizado · ejemplo

   {
     "event": "message.received",
     "channel": { "id": "nk_dvzobn7m4h4y", "platform": "whatsapp" },
     "contact": {
       "id": "5491112345678",
       "name": "Ana",
       "phone": "+5491112345678",
       "username": null,
       "avatar_url": null
     },
     "message": {
       "id": "wamid.HBgNNTQ5MTEy…",
       "direction": "inbound",
       "timestamp": "2026-08-09T18:12:44.310Z",
       "type": "text",
       "content": { "text": "Hola 👋 ¿tienen stock?" },
       "reply_to": null
     }
   }

2. 2

   Llega a tu URL, con prueba de origen

   Te hacemos POST a la URL que configures. Cada despacho lleva tu token compartido; si tu servidor está caído, la cola reintenta y el evento queda registrado.

   lo que recibís

   POST https://tu-backend.com/chat/whatsapp/receive
   x-webhook-token: whsec_k2m…   ← para validar que somos nosotros
   content-type: application/json

3. 3

   Respondés con un POST

   Mismo endpoint para los tres canales: texto, media, templates. Nosotros hablamos con la Graph API con el token cifrado de tu canal.

   tu respuesta

   curl -X POST https://api.neike.dev/api/outbound/send \
     -H "x-neike-api-key: whk_live_..." \
     -H "Content-Type: application/json" \
     -d '{ "channelId": "nk_...", "to": "5491122334455",
           "type": "text", "content": { "text": "Sí, tenemos stock" } }'

4. 4

   Y seguimos el rastro

   Los estados vuelven a tu webhook a medida que Meta los confirma, y todo queda medido por canal y período:

   enviado → entregado → leído · fallido → reintentá desde la consola