Conversación proactiva en WhatsApp Web

/v2/message/create_conversation/ - POST

Probar servicio

Permite iniciar una conversación con un cliente de manera proactiva.

Mejores prácticas - WhatsApp

La persona que recibirá el mensaje debe saber que la van a contactar. De lo contrario es posible que reporte o bloquee la cuenta. Si muchos clientes lo hacen, WhatsApp puede bloquear el número de teléfono permanentemente.

Cuentas proactivas - WhatsApp

No todos los números de WhatsApp conectados en Desk tendrán permitido el envío proactivo de mensajes.

Para un mejor manejo, usted debe definir desde la aplicación qué cuentas se utilizarán para envío de mensajes proactivo y cuáles no.

Se recomienda que las cuentas proactivas se consideren desechables. Usted además puede monitorear cuántos envíos proactivos ha realizado cada cuenta por mes y cuándo se acerca a un límite peligroso. En este caso recomendamos habilitar más números proactivos y dividir la carga.

Ejemplo de body para crear la conversación, en formato JSON:

{
  "phone": "56912349876",
  "user_name": "Carlos Soto",
  "account_id": "au2geg72gs",
  "message": "Hola Carlos, bienvenido a nuestra tienda"
}

Donde los parámetros son:

Campo	Descripción	Tipo
phone	Número de Whatsapp del cliente	string
user_name	Nombre del cliente, utilizado para crear su perfil en Desk	string
account_id	Identificador del la cuenta de WhatsApp a utilizar	string
message	El texto a enviar	string
no_manual_reopen	Fuerza a que el ticket una vez cerrado, no se pueda reabrir	boolean
no_manual_merge	Fuerza a que el ticket no se pueda fusionar con otro	boolean

Fusionar tickets

En Desk un agente puede unir dos tickets. Cuando se realiza esta acción, se unifica en uno de los dos tickets, toda la información de ambos, incluyendo mensajes, comentarios o clasificaciones del ticket. El otro se elimina.

Este puede ser un comportamiento no deseable en algunos casos de negocio, por lo que existe el parámetro no_manual_merge, que impide que el ticket creado pueda ser fusionado y en consecuencia potencialmente eliminado.

Re abrir tickets

En Desk un agente puede abrir o cerrar un ticket múltiples veces. En ocasiones esto puede provocar que el ticket tenga un estado no deseado de cara a una integración. Para garantizar que un ticket una vez cerrado, siempre se mantendrá así, usted puede utilizar el parámetro no_manual_reopen, que impedirá a los agentes re-abrir el ticket, garantizando su estado.

En el caso de que necesitemos que el ticket creado no pueda ser fusionado o re-abierto, existen los campos no_manual_merge y no_manual_reopen. Lo anterior es relevante si el flujo que queremos implementar con los tickets de Desk requiere mantener ciertas condiciones.

La respuesta esperada tendrá la siguiente forma en caso de éxito:

{
  "status": 200,
  "ticket_id": "583dcb2855d0a46e438d0206"
}

Campo	Descripción	Tipo
status	Código de retorno de la petición. 200 si la petición fue exitosa	integer
ticket_id	Identificador de ticket	string

En caso de que se intente enviar un mensaje utilizando una cuenta que no tiene permitido enviar mensajes proactivos, la respuesta será la siguiente:

{
  "status": 202,
  "msg": "This account doesnot allow proactive messaging. Please configure at least one account to be allowed to send proactive messages in Admin / Channels / Whatsapp select account and then Configurations > Enable Proactive Messaging"
}