Chat2Desk

⁠

Chat2Desk es una de las plataformas omnicanal para comunicarse con los clientes en canales de texto. Puede utilizarla como canal para publicar su Agente como operador de Bot. Puede consultar la documentación de usuario utilizando este link.

Conexión

Configuración del bot en Chat2Desk

1. Inicie sesión en su cuenta de Chat2Desk.

2. Ir a API y scripts.

⁠3. Haga clic en "Mostrar" e introduzca la contraseña del administrador de la cuenta.

⁠4. Copie el token de API recibido.

Configuración del canal del proyecto en la plataforma

Debe crear y configurar un canal de proyecto con el conector Chat2Desk.

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

1. Pulse el botón Crear canal.

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

1. Seleccione Chat2Desk.

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. Pegar el enlace https://api.chat2desk.com/v1 o https://api.chat2desk.kz/v1 en el campo URL del webhook de Chat2Desk.

1. Pegue el código copiado anteriormente en el campo de código de Chat2Desk.

1. Si necesita configurar la asignación automática de chats a un operador específico, introduzca el ID del operador en el campo ID del operador de Chat2Desk. Cómo obtener el ID de operador: Conectar el Bot como un operador en Chat2Desk

1. Opcionalmente, active la recepción de mensajes de servicio conmutando el interruptor basculante.

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 Chat2Desk 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 Chat2Desk 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.

image.png

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 Chat2Desk 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

Conexión del bot como operador en Chat2Desk

En Chat2Desk, es posible configurar la autoasignación del chat a un operador específico. Cuando la autoasignación de chat está desactivada, los chats se dirigen a la cola general.

Si necesitas que el Bot procese sólo los chats asignados a un operador específico, necesitas conectar el Bot como un operador específico y configurar la asignación de nuevos chats a este operador. Si no se especifica el ID del operador en la configuración del canal del proyecto, el Bot recibirá todos los mensajes de la cola general, es decir, no asignados a ningún operador específico.

Para configurar la conexión del Bot como operador en Chat2Desk, es necesario:

1. Inicie sesión en su cuenta de Chat2Desk.

2. Vaya a Ajustes - Operadores - Lista.

1. Haga clic en el botón Crear operador.

⁠4. Rellene todos los datos del nuevo operador.

1. Inicie sesión como el operador recién creado. Obtenga el token de API como se describe en el paso 3 de la sección "Configuración del bot en el lado de Chat2Desk".

2. Vaya a la aplicación Cartero y envíe la siguiente solicitud:

   1. Método: GET

   2. URL: https://api.chat2desk.com/v1/operators/

   3. Headers: Authorization: {API token de la cuenta personal}

3. La respuesta a la solicitud incluirá una lista con información sobre todos los operadores en el siguiente formato:

4. `{"data":[{”id":``operator id``,"email":”email","first_name":"first name","last_name":"last name","role":"role",”phone":"phone number","avatar":avatar,”last_visit":”time of last login to the account","online":1 if operator is online, 0 if offline,”offline_type":null,"external_id":null,"opened_dialogs":number of opened dialogs,"status_id":0}, {data for the next operator}],"meta":{"total":total number of operators,"limit":limit on the number of operators,"offset":0},”status":"success"}`

5. Busca la información sobre el operador creado para conectar el Bot y copia el valor del parámetro "id".

6. Este valor debe insertarse en el campo ID de operador de Chat2Desk en la configuración del Canal de Agente en Chat2Desk.

⁠Asignación de variables de canal de Chat2Desk

Canal variable	Canal final	Variable en el cuerpo de una solicitud entrante de un canal	Peculiaridades
channel_message_id	Chat2Desk	message_id	id del mensaje asignado por Chat2Desk (implementado sólo en C2D)
channel_message_recipient	Chat2Desk	operator_id	El bot en Chat2Desk es un operador y recibirá su id en esta variable (implementado sólo en C2D)
channel_visitor_id	Chat2Desk	client_id
channel_conversation_id	Chat2Desk	dialog_id
channel_visitor_phone	Chat2Desk	client.phone	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_firstname	Chat2Desk	client.name
channel_visitor_lastname	Chat2Desk	No
channel_visitor_account	Chat2Desk	No
channel_visitor_email	Chat2Desk	No
channel_visitor_source	Chat2Desk	No
channel_visitor_auth	Chat2Desk	No
channel_visitor_location	Chat2Desk	No
channel_reply_to	Chat2Desk	no

Mensajes de servicio de Chat2Desk

Mensaje	Canal final	Formato en client_message	Descripción	Casos
Cerrar una conversación en Chat2Desk	Chat2Desk	String:c2d: diálogo cerrado	El mensaje de servicio llega a client_message cuando se cierra el diálogo en Chat2Desk a través de la función Cerrar chat.

Acerca de los mensajes de servicio y cómo activar su transmisión desde el Canal Final: Despliegue del proyecto a los canales

Comunicación en Chat2Desk

Funcionalidad	Canal	Disponibilidad	Descripción
Uso de Markdown	Chat2Desk	Parcialmente	Compatible con widget. La aparición de texto Markdown en otros canales depende de los propios canales.Se admiten los siguientes tipos de marcado:cursivacursiva___negrita fuente_negrita cursivaenlace
channel_chat_id	Chat2Desk	Si	Formato: 500482964|chat2desk
Los mensajes llegarán al Usuario Bot si el Agente escribe primero en un chat existente	Chat2Desk	Si	Casos: El operador aceptó y permaneció en el chat - el bot puede escribir al interlocutor. El operador aceptó y cerró el chat - el bot puede escribir al interlocutor.
Botones	Chat2Desk	Si
Transferencia al operador	Chat2Desk	Parcialmente	Change Chat Mode — noExternal Request — yes
Transferencia de archivos como archivos del Agente	Chat2Desk	Si	El widget recibe un icono que conduce a un enlace como https://storage.chat2desk.com/companies/company_236200/messages/199219/Kalimba.mp3; Al hacer clic, el contenido se reproduce automáticamente. Las imágenes se transmiten como imágenes.
Transferencia de archivos como enlaces desde el Agente	Chat2Desk	Parcialmente	Se muestra de forma similar al archivo transferido, el enlace lleva a storage.chat2desk.com y el archivo se abre automáticamente en el navegador. Nota: no es visible en telegram
Recepción de un archivo del Usuario Bot en un script	Chat2Desk	Si	Format: file:photo|https://storage.chat2desk.com//companies/company_236200/messages/169029/9ac926de046179b3.png
Recibir geolocalización de un usuario Bot en un script	Chat2Desk	No
Entrega de mensajes de más de 1000 caracteres del Agente al Usuario Bot	Chat2Desk	Si
Obtener un enlace a la fuente de información	Chat2Desk	No
Envío con notificación	Chat2Desk	No