Servicios Mensaje¶
Iniciar conversación proactiva en WhatsApp¶
Para realizar envío de mensajes proactivos a un cliente usando una cuenta de WhatsApp varía en función si se posee una cuenta oficial de WhatsApp Business API o una cuenta de WhatsApp Web mediante un teléfono.
- Para la documentación mediante WhatsApp Business API, haz clic aquí
- Para la documentación mediante WhatsApp Web con teléfonos, haz clic aquí
Publicar mensajes dentro de un ticket¶
/v2/message/
- POST
El servicio de Publicar Mensajes
permite responder un mensaje a un cliente dentro de un determinado ticket de atención. Si no se provee un client_id
, el mensaje se enviará al primer cliente que participe en el ticket y se responderá al último mensaje del ticket.
Por defecto, solo se pueden responder mensajes privados, por lo que Desk buscará el primer mensaje privado que encuentre y responderá a ese.
Si requiere enviar mensajes públicos, lo puede hacer enviando el parámetro private_only
en false
. De esta forma, si se encuentra un mensaje público primero, se respondera a ese mensaje.
No hay mensajes
Si Desk no encuentra mensajes privados del cliente y no se usa el flag private_only
o se establece en true
usted obtendrá el código de error 403 - FORBDDEN
. Si no se encuentra ningún mensaje, recibirá un mensaje de error 404 - NOT FOUND
.
Solo mensajes de Desk
Usted sólo puede responder mensajes que han pasado por Desk y estén vinculados a las cuentas de su empresa en nuestra plataforma.
Un ejemplo de respuesta después de un envío exitoso será:
1 2 3 4 | { "status": 200, "message": "Message sent to carlos@soto.cl" } |
La respuesta se conforma de los siguientes campos:
Campo | Descripción | Tipo |
---|---|---|
status | Código de retorno de la petición. 200 si la petición fue exitosa |
integer |
message | Texto indicando a quien fue enviado el mensaje | string |
Usted debe enviar los siguientes parámetros en formato JSON
en el body
de su petición:
Campo | Descripción | Tipo | Requerido |
---|---|---|---|
ticket_id | Id del ticket al cual se desea responder | string |
sí |
client_id | Id del cliente al cual se desea responder | string |
no |
message | Mensaje a enviar al cliente | string |
sí |
private_only | Si el mensaje puede o no ser enviado como respuesta pública | boolean |
no |
Un ejemplo es:
1 2 3 4 | { 'ticket_id': '583dcb2855d0a46e438d0206', 'message': 'Este es un mensaje para un cliente' } |
Si todo es correcto, la respuesta esperada será:
1 2 3 4 | { "status": 200, "message": "Message sent to carlos@soto.cl" } |
El mensaje en este ejemplo se habrá enviado al primer cliente en el ticket 583dcb2855d0a46e438d0206
de manera privada.
Otro ejemplo puede ser:
1 2 3 4 5 6 | { 'ticket_id': '583dcb2855d0a46e438d0206', 'client_id': '546b9b2720a9f1301050fec3', 'message': 'Este es un mensaje para un cliente' 'private_only': false, } |
Donde se explicita que el cliente 546b9b2720a9f1301050fec3
recibirá el mensaje en el ticket 583dcb2855d0a46e438d0206
pudiendo ser que su respuesta aparezca pública o privada, dependiendo de cuál sea más reciente.
Mensajes automáticos
Para el envío de mensajes automáticos, se recomienda siempre explicitar private_only
en true
, dado que es posible que usted desee enviar datos como comprobantes de venta/pago, ordenes de compra u otro tipo de información confidencial al cliente.