360Dialog (nube)

360dialog es el proveedor oficial de WhatsApp Business. Mediante el conector (en la nube) de 360Dialog, puedes conectar el bot a la cuenta de WhatsApp Business (WABA). Puede encontrar más información sobre las reglas de WhatsApp en la documentación de 360dialog.

Conexión

Configuración en el lado 360dialog

En primer lugar, es necesario configurar en el lado 360dialog.

1. Acceda a su cuenta 360dialog. En la página principal aparecerá una lista de las cuentas de WhatsApp Business registradas (más información sobre cómo registrar una cuenta de WhatsApp Business).

1. Seleccione la cuenta de empresa a la que desea conectar el Agente.

2. Obtenga un token de acceso siguiendo las instrucciones.

3. Copia el token de acceso.

Configuración del canal del proyecto en la plataforma

Debe crear y configurar un canal de proyecto con el conector 360Dialog (nube).

1. Vaya a la pestaña Canales del proyecto.

⁠2. Pulse el botón Crear canal.

1. Se abrirá el panel de selección de canal final.

1. Seleccione 360Dialog (nube).

2. Se abrirá el panel de creación del Canal Proyecto.

1. Opcionalmente, introduzca un título para este Canal de Proyectos en el campo Nombre con el marcador de posición Nuevo canal.

1. Pegue el token recibido en el campo token de 360Dialog.

1. Para guardar el Canal Proyecto sin activarlo, pulse el botón CREAR.

1. Para guardar y activar el Canal Proyecto, haga clic en el botón CREAR Y ACTIVAR.

a. El Canal Proyecto se guardará y activará si:

i. Se publica el proyecto;

ii. El token del campo token de 360Dialog es único (no hay canales activos del mismo tipo con el mismo token);

iii. La dirección del canal es accesible;

iv. El webhook del canal se ha registrado correctamente.

b. El Canal Proyecto se guardará pero no se activará si no se cumplen una o varias condiciones.

1. Para cancelar la creación del Canal Proyecto, pulse el botón CANCELAR.

Editar y eliminar el canal del proyecto

Para editar un Canal de Proyectos, haga clic en su ficha en la lista de Canales de Proyectos.

1. Para editar cualquier campo, haga clic en él e introduzca un nuevo valor.

2. Para aplicar los cambios a un Canal Proyecto activado, pulse el botón APLICAR.

a. Los cambios se aplicarán si:

i. Se publica el proyecto;

ii. El token del campo token de 360Dialog es único (no hay canales activos del mismo tipo con el mismo token);

iii. La dirección del canal es accesible;

iv. El webhook del canal se ha registrado correctamente.

b. Los cambios no se aplicarán si no se cumplen una o varias condiciones.

1. Para desactivar el Canal Proyecto, pulse el botón DESACTIVAR.

1. Para aplicar los cambios a un Canal Proyecto no activado, pulse el botón GUARDAR.

1. Para aplicar los cambios y activar el Canal Proyecto, pulse el botón GUARDAR Y ACTIVAR.

a. Los cambios se aplicarán y el Canal Proyecto se activará si:

i. Se publica el proyecto;

ii. El token del campo token de 360Dialog es único (no hay canales activos del mismo tipo con el mismo token);

iii. La dirección del canal es accesible;

iv. Se puede registrar el webhook del canal.

b. Los cambios se aplicarán pero el Canal Proyecto no se activará si no se cumplen una o varias condiciones.

1. Para cancelar los cambios, pulse el botón CANCELAR.

1. Para eliminar el Canal Proyecto, pulse el botón ELIMINAR.

Comunicación

La interacción con este canal final se produce de forma asíncrona, utilizando la API de WhatsApp Business.

Modelo de mensaje

Las plantillas son mensajes con los que un Bot de WhatsApp inicia un Chat con el Usuario Bot. Para enviar un correo a Usuarios Bot en WhatsApp, es necesario crear una plantilla, enviarla para su aprobación, si no tiene éxito, reformular y enviar una nueva plantilla, y si es aprobada, iniciar el envío utilizando la ranura de notificaciones.

Asignación de variables de canal desde 360dialog(Cloud)

Canal variable	Canal final	Variable en el cuerpo de una solicitud entrante de un canal	Peculiaridades
channel_conversation_id	360Dialog (cloud)	response["messages"][0]["from"]
channel_visitor_id	360Dialog (cloud)	response["messages"][0]["from"]
channel_visitor_firstname	360Dialog (cloud)	response["contacts"][0]["profile"]["name"]	Puede faltar hasta el primer espacio
channel_visitor_lastname	360Dialog (cloud)	response["contacts"][0]["profile"]["name"]	No puede haber ningún espacio después del primer espacio
channel_visitor_phone	360Dialog (cloud)	response["messages"][0]["from"]	Después de enviar un mailing por Notificación, esta variable contiene el número de teléfono al que se envió el mailing
channel_visitor_email	360Dialog (cloud)	No
channel_visitor_account	360Dialog (cloud)	response["messages"][0]["from"]	Número de teléfono del usuario
channel_visitor_auth	360Dialog (cloud)	No
channel_visitor_source	360Dialog (cloud)	No
channel_reply_to	360Dialog (cloud)	no

Comunicación en 360dialog (Nube)

Funcionalidad	Canal	Disponibilidad	Descripción
channel_chat_id	360Dialog (cloud)	Sí	Formato: número de teléfono del Usuario Bot empezando por el prefijo telefónico del país sin el signo + |dialog360
Los mensajes llegarán al Usuario Bot si el Agente escribe primero en un chat existente	360Dialog (cloud)	Parcialmente	El Agente puede iniciar un Diálogo enviando una plantilla aprobada, Sin embargo, en 360dialog el Diálogo dura 24 horas; pasado este tiempo, el mensaje enviado por el Agente a través de la Ranura de Solicitud Entrante no llegará al Usuario Bot.
Botones	360Dialog (cloud)	Parcialmente	Si no hay más de 3 botones en el menú de botones, se enviarán como botones; Si hay más de 3 botones en el menú de botones, se enviarán como una lista numerada.
Transferencia al operador	360Dialog (cloud)	No	WhatsApp no tiene software de operador
Transferencia de archivos como archivos del Agente	360Dialog (cloud)	Parcialmente	La imagen no se transmite, el vídeo se transmite, el audio se transmite como archivo de audio, el archivo se transmite como archivo para descargar
Transferencia de archivos como enlaces desde el Agente	360Dialog (cloud)	Sí	Se intenta enviar una imagen/archivo utilizando un método especial; si el formato del archivo a través del enlace no es adecuado, el canal responderá con un mensaje de error técnico y entonces repetiremos el envío del mensaje pero enviaremos un enlace al archivo/imagen en texto plano.
Recepción de un archivo del Usuario Bot en un script	360Dialog (cloud)	Sí	Formato: archivo:tipo de archivo|id del archivo transferido|https://waba.360dialog.io/v1/media/id del archivo transferido Example: file:document|7b825480-9148-44a7-9454-b60d7f433e14|https://waba.360dialog.io/v1/media/7b825480-9148-44a7-9454-b60d7f433e14
Recibir geolocalización de un usuario Bot en un script	360Dialog (cloud)	No
Entrega de mensajes de más de 1000 caracteres del Agente al Usuario Bot	360Dialog (cloud)	Sí
Uso de Markdown	360Dialog (cloud)	No
Envío con notificación	360Dialog (cloud)	Sí	Antes de crear una ranura de notificación, debe hacer lo siguiente: 1. Cree una plantilla en 360dialog 2. Importante: sólo un Agente puede estar conectado a un WABA.