POST
https://json.ricardofuentes.dev
/
api
/
v1
/
whatsapp
/
webhook
Webhooks
curl --request POST \
  --url https://json.ricardofuentes.dev/api/v1/whatsapp/webhook \
  --header 'Content-Type: application/json' \
  --data '
{
  "instance": "<string>",
  "url": "<string>",
  "events": [
    {}
  ]
}
'
{
  "event": "message.received",
  "instance": "mi-instancia",
  "timestamp": 1740000000,
  "data": {
    "id": "msg_02k...",
    "from": "+51999000111",
    "type": "text",
    "body": "Hola!",
    "name": "Juan Pérez"
  }
}

Body

instance
string
required
Nombre de la instancia de WhatsApp
url
string
required
URL de tu servidor que recibirá los eventos
events
array
required
Lista de eventos a recibir

Eventos disponibles

EventoDescripción
message.receivedMensaje entrante recibido
message.deliveredMensaje entregado al destinatario
message.readMensaje leído por el destinatario
instance.connectedInstancia conectada
instance.disconnectedInstancia desconectada

Ejemplo de configuración

cURL
curl -X POST https://json.ricardofuentes.dev/api/v1/whatsapp/webhook \
  -H "Authorization: Bearer tu_token" \
  -H "Content-Type: application/json" \
  -d '{
    "instance": "mi-instancia",
    "url": "https://tu-servidor.com/webhook",
    "events": ["message.received", "message.delivered"]
  }'

Payload que recibirás

Cuando ocurra un evento, tu servidor recibirá un POST con este payload:
{
  "event": "message.received",
  "instance": "mi-instancia",
  "timestamp": 1740000000,
  "data": {
    "id": "msg_02k...",
    "from": "+51999000111",
    "type": "text",
    "body": "Hola!",
    "name": "Juan Pérez"
  }
}