Resumen

Este artículo cubre las preguntas frecuentes sobre el uso de la API y los webhooks de Wati, incluyendo cómo añadir contactos a través de la API, dónde encontrar su token de API, cómo habilitar las confirmaciones de lectura usando eventos de webhook y cómo gestionar los webhooks mediante la API.

Importante: Los Webhooks globales solo son compatibles para mensajes de WhatsApp. Para recibir alertas o activar acciones para mensajes de Instagram o Facebook Messenger, utilice el nodo de Webhook dentro de un flujo de chatbot.

Preguntas frecuentes (FAQs)

1. ¿Puedo añadir un contacto a través de la API?

Sí. Utilice uno de los siguientes endpoints:

v3 (recomendado): POST https://live-mt-server.wati.io/api/ext/v3/contacts
v1 (legado): POST https://live-mt-server.wati.io/{tenantId}/api/v1/addContact/{whatsappNumber}

La v3 se recomienda para todas las integraciones nuevas. La v1 es una versión anterior, pero sigue siendo compatible.

2. ¿Dónde puedo encontrar mi token de API de Wati?

Vaya a Connector > API > Create API Token en su cuenta de Wati. Allí encontrará su Token de acceso y la URL del endpoint de la API.

Para los endpoints de la v3, cree un token con el ámbito (scope) correspondiente:

Ámbito (Scope)	Usado para
`contactsv3:*`	Operaciones de contacto
`conversationsv3:*`	Operaciones de conversación
`messagetemplatev3:write`	Envío de plantillas

3. ¿Cómo habilito las confirmaciones de lectura?

Habilite el evento de webhook sentMessageREAD_v2 para recibir una devolución de llamada (callback) cuando el destinatario lea un mensaje enviado por usted.

Para configurarlo:

Vaya a Connector > Webhooks en su cuenta de Wati.
Añada su URL de webhook.
Habilite el evento sentMessageREAD_v2.

Los webhooks de Wati pueden notificarle mediante una URL de callback para lo siguiente:

Mensajes recibidos
Mensajes enviados (Plantilla y Sesión)
Actualizaciones de estado de mensajes (Enviado / Entregado / Leído)

sentMessageREAD_v2 — Carga útil de ejemplo

{
  "eventType": "sentMessageREAD_v2",
  "statusString": "Read",
  "id": "1a2b3b4d5e6f7g8h9i10j",
  "localMessageId": "...",
  "whatsappMessageId": "abcdefghi_jklmnop",
  "conversationId": "a1b2c3d4e5f6g7h8i9j10",
  "ticketId": "m1n2o3p4q5r6s7t8u9v10",
  "channelId": "...",
  "channelPhoneNumber": "85264318722",
  "text": null,
  "type": "template",
  "timestamp": "1665645642",
  "assigneeId": null,
  "operatorEmail": "[email protected]",
  "bsuid": "...",
  "parentBsuid": "...",
  "username": "..."
}

Variantes de eventos BSUID

Wati admite variantes _bsuid de eventos de webhook. Estas cargas útiles incluyen los campos bsuid, parentBsuid y username para identificar contactos por su BSUID; es útil cuando los contactos se referencian por BSUID en su sistema en lugar de por número de teléfono.

4. ¿Cómo gestiono los webhooks a través de la API?

Puede crear, listar, actualizar y eliminar webhooks mediante programación.

Crear un webhook (v2):

POST https://live-mt-server.wati.io/{tenantId}/api/v2/webhookEndpoints

Listar, obtener, actualizar y eliminar webhooks (v3 — recomendado):

https://live-mt-server.wati.io/api/ext/v3/webhooks

La gestión de webhooks v3 no incluye /{tenantId}/ en la ruta. La v3 se recomienda para todas las integraciones nuevas.

Para obtener todos los detalles, consulte la Documentación de Webhooks de Wati.

Preguntas frecuentes generales: APIs y Webhooks de Wati