Webim (External Bot API 1.0)
Last updated
Last updated
es una de las plataformas omnicanal más populares para comunicarse con los clientes a través de canales de texto. Con la plataforma omnicanal Webim, puede colocar su Bot en uno o varios canales de comunicación.
En primer lugar, es necesario configurarlo en el lado Webim.
Inicie sesión en Webim como administrador.
Ve a Configuración → Bots.
Haz clic en el botón Crear nuevo bot y rellena los siguientes campos:
Agente para el bot - seleccione el operador al que se adjuntará el bot; se recomienda crear operadores separados para los bots.
Tipo de bot: selecciona Bot inteligente.
Orden de clasificación - el orden determina en qué lugar de la lista de bots se situará este bot. Cuanto menor sea el número, mayor será la prioridad.
Estado - seleccione el estado del bot.
Versión - seleccione la versión 1.
Estado - introduzca la dirección del webhook, se puede obtener al configurar el Canal del Proyecto - véase el párrafo Configuración del canal del Agente en la Plataforma.
Esto completa la configuración del Bot en Webim.
Es necesario crear y configurar un canal de proyecto con el conector Webim (External Bot API 1.0).
Vaya a la pestaña Canales del proyecto.
Pulse el botón Crear canal.
Se abrirá el panel de selección de canal final.
Seleccione Webim (External Bot API 1.0).
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 Nuevo canal.
Copia el enlace del campo URL del webhook de Chatbot y pégalo en el campo Enlace a API externa en la configuración del Bot en Webim.
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. La dirección del canal es accesible;
iii. 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.
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. La dirección del canal es accesible;
iii. 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. La dirección del canal es accesible;
iii. 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.
La interacción con este Canal Final ocurre usando un método síncrono, usando Webim External Bot API 1.0.Dado que el Canal Final es síncrono, la Conversación ocurre de acuerdo al esquema Request from Webim - Response from the Agent, esto impone algunas restricciones y características en la Conversación:
Para transferir a un operador utilizando el Modo Cambiar Chat, esta Ranura debe estar después de la Ranura Esperar Reacción: en respuesta a una Respuesta con un mensaje del Usuario Bot, se enviará una Respuesta con un comando de control para transferir el Diálogo al operador.
El Agente sólo puede responder a mensajes, pero no puede ser el primero en enviar mensajes al Chat de este Canal Final a través del Timer Slot o Incoming Request Slot, ya que en este caso no habrá ninguna Solicitud de Webim a la que se pueda dar una Respuesta.
Importante: cuando se activa el Temporizador o la Ranura de Solicitud Entrante, el Agente iniciará la Rama de Script correspondiente y seguirá el Script, deteniéndose en la Ranura de Espera de Entrada, mientras que los mensajes enviados antes de esta Ranura no se entregarán realmente al Agente.
Si se produce algún error en una solicitud de API (la respuesta difiere de la esperada o la solicitud se cerró tras un tiempo de espera de 5 segundos), el chat se transfiere automáticamente a la cola general de operadores.
chat.id
visitor.id
visitor.firstname
visitor.lastname
visitor.username
visitor.phone
visitor.email
visitor.location
no
Transferencia de archivos como archivos del Agente
Sí
channel_chat_id
Sí
format <webim chat_id>|webim
Los mensajes llegarán al Usuario Bot si el Agente escribe primero en un chat existente
No
En este caso, los mensajes no llegarán al Usuario Bot. Sólo los mensajes de Agente enviados en respuesta a sus acciones o a mensajes de servicio, si están habilitados, llegarán al Usuario Bot
Transferencia al operador
Sí
Uso de la ranura Cambiar Modo de ChatImportante: antes de Cambiar Modo de Chat debe haber Esperar ReacciónTambién se producirá la transferencia al operador si webim no recibe una respuesta del Agente en 5 segundos.
Botones
Sí
Transferencia de archivos como enlaces desde el Agente
Sí
Transferencia de archivos como archivos del Agente
No
La ranura Attachment pasará un enlace de texto
Recepción de un archivo del Usuario Bot en un script
No
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
Sí
Uso de Markdown
No
Envío con notificación
No
Se enviará un enlace como éste a :
