En primer lugar, debes integrar Zenvia Bots, para obtener más información sobre cómo hacerlo, puedes consultar este artículo.
Si está correctamente integrado, verás un OK en verde, como se muestra a continuación:
Para ver la API Key de esta integración, haz clic en el icono de Bots y te aparecerá la siguiente pantalla:
En el siguiente paso, usaremos la API Key para configurar el plugin en Bots.
Configurando el plugin de Zenvia Bots
Después de crear tu flujo en App.zenvia > Productos > Bots > Nuevo flujo:
Selecciona el plugin Consultar contacto registrado:
La función principal de este plugin es verificar si el contacto ya está en la base de datos de Zenvia Conversion (considerando la línea de WhatsApp y el grupo con el que interactúa el contacto).
Si ya es un contacto conocido con un asesor asignado, la conversación se transferirá directamente a ese asesor específico.
Luego, se abrirá una nueva ventana donde deberás pegar la información de la API Key generada previamente en el campo Token Sirena:
También deberás agregar el Plugin Sirena. La función principal de este complemento es transferir la conversación a Zenvia Conversion.
Hay 4 formas de transferir una conversación de Zenvia Bots a Conversion:
-
Directamente para el asesor designado cuando se trata de un contacto preexistente: En este caso, le recomendamos que agregue un grupo para transferir contactos si el contacto aún no ha sido asignado.
-
Configurar un grupo por defecto (Grupo Fijo Secundario) para crear una cola de conversación en un grupo específico: En este campo añadimos el ID del grupo.
-
Configurar un grupo fijo (Grupo predeterminado para desbordamiento) para transferir todas las conversaciones a un grupo fijo en todo momento.
-
Poner a disposición los grupos (departamentos) disponibles para la selección por parte de los clientes.
Accede al flujo en el que deseas agregar el plugin y haz clic en el icono de +:
Selecciona la opción Plugin Sirena, como se muestra en la imagen a continuación:
Se exibirá la ventana del componente:
De vuelta a Zenvia Conversion, haz clic en el botón ubicado junto al campo API Key para copiarla:
Finalmente, simplemente pega esta API Key en el campo Token Zenvia Conversion Bots:
Aún en esta ventana, maximiza el cuadro Más parámetros haciendo clic en el icono ubicado a la derecha:
Se mostrará el campo Teléfono de usuario, agrega la variable #{fone}, como se muestra en el siguiente ejemplo:
También puedes configurar un grupo predeterminado (grupo fijo secundario) para crear una cola de conversación en un grupo específico.
En este caso, el ID del grupo es:
ID Group
Directamente al consultor designado cuando se trate de un contacto preexistente;
Sugerimos usar la variable:
#{agentGroupId}
En este caso, le recomendamos que agregues un grupo para transferir contactos si aún no se ha asignado.
Las demás opciones de esta ventana se pueden configurar según las propias necesidades del usuario. Haz clic en el botón OK para completar esta configuración.
Además de estos ajustes, también es necesario editar el Evento Inicial.
Configurando el Evento Inicial
En tu flujo, haz clic en el botón del lápiz ubicado en la parte superior derecha del Evento Inicial para editarlo:
En la ventana de edición, agrega las variables que se utilizarán en el flujo, como se muestra a continuación:
|
Nombre |
Expresión |
|
username |
visitor.firstName |
|
fone |
from |
Para asegurarse de que la sintaxis sea la correcta, recomendamos copiar y pegar las variables de la tabla anterior. Para confirmar los cambios, haz clic en OK.
Finalmente, el último cambio que debemos hacer es agregar un código JSON.
Configurando JSon
Haz clic en la flecha ubicada en el lado derecho de tu flujo:
En la ventana que aparece, deberás agregar el siguiente Json al final del código:
1 2 "defaultConversationalChannel": "WHATSAPP", "historic": true
Para asegurarse de que la sintaxis sea la correcta, recomendamos copiar el snippet anterior y pegarlo en tu código de Bots.
Comprueba en la siguiente imagen la posición en la que este Json debería estar:
Después de guardar tus configuraciones, tu integración con Zenvia Conversion funcionará correctamente.