Jivo
Last updated
Last updated
es una de las plataformas omnicanal más populares que ofrece a los operadores una herramienta para comunicarse con los clientes en redes sociales, mensajería instantánea, aplicaciones móviles y su propio widget web.
Es necesario crear y configurar un canal de proyecto con el conector Jivo.
Vaya a la pestaña Canales del proyecto.
Pulse el botón Crear canal.
Se abrirá el panel de selección de canal final.
Se abrirá el panel de creación del Canal Proyecto.
Opcionalmente, introduzca un título para este Canal de Proyectos en el campo Nombre con el marcador de posición New channel.
7. El campo Token de Jivo contendrá un token generado automáticamente que deberá especificarse en la configuración de Jivo.
8. Opcionalmente, active la recepción de mensajes de servicio conmutando el interruptor basculante.
Para guardar el Canal Proyecto sin activarlo, pulse el botón CREAR
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 Jivo 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.
Para cancelar la creación del Canal Proyecto, pulse el botón CANCELAR.
Nota: Este artículo sólo cubre la integración de Jivo con los robots; para obtener información sobre cómo organizar el enrutamiento de diálogo entre los robots y los operadores, consulte la documentación de Jivo.
Inicia sesión en Jivo.
Para los interlocutores, los bots en Jivo parecen operadores (empleados virtuales). Rellene los siguientes campos:
Avatar: imagen que se mostrará como avatar del empleado en el widget web de la marca Jivo;
Nombre: lo que se mostrará en el widget web Jivo de marca como nombre del empleado;
Posición: lo que se mostrará en el widget web Jivo de marca como la posición del empleado.
Pegue el token previamente copiado de la Plataforma en el campo Bot Token.
5. Seleccione los canales que desea conectar en la sección Conectar para los siguientes canales marcando la casilla situada junto a los canales necesarios y haga clic en el botón Guardar.
Para editar un Canal de Proyectos, haga clic en su ficha en la lista de Canales de Proyectos.
Para editar cualquier campo, haga clic en él e introduzca un nuevo valor.
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 Jivo 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.
Para desactivar el Canal Proyecto, pulse el botón DESACTIVAR.
Para aplicar los cambios a un Canal Proyecto no activado, pulse el botón GUARDAR.
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 Jivo 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.
Para cancelar los cambios, pulse el botón CANCELAR.
Para eliminar el Canal Proyecto, pulse el botón ELIMINAR.
client_id
remitente.id
remitente.name (opcional)
No
No
remitente.phone (opcional)
Importante: Esta variable no llega si Jivo y el stand no tienen un acuerdo para transferirla
remitente.email (opcional)
Importante: Esta variable no llega si Jivo y el stand no tienen un acuerdo para transferirla
remitente.user_token (opcional)
remitente.url (opcional)
Contiene un enlace a la página donde se encuentra el widget, o a la página de Avito
El enlace contiene información sobre el canal a través del cual se produce la comunicación
no
Cierre del diálogo
Cadena: jivo: operador se unió al chat
Después de completar la transferencia de la conversación a un operador en el modo de cambio de chat, los operadores de Jivo deben hacer clic en el botón "Aceptar diálogo" para unirse a la conversación. Al hacer clic en este botón, recibimos un evento en client_message si los mensajes del Servicio de Canal están activados para este Canal de Proyecto
Cuando el bot haya transferido el diálogo al operador, y hasta que éste haga clic en "Entrar en diálogo", todos los mensajes del interlocutor se enviarán al bot, y éste responderá a ellos como si se hubiera iniciado un nuevo diálogo. Se puede implementar una Rama Script para que el bot permanezca en silencio o responda "el operador llegará pronto" hasta que consigamos jivo: operador se unió al chat *** Translated with www.DeepL.com/Translator (free version) ***
channel_chat_id
Sí
formato <id_cliente jivo>|jivosite
Los mensajes llegarán al Usuario Bot si el Agente escribe primero en un chat existente
Parcialmente
el diálogo en Jivo dura 2 horas, los mensajes llegarán al Interlocutor sólo durante este tiempo
Botones
Sí
Los botones del teclado llegan a Telegram
Transferencia al operador
Sí
utilizando la ranura Cambiar modo de chat
Transferencia de archivos como archivos del Agente
No
Transferencia de archivos como enlaces desde el Agente
Sí
en Telegram, los enlaces de imagen muestran automáticamente la imagen en el mensaje
Recepción de un archivo del Usuario Bot en un script
Sí
Los metadatos del archivo (tipo, enlace) se escriben en la variable client_message; el archivo no se carga en la plataforma.
Recibir geolocalización de un usuario Bot en un script
Sí
Entrega de mensajes de más de 1000 caracteres del Agente al Usuario Bot
Parcialmente
En OK, FB, VK, los mensajes de más de 1000 bytes se dividen en varios párrafos. Transmitidos íntegramente en Messengers
Obtener un enlace a la fuente de información
Parcialmente
La variable channel_visitor_source contiene un enlace a la página donde se encuentra el widget, o a la página de Avito. No funciona para otros mensajeros
Uso de Markdown
Parcialmente
Envío con notificación
No
Cuando se utiliza la ranura Cambiar modo de chat, el diálogo cambia al operador. Tras cambiar al operador, el Diálogo finaliza y se muestra en la pestaña Análisis.
Todos los eventos de Jivo al proveedor de bots y viceversa se envían en forma de solicitudes HTTPS utilizando el método POST en formato application/json. El tiempo de espera de la solicitud es de 3 segundos, el número de reintentos es de 2 (total 3 intentos, 3 segundos cada uno), hasta que se reciba una respuesta regular exitosa, de lo contrario el cliente es transferido al operador.
Seleccione .
Ir a
client_message al enviar geolocalización: 📍 Ubicación.
Soportado en 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 cursivaCaracterísticas conocidas: Telegram y VKontakte no soportan Markdown, el texto llega sin marcas.