El marco de chatbot de Workvivo está diseñado para transformar la forma en que las organizaciones interactúan y se relacionan con sus empleados, lo que permite conversaciones fluidas, intuitivas e impactantes a través de una plataforma de chatbot avanzada y personalizable.
Esto permite a las organizaciones crear experiencias de chatbot personalizadas que van más allá de las simples respuestas de texto, mejorando las interacciones en el chat con elementos multimedia e interactivos.
Dispositivo(s): Web, Móvil
Roles/Permisos: Administrador y Desarrollador
Disponibilidad: Acceso general
Nota: Solo disponible para clientes que tengan el complemento de chat; habla con tu representante de Éxito del cliente para obtener más información.
- Flujo de creación de bots por parte del administrador
- Publicado en developer.workvivo.com
- Nueva conversación de bots
- Dejar conversación
- Plantilla de texto y medios
Configuración inicial de API:
Para usar la API de Workvivo, primero debes comunicarte con el servicio de soporte para solicitar acceso a la API. Consulta developer.workvivo.com para obtener más detalles.
- Utilice las API de Workvivo con un token de portador
- Manejar solicitudes de webhook desde Workvivo.
- Verifique la autenticidad de las solicitudes de webhook utilizando un JWT proporcionado por Workvivo.
Autorización para las API de Workvivo
Para interactuar con las API de Workvivo, necesitas un token de portador para la autorización. Incluye el token en el encabezado de autorización al realizar las solicitudes. Hay más detalles disponibles aquí.
Alcances requeridos
Se requieren los siguientes alcances para utilizar las API de Workvivo para interacciones de chatbot:
chats.bots.read – Para leer información y configuración del chatbot.
chats.bots.write – Para crear chatbots y actualizar la configuración de un chatbot.
chats.message.write - Para crear mensajes en el chat de workvivo.
Manejo de solicitudes de webhook desde Workvivo
Cuando un usuario interactúa con un chatbot en Workvivo, Workvivo envía una solicitud POST a la URL del webhook especificada durante la creación del bot. Esta solicitud incluye un JWT en el encabezado x-workvivo-jwt para verificar la autenticidad de la solicitud.
Formato de solicitud de webhook
Método HTTP: POST
Tipo de contenido: aplicación/json
Encabezado de webhook
x-workvivo-jwt: JWT generado por Workvivo
Medios en chatbots
- Para conocer las especificaciones sobre los archivos adjuntos en los chatbots, consulta aquí
Notas:
Esto te permite enviar un archivo por mensaje
Los chatbots admiten los siguientes tipos de archivos
- Tipos MIME de imágenes: gif, png, jpg, jpeg, jfif
- Tipos MIME de videos: video/mp4, videp/x-m4v
-
Archivo: no hay restricción de tipo de archivo según los tipos MIME permitidos. Excepción de error al enviar una imagen o un video.
- También puedes agregar miniaturas al video
- Tamaño máximo: 128 MB
Ejemplos:
.
.
Activar la función de chatbot
Puedes activar los chatbots directamente desde el panel de administración de tu entorno, activando la siguiente opción de configuración:
Si necesitas ayuda, comunícate con tu contacto de Workvivo para que te habiliten esta función.
Creación de un chatbot en Chat Admin
Vaya a Administración > Administración de chat > Administrar bots
Seleccione "Agregar bot de chat"
- Agregue el apodo del bot, por ejemplo, "Helpdesk"
- Agregue la URL de la imagen del bot para darle al bot un avatar en el chat
- Seleccione un tipo de bot: esta es una categoría en la que reside el bot, por ejemplo, Productividad
- Agregar la URL de devolución de llamada del bot
Seleccione la audiencia
- Esto determinará quién tendrá acceso para comunicarse con este Bot.
- Global está configurado de forma predeterminada, los administradores pueden seleccionar varios equipos.
- Seleccione "Guardar"
Una vez guardado
- El bot está deshabilitado de forma predeterminada: cámbielo a Habilitar
Desde aquí puedes editar o eliminar el bot