📇Widget

La Plataforma tiene la capacidad de conectar el Bot a un widget personalizado y mostrarlo en su sitio web. El widget se crea de forma similar a otros Canales de Proyecto.

Conexión

Configuración del widget en la plataforma

Debe crear y configurar un canal de proyecto con un conector de widgets.

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

2. Se abrirá el panel de creación del Canal Proyecto.

1. En la pestaña Configuración:

   1. Opcionalmente, introduzca un título para este Canal de Proyectos en el campo Nombre con el marcador de posición Nuevo canal.

   

   b. Opcionalmente, añada dominios en los que estará disponible el widget en el campo Dominio.

i. Si especifica un dominio, el widget no funcionará en otros dominios. Esto le ahorrará el robo del widget si los datos del sitio se ven comprometidos.

ii. Puede especificar el propio dominio o el patrón en el formato *.dominio.com. En este caso, el widget funcionará en todos los subdominios de dominio.com.

c. Necesitará el fragmento en el campo Fragmento para instalar el widget en su sitio web. Puede copiarlo pulsando el botón COPIAR CÓDIGO WIDGET.

1. Vaya a la pestaña Diseño.

a. Introduce un nombre para tu Bot en el campo Nombre del Bot

⁠b. Introduzca un título para el widget en el campo Título del widget

c. Especifique el color del widget en el campo Color del widget. El color del widget puede establecerse de dos formas:

i. Código HEX, por ejemplo #ADFF2F;

ii. el nombre del color. ​

d. Opcionalmente, especifique el color de la fuente del widget (color de los mensajes del Bot) en el campo Color de fuente del widget. El color de la fuente del widget puede establecerse de dos maneras:

i. Código HEX, por ejemplo #ADFF2F;

ii. el nombre del color.

e. Opcionalmente, añada una imagen para el widget en el campo Logotipo de la empresa. Si no añades una imagen, el widget se mostrará con una imagen por defecto.

⁠f. Si es necesario, especifique una sugerencia de marcador de posición en el campo Marcador de posición en el widget expandido. Si no especifica ninguna pista, el texto "Escriba un mensaje" se insertará automáticamente en el campo de entrada.

g. Si es necesario, añade un mensaje de bienvenida del Bot. Para ello, active el interruptor expandido Enviar mensaje de bienvenida en el widget e introduzca el mensaje en el campo de mensaje de bienvenida del Bot.

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. Para cancelar la creación del Canal Proyecto, pulse el botón CANCELAR.

b. El Canal del Proyecto se guardará y activará si el Proyecto se Publica;

1. Si el proyecto no se publica, el canal del proyecto se guardará pero no se activará.

Instalación del widget en su sitio web

1. Para instalar el widget en su sitio web, copie el fragmento y péguelo en el de su código.

1. Active el Canal Proyecto si aún no lo está.

2. A continuación, el widget aparecerá en su sitio web.

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.

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.

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 del Proyecto se activará si el Proyecto está Publicado;

b. Si el proyecto no se publica, el canal del proyecto se guardará pero no se activará.

1. Para cancelar los cambios, pulse el botón CANCELAR.

1. Para eliminar el Canal Proyecto, pulse el botón ELIMINAR.

Comunicación

Asignación de variables de canales desde el widget

Canal variable	Canal final	Variable en el cuerpo de una solicitud entrante de un canal	Peculiaridades
channel_visitor_id	Widget	una cadena generada por Platform,channel_visitor_id es igual a channel_chat_id
channel_visitor_firstname	Widget	No
channel_visitor_lastname	Widget	No
channel_visitor_phone	Widget	No
channel_visitor_email	Widget	No
channel_visitor_account	Widget	No
channel_visitor_auth	Widget	No
channel_visitor_source	Widget	un enlace a la página en la que está incrustado el widget
channel_reply_to	Widget	no

Comunicación en widget

Funcionalidad	Canal	Disponibilidad	Descripción
channel_chat_id	Widget	Sí	una cadena generada por la Plataforma, channel_visitor_id es igual a channel_chat_id
Los mensajes llegarán al Usuario Bot si el Agente escribe primero en un chat existente	Widget	Sí
Botones	Widget	Sí
Transferencia al operador	Widget	No
Transferencia de archivos como archivos del Agente	Widget	No
Transferencia de archivos como enlaces desde el Agente	Widget	Sí
Recepción de un archivo del Usuario Bot en un script	Widget	No
Recibir geolocalización de un usuario Bot en un script	Widget	No
Entrega de mensajes de más de 1000 caracteres del Agente al Usuario Bot	Widget	Sí
Uso de Markdown	Widget	No
Envio con notificación	Widget	No
Obtener un enlace a la fuente de información	Widget	Sí	channel_visitor_source contiene un enlace a la página en la que está incrustado el widget