Resumen
Si estás utilizando la característica Varios números de WhatsApp de Wati, esta guía explica cómo usar la API de Wati en diferentes números conectados.
Instrucciones
Utilizar varios números de WhatsApp en tu cuenta de Wati te permite enviar y recibir mensajes desde diferentes números. Para asegurarte de que tus llamadas a la API pasen por el número correcto, necesitas incluir una clave adicional en la carga útil o la URL, dependiendo de la API que estés utilizando.
A continuación, se muestran las APIs que actualmente admiten varios números y cómo usarlas.
1. API para enviar mensaje con plantilla
Punto final:POST /{tenantId}/api/v1/sendTemplateMessage
Campos requeridos:
ID del inquilino (Tenant ID)
Número de WhatsApp
channelNumber (en la carga útil): El número de teléfono desde el que deseas enviar el mensaje.
Por ejemplo, si deseas que el mensaje se envíe desde tu número predeterminado, establece channelNumber
en ese número de teléfono predeterminado.
2. API para actualizar estado de chat
Punto final:POST /{tenantId}/api/v1/updateChatStatus
Campos requeridos:
ID del inquilino (Tenant ID)
channelPhoneNumber (en la carga útil): Establece esto en el número cuyo estado de chat deseas actualizar.
El estado del chat se actualizará para el número de teléfono enviado como valor de “channelPhoneNumber”.
3. API para obtener mensajes por número de WhatsApp
Punto final:GET /{tenantId}/api/v1/getMessages/{whatsappNumber}
Aquí, como se muestra a continuación, los parámetros de consulta WhatsApp Number y Tenant ID son requeridos, y para obtener el mensaje desde qué número conectado, necesitas especificarlo como parámetro de consulta.
Por ejemplo, para recuperar mensajes desde tu número predeterminado, proporciona ese número como valor para channelPhoneNumber
.
4. Enviar mensaje a sesión abierta
Punto final: Post /{tenantId}/api/v1/sendSessionMessage/{whatsappNumber}
Como se muestra a continuación, el parámetro “Tenant ID”, “Número de WhatsApp” y “Texto del mensaje” son requeridos, y en la carga útil es necesario especificar el “channelPhoneNumber”.
Por ejemplo: Para enviar un mensaje de sesión desde el Número Predeterminado. Especifica el Número Predeterminado como valor para “channelPhoneNumber” en la carga útil.
5. Otras APIs que funcionan sin especificar el número
Las siguientes APIs no requieren un número de teléfono específico porque los datos de contacto se comparten entre todos los números conectados:
Agregar contacto:
POST /{tenantId}/api/v1/addContact/{whatsappNumber}
Actualizar atributos de contacto:
POST /{tenantId}/api/v1/updateContactAttributes/{whatsappNumber}
Actualizar lista de atributos de contacto:
Obtener lista de contactos:
Nota: Puedes encontrar tu Token de Acceso y los detalles del punto final de la API al ir a la página Documentación de la API en tu entorno de Wati.
APIs de Wati y su soporte para Varios Números de WhatsApp
Nombre de la API | Disponible |
Enviar mensaje con plantilla | Sí |
Enviar mensajes con plantilla | Sí |
Obtener mensajes por número de WhatsApp | Sí |
Obtener lista de contactos | Sí |
Actualizar atributos de contacto | Sí |
Actualizar lista de atributos de contacto | Sí |
Agregar contacto | Sí |
Enviar mensaje a sesión abierta | Sí |
Actualizar estado de chat | Sí |