### **🚀 Instalación y Requisitos**
Para integrar el chat, acceda a [https://chatbot.zampisoft.com/account/?tab=installation](https://chatbot.zampisoft.com/account/?tab=installation), copie el código de inserción y péguelo dentro de las etiquetas `` o `` de cada página donde desee mostrar el chat.
**Ejemplo de implementación:**
```
```
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/8mwlu6t3tNJk7rhD-image.png)
---
\#users-info### **Configuración óptima**
ZampiBot es una herramienta potente, pero su gran cantidad de funciones puede dificultar su configuración rápida. Para agilizar el proceso, proporcionamos una lista de las funciones más utilizadas que recomendamos configurar. Al incorporar todas estas funciones, tendrá acceso a las más esenciales y beneficiosas.
1. Activar notificaciones por correo electrónico desde **Configuración > Notificaciones** Asegúrese de activar las siguientes opciones: **Notificaciones por correo electrónico del agente**, **Administrador de sonidos > Conversaciones y mensajes entrantes**, y **Notificaciones push.** Para obtener más información sobre cómo funcionan las notificaciones. [](https://docs.zampisoft.com/uploads/images/gallery/2026-01/9klLtMWVjIxDlgSU-image.png)
2. Configurar el servidor SMTP en **Configuración > Notificaciones > SMTP** Para más detalles, consulta la sección de notificaciones por correo electrónico . Si usas la [versión en la nube](https://zampibotpage.zampisoft.com/docs/#cloud-version) , el SMTP ya está activado, pero puedes usar el tuyo de todas formas. [](https://docs.zampisoft.com/uploads/images/gallery/2026-01/ESBvGLTgs5Y5eVgl-image.png)
3. Navega a **Configuración > Mensajes y formularios** y configura el [mensaje de seguimiento](https://zampibotpage.zampisoft.com/docs/#follow-up-message) y [el mensaje fuera de línea](https://zampibotpage.zampisoft.com/docs/#offline-message). [](https://docs.zampisoft.com/uploads/images/gallery/2026-01/r4S6ZUZMvdAJLhNa-image.png)
4. Pusher ya está activado.
5. Optimizar el [rendimiento](https://zampibotpage.zampisoft.com/docs/#performance) del sistema .
6. En caso de que estés utilizando el chatbot, asegúrate de consultar la configuración óptima [aquí](https://zampibotpage.zampisoft.com/docs/#optimal-configuration-ai) .
7. Si tiene dificultades para sincronizar servicios como Google o WhatsApp, nuestro equipo puede ayudarle a configurarlos. Al usar sus cuentas personales, como las de **Google** o **Facebook**, podrá disfrutar de créditos y cuotas gratuitas, y c**ostos significativamente más bajos** que con otros servicios de chat. Además, tendrá control total y transparencia sobre sus datos y gastos.
---
#### ¿Tienes problemas?
Si tiene algún problema, contacte con nuestro equipo de soporte a través del chat a la derecha de esta página. Antes de contactarnos, asegúrese de que su servidor cumpla con todos los requisitos mencionados anteriormente.
#### 403 Forbidden Error
El error 403 Prohibido es estrictamente un problema del servidor relacionado con los permisos de archivo o una regla de firewall que bloquea el acceso al recurso. No podemos ayudarle porque no está relacionado con nuestro producto. Envíe este mensaje y la URL del recurso bloqueado al soporte técnico de su servidor para que resuelvan el problema. A continuación, encontrará las causas más comunes del error 403 Prohibido.
- **Complemento de WordPress**— Si está utilizando la versión de WordPress, asegúrese de no tener ningún complemento de seguridad que genere el problema.
- **Permisos de archivos**— Los permisos de archivo del recurso son incorrectos. Deberían ser 644 para archivos y 755 para carpetas.
- **Cortafuegos**El firewall de tu servidor está bloqueando el recurso. Puedes comprobarlo desactivándolo o usando una VPN.
- **ModSecurity**— El ModSecurity de tu servidor está bloqueando el recurso. Puedes comprobarlo desactivándolo o usando una VPN.
- **Cloudflare**— El firewall de Cloudflare está bloqueando el recurso. Puedes comprobarlo desactivándolo o usando una VPN. Puedes solucionar el problema abriendo la configuración de tu sitio web de Cloudflare y comprobando..
---
#### Bloquear el zoom en dispositivos iOS
Al usar el chat en iPhones, el área de texto se amplía automáticamente cuando el usuario comienza a escribir un mensaje nuevo. Para detener el zoom, introduzca el código a continuación.**<head>**área de todas las páginas que incluyen el chat.
```
```
---
#### El widget de chat no se muestra
Es posible que el chat no se muestre debido a los siguientes motivos:
- Es posible que no veas el chat porque lo has desactivado en la configuración. Para solucionarlo, visita la sección de configuración y desmarca todas las opciones relacionadas: **Chat > Inicialización manual**,**Chat > Inicialización de inicio de sesión**,**Chat > Ocultar el chat fuera del horario de oficina**,**WordPress > Inicialización manual**. [](https://docs.zampisoft.com/uploads/images/gallery/2026-01/JBb54OMB0mQoTe2X-image.png)
- Intenta deshabilitar cualquier complemento de rendimiento o técnicas como la caché o la minimización de JavaScript en tu sitio web, ya que podrían estar causando problemas. Una vez deshabilitados, vuelve a verificar.
- Intente deshabilitar cualquier CDN o proxy (por ejemplo, CloudFlare). Una vez deshabilitado, vuelva a verificar.
---
#### Las conversaciones no son visibles para los administradores o agentes.
Es posible que las conversaciones no se muestren debido a los siguientes motivos.
1. Al agente se le ha asignado un [departamento](https://zampibotpage.zampisoft.com/docs/#departments) , pero las conversaciones no se han asignado a ese departamento específico.
2. Se han activado una o más de las siguientes configuraciones:
- **Misceláneas > Enrutamiento**
- **Misceláneas > Cola**
- **Misceláneas > Ocultar conversaciones de otros agentes**
3. Estás utilizando el chatbot y la función [de toma de control humana](https://zampibotpage.zampisoft.com/docs/#human-takeover) está activada. [](https://docs.zampisoft.com/uploads/images/gallery/2026-01/AhVuz3UZC8WxfoSC-image.png)
Para los casos 1 y 2, asegúrese de iniciar sesión con el administrador/agente correcto o revise su perfil para comprobar que no haya [departamentos](https://zampibotpage.zampisoft.com/docs/#departments) asignados. En el caso 3, revise las conversaciones archivadas.
---
## **CONVERSACIONES**
### **Gestionar conversaciones**
Las conversaciones tienen un total de cuatro estados diferentes: **marcar como leído**, **archivo**, **borrar** y **restaurar.** Puedes administrar el estado de una conversación abriéndola en el área de conversaciones y luego haciendo clic en cualquiera de los botones de ícono correspondientes en la parte superior derecha de la ventana de conversación.
#### Buscar conversaciones
Puede buscar conversaciones por ID de departamento, ID de agente asignado, título de la conversación, ID de la conversación, texto del mensaje, nombre de los archivos adjuntos, nombre del usuario, apellido del usuario y correo electrónico del usuario. Si busca un texto de mensaje específico, la conversación que lo contiene se mostrará en la posición correcta y se resaltará.
#### Información
- Cuando se vacía la papelera, todas las conversaciones en la papelera se eliminan de forma permanente.
- Cuando un usuario envía un mensaje nuevo a una conversación archivada o eliminada, la conversación se restaura automáticamente y ahora será visible en la **bandeja de entrada**.
- Las conversaciones eliminadas se eliminan automáticamente después de 30 días.
- Cuando se elimina un usuario, todas las conversaciones y mensajes también se eliminan de forma permanente.
- Un agente puede eliminar sus mensajes abriendo el menú de mensajes y haciendo clic **Borrar.** El menú del mensaje se hace visible cuando pasa el cursor del mouse sobre el mensaje.
- La lista de conversaciones de la izquierda utiliza paginación automática, que está limitada a 100 resultados por desplazamiento.
---
#### Responder a un mensaje
Puedes responder a un mensaje abriendo el menú del mensaje y haciendo clic en **Responder a.** La función de respuesta solo es compatible con los siguientes servicios de mensajería:**WhatsApp**, **Telegrama**,**Facebook Messenger**.
---
### **Funciones editor de texto y mensajes automatizado**
El editor de texto del área de administración y los mensajes automatizados (ejemplo: mensajes de bienvenida y suscripción) se pueden utilizar para crear mensajes estilizados:
1. Todos los enlaces de texto se convierten automáticamente en hipervínculos clicables. Para establecer el nombre del enlace, añada la siguiente cadena a la URL:**\#sb-ejemplo**. Reemplazar **ejemplo** con el nombre del enlace deseado y espacios en blanco con**--**.
2. El editor también admite la sintaxis de formato de texto:
1. 1. - **Negrita:**`*texto*`
- **Cursiva:**`__texto__`
- **Tachado:**`~texto~`
- **Código:**``texto``
- **Bloque de código:**````texto````
- HTML y otros lenguajes de programación: por razones de seguridad, no se permite HTML, JavaScript (JS) ni otros lenguajes de programación. Sin embargo, puede usar fragmentos de HTML mediante mensajes enriquecidos personalizados (que se explican más adelante).
- Para insertar un salto de línea en un mensaje, utilice la combinación de teclado **MAYÚS + ENTER** o **CTRL + ENTER**.
---
#### Fusionar campos
Los campos de combinación son cadenas que se reemplazan por valores externos cuando se usan. Pueden usarse en cualquier mensaje o mensaje automatizado, incluidos los mensajes de chatbot.
Código
Descripción
```
{user_name}
```
Nombre completo del usuario activo.
```
{user_email}
```
Correo electrónico del usuario activo.
```
{agent_name}
```
Nombre completo del agente activo.
```
{agent_email}
```
Correo electrónico del agente activo.
---
### **Mensajes enriquecidos**
Los mensajes enriquecidos son mensajes especiales con funciones interactivas como botones, menús desplegables o entradas. Permiten que un agente solicite información al usuario mediante un formulario de entrada o muestre contenido interactivo. Se pueden insertar en un mensaje de chat mediante códigos cortos. Estos códigos aceptan diversos parámetros, como el título y la descripción. Los mensajes enriquecidos disponibles se enumeran a continuación.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/tLLurENrmU7QTOwc-image.png)
---
#### Parámetros globales
Todos los mensajes enriquecidos admiten los siguientes parámetros:
---
Parameters
Description
```
id="123"
```
El ID del mensaje enriquecido (utilizado también para guardar los datos JSON).
```
title="ABC"
```
El título del mensaje enriquecido.
```
message="ABC"
```
La descripción enriquecida del mensaje que aparece debajo del título.
```
success="ABC"
```
El mensaje que aparece cuando el usuario completa y envía el mensaje enriquecido. La entrada del usuario se adjunta a este mensaje.
```
settings="ABC"
```
Campo adicional para valores extra opcionales.
---
#### Utilice mensajes enriquecidos en el chatbot
Debes crear un [chatbot de Dialogflow](https://zampibotpage.zampisoft.com/docs/#dialogflow-bot) y luego simplemente ingresar el código corto del mensaje enriquecido en el **respuesta de texto** del **Intención**.
---
#### Respuesta de mensaje enriquecido
Cuando un usuario completa un mensaje enriquecido, los datos de respuesta se guardan en formato JSON en la base de datos en la tabla **mensajes\_sb** y columna**carga útil**. Ejemplo:
```c#
{"rich-messages":{"4Voyu":{"type":"email","result":{"email":["example@email.com","Your email..."]}}}}
```
---
#### Traducciones de mensajes enriquecidos
Para traducir una cadena de mensaje enriquecido, el texto original del mensaje enriquecido debe estar en inglés; agregue el texto exacto en inglés y sus traducciones en **Configuración > Traducciones > Interfaz.**
---
#### Mostrar un mensaje enriquecido al inicializar el chat
Para mostrar un mensaje enriquecido, como una lista de botones, cuando un usuario inicia un chat por primera vez, inserte el código corto del mensaje enriquecido en el [mensaje de bienvenida](https://zampibotpage.zampisoft.com/docs/#welcome-message) .
---
#### Mensajes enriquecidos personalizados
Puede crear mensajes enriquecidos personalizados con su propio contenido personalizado yendo a **Configuración > Varios**Actualmente, los mensajes enriquecidos personalizados son estáticos y no ofrecen opciones interactivas como los códigos cortos. Sin embargo, puedes insertar códigos HTML personalizados.
---
#### Códigos HTML
Al crear un mensaje enriquecido personalizado, puede utilizar los siguientes códigos:
\#welcome-message### **Mensajes integrados**
Los mensajes integrados son mensajes preprogramados que envía automáticamente en ZampiBot. Puedes encontrarlos en **Configuración > Mensajes**.
#### Mensaje de bienvenida
Envía un mensaje a los nuevos usuarios cuando visitan el sitio web por primera vez.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/IrsYoK0gCTqS6wnC-image.png)
- Se admite [el formato de texto .](https://board.support/docs/#text-editor)
- Se admiten [campos de combinación .](https://board.support/docs/#merge-fields)
- Se admiten [mensajes enriquecidos .](https://board.support/docs/#rich-messages)
- El mensaje de bienvenida no se envía a Slack.
- Las conversaciones que contienen sólo el mensaje de bienvenida (y ninguna respuesta) se archivan automáticamente.
---
\#follow-up-message#### Mensaje de seguimiento
Si ningún agente responde dentro del intervalo de tiempo especificado, se enviará un mensaje para solicitar los detalles del usuario, como su correo electrónico.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/9DgJgpUpMZwbMSG2-image.png)
- Se admite [el formato de texto .](https://board.support/docs/#text-editor)
- Se admiten [campos de combinación .](https://board.support/docs/#merge-fields)
- Puede enviar un correo electrónico de confirmación al usuario completando el formulario **Correo electrónico de seguimiento** campos. El correo electrónico utiliza la plantilla definida en **Configuración > Notificaciones > Plantilla de correo electrónico**.
- Si la **demora** no está configurado, se utiliza un intervalo de tiempo dinámico y se determina de la siguiente manera: Si **Configuración > Varios > Horario de oficina.** Si está configurado y la hora actual coincide con el horario de oficina definido, o si al menos un agente está conectado, el retraso se establecerá en 15 segundos. En todos los demás casos, el retraso se establecerá en 5 segundos.
- Los mensajes de seguimiento se envían un máximo de una vez cada 24 horas.
- Si el usuario proporciona una dirección de correo electrónico y la función [de boletín informativo](https://board.support/docs/#newsletter) está habilitada, se suscribirá a la dirección de correo electrónico.
- El mensaje de seguimiento se envía solo a usuarios sin dirección de correo electrónico.
- [Si la función de toma de control humana](https://board.support/docs/#human-takeover) del chatbot está activada, el mensaje de seguimiento solo se envía durante la toma de control humana.
---
\#rating#### Calificación
Muestra el formulario de comentarios para calificar la conversación cuando esté archivada.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/tq36Y3Bva1H7jDFI-image.png)
- El mensaje de calificación es compatible con los canales de mensajería. Los botones de calificación no se muestran en los canales de mensajería. Sin embargo, si se configuran Inteligencia Artificial y OpenAI, se analizará la respuesta del usuario para extraer la calificación.
- La calificación es visible en el panel derecho de la área de conversaciones, la calificaciones de los agentes se muestra en la área de informe y en el perfil del agente.
- Habilite el recordatorio de correo electrónico de calificación configurando el retraso (en horas). En el opción **Retraso en el recordatorio por correo electrónico** . El correo electrónico recuerda al usuario que debe proporcionar comentarios y se envía solo si no ha calificado la conversación después del tiempo establecido. Para que esta función funcione, también debe configurar la opción **URL de redirección** — Ingrese cualquier URL que incluya el widget de chat (por ejemplo, la URL de su sitio web). Una vez que el usuario haga clic en el widget **Útil** o **No es útil**Al acceder al enlace del correo electrónico, se redirigirá a la URL de redireccionamiento especificada y la calificación se guardará automáticamente. Se abrirá el chat con el panel de calificación, que permite al usuario proporcionar comentarios adicionales.
- Los correos electrónicos se envían a través de los [trabajos cron](https://board.support/docs/#cron-jobs) .
---
\#offline-message#### Mensaje fuera de línea
Notificar al usuario cuando su mensaje se envía fuera del horario de oficina programado o todos los agentes están fuera de línea.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/NhR8z6hllH6Eoktz-image.png)
- Se admite [el formato de texto .](https://board.support/docs/#text-editor)
- Se admiten [campos de combinación .](https://board.support/docs/#merge-fields)
- Para conocer más sobre la opción de horario de oficina, haga clic [aquí](https://board.support/docs/#office-hours) .
- El mensaje sin conexión se envía al mismo usuario máximo 1 vez por hora.
- De forma predeterminada, el mensaje de desconexión también se envía si todos los agentes están desconectados, incluso en horario de oficina. Para evitarlo, active la opción **Deshabilitar la verificación de agentes**.
- [Si la función de toma de control humana](https://board.support/docs/#human-takeover) del chatbot está activada, el mensaje sin conexión solo se envía durante la toma de control humana.
- Si usted o cualquier otro agente está en línea usando [Slack](https://board.support/docs/#slack) , ZampiBot también lo considerará como agente en línea.
---
\#privacy-message#### Mensaje de privacidad
Presenta un mensaje de privacidad con los botones "Aceptar" y "Rechazar". Se requiere la aprobación del usuario al hacer clic en el botón "Aceptar" para comenzar a usar el chat. Esta función garantiza el cumplimiento de la política de privacidad y el RGPD.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/bfPLx7jIclYVN3jw-image.png)
- El mensaje de privacidad no se muestra si la opción **Configuración > Usuarios > Requerir registro** está habilitada.
- El mensaje de privacidad también se envía a canales de mensajería como WhatsApp, pero el usuario no puede aceptar o rechazar la política de privacidad. Las funciones de mensajería tampoco se bloquean. El mensaje se envía después de que el usuario inicie la conversación enviando su primer mensaje.
---
\#pop-up-message#### Mensaje emergente
Mostrar una notificación emergente a todos los usuarios.
- El mensaje emergente siempre se muestra hasta que el usuario lo cierra manualmente; luego permanece cerrado.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-02/88HoyOg6ULOVBtYg-image.png)
---
#### Archivos adjuntos
Aquí podrás acceder a información sobre la carga de archivos y los adjuntos de los mensajes.
- Los siguientes formatos de imagen se muestran automáticamente:**.jpg, .jpeg, .png**.
- Para obtener instrucciones sobre cómo enviar archivos adjuntos con un chatbot, haga clic [aquí](https://board.support/docs/#dialogflow-info) .
---
### ***Información***
Aquí puede acceder a información sobre una variedad de funciones asociadas con las conversaciones.
\#tags#### Etiquetas
Las etiquetas permiten una organización y agrupación más eficiente de las conversaciones. Consulte la información a continuación para obtener más detalles.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/6r2IHdZcMjOyaSlD-image.png)
- Puedes administrar las etiquetas desde **Configuración > Administrador > Etiquetas**.
- Las etiquetas se pueden asignar a las conversaciones a través de diferentes métodos: a través del área de administración navegando a **Configuración > Automatizaciones > Más**, a través de [acciones de Dialogflow](https://board.support/docs/#dialogflow-actions) y insertando la variable de JS **SB\_DEFAULT\_TAGS** en una página que muestre el chat o en una página web que muestre el chat o el panel de tickets.
- Para encontrar conversaciones con etiquetas específicas, simplemente introduzca los nombres de las etiquetas en la barra de búsqueda ubicada en la esquina superior izquierda del área de conversaciones de administración, o puede seleccionar la etiqueta deseada en el menú de filtros dedicado en la esquina superior izquierda. El filtro de etiquetas solo es visible si hay al menos una etiqueta asignada a una conversación.
- Comprueba la opción **Etiqueta destacada** para mostrar el icono de la etiqueta destacada en el área de conversaciones. Esto permite seleccionar las conversaciones asignadas a la primera etiqueta con un solo clic. La primera etiqueta en la parte superior siempre es la etiqueta destacada.
- Puedes desactivar las etiquetas desde **Configuración > Administrador > Deshabilitar funciones > Etiquetas**.
\#notes#### Notas
Las notas permiten a los agentes y administradores agregar comentarios a las conversaciones.
- Las notas solo son visibles para agentes y administradores.
- Si está utilizando OpenAI, le sugerimos habilitar la opción [de extracción de datos de notas](https://board.support/docs/#open-ai-settings) .
- Administrar la configuración de notas desde **Configuración > Administración> Configuración de notas**.[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/90tl1JOMxFFLDts4-image.png)
- Puedes desactivar las etiquetas desde **Configuración > Administrador > Deshabilitar funciones > Notas**.
- Activa funciones avanzadas de IA con la app de Inteligencia Artificial. Más información [aquí](https://board.support/docs/#note-data-scraping) .
\#transcript#### Transcripción
El agente o administrador puede enviar la conversación completa al usuario como un archivo de transcripción.
- Los agentes y administradores pueden enviar transcripciones de conversaciones a los usuarios haciendo clic en el botón **Transcripción** botón en la esquina superior derecha de la ventana de conversación del administrador.
- Los agentes y administradores pueden enviar automáticamente la transcripción al usuario cuando se archiva la conversación mediante el uso de **cerrar mensaje** disponible en**Configuración > Mensajes y formularios > Cerrar mensaje**.
- La transcripción se puede enviar al usuario sólo si el usuario tiene una dirección de correo electrónico.
- Si la conversación ha sido traducida, la transcripción también incluirá los mensajes traducidos.
#### Misceláneas
- El formato de fecha y hora se detecta automáticamente según la configuración de idioma del navegador.
---
## **USUARIOS**
### **Administrar usuarios**
Administrar usuarios desde el **Área de usuarios**en el menú izquierdo del área de administración.
##### ***Importar usuarios***
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/22BGy8dSVuOqvEwp-image.png)
Puedes importar usuarios desde **Configuración > Usuarios > Importar usuarios** Solo se admiten archivos CSV. Puede descargar un archivo CSV de ejemplo [aquí](https://board.support/docs/files/users.csv) . En el archivo de ejemplo, la primera fila es el encabezado y las columnas...**Altura** y **Color de pelo** ¿Se agregan campos de usuario personalizados desde? **Configuración > Usuarios > Campos personalizados**.
#### Buscar usuarios
Puede buscar usuarios por nombre, apellido, correo electrónico y campos personalizados.
#### Eliminar usuarios
Puedes eliminar un usuario abriendo la opción de **edición de usuario**y luego hacer clic **Eliminar usuario.** Para eliminar varios usuarios a la vez, seleccione los usuarios que desea eliminar de la tabla Usuarios y luego haga clic en la esquina superior derecha. **Eliminar icono**.
- Cuando se elimina un usuario, todas sus conversaciones y mensajes se eliminan automáticamente de forma permanente.
- Los archivos adjuntos de la conversación se eliminarán permanentemente. Si [AWS S3](https://zampibotpage.zampisoft.com/docs/#aws) está habilitado, también se eliminarán los archivos de AWS S3.
- Si un usuario de un usuario eliminado regresa al sitio web, se crea automáticamente un nuevo usuario.
- Los visitantes se eliminan automáticamente cada 24 horas.
#### Fusionar usuarios
Puede fusionar dos usuarios en una misma tabla de usuarios. Seleccione dos usuarios y haga clic en el botón **Fusionar usuarios** botón en la parte superior.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/f2fGHAcv9WzhYTIr-image.png)
- Cuando se fusionan dos usuarios, todas sus conversaciones se combinan en la nueva cuenta de usuario.
- El sistema identifica y fusiona automáticamente la información relevante de ambos usuarios en la nueva cuenta.
\#user-table-extra-columns#### Columnas adicionales de la tabla de usuarios
Para mostrar columnas adicionales en la tabla de usuario, vaya a **Configuración > Administración> Columnas adicionales de la tabla de Usuarios** y agregue las nuevas columnas. El valor de cada columna es el slug del detalle del usuario o del detalle adicional que desea mostrar. El slug está en minúsculas y los espacios se reemplazan por el carácter**-**Por ejemplo, el slug del detalle adicional de usuario "Fecha de nacimiento" es "fecha-de-nacimiento".
#### Tipos de usuarios
Tipo
Descripción
```
usuario
```
Un "usuario" es cualquier usuario con un correo electrónico.
```
Lead
```
Un "lead" es cualquier usuario sin detalles de usuario, que se registra automáticamente y con al menos una conversación.
```
visitante
```
Un "visitante" es cualquier usuario que no haya iniciado una conversación. Nota: Los visitantes se eliminan automáticamente cada 24 horas.
manual-de-usuario#agents### **Administrar agentes y administradores**
Administrar, crear y eliminar agentes y administradores desde **Área de usuarios**.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/eaNAKg4ojbuJduGz-image.png)
- Configurar los privilegios y permisos de los agentes desde **Configuración > Administración > Privilegios del agente**.
- Puede crear un supervisor a partir de **Configuración > Administración> Supervisor.** El supervisor es un agente especial con privilegios específicos y debe ser administrador. Puede agregar varios supervisores añadiendo ID de administrador separados por comas.
- Para crear un agente o administrador de anuncios, vaya a área de **usuarios** y haga clic en el botón **Agregar usuario e**n la parte superior derecha.
- Solo los agentes y administradores pueden iniciar sesión en el área de administración de ZampiBot.
- Cuando activa el complemento ZampiBot en WordPress, se crea automáticamente una cuenta de administrador utilizando el mismo nombre de usuario y contraseña que el usuario actualmente conectado.
---
### **Recopilar detalles del usuario**
Puede recopilar detalles del usuario, como su nombre y correo electrónico, a través de varios métodos:
- Con un formulario de pre-chat utilizando el [formulario de registro](https://zampibotpage.zampisoft.com/docs/#registration) .
- Con el mensaje [de seguimiento](https://zampibotpage.zampisoft.com/docs/#built-in-messages) .
- Con [flows](https://zampibotpage.zampisoft.com/docs/#open-ai-flows) en el chat .
---
\#registration### **Registro**
El **formulario de registro** es una herramienta previa al chat que requiere que el usuario ingrese información específica antes de iniciar la conversación. Es ideal para solicitar datos clave, como el nombre y el correo electrónico, asegurando que cada contacto esté debidamente identificado.
#### Configuración y Activación
Para gestionar las opciones de registro, diríjase a: `Configuración > Usuarios`
---
#### Funcionamiento del Formulario
- **Uso como Formulario Pre-Chat:** Puede limitar la información solicitada (por ejemplo, pedir solo el nombre de usuario o el email) configurando la opción **Requerir registro** en la modalidad **Formulario de inscripción** y habilitando los campos deseados en la lista de **Campos de registro**.
- **Visibilidad del Inicio de Sesión:** El formulario de inicio de sesión solo se mostrará si el campo de correo electrónico ha sido habilitado previamente en los ajustes.
- **Integración con WordPress:** El campo de contraseña se mostrará siempre de forma automática cuando el sistema de usuarios esté configurado para sincronizarse con **WordPress**.
- **Inicio de Sesión Automático:** El sistema permite que un usuario inicie sesión automáticamente mediante el uso de **parámetros de URL**, lo que agiliza la experiencia del cliente.
- [](https://docs.zampisoft.com/uploads/images/gallery/2026-01/5yK4idxZiwIzGydQ-image.png)
#### Gestión de Usuarios Existentes (OTP)
Si un usuario intenta registrarse utilizando un correo electrónico que ya se encuentra en su base de datos, Zampibot enviará automáticamente una **OTP** (Contraseña de un solo uso) a su email para permitirle autenticarse e iniciar sesión de forma segura.
> \[!NOTE\] En situaciones de uso real, los registros duplicados son poco frecuentes ya que los usuarios suelen permanecer conectados en el mismo dispositivo; esta función es especialmente útil para evitar conflictos durante las fases de prueba del sistema.
---
### **Información**
#### Contraseña (OTP)
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/ZVhNdVFNzmMF3Bkz-image.png)
La función OTP verifica el correo electrónico del usuario durante el registro mediante el envío de un código de un solo uso a su dirección de correo electrónico. El usuario debe introducir este código en el formulario de registro. Habilítela desde **Configuración > Usuarios > Verificación de correo electrónico**, y personaliza el correo electrónico OTP desde **Configuración > Usuarios > Correo electrónico de verificación de correo electrónico.** El correo electrónico también utiliza la plantilla definida en **Configuración > Notificaciones > Plantilla de correo electrónico.** Tenga en cuenta que la OTP siempre se envía, incluso si la función está deshabilitada, cuando un usuario intenta registrarse con un correo electrónico ya registrado.
\#login-verification-url #login-link#### URL de verificación de inicio de sesión
La función de URL de verificación de inicio de sesión se puede encontrar en **Configuración > Usuarios > URL de verificación de inicio de sesión.** En ZampiBot esta función permite autenticar un inicio de sesión externo y registrar e iniciar sesión automáticamente al usuario. ZampiBot enviará una solicitud a la URL especificada, añadiendo la dirección de correo electrónico del usuario y la contraseña ingresada en el formulario de inicio de sesión del chat como parámetros de URL. Los parámetros se denominan****email** y **password**** Ejemplo:**https://ejemplo.com/login.php?email=ejemplo@mail.com&contraseña=12345678.** La respuesta esperada de la URL debe ser un objeto JSON como el siguiente:
```c#
{ "first_name": "John", "last_name": "Doe", "email": "johon@example.com", "profile_image": "https://zampisoft.com/user.svg", "department": null, "password": "", "details": { "location": [ "Location", "New York, United States" ], "country_code": [ "Country code", "America/New_York" ] } }
```
>
El valor **first\_name** es requerido.
---
#### Enlace de inicio de sesión y contraseña olvidada
Si un usuario olvida su contraseña, puede hacer clic en **Has olvidado tu contraseña y s**e enviará un correo electrónico con un enlace de inicio de sesión a la dirección de correo electrónico registrada. Al hacer clic en el enlace, el usuario iniciará sesión automáticamente. Puede personalizar el correo electrónico que se envía a los usuarios desde **Configuración > Usuarios > Correo electrónico del enlace de inicio de sesión.** El correo electrónico utiliza la plantilla definida en **Configuración > Notificaciones > Plantilla de correo electrónico.** Esta función solo está disponible si en **Requerir registro** está configurado para **Formulario de registro e inicio de sesión** o **Formulario de inicio de sesión**.
---
##### **Misceláneas**
- Los nuevos usuarios se muestran automáticamente en la tabla de usuarios en tiempo real.
- Para ver usuarios en línea, habilite **Configuración > Usuarios > Registrar a todos los visitantes**. [](https://docs.zampisoft.com/uploads/images/gallery/2026-01/unSEBICb8zvczprb-image.png)
- Si está utilizando la [versión en la nube](https://zampibotpage.zampisoft.com/docs/#cloud-version) , esta configuración se activa automáticamente) en **Configuración > Usuarios > Registrar a todos los visitantes**(activada por defecto). Esta función cubre todos los tipos de usuarios, incluyendo visitantes y clientes potenciales. Las notificaciones solo se envían una vez por usuario en un periodo de 24 horas.
- Los agentes y administradores pueden configurar su estado como en línea o fuera de línea desde el panel de perfil inferior izquierdo. Si la opción...**Configuración > Notificaciones > Modo Ausente.** Si está activo, el estado desconectado se activa automáticamente cuando el agente o administrador ha estado inactivo en el área de administración durante al menos 10 minutos. La inactividad se define como no realizar clics, movimientos ni pulsaciones de teclas. La función de desconexión automática no está habilitada en dispositivos móviles.
- La tabla de usuarios utiliza paginación automática, que está limitada a 100 resultados por desplazamiento.
---
\#office-hours## **AJUSTES**
### **Horario de oficina**
Puede configurar el horario de oficina desde**Configuración > Varios > Horario de oficina** El horario de oficina se utiliza para:
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/Cadd9OT2TM5wrp3Q-image.png)
- Enviando el [mensaje fuera de línea](https://zampibotpage.zampisoft.com/docs/#offline-message) .
- Deshabilitar y ocultar el chat fuera del horario de oficina.
- Deshabilitar el chatbot durante el horario habitual de oficina y habilitarlo fuera del horario de oficina.
#### Más información
- Si un día solo tiene una hora de inicio y una hora de fin, introdúzcalas en los dos primeros campos. Por ejemplo, utilice **De 10:00 a 17:00 horas y de (vacío) a (vacío)**, no **10:00 AM a (vacío) y (vacío) a 5:00 PM**.
- No deje valores vacíos. Establézcalos en **cerrado** en cambio.
- Tienes que establecer valores para **cerrado.** Si desea establecer un día entero como no horario de oficina.
- El horario de oficina está en formato UTC. Establezca su UTC desde **Configuración > Varios > Zona horaria**.
- El formato de fecha y hora del horario coincide automáticamente con el utilizado en el país del idioma del navegador del usuario.
---
### **Artículos**
Los artículos de la base de conocimientos ofrecen respuestas instantáneas a los clientes para ayudar a reducir el volumen de atención al cliente. Puede acceder a los artículos desde el menú izquierdo de ZampiBot.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/kRDYKqeuuCmq3Lui-image.png)
#### Cómo visualizar el área de artículos
- Los artículos se pueden mostrar en el panel de chat habilitándolos desde **Configuración > Artículos > Mostrar en el panel**.
- Alternativamente, los artículos se pueden compartir en cualquier conversación de chat a través del código corto de mensaje enriquecido. **\[articles\]**.
Sigue estos pasos para mostrar los artículos en una página de tu dominio y sitio web. Puedes mostrarlos de tres maneras:
#### Método API REST
Inserta el código a continuación en tu página. Reemplazar **\[URL DE ZAMPIBOT\]** con la URL de la instalación de su ZampiBot y**\[TU-TOKEN\]** con cualquier token de administrador. Si usa la [versión en la nube](https://board.support/docs/#cloud-version) , la URL es **[https://chatbot.zampisoft.com/script/include/api.php](https://chatbot.zampisoft.com/script/include/api.php).** Para obtener el token, haga clic [aquí](https://board.support/docs/#cloud-info) . Además, elimine los dos primeros scripts. Incluya la etiqueta **nojquery => true.** Si ya tienes jQuery incluido en tu página, incluye el atributo****nojs => true.**** Si ya tienes el código de inserción de chat incluido en tu página.
```c#
```
#### Método JAVA SCRIPT
Inserta el código a continuación en tu página. Este método no se recomienda para SEO, ya que los artículos se cargan de forma asincrónica y es posible que los motores de búsqueda no indexen la página. Si está utilizando la [versión en la nube](https://board.support/docs/#cloud-version) , la URL [https://chatbot.zampisoft.com/script](https://chatbot.zampisoft.com/script)
```c#
```
#### Navegación de una página
La navegación de una página del artículo aparece automáticamente en todos los artículos. Se genera a partir de la página del artículo. **h2** y **h3** bloques de encabezado.
\#articles-url-rewrite#### Reescritura de URL
Puede habilitar la reescritura de URL desde **Configuración Artículos > Reescritura de URL.** Las URL predeterminadas de ZampiBot no son intuitivas e incluyen parámetros. Puedes reescribirlas mediante un archivo de **.htaccess**. El código a continuación reescribe las URL de las categorías y las páginas de artículos. La URL de las categorías cambia de **articles.php?categories=ID** a **articles/category/ID.** La URL del artículo cambia de**articles.php?article\_id=ID** a ****articles/ID****.
```html
RewriteEngine On RewriteRule ^articles?$ articles.php [L] RewriteRule ^articles/category/(.*)$/?$ articles.php?category=$1 [L,QSA] RewriteRule ^articles/(.*)$/?$ articles.php?article_id=$1 [L,QSA]
```
Cambiar **articles** con el nombre de su página de artículos y configure la URL de la página de artículos en: **Configuración > Artículos > URL de la página de artículos**.
---
\#article-language#### Idioma
- Puedes agregar nuevas traducciones de artículos abriendo un artículo. Haz clic en el **+** en la esquina superior derecha y seleccione el idioma al que desea traducir el artículo. Para eliminar una traducción, pase el cursor sobre el icono de la bandera del idioma y haga clic en el icono de basura.
- Puede habilitar la traducción automática de artículos y categorías activando tanto la función [multilingüe mediante traducción como](https://zampibotpage.zampisoft.com/docs/#multilingual-via-translation) **Configuración > Artículos > Idioma > Traducción automática.** También debes configurar el idioma predeterminado de tus artículos desde **Configuración > Artículos > Idioma > Idioma predeterminado.** El idioma utilizado para la traducción automática es el idioma del usuario detectado por ZampiBot. También puedes forzar un idioma específico añadiendo el parámetro URL **lang=LANGUAGE-CODE**
- El menú de idiomas se muestra al final del artículo. Muestra todas las traducciones disponibles.
- Si hay al menos un artículo traducido al idioma del usuario, solo se mostrarán los artículos traducidos en la página de categorías o la página principal. De lo contrario, todos los artículos se mostrarán en el idioma original.
- Fuerza que la página de artículos se muestre en un idioma específico agregando el parámetro URL **lang=LANGUAGE-CODE.** Reemplazar****LANGUAGE-CODE**** con el código de idioma de dos letras.
##### More information
- Si utiliza categorías, todos los artículos deben asignarse a una categoría.
- Puedes crear un enlace de chat interno a un artículo con el [botón de mensaje enriquecido](https://zampibotpage.zampisoft.com/docs/#rich-messages) .
- Puede crear un enlace a un artículo específico con el atributo URL****article=ID****, reemplazar **ID** con el ID del artículo. Ejemplo: [https://zampibotpage.zampisoft.com/articles-demo?article=Ucsx6](https://zampibotpage.zampisoft.com/articles-demo?article=Ucsx6) .
- Puede crear un enlace a una categoría de artículo con el atributo URL****category=ID****, reemplazar **ID** con el ID de la categoría. Ejemplo: [https://zampibotpage.zampisoft.com/articles-demo?category=LnNaZ](https://zampibotpage.zampisoft.com/articles-demo?category=LnNaZ) .
- Los artículos siempre se incluyen en el entrenamiento de tu chatbot [de OpenAI](https://zampibotpage.zampisoft.com/docs/#open-ai) . Si actualizas un artículo, tendrás que volver a entrenar el chatbot; el proceso no es automático.
- Si algún bloque no se guarda, por ejemplo un bloque de texto, desactive todas las extensiones del navegador y vuelva a intentarlo.
- Para ocultar el widget de chat, inserte el siguiente código en la página de artículos: **<script>var SB\_DISABLED = true;</script>**.
---
### **Idioma y traducciones**
ZampiBot es totalmente multilingüe y ofrece potentes funciones para detectar el idioma del usuario sobre la marcha.
#### Idioma del chat
ZampiBot ya está traducido a más de 45 idiomas. Hay muchas opciones disponibles para configurar el idioma:
- **OPCIÓN 1:** Ir a **Configuración > Chat** y verificar el **Idioma**. Configúrelo en **plurilingüe** para utilizar automáticamente el idioma de chat del navegador del usuario o el idioma guardado en el perfil del usuario.[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/lg7GiyW6RiDIiINb-image.png)
- **OPCIÓN 2:** Agregar el parámetro URL **lang=LANGUAGE-CODE** Al script que carga el chat, reemplaza "CÓDIGO DE IDIOMA" con el código de idioma de dos letras que deseas mostrar.
Por ejemplo: **https://chatbot.zampisoft.com/account/js/init.js?id=123456&lang=es**.
Esta función obligará al chat a usar siempre el mismo idioma y **Configuración > Chat > Idioma** ignorará esta opción. Visite [wikipedia.org/wiki/List\_of\_ISO\_639-1\_codes](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) para ver la lista completa de códigos de idiomas (véase la columna 639-1). Para chino tradicional **zt**, para uso en chino simplificado **zh**, para uso en portugués brasileño **pt.**
- **OPCIÓN 3 - SOLO WORDPRESS:** La versión de ZampiBot para WordPress usa el idioma predeterminado de la instalación de WordPress; o el idioma de la página o entrada actual si el sitio web es multilingüe. Esta función es compatible con WPML, Polylang y otros plugins multilingües. Esta función se desactiva automáticamente si en **Configuración > Chat > Idioma** está activa.
\#multilingual-admin#### Idioma de administración
Para traducir el área de administración siga los pasos a continuación:
- Traduce los textos en tu idioma desde el **Configuración > Traducciones**.
Para configurar el idioma del área de administración siga los pasos a continuación:
- Activar la opción **Configuración > Administración > Traducir automáticamente el área de administración.** Esta función traduce automáticamente el área de administración para que coincida con el idioma del perfil del agente o el idioma del navegador del agente. [](https://docs.zampisoft.com/uploads/images/gallery/2026-01/wU7hn8D9TE79jJCT-image.png)
#### Chatbot y traducciones de mensajes
Para traducir automáticamente los mensajes del chatbot y otros textos, utilice la aplicación de Inteligencia Artificial y siga los pasos que se describen [aquí](https://zampibotpage.zampisoft.com/docs/#google-multilingual) .
#### Editar y agregar nuevas traducciones
Puedes traducir prácticamente cualquier contenido personalizado, como [mensajes enriquecidos](https://zampibotpage.zampisoft.com/docs/#rich-messages) , [mensajes integrados](https://zampibotpage.zampisoft.com/docs/#built-in-messages) , [departamentos](https://zampibotpage.zampisoft.com/docs/#departments) , encabezados de chat y más. Para añadir una nueva traducción o editar una existente, sigue estos pasos:
- Ir a **Configuración > Traducciones**, si desea agregar una nueva traducción, haga clic en **Nueva traducción**. [](https://docs.zampisoft.com/uploads/images/gallery/2026-01/BvOgoXWGDD4Kw6VX-image.png)
- Ingrese el contenido en inglés que desea traducir en el primer campo. El texto original debe estar en inglés. Si el texto original tiene saltos de línea, reemplácelos con el codigo .**\\no**.
- Introduzca la traducción correspondiente en el segundo campo. Para añadir saltos de línea, utilice el código **\\n**.
- Si tienes la aplicación de inteligencia artificial también puedes traducir todos los contenidos a cualquier idioma automáticamente a través de la función [de traducción multilingüe](https://zampibotpage.zampisoft.com/docs/#multilingual-via-translation) .
#### Información
- Si falta una cadena de traducción, agréguela haciendo clic en el botón **Añadir nueva traducción**.
- Si una cadena de traducción no funciona, asegúrese de eliminar todos los espacios en blanco y los saltos de línea al principio y al final de la cadena.
- Las ediciones de las traducciones no se guardan en la base de datos, sino directamente en los archivos de traducción. Cuando se edita y se guarda una traducción, se crea una copia de seguridad. La copia de seguridad se restaura automáticamente al actualizar y activar el complemento.
- Algunos personajes especiales como **&** se reemplazan por el código HTML equivalente (ver [https://www.w3schools.com/html/html\_entities.asp](https://www.w3schools.com/html/html_entities.asp) ). Ej.**&** se reemplaza por **&**.
- También puedes agregar las cadenas de traducción faltantes mediante código. Edita los archivos de idioma ubicados en **tablero de soporte\\recursos\\idiomas.** Después de editar un archivo, las nuevas cadenas serán visibles en **Configuración > Traducciones.** Recuerda hacer clic **Guardar cambios** para preservar sus traducciones y evitar perderlas cuando se actualice ZampiBot.
---
\#departments### **Departamentos**
Los departamentos le permiten distribuir conversaciones y asignar agentes a departamentos específicos. Por ejemplo, puede crear un departamento llamado "Ventas" y asignarle conversaciones específicas. Para empezar a usar los departamentos, siga estos pasos:
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/w0WO6OPt6dywXvvm-image.png)
- Ir a **Configuración > Misceláneas** y añadir, eliminar y gestionar los departamentos. Después de guardar, recarga la página.
- Ir a **Usuarios > Agentes** y editar un agente, verás un nuevo campo donde podrás configurar el departamento del agente.
- ¡Recarga la página y listo! En el **Área de conversaciones** verá una opción para configurar el departamento.
#### Ajustes
- **El tablero** muestra la lista de departamentos en el panel de chat y obliga a los usuarios a elegir un departamento antes de iniciar una conversación.
- **En la opción mostrar imágenes** muestra la imagen del departamento en lugar del color del departamento.
- **Mostrar en la lista de conversaciones** muestra el color del departamento en la lista de conversaciones del área de administración.
- **La opción conversación por departamento** restringe que los usuarios abran múltiples conversaciones dentro del mismo departamento, permitiendo que solo una conversación esté activa por departamento.
- **La opción Etiqueta** reemplazar la etiqueta **Departamentos**(plural) con otro texto. El nombre se muestra en el área de administración y tickets.
- **Etiqueta única** reemplazar la etiqueta **Departamento**(singular)con otro texto. El nombre se muestra en el área de administración y tickets.
- **Título del tablero** establezca el título de la lista del panel de chat. Predeterminado: Departamentos.
#### Cómo funciona
- Los agentes y administradores sin un departamento asignado siempre ven las conversaciones de todos los departamentos.
- Los agentes y administradores con un departamento asignado solo pueden acceder a las conversaciones, usuarios y agentes dentro de ese departamento.
- Cuando una conversación se asigna a un nuevo departamento, se envía una notificación por correo electrónico a todos los agentes asignados al nuevo departamento.
- El chatbot puede asignar un departamento a la conversación activa a través de la función [de conjunto de datos de preguntas y respuestas](https://board.support/docs/#open-ai-qea) , la función [de acciones de flujos](https://board.support/docs/#open-ai-flows) o [las acciones de Dialogflow](https://board.support/docs/#dialogflow-actions) .
#### Cómo asignar un departamento a una conversación
Puedes asignar un departamento a una conversación de varias maneras:
- A través de la función [de configuración de datos de preguntas y respuestas](https://board.support/docs/#open-ai-qea) .
- A través de la función [de acciones de flujos](https://board.support/docs/#open-ai-flows) .
- A través de **Configuración > Misceláneas > Configuración de departamentos > Mostrar en el panel.** En este caso, el usuario deberá seleccionar un departamento antes de iniciar una nueva conversación.
- A través de **Configuración > Automatizaciones > Agregar nueva automatización.**
- A través de JavaScript, con la variable **var SB\_DEFAULT\_DEPARTMENT = ID;** Introduce el código en las páginas donde se muestra el chat y reemplaza el ID por el ID del departamento. Para más detalles, consulta la API [aquí](https://board.support/docs/api/use-cases#auto-departments) .
- Vía [API](https://board.support/docs/api/js) .
---
queue-routing
### **Cola y Enrutamiento**
El sistema de **Cola y Enrutamiento** de Zampibot permite que el tablero de soporte asigne automáticamente las conversaciones a los agentes disponibles de forma proporcional y equitativa.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/ItUjQ7SBFBowL3UZ-image.png)
#### Configuración y Activación
Para habilitar estas funciones, acceda a:
- **Cola:**`Configuración > Misceláneas > Cola`.
- **Enrutamiento:**`Configuración > Misceláneas > Enrutamiento`.
Una vez activo, el sistema distribuirá las conversaciones de los usuarios entre todos los agentes disponibles de manera automática.
---
#### Reglas de Asignación Automática
El sistema gestiona la carga de trabajo basándose en la disponibilidad real:
- **Disponibilidad:** Solo los agentes con estado **en línea** son considerados disponibles para recibir nuevas conversaciones.
- **Reparto Proporcional:** Las charlas se asignan equitativamente entre los agentes conectados.
- **Sin Agentes Online:** Si no hay agentes en línea, la conversación permanecerá como "sin asignar" y se entregará automáticamente al **primer agente que se conecte**.
- **Administradores:** Los administradores están excluidos del ciclo de asignación automática; ellos siempre mantienen visibilidad sobre todas las conversaciones.
---
\#manual-routing#### Guía para el Agente
**Gestión de Estado:** Los agentes pueden alternar entre **en línea** y **fuera de línea** pasando el cursor sobre su imagen de perfil y haciendo clic en la etiqueta de la ventana emergente (esquina inferior izquierda del área de administración).
**Flujo de Trabajo:**
- **Completar Tareas:** El agente debe **archivar** una conversación para marcarla como completada. Esto le dará acceso automático a la siguiente conversación en espera.
- **Privacidad:** Los agentes solo pueden buscar, filtrar y ver sus propias conversaciones. Sin embargo, pueden ver el historial completo de un usuario si están atendiendo una de sus charlas.
**Configuraciones de Visibilidad:** Para permitir que los agentes vean conversaciones no asignadas, active: `Configuración > Misceláneas > Ocultar conversaciones de otros agentes` y `Ver conversaciones no asignadas`.
---
#### Información Detallada: Solo Cola
Cuando la cola está activa, los usuarios entran en ella automáticamente al alcanzarse el límite de chats de un agente.
- **Mensaje de Espera:** El usuario verá su posición y el tiempo estimado. Puede usar las variables `{position}` y `{minutes}` en el mensaje de configuración.
- **Cálculo de Tiempo:** Se calcula como: `Posición X Tiempo de respuesta` (configurado en `Configuración > Misceláneas > Cola`).
- **Abandono:** Si un usuario cierra el navegador por más de 1 minuto, perderá su posición. La conversación quedará como "sin asignar" (visible solo para administradores).
- **Apps de Mensajería (WhatsApp):** No respetan el límite por agente; las conversaciones se asignan inmediatamente de forma proporcional a los agentes en línea.
---
#### Información Detallada: Solo Enrutamiento
- **Desactivar Verificación de Estado:** Si activa `Enrutamiento > Desactivar verificación de estado en línea`, las conversaciones se distribuirán incluso entre agentes desconectados.
- **Reasignación:** Si un usuario reabre un chat archivado y el agente asignado está offline, el sistema lo reasignará a un agente que esté en línea.
- **Enrutamiento Manual:** Los agentes pueden mover conversaciones a otros compañeros desde el panel derecho si la opción `Ver conversaciones no asignadas` está activa.
---
#### Menú de Agentes
El **Menú de Agentes** permite asignar conversaciones manualmente a personas específicas. Aparece en el lado derecho del área de conversaciones y se habilita automáticamente con la cola o el enrutamiento.
**Formas de asignar un agente:**
1. Mediante la función **Q&A set data**.
2. A través de acciones en los **Flows** (flujos).
3. Mediante las funciones de **Cola o Enrutamiento**.
4. Activando `Configuración > Chat > Menú de Agentes` (el usuario elige al agente antes de empezar).
5. A través de `Configuración > Automatizaciones > Más`.
6. Vía JavaScript usando la variable `var SB_DEFAULT_AGENT = ID;`.
7. A través de la **API**.
---
#### Cómo probar la cola
1. Abra el chat en diferentes navegadores (Chrome, Firefox, etc.) o en modo incógnito para simular múltiples usuarios.
2. Para resetear una sesión y empezar como usuario nuevo, abra la consola del navegador (F12), escriba `SBF.reset()` y presione Enter.
---
\#email-piping### **Email Piping (Sincronización de Correo)**
El **Email piping** le permite sincronizar múltiples direcciones de correo electrónico para recibir mensajes directamente en Zampibot. También permite que usted, sus agentes y los usuarios respondan a los mensajes del chat a través del correo electrónico.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/mnDkbGIJsNB5fBMc-image.png)
#### Activación
Para poner en marcha esta función, siga estos pasos:
1. Vaya a `Configuración > Notificaciones > Email piping` e ingrese la información de su servidor de correo **POP3/IMAP**.
2. Vaya a `Configuración > Notificaciones > SMTP` e ingrese la información de su servidor de correo **SMTP**.
3. *Importante:* La dirección de correo debe coincidir con la que se conecta el servidor de email piping. Zampibot enviará todos los correos desde esta dirección.
---
#### Información y Reglas de Funcionamiento
- **Coincidencia de Emisor:** El correo en `Configuración > Notificaciones > SMTP > Sender email` debe ser el mismo que el del servidor de piping. Si usa varias direcciones, Zampibot incluirá un campo **reply-to** para asegurar que las respuestas se vinculen correctamente a la conversación original.
- **Notificaciones:** Las opciones de `User email notifications` y `Agent email notifications` se activan automáticamente al habilitar el piping.
- **Inteligencia Artificial:** Si usa la App de IA y el **human takeover** está activo, no se enviarán correos si el chatbot puede responder por sí solo.
- **Conversión Global:** Si activa **Convert all emails**, todos los correos recibidos (incluido el spam) se convertirán en chats. Úselo con precaución.
---
#### Guía para Agentes y Administradores
- **Cuentas Diferentes:** No puede usar la misma dirección de email piping para responder manualmente desde fuera del sistema. Todos los agentes deben tener registrado un correo distinto al del piping.
- **Remitente Autorizado:** Los agentes deben responder desde el mismo email con el que están registrados en el panel de Zampibot.
- **Estado del Agente:** El sistema solo envía notificaciones por correo a los agentes si estos están **fuera de línea**.
---
#### Detalles Técnicos
- **Google / Gmail:** Es obligatorio usar una **Contraseña de aplicación** de Google. Use el host `imap.gmail.com` y el puerto `993`.
- **Módulo PHP:** Requiere que el servidor tenga instalado el módulo `php5-imap`.
- **Delimitador:** La opción **Delimitador** añade el texto: `### Please type your reply above this line ###`. Esto evita mensajes duplicados al recortar el historial previo. Si está activo, nadie debe usar la cadena `###` en sus correos.
- **Filtros:** Puede añadir palabras clave separadas por comas en la opción **Filtros** para evitar que ciertos correos se conviertan en chats.
---
\#email-cron#### Cron Job (Tareas Programadas)
El sistema procesa los correos cada 60 segundos mediante un cron job.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/VfKP3umoRpLwxPsU-image.png)
- **Versión Cloud:** Ya viene configurado por defecto.
---
### **Mensajes Directos**
Los **mensajes directos** le permiten enviar un único mensaje de chat, correo electrónico o mensaje de texto a un usuario individual o a varios usuarios a la vez. A continuación, se detalla cómo funciona esta característica:
#### Cómo enviar un mensaje
- **Desde el área de Usuarios:** Diríjase a `Usuarios` y haga clic en el icono de mensaje directo.
- **Desde el perfil:** Los botones de mensaje directo también están disponibles dentro del cuadro de perfil de cada usuario.
- **Enviar a todos:** Para enviar un mensaje a toda su base de usuarios, escriba `All` en el campo `IDs de usuario`.
- **Enviar a un grupo:** Ingrese los IDs específicos en el campo `IDs de usuario`. Puede seleccionar a los usuarios en la tabla y luego hacer clic en el icono de mensaje directo para que los IDs se completen automáticamente.
#### Características Generales
- **Campos de combinación:** Todos los tipos de mensajes admiten el uso de campos de combinación (`merge fields`).
- **Traducción automática:** Todos los tipos de mensajes son compatibles con la **traducción automática**.
---
#### Tipos de Mensajes
**1. Mensaje Directo de Chat**
El mensaje se envía a la conversación activa del usuario. Si no existe una, se iniciará una nueva automáticamente.
- **Notificaciones por Correo:** Si la opción `Configuración > Notificaciones > Notificaciones por correo electrónico del usuario` está activa, los usuarios con email recibirán un aviso por esa vía.
- **Notificaciones por SMS:** Si la opción `Configuración > Notificaciones > Notificaciones de mensajes de texto > Activo para usuarios` está activa, los usuarios con número de teléfono recibirán un mensaje de texto.
- **Notificaciones Push:** Si la opción `Configuración > Notificaciones > Notificaciones push` está activa, se enviará una notificación push a todos los usuarios.
- **Apps de Mensajería:** El mensaje también se enviará a aplicaciones como **WhatsApp** y **Messenger** si el usuario está vinculado a ellas.
- **Filtrar por App:** Para enviar un mensaje solo a los usuarios de una plataforma específica, ingrese una de estas cadenas en el campo de IDs: `whatsapp`, `messenger`, `instagram`, `telegram`, `twitter`, `zalo`, `wechat`, `viber`, `line`.
- **Tickets:** Ingrese `tickets` para contactar únicamente a los usuarios que hayan creado un ticket a través de la aplicación de `Tickets`.
**2. Correo Electrónico Directo**
- Puede configurar la apariencia desde `Configuración > Notificaciones > Plantilla de correo electrónico`.
- El sistema admite lenguaje **HTML** para el diseño del mensaje.
- El asunto del correo también es compatible con **campos de combinación** (`merge fields`).
**3. Mensajes de Texto Directos (SMS)**
- Para habilitar esta función, debe activar los SMS en `Configuración > Notificaciones > Notificaciones de mensajes de texto`.
**4. Mensajes de Plantilla de WhatsApp Directos**
- Esta función permite enviar plantillas oficiales de WhatsApp a los usuarios. Para más detalles técnicos, consulte la sección de `WhatsApp` de esta documentación.
---
### **Automatizaciones**
Las **automatizaciones** permiten ejecutar tareas automáticas multilingües cuando se cumplen las condiciones específicas que usted configure.
#### Configuración y Control
- **Gestión de condiciones:** Para eliminar una condición, simplemente déjela vacía. Para desactivar una automatización por completo, elimine todas sus condiciones.
- **Frecuencia de envío:** Las automatizaciones se envían **solo una vez** a cada usuario. Si desea que los usuarios que ya recibieron una automatización la vuelvan a ver, deberá eliminarla y crear una nueva.
---
#### Reglas de Fecha y Tiempo
- **Repetir:** La función de repetición solo es operativa cuando se utiliza en conjunto con el criterio `date time` (fecha y hora).
- **Criterio exacto:** Cuando utilice `date time` con el criterio **"es exactamente"**, el valor no debe incluir horas ni minutos (hh:mm). Por ejemplo: `25/10/2021` funcionará, pero `25/10/2021 10:30` no.
---
#### Requisitos de Ubicación e Idioma
Para que las automatizaciones basadas en geolocalización o idioma funcionen correctamente, deben cumplirse ciertos requisitos en la configuración:
- **Dependencia general:** La opción `Configuración > Usuarios > Registrar a todos los visitantes` debe estar activa para ejecutar automatizaciones al cargar la página.
- **Detalles avanzados:** Las condiciones de ciudad, país e idioma requieren que también esté habilitada la ruta: `Configuración > Usuarios > Detalles completos del visitante`.
- **Ciudad:** Solo funciona si el detalle de usuario `location` está configurado como "ciudad, país" o si el detalle `city` está definido.
- **País:** Requiere que `country_code`, `country` o `location` estén configurados. **Nota:** El nombre del país debe estar escrito en inglés.
- **Idioma:** Requiere los detalles de usuario `browser_language` o `language`.
---
#### Comportamiento del Visitante
- **Visitante recurrente:** Se considera un "visitante recurrente" únicamente si vuelve a visitar el sitio web después de un periodo de **24 horas o más**.
- **Ventanas emergentes (Pop-ups):** Aparecen solo si el chat está cerrado y sobrescriben la ventana emergente predeterminada. Puede activar la opción de **mensaje de respaldo** (*message fallback*) para enviar un mensaje en lugar de mostrar el pop-up si el chat ya está abierto.
---
#### Condiciones Técnicas Especiales
- **Control de conversación:** Para evitar interrupciones durante una charla activa, los mensajes automáticos y los respaldos de pop-up se envían solo si el último mensaje del usuario o agente tiene más de **10 minutos** de antigüedad.
- **Variables personalizadas:** Esta condición verifica variables de JavaScript en su página web. Por ejemplo, la condición `example=ABC` se cumple si en el código de su página existe: `var example = "ABC";`. Puede añadir múltiples variables separadas por comas.
---
#### Restricciones de Compatibilidad
Las automatizaciones **no son compatibles** con aplicaciones de mensajería externas, tales como:
- WhatsApp, Messenger, Instagram, Telegram, Twitter, Zalo, WeChat, Viber y Line.
---
\#newsletter### **Newsletter**
Siga las instrucciones a continuación para completar la sincronización con su servicio de boletines (newsletter). Los usuarios se suscriben automáticamente en los siguientes casos: a través del **formulario de registro**, mediante el **mensaje de seguimiento**, con el **mensaje de suscripción** o al utilizar el **código corto de correo electrónico**.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/3y5c9Rse6Sn8qN5q-image.png)
**Mailchimp**
- - Para obtener la **Clave (Key)**, siga las instrucciones en: `https://mailchimp.com/help/about-api-keys/`.
- Para obtener el **ID de la lista**, siga las instrucciones en: `https://mailchimp.com/help/find-audience-id/`.
**Brevo**
- - Obtenga la **Clave** en: `https://account.brevo.com/advanced/api`.
- Obtenga el **ID de la lista** en: `https://my.brevo.com/lists`.
**SendGrid**
- - Obtenga la **Clave** en: `https://app.sendgrid.com/settings/api_keys`.
- Para el **ID de la lista**, ingrese a SendGrid y haga clic en `Marketing > Contacts`. Seleccione una lista o cree una nueva; el ID es la última parte de la URL (ejemplo: `8558c1e7-3c99-4428-a68f-78df2e437f8e`).
**Elastic Email**
- - Para la **Clave**, vaya al menú de perfil superior derecho en `Settings > Create Additional API key`. Elija **Plugin** o **Full access** y asegúrese de que el permiso de **Contacts** esté configurado como **View & Modify**.
- El **ID de la lista** es el nombre de la lista. **Importante:** Los nombres de listas o segmentos no deben contener espacios.
**Campaign Monitor**
- - Obtenga la **Clave** en el menú de perfil superior derecho bajo `Account settings > API keys > Generate API key`.
- Para el **ID de la lista**, vaya al menú superior en `List and subscribers`, seleccione una lista, haga clic en `Settings` en el menú izquierdo y copie el **List API ID**.
**HubSpot**
- - Para la **Clave**, vaya a `Settings > Integrations > Private apps` y cree una nueva aplicación. En la pestaña **Scope**, añada los permisos: `crm.lists.write`, `crm.lists.read`, `crm.objects.contacts.read` y `crm.objects.contacts.write`. Copie el token generado y péguelo en el campo **Key** de ZampiBot.
- Obtenga el **ID de la lista** en `Contacts > List > List details`.
**Moosend**
- - Obtenga la **Clave** en `Settings > API key`.
- Obtenga el **ID de la lista** en `Audience > Email lists`.
**GetResponse**
- - Para el **ID de la lista**, vaya a `Lists > Your list > Settings` y copie el valor de **List token**.
- Obtenga la **Clave** en `https://app.getresponse.com/api`.
**ConvertKit**
- - Obtenga la **Clave** en `Settings > Advanced > API secret`.
- Para el **ID de la lista**, vaya a `Grow > Landing Pages & Forms`. Abra su formulario y copie la parte numérica de la URL (ejemplo: si la URL es `.../designers/3003412/edit`, el ID es `3003412`).
**ActiveCampaign**
- - Obtenga la **Clave** en `Account settings > Developer`.
- Para el **ID de la lista**, vaya a `Left menu > Lists`. Copie el ID numérico de la URL. El valor final debe tener el formato `dominio:ID-lista`. El dominio es la primera parte de la URL de su tablero (ejemplo: `schiocco:1`).
**MailerLite**
- - Obtenga la **Clave** en `Left menu > Integrations > MailerLite API`.
- Para el **ID de la lista**, vaya a `Left menu > Subscribers > Groups`. Abra un grupo y copie el ID de la URL.
**Mailjet**
- - Obtenga la **Clave** en `https://app.mailjet.com/account/apikeys` o en `Account settings > Account settings`.
- Para el **ID de la lista**, vaya a `Contacts > Contacts lists > Your list`. Obtenga el ID haciendo clic en el icono `?` junto al correo de la lista.
**Sendy**
- - Obtenga la **Clave** en el área de configuración de Sendy.
- Para el **ID de la lista**, seleccione su marca, haga clic en `View all lists` y copie el ID. El ajuste debe incluir su URL completa de Sendy y el ID separados por una barra vertical (ejemplo: `https://ejemplo.com|TDf6o892Mx11VXGC51ui567u`).
**SendFox**
- - Obtenga la **Clave** en `Settings > API > Personal Access Tokens`.
- Para el **ID de la lista**, vaya a `Audience > Lists`. Abra una lista y copie el ID de la URL.
---
### **Mas ajustes**
\#saved-replies#### Respuestas guardadas
Las **respuestas guardadas**, también conocidas como mensajes predefinidos, son una colección de mensajes escritos previamente que los agentes pueden utilizar de forma rápida en el editor del chat. Puede gestionarlas desde la siguiente ruta: `Configuración > Administración > Respuestas guardadas`.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/uOVdKwYpF4govqzC-image.png)
- **Uso rápido:** Las respuestas se pueden insertar escribiendo `#` seguido del nombre de la respuesta guardada y un espacio.
- **Ventana emergente:** Para abrir el panel emergente con todas las respuestas disponibles, escriba `##`.
- **Formato:** Utilice el código `\n` para insertar un salto de línea en el mensaje.
- **Integración con Dialogflow:** Si utiliza el chatbot de Dialogflow, la búsqueda en el panel de respuestas guardadas incluirá resultados de las **Intents** de Dialogflow.
- **Importación de Intents:** Tiene la opción de añadir todas las Intents de Dialogflow a la lista de respuestas guardadas activando la opción en: `Configuración > Inteligencia Artificial > Google > Añadir Intents a respuestas guardadas`.
---
\#email
\#email
## **Notificaciones por Email**
Para comprender cómo funcionan las notificaciones y cuándo se envían, lea la siguiente información. Si cree que las notificaciones no funcionan, probablemente las esté probando incorrectamente. Lea la siguiente información antes de solicitar asistencia.
### ***Notificaciones por correo electrónico***
Tanto los agentes como los usuarios pueden recibir una notificación por correo electrónico cuando se recibe un nuevo mensaje.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/pNFkouSwdi7KSYDI-image.png)
#### Notificaciones por correo electrónico para administradores y agentes
- Cuando un usuario envía su primer mensaje, si la conversación está asignada a un [departamento](https://zampibotpage.zampisoft.com/docs/#departments) , se envía un correo electrónico solo a los agentes y administradores que estén desconectados y asignados a ese departamento, o a aquellos que no tengan asignado ningún departamento. Si la conversación está asignada a un agente específico, se envía un correo electrónico solo a ese agente; de lo contrario, se envía un correo electrónico a todos los agentes que no estén conectados en ese momento. Los correos electrónicos posteriores se envían solo al último agente de la conversación.
- Las notificaciones por correo electrónico se envían solo a agentes y administradores fuera de línea.
- Si está utilizando la aplicación de Inteligencia Artificial y la función [de toma de control humano](https://zampibotpage.zampisoft.com/docs/#human-takeover) está activada, no se envían correos electrónicos si el chatbot sabe la respuesta.
- Para evitar que los administradores reciban notificaciones por correo electrónico, marque **Configuración > Notificaciones > No enviar notificaciones a los administradores**.
#### Notificaciones por correo electrónico para los usuarios
- Cuando un agente envía un mensaje a un usuario, se le envía un correo electrónico solo si el usuario está desconectado.
- Solo se envía un correo electrónico. Los mensajes posteriores no activarán una nueva alerta.
#### Crear el correo electrónico
Para administrar los correos y crear los contenidos vaya a**Configuración > Notificaciones**Puedes usar texto y HTML. Las nuevas líneas se convierten automáticamente a**<br />**Puede usar los siguientes campos de combinación en el correo electrónico. Estos campos se reemplazan automáticamente con la información actualizada.
---
Merge field
Description
```
{recipient_name}
```
El nombre del usuario o agente que recibe el correo electrónico.
```
{sender_name}
```
El nombre del usuario o agente que envió el mensaje que activó la notificación por correo electrónico.
```
{sender_profile_image}
```
The profile image of the user or agent who was sending the message that triggered the email La imagen de perfil del usuario o agente que envió el mensaje que activó la notificación por correo electrónico..
```
{message}
```
Los enlaces a cualquier archivo adjunto que formaba parte del mensaje que activó la notificación por correo electrónico.
```
{attachments}
```
Los archivos adjuntos de los correos electrónicos.
```
{conversation_link}
```
Un enlace para abrir la conversación en el área de administración. Este campo de combinación solo está disponible para los correos electrónicos de los agentes.
```
{conversation_id}
```
El ID de la conversación.
#### Plantilla de correo electrónico
Todos los correos electrónicos enviados por ZampiBot utilizan la plantilla definida en la siguiente ruta: `Configuración > Notificaciones > Plantilla de correo electrónico`.
Es obligatorio incluir el campo de combinación `{content}`, el cual será reemplazado automáticamente por el cuerpo real del mensaje de correo electrónico al momento del envío.
---
#### Cron job (Trabajos programados)
Puede ejecutar un cron job para el envío de notificaciones por correo electrónico tanto a usuarios como a agentes. Al utilizar este método, las notificaciones mejoran significativamente: incluirán la conversación completa y se enviarán una sola vez.
**Configuración requerida:** Para utilizar esta función, debe activar la opción en: `Configuración > Notificaciones > Notificaciones por correo electrónico a través del trabajo cron`.
**Ejecución del comando:** Puede crear un cron job que ejecute la siguiente URL: `[URL-DE-INSTALACION]/include/api.php?email-notifications=true`.
- **Obtención de la URL:** Puede encontrar su URL de instalación en `Configuración > Misceláneas > Installation URL`.
- **Versión Cloud:** Si utiliza la versión en la nube, emplee esta URL: `https://chatbot.zampisoft.com/script/include/api.php?email-notifications=true&cloud=API-TOKEN` (reemplace `API-TOKEN` con su token de API personal).
*Nota: Esta es una función avanzada relacionada con la configuración de su servidor. Nuestro equipo de soporte no ofrece asistencia directa para la gestión de servidores, pero puede contratarnos para ayudarle con esta implementación.*
---
#### ¿Tiene problemas?
Si las notificaciones por correo no se entregan correctamente, puede realizar una prueba de envío desde la siguiente ruta: `Configuración > Notificaciones > Send an agent email notification`.
Existen diversos motivos por los cuales los correos podrían no entregarse:
- **Problemas de Hosting:** El servidor de su proveedor de alojamiento no puede enviar correos o estos son marcados como spam. En este caso, se recomienda activar un servidor SMTP externo en `Configuración > Notificaciones > SMTP`.
- **Errores de SMTP:** Si tras activar el SMTP no recibe los correos de prueba, es probable que los datos de conexión sean incorrectos o su servidor SMTP no esté funcionando.
- **Configuración de Gmail:** Si utiliza Gmail o Google Workspace, debe usar una "Contraseña de aplicación" y asegurarse de que el puerto sea `465` o `587`. Además, verifique que el acceso SMTP para aplicaciones de terceros no esté restringido en su consola de administración.
**Razón**
**Descripción**
**Solución**
**Problemas de alojamiento (Hosting)**
El servidor de su proveedor de hosting no puede enviar correos o estos son detectados automáticamente como spam y eliminados.
Si las opciones en `Configuración > Notificaciones > SMTP` no están configuradas, su servidor intentará enviar los correos de forma nativa. Contacte con su proveedor de hosting para obtener soporte o active un servidor SMTP externo en la ruta mencionada.
**Problemas con SMTP**
El correo electrónico no se envía a pesar de haber activado la opción SMTP en el área de notificaciones.
Asegúrese de que la conexión funcione enviando un correo de prueba desde `Configuración > Notificaciones > Enviar una notificación por correo electrónico al usuario` o `Enviar una notificación por correo electrónico al agente`. Si no recibe el mensaje, su servidor SMTP no funciona. Revise la consola del navegador para ver el error específico. Este problema es externo a ZampiBot; contacte a su proveedor de SMTP o use servicios como **SendGrid** (40,000 correos gratis el primer mes).
**Google Gmail**
El correo no se envía al intentar utilizar el servidor SMTP de Gmail, incluso con la opción activa.
Para cuentas de Gmail o Google Workspace, debe usar una **Contraseña de Aplicación** (consulte la [guía de Google](https://support.google.com/accounts/answer/185833)). Use `smtp.gmail.com` como anfitrión y el puerto `465` o `587`. En Google Workspace, verifique en `Consola de administración > Seguridad > Control de acceso y datos > Controles de API > Control de acceso a aplicaciones` que el acceso SMTP no esté restringido.
---
\#push### **Notificaciones Push**
Las **notificaciones push** se diferencian de las notificaciones de escritorio tradicionales en que son enviadas directamente desde un servidor. Esto permite que funcionen en todo momento, incluso si su dispositivo está desconectado o si ZampiBot no está abierto en el navegador. Además, son persistentes y permanecen visibles hasta que el usuario las cierra.
ZampiBot es compatible con **Pusher** y **OneSignal**, ambos servicios gratuitos para hasta 2000 usuarios o dispositivos.
> **Nota importante:** Pusher no es compatible con dispositivos iOS; si utiliza iPhone o iPad se envia por **OneSignal**.
#### Versión Cloud
La versión en la nube de ZampiBot utiliza **OneSignal** por defecto y ya se encuentra preconfigurada. Para habilitarlas en el área de administración, solo debe seguir esta ruta: `Configuración > Notificaciones > Notificaciones push > Activo para agentes`, guarde los cambios y recargue el panel.
---
#### Activación para Usuarios
Para habilitar las notificaciones push en sus clientes, siga estos pasos:
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/Gr3UQLY10LoM0Tbs-image.png)
1. Descargue el archivo del **Service Worker** desde el enlace proporcionado [here.](https://board.support/docs/files/service-worker.zip)
2. Suba dicho archivo a la raíz de su sitio web en la siguiente ubicación: `https://su-sitio.com/service-worker.js`.
3. Vaya a `Configuración > Notificaciones > Notificaciones push > URL del Service Worker` e ingrese la URL completa del archivo.
---
#### Información y Requisitos
- **Seguridad:** Las notificaciones push solo funcionan en sitios web con protocolo **HTTPS** completo (a excepción de *localhost* para pruebas de desarrollo).
- **Funcionamiento en Escritorio:** El navegador debe estar ejecutándose (aunque esté en segundo plano) para recibir los mensajes.
- **Sustitución:** Cuando las notificaciones push están activas, reemplazan automáticamente a las notificaciones de escritorio estándar.
- **Dispositivos iOS:** Disponibles a partir de **iOS 16.4**. Requiere que ZampiBot esté instalado y el uso obligatorio de **OneSignal**.
- **Interacción:** Al hacer clic en una notificación, se abrirá la última página visitada por el usuario y el chat se desplegará automáticamente.
---
#### Reglas para Administradores y Agentes
El sistema sigue una lógica inteligente para el envío de alertas:
- **Disponibilidad:** Solo se envían notificaciones a agentes y administradores que estén **fuera de línea**.
- **Segmentación por Departamentos:** Si un chat pertenece a un departamento, solo los agentes asignados a este recibirán la alerta.
- **Asignación Específica:** Si la conversación tiene un agente asignado, solo esa persona recibirá la notificación.
- **Control de IA:** Si la función de **human takeover** está activa y el chatbot conoce la respuesta, no se enviarán notificaciones al equipo humano.
- **Restricción de Administradores:** Puede evitar que los administradores reciban alertas activando: `Configuración > Notificaciones > No enviar notificaciones a los administradores`.
---
#### Solución de Problemas
Si las notificaciones no funcionan correctamente, verifique los siguientes puntos:
- - **Permisos del Navegador:** En Chrome, revise `Privacidad y seguridad > Configuración de sitios > Notificaciones` para asegurarse de que el sitio esté permitido.
- **Segundo Plano (Chrome):** Asegúrese de que la opción `Seguir ejecutando aplicaciones en segundo plano al cerrar Google Chrome` esté activa en la configuración del sistema de su navegador.
- **Configuración de Windows:** Verifique que el sistema operativo no esté bloqueando las alertas en `Inicio > Configuración > Notificaciones`.
- **Visibilidad del Panel:** Las notificaciones no se mostrarán si el área de administración de ZampiBot ya está abierta y visible; minimice la ventana o use otra pestaña para probar.
- **Reset de Suscripción:** Si el problema persiste con OneSignal, acceda a su panel de control, elimine al usuario de la sección `Audience > Users` y suscríbase nuevamente.
---
### **Notificaciones de escritorio**
Las notificaciones de escritorio (también conocidas como notificaciones web) permiten alertar a los usuarios y agentes de forma inmediata, con las siguientes condiciones:
- No se envían si el usuario está visualizando activamente una página que incluye el chat (el navegador está abierto, visible y la página activa contiene el chat).
- No son compatibles con dispositivos **iPhone o iOS**.
- Funcionan únicamente en URLs seguras que utilicen **HTTPS**. La URL de administración de ZampiBot debe usar HTTPS obligatoriamente.
- Si las **Notificaciones Push** están activas, estas reemplazarán automáticamente a las notificaciones de escritorio.
- Si experimenta problemas con estas alertas, intente aplicar las soluciones descritas en la sección de Notificaciones Push.
---
### **Notificaciones de mensajes de texto (SMS)**
Tanto los agentes como los usuarios pueden ser notificados mediante mensajes de texto cuando llega un nuevo mensaje. Este servicio es proporcionado por **Twilio**. Es un servicio de pago, pero cuenta con una versión de prueba gratuita para realizar tests. Además, los mensajes SMS enviados a su número de Twilio pueden recibirse dentro de ZampiBot, permitiendo una experiencia de mensajería bidireccional.
#### Activación
1. Regístrese en [Twilio](https://www.twilio.com) y cree una nueva cuenta.
2. Verifique su número de teléfono y elija la opción **SMS** en el formulario de configuración.
3. Desde su panel de Twilio, haga clic en `Get a Trial Number` (Obtener un número de prueba).
4. Ingrese al área de administración de ZampiBot y vaya a: `Configuración > Notificaciones > Notificaciones de mensajes de texto`. Pegue el SID de la cuenta, el token de autenticación y el número de prueba (o número comprado).
5. **Pruebas:** Si usa la versión de prueba, solo podrá enviar notificaciones a números verificados en su panel de Twilio bajo `Verified Caller IDs`.
6. **Uso en vivo:** Para recibir mensajes de texto en ZampiBot, debe comprar un número y configurar la URL en Twilio desde: `Phone numbers > Manage > Active numbers`. Obtenga el enlace necesario en ZampiBot en: `Configuración > Notificaciones > Notificaciones de mensajes de texto > URL de configuración`.
#### Información importante
- **Lógica de envío:** Cuando un usuario envía su primer mensaje, el SMS se envía únicamente a los agentes y administradores que estén **fuera de línea** y asignados al departamento correspondiente. Los mensajes subsiguientes se envían solo al último agente que participó en la conversación.
- **Restricción de administradores:** Puede evitar que los administradores reciban estos SMS activando: `Configuración > Notificaciones > No enviar notificaciones a los administradores`.
- **Números de Agentes:** Asegúrese de que sus agentes tengan un número de teléfono asignado en su perfil para recibir las alertas.
- **Formato:** Todos los números deben incluir el código de país comenzando con el símbolo **+** (ej. +15558675310).
- **Control de IA:** Si utiliza la App de Inteligencia Artificial y el relevo humano (*human takeover*) está activo, no se enviarán SMS si el chatbot conoce la respuesta.
- **Sender ID:** Puede personalizar el nombre del remitente en el campo `Sender number` si su plan de Twilio lo permite.
---
\#sound### **Notificaciones de sonido**
Al habilitar los sonidos en `Configuración > Notificaciones > Sonidos`, se reproducirá una alerta auditiva cada vez que se reciba un nuevo mensaje o conversación.
[](https://docs.zampisoft.com/uploads/images/gallery/2026-01/qNqxirf8ZvnL0xr4-image.png)
- **Interacción obligatoria:** Debido a las políticas de seguridad de los navegadores modernos, el audio solo sonará si el usuario o agente ha interactuado previamente con el documento (haciendo clic en cualquier parte del panel de administración o en la página del chat).
- **Bucle:** Si el sonido está configurado para **repetir**, se reproducirá en bucle siempre que el área de administración o la página del chat **no estén abiertas o estén minimizadas**. Si la ventana está activa y visible, el sonido no se reproducirá.
---
### **Notificaciones de Telegram**
Para conocer los detalles específicos sobre cómo vincular ZampiBot con Telegram para recibir notificaciones, consulte la sección dedicada a Telegram en esta documentación.
---
open-ai## **ARTIFICIAL INTELLIGENCE**
Esta sección detalla el funcionamiento y la configuración de la aplicación de **Inteligencia Artificial** para Zampibot, diseñada para automatizar respuestas y optimizar la atención al cliente.
---
#### Instalación
Para comenzar a utilizar las funciones de IA:
1. Diríjase a `Configuración > Apps`.
2. Simplemente haga clic en **Activo**.
---
\#human-takeover### ***Toma de control humana (Human Takeover)***
El relevo de un chatbot a un agente humano ocurre en los siguientes casos:
- Cuando un agente humano responde directamente al mensaje de un usuario.
- Cuando la opción `Configuración > Inteligencia Artificial > Adquisición humana > Activo` está marcada. Esto se dispara automáticamente si el chatbot no entiende un mensaje o si el usuario solicita explícitamente hablar con un humano.
#### Información General
- **Desactivación del Bot:** Al activarse el relevo, el chatbot se deshabilita mientras el último agente humano que respondió esté en línea. Si ningún agente ha respondido aún, el bot permanecerá activo.
- **Reactivación:** El chatbot se activa de nuevo totalmente si la conversación se archiva o se elimina.
- **Mensaje de Respaldo:** La función `Configuración > Inteligencia Artificial > Human takeover > Mensaje de reserva` envía un mensaje automático avisando que un agente responderá pronto. Este se envía como máximo una vez cada 30 minutos.
- **Compatibilidad:** Funciona en todas las apps de mensajería (WhatsApp, Messenger, Telegram, etc.) sin necesidad de que el usuario haga clic en botones de confirmación.
#### Activación Manual
- **Solo Dialogflow:** Puede forzar el relevo creando una **Intent** con la respuesta de **Custom Payload**: `{ "human-takeover": true }`.
- **Solo OpenAI:** El usuario puede solicitarlo manualmente (opción activa por defecto).
- **Vía Q&A:** Puede añadir la acción de **human takeover** a respuestas específicas en el entrenamiento.
---
\#smart-reply### **Respuesta inteligente (Smart Reply)**
Esta función sugiere respuestas rápidas en tiempo real durante una conversación activa con un agente.
- **Lógica:** El sistema busca primero sugerencias en **Dialogflow** (si está activo); si no hay resultados, devuelve sugerencias de **OpenAI**.
- **Uso:** Pase el cursor sobre una sugerencia durante 3 segundos para leer el texto completo.
- **Atajo:** Presione `CTRL + Z` para restaurar el mensaje anterior en el editor.
---
### **Configuración Óptima del Chatbot**
Para obtener los mejores resultados, recomendamos seguir estos pasos:
1. **Activar Dialogflow:** Ideal para consultas generales, respuestas definitivas o uso de **mensajes enriquecidos** (botones).
2. **Entrenamiento:** Entrene su chatbot de OpenAI con su propio contenido para respuestas personalizadas.
3. **Confianza de Detección:** Establezca el valor de `Google > Dialogflow Intent detection confidence` en **0.81**.
4. **Funciones de OpenAI:** Active las opciones de Bot conversacional, corrección ortográfica y Reescritura de mensajes.
5. **Multilingüe:** Si su sitio es internacional, active `Traducción automática` y `Detección de idioma`.
---
### **Solución de Problemas (IA)**
Si las funciones de **OpenAI** o **Google** no funcionan correctamente, las razones más frecuentes se enumeran a continuación.
> \[!TIP\] Para obtener detalles técnicos sobre un error, abra las **herramientas de desarrollador** de su navegador (F12 en Windows), diríjase a la pestaña **Consola**, envíe un mensaje a través del chat de ZampiBot y observe si aparece algún mensaje de error resaltado en rojo.
---
#### OpenAI y Google (General)
- **Toma de control humana:** Verifique si existe un `human takeover` activo en la conversación, lo cual inhabilita las respuestas automáticas del bot.
- **Servicios de integración:** Si tiene dificultades con la sincronización, puede contratarnos para que nuestro equipo realice la configuración técnica por usted desde nuestra página de soporte.
---
#### OpenAI
- **Herramienta de diagnóstico:** Utilice el botón ubicado en `Configuración > Inteligencia Artificial > OpenAI > Solucionar problemas` para verificar errores específicos relacionados con su cuenta de OpenAI.
- **Verificación de estado:** Asegúrese de que la casilla `Configuración > Inteligencia Artificial > OpenAI > Chatbot` esté marcada.
- **Límites y Facturación:** Compruebe si ha alcanzado su límite de cuota o si hay problemas con el método de pago en su [panel de uso de OpenAI](https://platform.openai.com/account/usage).
- **Conflicto con Dialogflow:** Si utiliza ambos servicios, OpenAI podría no responder si su agente de Dialogflow no tiene configurada la **Fallback Intent** (Intención de respaldo). Verifique su presencia en la página de Intents de Google.
- **Limpieza de Datos:** Si las respuestas son inconsistentes, intente eliminar todos los datos de entrenamiento en `Chatbot > Training > Information > Delete all training data` y realice el proceso de entrenamiento nuevamente.
- **Sitios Multilingües:** Para el entrenamiento mediante sitios web, asegúrese de que la etiqueta `` de su página web contenga el atributo de idioma correcto (ejemplo: ``).
- **Versión Cloud:** Si experimenta problemas persistentes, puede cambiar el modo de sincronización a **Automático** en `Configuración > Inteligencia Artificial > OpenAI > Modo de sincronización` para utilizar nuestra clave de API (requiere la compra de créditos).
---
##### **Google (Dialogflow)**
- **Diagnóstico de Google:** Haga clic en el botón `Configuración > Inteligencia Artificial > Google > Troubleshoot problems` para identificar errores de conexión con su cuenta de Google Cloud.
- **Activación del Bot:** Confirme que la opción `Configuración > Inteligencia Artificial > Google > Dialogflow chatbot` esté habilitada.
- **Ubicación del Agente:** Verifique que ha seleccionado la ubicación o región correcta donde reside su agente en la consola de Dialogflow.
- **Mega Agentes:** Asegúrese de **no** estar utilizando un "Mega Agent", ya que esta arquitectura no es compatible con el sistema.
---
## **OpenAI**
Esta sección detalla los ajustes de sincronización y configuración inicial del chatbot de **OpenAI** para **Zampibot**, permitiendo que el sistema responda preguntas generales de manera inteligente.
---
### **Sincronización**
Existen dos modalidades para vincular el servicio de Inteligencia Artificial con su cuenta:
**1. Modo de sincronización automática**
Esta característica es exclusiva de la **versión en la nube** de Zampibot.
- **Configuración:** Este modo está listo para usarse y no requiere ajustes adicionales. Puede activarlo en `Configuración > Inteligencia Artificial > OpenAI > Modo de sincronización`.
- **Activación:** Para habilitar el chatbot, marque la opción en `Configuración > Inteligencia Artificial > OpenAI > Bot conversacional`.
- **Costos:** Es necesario adquirir **créditos** para utilizar esta modalidad.
**2. Modo de sincronización manual**
La integración con OpenAI (ChatGPT) otorga al chatbot la capacidad de responder a casi cualquier consulta general. Siga estos pasos para la configuración manual:
- **Registro:** Cree una cuenta en el portal oficial: [https://platform.openai.com/](https://platform.openai.com/).
- **Clave de API:** Obtenga su clave en [https://platform.openai.com/api-keys](https://platform.openai.com/api-keys).
- **Vinculación:** Pegue la clave en la ruta `Configuración > Inteligencia Artificial > OpenAI > Clave API`.
- **Ajuste en la nube:** Si utiliza la versión en la nube, asegúrese de establecer `Configuración > Inteligencia Artificial > OpenAI > Modo de sincronización` en la opción **Manual**.
- **Activación final:** Habilite el bot en `Configuración > Inteligencia Artificial > OpenAI > Chatbot`.
---
### **Chatbot**
Para configurar su primer chatbot, siga esta secuencia de pasos:
1. Complete el **proceso de sincronización** mencionado anteriormente.
2. Habilite la opción en `Configuración > Inteligencia Artificial > OpenAI > Chatbot` y guarde los cambios.
3. **Acceso al área de pruebas:** Su chatbot estará activo de inmediato. Puede acceder al área de pruebas desde la sección **Chatbot**, identificada con el icono de la **carita sonriente**`🙂` en el menú de la izquierda.
#### Solución de problemas iniciales
Si el chatbot no responde como se espera, haga clic en el botón `Configuración > Inteligencia Artificial > OpenAI > Solucionar problemas` y siga las instrucciones en pantalla para diagnosticar el error.
Para perfeccionar el desempeño de su asistente, le recomendamos explorar las secciones de **Entrenamiento** y **Toma de control humana**.
---
### **Chatbot Integrations**
Las siguientes integraciones están disponibles para potenciar las capacidades del chatbot de OpenAI en Zampibot. Estas herramientas son conversacionales, multilingües y compatibles con cualquier aplicación de mensajería como WhatsApp, Messenger y Telegram.
---
\#google-calendar-integration
\#google-calendar-integration
#### Google Calendar
Habilite esta integración para permitir que el chatbot acceda a su Google Calendar, permitiendo que los usuarios reserven y gestionen citas directamente en su calendario.
**Tareas disponibles:**
- **Reservar una cita:** El chatbot puede agendar eventos en su calendario en nombre del usuario.
- **Actualizar una cita:** Permite modificar eventos existentes para un usuario específico.
- **Cancelar una cita:** El chatbot puede eliminar eventos programados previamente.
- **Listar eventos:** Muestra los eventos programados de un usuario.
- **Mostrar disponibilidad:** Informa al usuario sobre los horarios de reserva disponibles.
**Configuración:**
1. Diríjase a `Configuración > Inteligencia Artificial > Google Calendar integration` y haga clic en **Activato**.
2. Acceda a `Configuración > Inteligencia Artificial > Google > Sincronizar` y complete el proceso de sincronización.
3. Establezca los horarios de reserva disponibles en `Configuración > Misceláneas > Horas de oficina programadas`.
**Información técnica:**
- **Slot duration:** Determina la duración de cada evento reservado.
- **Buffer time:** Tiempo de espera (en minutos) entre reservas para evitar citas consecutivas sin descanso.
- **Minimum booking time:** Tiempo mínimo requerido (en minutos) para realizar una reserva desde el momento actual.
---
\#tidycal-integration#### TidyCal
Esta integración permite al chatbot de OpenAI conectarse con su cuenta de TidyCal para que los usuarios gestionen sus citas de forma automatizada.
**Tareas disponibles:**
- El chatbot puede realizar las mismas funciones que en Google Calendar: reservar, actualizar, cancelar, listar eventos y mostrar horarios disponibles en TidyCal.
**Configuración:**
1. Vaya a `Configuración > Inteligencia Artificial > TidyCal integration` y haga clic en **Activate**.
2. En su cuenta de TidyCal, acceda a `Integrations > Advanced > API Keys` para crear un **Personal Access Token**. Cópielo y péguelo en `Configuración > Inteligencia Artificial > TidyCal integration > Access token`.
3. Ingrese el título del tipo de reserva que desea utilizar en `Configuración > Inteligencia Artificial > TidyCal integration > Booking type title` y guarde los cambios.
4. Configure los horarios disponibles, tiempos de espera y duración de las citas directamente dentro de su cuenta de TidyCal.
**Información importante:**
- Solo se admiten eventos que no tengan un precio asignado.
- El tipo de reserva seleccionado se almacena en caché durante 24 horas. Si realiza cambios, pueden tardar hasta un día en verse reflejados. Para forzar la actualización inmediata, cree un nuevo tipo de reserva o cambie su título y actualícelo en los ajustes de Zampibot.
---
### **Configuración**
Consulte a continuación la información detallada sobre la mayoría de los ajustes de **OpenAI** para **Zampibot**.
#### Modo de Chatbot (Chatbot mode)
Esta función está vinculada a la opción `Configuración > Inteligencia Artificial > OpenAI > Modo de sincronización`. Le permite configurar qué información utilizará OpenAI para responder a los mensajes de los usuarios:
- **Solo preguntas generales (Only general questions):** OpenAI responderá únicamente a preguntas generales y a consultas relacionadas con mensajes anteriores del usuario en la misma conversación, sin utilizar ninguna información proporcionada por usted. Este es el ajuste por defecto.
- **Solo preguntas relacionadas con sus fuentes (Only questions related to your sources):** OpenAI solo responderá a preguntas relacionadas con la información que usted proporcione. Los mensajes generales del usuario serán ignorados. Para esto, primero debe entrenar al chatbot con sus fuentes.
- **Todas las preguntas (All questions):** OpenAI responderá tanto a preguntas relacionadas con su información como a preguntas generales y consultas sobre el historial de la conversación actual. Requiere entrenamiento previo con sus fuentes y es el **modo recomendado**.
- **Asistente (Assistant):** Utilice este modo si está empleando un asistente de OpenAI configurado externamente.
#### Conversación casual (Small talk)
Esta función habilita respuestas predefinidas para que el chatbot pueda manejar interacciones sociales y corteses, como "Hola", "¿Cómo estás?" o "Cuéntame un chiste". Esto hace que los bots se sientan más humanos y atractivos en lugar de estar enfocados únicamente en tareas técnicas.
\#open-ai-assistant#### Asistente (Assistant)
Esta característica le permite utilizar sus propios asistentes creados en `https://platform.openai.com/assistants`:
- Si utiliza la versión Cloud, debe establecer `Configuración > Inteligencia Artificial > OpenAI > Modo de sincronización` en **Manual** y usar su propia clave de API.
- Puede usar **múltiples** asistentes añadiendo sus IDs en `Configuración > Inteligencia Artificial > OpenAI Assistants - Department linking` y seleccionando **Assistant** en el modo de chatbot.
- Para activar un asistente, tanto este como las conversaciones deben estar asignados a un **departamento**.
- El asistente se utiliza *únicamente* para el chatbot y las respuestas inteligentes (Smart Replies), no para la reescritura de mensajes u otras funciones.
#### Chatbot
La función de chatbot de OpenAI opera de forma similar a Dialogflow, proporcionando respuestas automáticas. Seleccione el ajuste de **Modo de bot coversacional** para especificar qué preguntas podrá responder y utilice la función de **toma de control humana** (human takeover) para redirigir el chat a un agente cuando sea necesario.
#### Mensaje de respaldo (Fallback message)
Este mensaje se envía cuando OpenAI no logra entender la pregunta del usuario. Si el chatbot de Dialogflow está habilitado, este mensaje se desactivará y se utilizará en su lugar el mensaje de respaldo de Dialogflow.
#### Instrucción de comportamiento (Prompt)
El **Prompt** instruye a OpenAI sobre cómo debe responder, proporcionando información relevante para contestar a los usuarios.
- Si activa la toma de humano, debe indicarle a OpenAI que responda "No lo sé" si no puede contestar. Siempre debe incluir el siguiente texto en el Prompt: **Responde "No lo sé" si no estás seguro de la respuesta**.
- Las respuestas de las fuentes de entrenamiento son compatibles con esta función.
#### Corrección ortográfica (Spelling correction)
Esta función corrige automáticamente cualquier error de ortografía en los mensajes enviados por el agente.
#### Idioma de los datos de entrenamiento
Si utiliza datos de entrenamiento y su chatbot es multilingüe, configure aquí el idioma predeterminado de dichos datos. Déjelo como **default** si el idioma principal de sus fuentes es el inglés.
#### Respuesta inteligente (Smart reply)
Permite habilitar sugerencias de respuesta rápida incluso si el chatbot no está activo. Si el chatbot está activo, esta función utilizará OpenAI de forma automática.
#### Corrección ortográfica de Dialogflow
Si Dialogflow no encuentra una respuesta adecuada, esta función verifica si hay errores ortográficos en el mensaje del usuario. Si existen, se vuelve a consultar a Dialogflow con el mensaje corregido. Aunque tiene mayor prioridad, puede trabajar en conjunto con la corrección ortográfica de Google Search.
#### Reconocimiento de voz (Speech recognition)
OpenAI permite convertir mensajes de voz en texto escrito.
- No es necesario activar esta opción para que el chatbot entienda audios, ya que esa función siempre está activa.
- Funciona mejor si se conoce el idioma del usuario (puede activar la detección de idioma para esto).
- El texto generado se mostrará junto al reproductor de audio y es compatible con las funciones de traducción.
#### Análisis de imágenes y archivos
Permite al chatbot interpretar imágenes y archivos enviados por los usuarios.
- Solo es compatible con modelos **GPT-4** y versiones más recientes.
- Los archivos se almacenan temporalmente en su cuenta de OpenAI y se borran tras la respuesta.
- Requiere un servidor en línea o el uso de **AWS S3** (no funciona en localhost).
#### Enlaces de fuentes (Source links)
Al estar activa, la respuesta incluirá automáticamente enlaces a las fuentes y datos de entrenamiento utilizados. Para incluir artículos, primero debe configurar la ruta en `Configuración > Artículos > URL de la página de artículos`.
#### Extracción de datos en notas (Note data scraping)
Habilita un menú en el panel de **Notas** que permite extraer automáticamente información específica de los mensajes, como datos de inicio de sesión, URLs o un resumen de la conversación.
#### Parámetros de OpenAI
Zampibot permite ajustar parámetros técnicos como la `temperature` (creatividad) y `logit_bias`. **No modifique estos valores** si no está seguro de su funcionamiento, ya que OpenAI podría dejar de responder.
- **Logit bias:** Debe ser una cadena JSON con claves entre comillas, por ejemplo: `{"2435":-100, "640":-100}`.
#### Generar preguntas de usuario
Si esta opción está activa, OpenAI generará nuevas variaciones de preguntas de usuario en tiempo real al abrir el panel de entrenamiento del chatbot.
#### Usar conversaciones para entrenamiento
Utiliza automáticamente las conversaciones reales para entrenar al bot mediante un cron job cada 24 horas. Solo se emplean mensajes de usuarios y agentes (se ignoran los del bot). Puede encontrar estos datos en `Chatbot > Entrenamiento > Conversaciones`.
#### Conocimiento del contexto (Context awareness)
Permite a OpenAI reconocer el contexto de la página web donde se encuentra el usuario (título meta y descripción meta). Esta opción solo es compatible con el widget de chat y no con canales de mensajería externos.
\#message-rewriting
#### \#message-rewriting
#### Reescritura de mensajes (Message rewriting)
Añade un botón en el campo de texto del área de conversación para profesionalizar sus mensajes.
- Los saludos se añaden automáticamente si no hay mensajes previos del agente.
- Asegúrese de que su perfil de agente tenga el idioma correcto seleccionado.
- Puede configurar un **Prompt** para guiar el estilo de reescritura.
- El **Modo de ejecución** puede ser automático (para todos los mensajes) o por "sentimiento negativo" (solo para mensajes que OpenAI detecte como negativos).
---
### **Entrenamiento**
Con esta función, su chatbot puede someterse a un proceso de aprendizaje utilizando su sitio web, textos, documentos PDF y más. Una vez completado el entrenamiento con éxito, el chatbot será capaz de responder preguntas relacionadas con sus contenidos.
#### Entrenamiento mediante archivos
Este proceso le permite entrenar al chatbot utilizando archivos en formato **PDF** y **TXT**.
- **Acceso:** Diríjase a `Chatbot > Entrenamiento > Archivos`.
- **Proceso:** Seleccione sus archivos, haga clic en el botón **Entrenar chatbot** y espere a que el proceso finalice.
- **Nota:** Una vez completado el entrenamiento, los archivos cargados se eliminan del sistema automáticamente.
#### Entrenamiento mediante un sitio web
Permite al chatbot aprender directamente de las páginas de su sitio web.
- **Acceso:** Diríjase a `Chatbot > Entrenamiento > Sitio web`.
- **Proceso:** Ingrese las URLs de su sitio y haga clic en **Entrenar chatbot**.
- **Sitemaps XML:** Para sitios web grandes, es más eficiente y menos propenso a errores utilizar un mapa del sitio (XML sitemap) en lugar de la URL principal. Puede crear uno con herramientas externas como `https://www.xml-sitemaps.com`.
- **Límites:** Si su sitemap contiene más de 1000 URLs, se recomienda dividirlo en varios archivos y entrenar uno a la vez para evitar sobrecargas en el servidor.
- **Reentrenamiento:** Si vuelve a entrenar el mismo sitio, debe eliminar primero los datos previos; de lo contrario, solo se entrenarán las URLs nuevas.
#### Entrenamiento mediante preguntas y respuestas (P&R)
Este método permite añadir preguntas y sus respectivas respuestas de forma individual.
- **Acceso:** Navegue a `Chatbot > Entrenamiento > Preguntas & Respuestas`.
#### Entrenamiento mediante artículos
El chatbot puede utilizar sus artículos de la base de conocimientos como fuente de aprendizaje.
- **Proceso:** Añada sus artículos y luego haga clic en el botón **Entrenar chatbot**; los artículos se utilizarán como fuentes automáticamente.
#### Entrenamiento mediante flujos (Flows)
Utilice los flujos conversacionales diseñados para guiar las respuestas del bot.
- **Acceso:** Navegue a `Chatbot > Flujos`.
---
#### ***Métodos de Mejora Continua***
#### Entrenamiento mediante conversaciones
Permite generar datos de entrenamiento a partir de las interacciones reales entre usuarios y agentes.
- **Activación:** Marque la opción en `Configuración > Inteligencia Artificial > OpenAI > Usar conversaciones para entrenamiento`.
**Importante:** Revise estos datos regularmente en `Chatbot > Entrenamiento > Conversaciones`, ya que las respuestas incorrectas de los agentes pueden generar datos de baja calidad.
#### Panel de entrenamiento del chatbot
Permite seleccionar mensajes específicos de una conversación para crear nuevas preguntas y respuestas.
- **Uso:** En el área de conversación, pase el cursor sobre un mensaje, abra el menú del mensaje y seleccione **Entrenar chatbot**.
- **Sincronización:** Si **OpenAI** está activo, el chatbot se entrenará automáticamente con la nueva información.
---
#### Información Técnica y Límites
- **Actualización de datos:** Para añadir información nueva, simplemente realice el entrenamiento otra vez; los datos previos no se perderán, solo se sumarán las nuevas fuentes.
- **Versión Cloud:** Existen límites de caracteres para el entrenamiento en la versión en la nube.
- **Modelo de Embeddings:** El sistema utiliza obligatoriamente el modelo `text-embedding-3-small` de OpenAI para procesar los mensajes y el entrenamiento.
- **Seguridad:** Los embeddings se almacenan como archivos JSON en la carpeta de `uploads` de ZampiBot y están protegidos mediante el enfoque de "contraseña por nombre de archivo".
- **Borrado total:** Puede eliminar todos los datos previos en `Chatbot > Entrenamiento > Información > Eliminar todos los datos de entrenamiento`.
---
#### Entrenamiento mediante Cron Job
Puede automatizar el entrenamiento periódico de su sitio web.
- **Versión Cloud:** Active `Configuración > Inteligencia Artificial > OpenAI > Entrenamiento mediante cron job`. Se puede ejecutar máximo una vez cada 7 días.
- **Ruta de URL:** Obtenga su enlace en `Configuración > Misceláneas > Installation URL`.
---
#### Entrenamiento Multilingüe
Si sus usuarios hablan varios idiomas, puede limitar al chatbot para que recupere respuestas solo de fuentes en el idioma del usuario.
- **Activación:** Marque `Configuración > Inteligencia Artificial > OpenAI > Fuentes de entrenamiento multilingües`.
- **Websites:** El idioma se detecta automáticamente mediante el atributo `lang` en la etiqueta `` de sus páginas.
- **Artículos:** Todos los idiomas de los artículos se utilizan de forma automática.
- **Archivos y P&R:** Actualmente solo admiten un idioma por fuente.
---
### **Q&A (Preguntas y Respuestas)**
Esta sección se refiere al área de entrenamiento del chatbot mediante preguntas y respuestas directas. Añada pares de preguntas y respuestas para mejorar el rendimiento del bot y permitirle responder consultas específicas de los usuarios.
#### Configuración de una Q&A
- **Pregunta (Question):** Ingrese los mensajes del usuario que activarán la respuesta. Añada tantas variaciones de la pregunta como sea necesario para cubrir diferentes formas de redacción.
- *Ejemplo:* Para la respuesta "¡Soy un chatbot!", las preguntas podrían ser: "¿Quién eres?", "¿Qué eres?", "¿Eres un robot?".
- **Respuesta (Answer):** Ingrese el texto exacto con el que el chatbot responderá al usuario.
- **Llamada a herramientas (Tools calling):** Permite conectar esta respuesta con datos externos (detalles más abajo).
- **Establecer datos y acciones (Set data and actions):** Permite asignar valores específicos al usuario cuando se formula esta pregunta.
- Puede utilizar **campos de combinación** para asignar valores extraídos del mensaje del usuario. Incluya estos campos en la respuesta y serán reemplazados por los valores reales (ejemplo: `{language}`).
- También puede usar esta función para ejecutar acciones como asignar **departamentos**, **agentes** y **etiquetas** a la conversación.
---
### **Flujos (Flows)**
La siguiente información se relaciona con el área de flujos del chatbot, disponible en la ruta: `Chatbot > Flujos`
Los flujos le permiten crear secuencias de conversación automatizadas de manera sencilla. Utilícelos para guiar al usuario hacia un objetivo específico mediante una serie de mensajes predefinidos.
#### Bloques de Flujo
- **Inicio (Start):** Determina cuándo debe comenzar el flujo.
- Puede iniciarse cada vez que el usuario abre una conversación, al enviar un mensaje específico o al cargar la página.
- **Condiciones:** Si establece condiciones, el flujo solo iniciará cuando todas se cumplan.
- **Departamento/Fuente:** Puede limitar el inicio a conversaciones asignadas a un departamento específico o provenientes de una fuente concreta (ej. WhatsApp o Instagram).
- **Enviar mensaje:** Envía un mensaje de texto simple al usuario.
- **Enviar opciones (Send choices):** Envía una lista de botones o permite al usuario elegir una opción.
- **Modo conversacional:** Cuando está habilitado, los botones se ocultan y el chatbot envía solo texto; los usuarios seleccionan opciones respondiendo con texto. La IA interpreta la respuesta y selecciona la opción correspondiente, continuando el flujo como si se hubiera presionado el botón. Esto es ideal para canales como **WhatsApp** e **Instagram**.
- **Variaciones:** Puede añadir variaciones a los textos de los botones separándolos con el carácter `|` (ej. `Sí|Claro|Por supuesto`) para ayudar a la IA a entender mejor la respuesta del usuario.
- **Respaldo:** Si la respuesta no coincide, se enviará un mensaje de error (fallback) mostrando las opciones disponibles.
- **Enviar video:** Envía un archivo de video al usuario.
- **Obtener detalles del usuario:** Solicita y almacena información del usuario en ZampiBot.
- *Nota:* Los detalles no se guardan si prueba el flujo en el área de pruebas (playground) ya que el usuario es temporal. Pruebe con un usuario real para verificar el guardado.
- **Establecer datos (Set data):** Asigna valores específicos al usuario cuando se ejecuta el bloque.
- **Acciones:** Ejecuta acciones internas del sistema.
- **Condiciones:** Crea ramificaciones en el flujo. Si se cumplen las condiciones, el flujo sigue la rama "Verdadero" (`true`), de lo contrario, sigue la rama "Falso" (`false`).
- **Rest API:** Envía datos a su servidor externo.
- El cuerpo debe ser un array JSON. Detalles como el ID de usuario y de conversación se incluyen automáticamente bajo la clave `sb`.
- Use la sección **guardar respuesta** para almacenar detalles del usuario basados en la respuesta de su servidor (usando notación de puntos JSON).
- *Nota:* Esta es una función avanzada que requiere código personalizado en su servidor.
- **Conector de flujo:** Conecta el flujo actual con otro flujo diferente e inicia la ejecución de este último.
#### Información Adicional
- **Multilingüe:** Los flujos pueden traducirse. Añada traducciones para mensajes y botones en el área de **Traducciones**. También puede usar la función de **traducción automática**. Si el idioma por defecto no es inglés, configúrelo en `Configuración > Inteligencia Artificial > OpenAI > Training Data Language`.
- **Navegación:** Los usuarios pueden retroceder para corregir datos de manera conversacional (ej. diciendo "Perdón, me equivoqué de correo" o simplemente "atrás").
---
#### Llamada a Herramientas (Tools Calling)
Esta función permite conectar el chatbot con herramientas y sistemas externos para recuperar información necesaria para responder al usuario. El chatbot consultará a su servidor y devolverá la información al usuario.
> \[!WARNING\] Esta es una función para usuarios avanzados que requiere programación en su servidor. Nuestro soporte estándar no incluye asistencia para código personalizado, pero ofrecemos servicios de contratación para implementaciones.
#### Parámetros de Configuración
- **URL:** Ingrese la URL del punto final (endpoint) de la API que suministrará los valores.
- **Encabezados (Headers):**
- En **Q&A**: Ingrese pares clave-valor separados por comas (ej. `apikey:123345, json:true`).
- En **Flujos**: Añada parámetros clave-valor haciendo clic en el botón "Añadir nuevo ítem".
- **Propiedades:** Defina los valores que el chatbot debe solicitar al usuario (ej. una ciudad, un número de seguimiento, etc.).
- **Valores permitidos:** Si conoce las respuestas posibles de antemano, ingréselas en este campo.
#### Datos enviados a su servidor
ZampiBot enviará la siguiente información. Si usa el método **POST**, irá en el cuerpo JSON; si usa **GET**, irá en el encabezado.
**sb:** Incluye los IDs para que pueda recuperar más información vía la API REST de ZampiBot.
#### Respuesta de su servidor
Su servidor debe devolver un array JSON con los valores requeridos. Incluya `"success": true`**solo** cuando la solicitud sea exitosa y se devuelva la información esperada. No lo incluya si hubo un error (ej. número de orden inválido).
**Ejemplo de respuesta correcta:**
{ "order_status": "Entregado hace 2 horas y 25 minutos", "success": true }
**Información**- **Solución de problemas:** Si OpenAI no está funcionando, haga clic **aquí**.
- **Interacción con Dialogflow:** Si Dialogflow se encuentra activo, la consulta a OpenAI se ejecuta únicamente si el chatbot no conoce la respuesta a la pregunta del usuario y si la longitud del mensaje del usuario es superior a **4 caracteres**.
- **Compatibilidad de ajustes generales:** Los siguientes ajustes son totalmente compatibles con OpenAI:
- **Respuesta inteligente** (Smart reply).
- **Toma de control humana** (Human takeover).
- **Desactivar en el área de tickets** (Disable for the tickets area).
- **Desactivar durante horario de oficina** (Disable during office hours).
- **Retraso en la respuesta del bot** (Bot response delay).
- **Responder a correos de usuarios** (Reply to user emails).
- **Responder a mensajes de texto de usuarios** (Reply to user text messages).
- **Compatibilidad de ajustes de Google:** Los siguientes ajustes de Google funcionan conjuntamente con OpenAI:
- **Multilingüe vía traducción** (Multilingual via translation).
- **Traducción automática** (Automatic translation).
- **Detección de idioma** (Language detection).
- **Configuración de Idioma:** Establezca el idioma del chatbot de OpenAI desde la ruta: `Configuración > Chat > Idioma`.
- Seleccione la opción **Multilingual** (Multilingüe) si su sitio web admite varios idiomas o si sus usuarios hablan diferentes lenguas.
- Si utiliza canales de mensajería externos como **WhatsApp** o **Instagram**, es obligatorio detectar el idioma del usuario activando la función de **detección de idioma**. Para más detalles, haga clic **aquí**.
- **Comportamiento durante la Toma de Control:** Si un agente humano toma el control de la conversación, el chatbot de OpenAI se desactiva y **permanece desactivado** incluso si el agente se desconecta (pasa a estado offline). Por el contrario, el chatbot de Dialogflow continúa funcionando siempre que sea necesario.
- **Modelo por defecto:** El modelo de IA utilizado por defecto es **gpt-5-mini**.
- **Mensajes consecutivos:** Los mensajes enviados por el usuario de forma consecutiva (uno tras otro rápidamente) son tratados por el chatbot como un **único mensaje**, lo que resulta en una sola respuesta unificada en lugar de múltiples respuestas fragmentadas.
---
\#google-sync## **GOOGLE**
Los siguientes ajustes están relacionados con la aplicación de Inteligencia Artificial.
### **Sincronización**
Para comenzar a utilizar los servicios de IA de Google y Dialogflow, siga los pasos que se detallan a continuación.
#### Modo de sincronización automática
*Esta función está disponible solo en la **versión en la nube** de ZampiBot.*
1. Haga clic en **Sincronizar ahora** (*Synchronize now*) y complete el procedimiento.
2. Si desea activar el chatbot de Dialogflow, marque la opción en: `Configuración > Inteligencia Artificial > Google > Dialogflow chatbot`.
3. Además, deberá ingresar el **ID del Proyecto** o el **Nombre del Agente** de su chatbot. Para obtener estos datos, siga los pasos descritos más abajo en la sección de Dialogflow.
4. **Nota:** Necesita comprar **créditos** para utilizar esta opción.
#### Modo de sincronización manual
Siga estos pasos para configurar la integración manualmente en su propio servidor:
1. Habilite la opción `Configuración > Inteligencia Artificial > Google > Dialogflow Chatbot` en ZampiBot y guarde los cambios.
2. Vaya a [console.cloud.google.com](https://console.cloud.google.com) e inicie sesión.
3. Seleccione o cree un proyecto haciendo clic en el botón **Seleccionar un proyecto** en la parte superior izquierda. Nombre el proyecto como desee.
4. Active las APIs necesarias: Ingrese "Dialogflow API" en la barra de búsqueda superior, selecciónela y haga clic en **Habilitar**. Repita este paso para:
- **Cloud Natural Language API**
- **Cloud Translation API**
- **Google Calendar API**
5. Seleccione el proyecto y vaya al `Menú izquierdo > API y servicios > Pantalla de consentimiento de OAuth`.
- Seleccione **Externo** y haga clic en **Crear**.
- En **Nombre de la aplicación**, ingrese lo que desee.
- En **Correo electrónico de asistencia al usuario** y **Información de contacto del desarrollador**, ingrese su correo electrónico.
- Haga clic en **Guardar y continuar**.
6. En el área de **Permisos (Data access)**:
- Haga clic en **Agregar o quitar alcances** (*Add or remove scopes*).
- Desplácese hasta el fondo, al área de **Agregar alcances manualmente**, e ingrese las siguientes URLs separadas por comas (copie y pegue exactamente): `https://www.googleapis.com/auth/dialogflow,https://www.googleapis.com/auth/cloud-language,https://www.googleapis.com/auth/cloud-translation,https://www.googleapis.com/auth/calendar`
- Haga clic en **Agregar a la tabla**, luego en **Actualizar** y finalmente en **Guardar y continuar**.
7. En el área de **Usuarios de prueba (Audience)**:
- Haga clic en **Add users** (Agregar usuarios) y añada su correo electrónico de Google (el mismo con el que ha iniciado sesión).
- Haga clic en **Guardar y continuar**.
- Haga clic en **PUBLICAR LA APLICACIÓN** (*PUBLISH APP*). No es necesario completar el proceso de revisión de Google; déjelo en estado de revisión pendiente.
8. Vaya a `Menú izquierdo > API y servicios > Credenciales` y haga clic en **Crear credenciales**.
- Seleccione **ID de cliente de OAuth**.
- En **Tipo de aplicación**, seleccione **Aplicación web**. Ingrese cualquier nombre.
- En **Orígenes de JavaScript autorizados**, déjelo vacío.
- En **URI de redireccionamiento autorizados**, ingrese la URL de redirección que encontrará en ZampiBot bajo: `Configuración > Inteligencia Artificial > Google > Authorised redirect URI`.
- Haga clic en **Crear**.
9. Copie el **ID de cliente** y el **Secreto de cliente**. Péguelos en los campos correspondientes en ZampiBot en: `Configuración > Inteligencia Artificial > Dialogflow`. Guarde los ajustes.
10. Haga clic en el botón `Configuración > Inteligencia Artificial > Google > Sincronizar` en ZampiBot.
- Inicie sesión con la misma cuenta de Google utilizada hasta ahora.
- En la siguiente pantalla, haga clic en **Continuar** (si aparece una advertencia de seguridad, proceda indicando que confía en la aplicación ya que es suya).
- Seleccione todos los permisos/alcances y haga clic en **Continuar**.
11. Copie el **Token de actualización** (*Refresh token*) generado y péguelo en: `Configuración > Inteligencia Artificial > Google > Refresh token`.
12. ¡Listo! Si desea activar el chatbot, marque la opción `Dialogflow chatbot`. Recuerde ingresar el ID del Proyecto o Nombre del Agente.
> \[!NOTE\] **Usuarios de Google Workspace:** Vaya a `https://admin.google.com/`, haga clic en **Control de sesiones de Google Cloud** y establezca la "Política de reautenticación" en **Nunca requerir reautenticación**.
---
### **Dialogflow**
La información a continuación es relevante para el uso de Dialogflow.
> \[!WARNING\] **¡Advertencia!** Dejaremos de dar soporte a Dialogflow a finales de 2025. Todas sus funciones estarán disponibles en ZampiBot a través de OpenAI. Por favor, utilice OpenAI en lugar de Dialogflow.
#### Obtener ID del Proyecto (Dialogflow ES)
1. Inicie sesión en la consola de Dialogflow ES en [dialogflow.cloud.google.com](https://dialogflow.cloud.google.com). Use la misma cuenta de Google de la sincronización.
2. Haga clic en el **icono de engranaje** (ajustes) en la parte superior izquierda, junto al nombre del chatbot.
3. Si no ha creado un chatbot, siga las instrucciones de "Crear un chatbot básico" más abajo.
4. Copie el valor del **Project ID**.
5. *Importante:* Asegúrese de elegir la región **US / GLOBAL** en la parte superior izquierda. Nuestro sistema no soporta "Mega Agents".
#### Obtener Nombre del Agente (Dialogflow CX)
1. Inicie sesión en la consola de Dialogflow CX en [dialogflow.cloud.google.com/cx/](https://dialogflow.cloud.google.com/cx/).
2. Seleccione el proyecto y vaya a la página de agentes (Click en `Agents > View all agents`).
3. Haga clic en el menú de opciones (tres puntos) del agente deseado y seleccione **Copy name** (Copiar nombre).
#### Ajustes Adicionales
- **Ubicación (Location):** Establezca la región de su agente de Dialogflow. Es opcional si su agente está en la región "global".
- **Intent de Bienvenida (Welcome Intent):** Activa el Intent de bienvenida de Dialogflow para nuevos visitantes. Requiere que la opción `Configuración > Mensajes y formularios > Mensaje de bienvenida` esté activa.
- **Enviar detalles del usuario:** Envía a Dialogflow los datos recopilados en el **formulario de registro** y en los mensajes enriquecidos de correo electrónico.
- **Añadir Intents a respuestas guardadas:** Incluye los Intents de Dialogflow en su lista de respuestas predefinidas. Puede verlas en `Configuración > Administración > Respuestas guardadas`.
---
### **Crear un chatbot básico**
Si aún no tiene un chatbot, siga estas instrucciones. La gestión del bot se realiza enteramente en la plataforma de Dialogflow.
1. Ingrese a la **Consola de Dialogflow** y cree un agente.
2. En **Google Project**, seleccione el mismo proyecto que creó durante la sincronización manual.
3. Añada una nueva **Intent** desde el menú izquierdo y ábrala.
4. En el área de **Frases de entrenamiento (Training phrases)**, añada las preguntas que el usuario podría hacer. Agregue tantas variaciones como sea posible.
- *Ejemplo:* Si desea que el bot dé su dirección, añada: "¿cuál es su dirección?", "dirección", "¿dónde están ubicados?".
5. En el área de **Respuestas (Responses)**, añada la respuesta del bot como **Text response**.
6. ¡Ha creado su primera interacción! Pruébelo desde el área de chat de ZampiBot.
---
### **Comportamiento (Acciones del Chatbot)**
Las siguientes acciones permiten al chatbot interactuar con el sitio web y el sistema de forma autónoma en nombre del usuario.
#### Cómo configurar una acción
Para utilizar una acción, debe acceder a la consola de **Dialogflow** y seguir estos pasos:
1. Edite una **Intent** (Intención) existente o cree una nueva.
2. Desplácese hasta la sección de **Responses** (Respuestas).
3. Añada una respuesta de tipo **Custom Payload** (Carga útil personalizada).
4. Ingrese el código JSON utilizando la siguiente sintaxis general: `{ "NOMBRE-DE-ACCION": VALOR }`
---
**Lista de Acciones Disponibles**
Copie y pegue los siguientes códigos en su *Custom Payload* según la función que desee activar:
**Toma de control humana**
Inicia el proceso de relevo a un agente humano y desactiva el chatbot para esa conversación.
{ "human-takeover": true }
**Redireccionar**
Redirige al navegador del usuario a la URL especificada.
- **Nueva pestaña:** Añada `"new-window": true` para abrir el enlace en una pestaña nueva.
**Abrir artículo**
Abre automáticamente un artículo de la base de conocimientos. Reemplace `ID` con el ID numérico o slug del artículo.
{ "open-article": ID }
**Transcripción**
Genera la transcripción de la conversación actual como un archivo de texto y la descarga.
- **Enviar por correo:** Cambie el valor a `"email"` para enviarla al correo del usuario.
- **Mensaje adjunto:** Use el parámetro `message` para incluir un texto en el cuerpo del correo.
{ "transcript": "email", "message": "Aquí tienes tu copia de la conversación." }
**Asignar etiquetas**
Asigna una o más etiquetas a la conversación actual.
{ "tags": ["Ventas", "Urgente"] }
**Cambiar departamento**
Cambia o establece el departamento de la conversación y notifica a los agentes de dicho departamento. Reemplace `ID` con el ID del departamento.
{ "department": 1 }
**Asignar agente**
Asigna un agente específico a la conversación y le envía una notificación. Reemplace `ID` con el ID del agente.
{ "agent": 1 }
**Enviar correo electrónico**
Envía un correo electrónico al usuario o al agente activo.
- **Destinatario:** Puede ser `"active_user"` (usuario) o `"agents"` (agentes).
- **Adjuntos:** Siguen el formato `["nombre_archivo", "enlace_url"]`.
**Actualizar interfaz de usuario**
Fuerza al área de administración a actualizar los datos del usuario de la conversación activa. Se recomienda usar esto en combinación con otras acciones para ver los cambios en tiempo real (por ejemplo, tras actualizar un teléfono).
{ "update-user": true }
**Archivar chat**
Archiva la conversación actual y envía el mensaje de cierre (si esta función está activa en la configuración).
{ "archive-chat": true }
**Actualizar detalles del usuario**
Actualiza la información del perfil del usuario activo.
- **Campos estándar:** Puede actualizar `first_name`, `last_name`, `email`, `user_type`, `password`.
- **Campos extra:** Para actualizar detalles personalizados (como teléfono o dirección), use el objeto `"extra"`. La sintaxis es `"slug-del-campo": ["Valor", "Nombre visible"]`.
> \[!TIP\] Para probar esto fácilmente, puede descargar un ejemplo de Intent, ir al área de **Intents** en Dialogflow, hacer clic en el menú de 3 puntos (arriba a la derecha) y seleccionar **Upload Intent**. Luego, pruebe enviando el mensaje "start" o "iniciar" al bot.
**Actualizar idioma del usuario**
Actualiza el idioma del perfil del usuario y del chatbot (si la función multilingüe está activa) para coincidir con el idioma detectado o solicitado en la frase del usuario.
- **Variable:** El valor `$language` representa la entidad de idioma detectada por Dialogflow.
{ "update-user-language": "$language" }
---
### **Cumplimiento de Dialogflow**
Los datos de cumplimiento enviados a la URL de su webhook son como se muestra a continuación:
```c#
{ "responseId": "4a58fc4f...", "queryResult": { "queryText": "fullfilment", "parameters": [], "allRequiredParamsPresent": true, "fulfillmentText": "Example", "fulfillmentMessages": [{ "text": { "text": ["Response"] } }], "outputContexts": [{ "name": "projects/schiocco...", "parameters": { "no-input": 0, "no-match": 0 } }], "intent": { "name": "projects/schiocco...", "displayName": "Fullfilment" }, "intentDetectionConfidence": 1, "languageCode": "en" }, "originalDetectIntentRequest": { "payload": { "support_board": { "conversation_id": "3002", "user_id": "3777" } } }, "session": "projects/example/agent/sessions/3777-3002" }
```
Los campos `payload` y `session` contienen el **ID de usuario** y el **ID de conversación** de ZampiBot.
---
### **Información sobre Dialogflow**
#### Prioridad de OpenAI
Si **OpenAI** está habilitado, **Dialogflow tiene prioridad** sobre este. La API de OpenAI solo se utilizará si Dialogflow no logra encontrar una respuesta adecuada para la pregunta del usuario.
#### Entrenamiento y optimización del Chatbot
Lograr que su chatbot ofrezca respuestas correctas de manera consistente requiere tiempo. Para mejorar su rendimiento:
- **Entrenamiento continuo:** Usted y sus agentes deben entrenar al bot incorporando nuevas variaciones de preguntas e **Intents** (Intenciones).
- **Edición rápida:** Los agentes pueden añadir nuevos Intents o frases de entrenamiento desde el área de administración en tiempo real. Simplemente pase el cursor sobre un mensaje y haga clic en el **icono de Dialogflow Intent**.
- **Generación automática:** Habilite `Configuración > Inteligencia Artificial > OpenAI > Generar preguntas de usuario` para añadir variaciones de preguntas y reescribir respuestas automáticamente.
- **Dialogflow CX:** Las respuestas se añadirán al último flujo utilizado en la conversación; si no hay uno, se añadirán al flujo de inicio.
**Solución de problemas de clasificación:** Si el chatbot responde con Intents incorrectos:
1. Vaya a `Consola de Dialogflow > Configuración del chatbot > ML Settings`.
2. Aumente el **ML CLASSIFICATION THRESHOLD** a un número mayor (ej. `0.6`).
3. Verifique también la **Confianza de detección de Intent**.
#### Confianza de detección de Intent (Confidence)
Dialogflow asigna una puntuación a las posibles coincidencias (de 0.0 a 1.0).
- Especifique un valor entre **0.1** y **1.0** en la configuración de ZampiBot.
- Cualquier respuesta con una puntuación inferior al valor establecido será descartada.
- **Recomendación:** Si utiliza Dialogflow junto con un chatbot de OpenAI entrenado con sus propios recursos, configure este valor en **0.81**.
#### Base de Conocimientos (Knowledge Base)
Esta función está habilitada automáticamente y permite al chatbot buscar respuestas dentro de documentos (como PDF) o páginas web. Para crear su primera base de conocimientos, visite la documentación de Google Cloud.
#### Respuesta de Dialogflow
La respuesta completa en formato **JSON** de Dialogflow se guarda automáticamente en la base de datos, en la tabla `sb_messages`, columna `payload`.
---
#### Lógica Avanzada
#### Ignorar un Intent si faltan palabras clave
Para evitar respuestas incorrectas ante preguntas similares con sujetos diferentes, puede instruir al sistema para que ignore un Intent si no contiene palabras clave específicas:
1. Entre en Dialogflow y edite el Intent.
2. En las frases de entrenamiento, seleccione las palabras clave obligatorias y vincúlelas a una **Entidad** (nueva o existente).
3. Bajo **Actions and parameters**, marque la casilla **Required** (Requerido).
4. Añada un nuevo **Prompt** con el valor exacto: `skip-intent`.
5. Guarde el Intent.
#### Adjuntos (Attachments)
- **Del usuario:** Se envían a Dialogflow añadiendo las URLs de los archivos al mensaje.
- **Del chatbot:** Para enviar adjuntos, añada una respuesta de **Custom Payload** con el siguiente JSON:
#### Mensajes Enriquecidos en Dialogflow
Para enviar mensajes enriquecidos (botones, listas, etc.):
1. Ingrese el **shortcode** directamente en el campo **TEXT RESPONSE**.
2. O bien, use una respuesta **Custom Payload** con: `{ "rich-message": "shortcode" }`. *(Nota: Si usa JSON, debe escapar las comillas dobles `"` con `\"` dentro del shortcode).*
#### Respuestas de mensajes enriquecidos
Cuando un usuario interactúa (ej. hace clic en un botón):
- **Formato web:** Se envía a Dialogflow como `ID|respuesta`.
- Si el tipo es *registro, email o seguimiento*, los valores se envían como un array en la clave `queryParams['payload']`.
- `ID` es el identificador del mensaje (atributo `id="TU-ID"`). Si no se define, se usa uno aleatorio.
- **Apps de mensajería (WhatsApp, etc.):** La respuesta no contiene el ID del mensaje enriquecido. Debe utilizar **Contextos** en Dialogflow para saber qué Intent activar.
- **Bloquear respuesta:** Para evitar que Dialogflow responda a una interacción de mensaje enriquecido, cree un Intent cuyo única "frase de entrenamiento" sea el **ID** del mensaje y déjelo sin respuesta definida.
#### Obtener datos de formularios (Registro, Email, Seguimiento)
1. Active `Configuración > Inteligencia Artificial > Google > Enviar detalles del usuario`.
2. En Dialogflow (`Fulfillment`), habilite **Webhooks**. Solo necesita la URL del archivo que recibirá los datos.
3. Cree un Intent donde la frase de entrenamiento sea el ID del formulario:
- Formulario de registro: `registration`
- Formulario de seguimiento: `sb-follow-up-form`
- Formularios de email: `email`
4. Habilite el **Fulfillment** para ese Intent.
#### Encuesta Secuencial (Ejemplo)
Para encadenar preguntas, use el **ID del mensaje enriquecido** como la frase de entrenamiento del siguiente paso:
1. **Intent 1:** Frase: `ejemplo encuesta`. Respuesta: `[buttons id="test-encuesta-1" options="Software,Productos,Servicios" title="¿Tipo de negocio?"]`
2. **Intent 2:** Frase: `test-encuesta-1` (El ID del anterior). Respuesta: `[select id="sec-encuesta-2" options="Prioritario,Express" title="Método de envío"]`
3. **Intent 3:** Frase: `sec-encuesta-2`. Respuesta: `¡Gracias por completar la encuesta!`.
---
#### Vinculación de Departamentos
Permite dirigir al usuario a un agente de Dialogflow específico según el departamento.
- Obtenga los IDs de departamento en `Configuración > Misceláneas > Departamentos`.
- Obtenga los IDs de proyecto en la configuración de sus agentes de Dialogflow.
---
#### Más Información Técnica
- **Mensajes de voz:** Dialogflow soporta reconocimiento de voz. Para audios de **WhatsApp** y archivos `.ogg`, debe activar `Configuración > Inteligencia Artificial > OpenAI > Reconocimiento de voz`.
- **Activación vía API:** Envíe un mensaje sin texto con el payload `{ "event": "activate-bot" }`.
- **Datos enviados:** ZampiBot envía `conversation_id` y `user_id` en el parámetro `queryParams` al detectar un intent.
- **Evento de bienvenida (CX):** Cree un *Event Handler* e inserte `Welcome` como *Custom Event*.
- **Sincronización de artículos:** Los artículos de ZampiBot se sincronizan automáticamente con la Knowledge Base de Dialogflow.
- **Cambio dinámico de agente:** Use la variable JS `SB_DIALOGFLOW_AGENT = "PROJECT_ID"` para cambiar el agente predeterminado en el frontend.
- **Detección de bucle:** Si el usuario repite el mismo mensaje y activa el mismo Intent, y OpenAI está activo, ZampiBot intentará usar OpenAI e ignorará a Dialogflow.
- **Variables en CX:** Acceda al usuario y conversación en las condiciones de ruta usando `$session.params.user_id` y `$session.params.conversation_id`.
---
### **Chatbot y Traducción Multilingüe**
#### Chatbot Multilingüe
La función ubicada en `Inteligencia Artificial > Google > Multilingual` verifica si existe un agente de Dialogflow configurado en el idioma del usuario y, de ser así, lo activa.
Para que esto funcione, el sistema debe conocer el idioma del usuario. Este se determina en el siguiente orden de prioridad:
1. El detalle de idioma guardado en el perfil del usuario.
2. El idioma del navegador del usuario. *Nota: El idioma también puede ser identificado automáticamente mediante la función de **Detección de idioma**.*
---
#### Traducción Automática (Agentes)
Esta función traduce automáticamente los mensajes del usuario al idioma del agente y los mensajes del agente al idioma del usuario en tiempo real.
**Activación:** Marque la opción en `Configuración > Inteligencia Artificial > Traducción automática`.
**Requisitos:**
- **Versión Cloud:** Si `Inteligencia Artificial > Google > Modo de sincronización` está en **Automático**, funcionará sin configuración extra.
- **Versión Manual:** Debe completar la sincronización y la configuración que se detalla a continuación.
**Configuración Manual:**
1. Inicie sesión en [Google Cloud Console](https://console.cloud.google.com) y seleccione el proyecto de su agente.
2. Busque y habilite la **Cloud Translation API**. (Servicio de pago con nivel gratuito).
3. Habilite la facturación en `Menú izquierdo > Facturación` asociando un método de pago válido.
**Información Adicional:**
- Los agentes ven el mensaje traducido, pero pueden ver el original haciendo clic en el menú del mensaje y seleccionando **Ver mensaje original**.
- El idioma del agente se basa en su perfil o en el idioma del área de administración.
- Las notificaciones también se traducen.
- **Excluir texto:** Para evitar que una parte del texto se traduzca, enciérrela entre caracteres de acento grave (`) o triple acento grave (```).
---
#### Multilingüe vía Traducción (Chatbot)
La función en `Configuración > Inteligencia Artificial > Multilingüe a través de la traducción` traduce el mensaje del usuario al idioma predeterminado del chatbot (Dialogflow u OpenAI) para que este lo entienda, y luego traduce la respuesta del bot al idioma del usuario.
- **Alcance:** Traduce mensajes enriquecidos, artículos, formularios de registro y notificaciones emergentes.
- **Optimización:** Las traducciones se guardan en archivos para minimizar costos y mejorar la velocidad.
- **Importante:** Si el inglés es uno de los idiomas soportados, **el inglés debe ser el idioma predeterminado** y los textos originales deben estar en inglés.
- **OpenAI:** Si usa datos de entrenamiento, configure el idioma en `Configuración > Inteligencia Artificial > OpenAI > Training Sources Language`.
---
#### Detección de Idioma
Detecta el idioma de los mensajes del usuario y actualiza su perfil (y el agente de Dialogflow) automáticamente. Si no se soporta el idioma, muestra un mensaje de respaldo.
- **Variable:** Puede usar `{language_name}` en el mensaje de respaldo.
- **Condiciones:** El mensaje debe tener al menos **2 palabras**. La detección solo se ejecuta en los primeros **2 mensajes** de la conversación.
- **Con OpenAI:** Si el chatbot de OpenAI está activo para preguntas generales, el mensaje de respaldo nunca se enviará, ya que OpenAI responderá en el idioma detectado.
---
\#google-search### **Búsqueda en Google (Google Search)**
La función en `Configuración > Inteligencia Artificial > Busqueda Google` permite al chatbot buscar respuestas en la web en tiempo real.
#### Configuración
1. Regístrese en [Programmable Search Engine](https://programmablesearchengine.google.com/).
2. Cree un motor de búsqueda.
- *Recomendación:* Añada solo su sitio web y Wikipedia para evitar resultados irrelevantes. Deje desactivada la opción "Buscar en toda la web".
3. Vaya a `Edit search engine > Setup > Basic`, copie el **Search engine ID** y péguelo en ZampiBot.
4. Para obtener la clave API, visite [Google Custom Search API](https://developers.google.com/custom-search/v1/overview) y haga clic en **Get a key**.
#### Corrección Ortográfica
Si Dialogflow no encuentra una respuesta, esta función verifica si hay errores ortográficos. Si los encuentra, corrige el mensaje y vuelve a consultar a Dialogflow.
- Tiene menor prioridad que la corrección de OpenAI, pero pueden trabajar juntas.
- No requiere que la Búsqueda en Google esté activa para funcionar.
#### Entidades (Entities)
Analiza el mensaje para reconocer entidades como ciudades, eventos o fechas, ayudando a filtrar resultados inválidos de Google.
**Configuración:**
1. En Google Cloud Console, seleccione su proyecto.
2. Busque y habilite la **Cloud Natural Language API**.
3. Asegúrese de que la facturación esté habilitada para el proyecto.
#### Información de Funcionamiento
- La búsqueda se realiza solo si el chatbot **no sabe la respuesta** y el mensaje tiene más de **4 caracteres**.
- Si hay resultados, se activa el contexto de Dialogflow `google-search`. Este contiene el atributo `link` con la URL del resultado.
- Puede crear un Intent que responda con ese enlace si el usuario dice algo como "cuéntame más" o "quiero saber más".
- Es totalmente compatible con el chatbot de OpenAI.
---
## **TICKETS**
Los siguientes ajustes están relacionados con la aplicación de Tickets. Esta aplicación permite a los usuarios crear conversaciones y enviar mensajes a través de una interfaz de usuario diferente a la del widget de chat tradicional.
#### Instalación
1. Diríjase a `Configuración > Apps`.
2. Simplemente haga clic en **Activo**.
---
#### Mostrar el área de tickets
A continuación se detalla cómo implementar la interfaz de tickets según su versión de ZampiBot.
#### Versión WordPress
Para mostrar los tickets, utilice el siguiente código corto (shortcode): `[sb-tickets]`
Puede insertar este shortcode en cualquier página, entrada (post) o tipo de publicación personalizada dentro de su sitio WordPress.
#### Versión Cloud
Para mostrar el área de tickets, incluya el código de inserción del chat habitual en su página y añada el atributo `&mode=tickets` al final de la URL del script.
**Ejemplo de código:**
- **Método alternativo:** puede mostrar el área de tickets insertando el código `` en cualquier página que muestre el chat.
---
# **WHATSAPP**
Los ajustes a continuación están relacionados con la integración de la aplicación de WhatsApp.
#### Instalación
1. Vaya a `Configuración > Apps`.
2. Simplemente haga clic en **Activo**.
---
#### ***WhatsApp Cloud API (Oficial)***
#### Modo de sincronización automática
***Disponible solo en la versión Cloud de ZampiBot.***
1. Haga clic en **Sincronizar ahora** y complete el procedimiento.
2. **Gestión de números:** Para añadir nuevos números, visite el [administrador de Facebook](https://business.facebook.com/wa/manage/phone-numbers/). Si añade números después de la sincronización inicial, deberá sincronizar nuevamente. Todos los números se cargarán automáticamente.
3. **Desactivar números:** Puede eliminar números específicos desde `Configuración > WhatsApp > Cloud API numbers`.
Solución de problemas (Sync Auto):
- Si al resincronizar no recibe el SMS/llamada, ingrese el último PIN recibido; debería funcionar.
- Si no recibe mensajes en ZampiBot:
- Haga clic en **Reconectar** y complete el proceso.
- Verifique en **Meta Business Suite** que haya añadido un método de pago válido.
#### Modo de sincronización manual
Siga estos pasos para configurar la API oficial en su propio servidor:
1. Cree una cuenta en [developers.facebook.com](https://developers.facebook.com) o inicie sesión.
2. Cree una nueva app. Seleccione **Conectar con clientes a través de WhatsApp** como caso de uso y elija su cuenta comercial.
3. En ZampiBot, vaya a `Configuración > WhatsApp > Cloud API > Secret key` e ingrese una cadena de texto aleatoria (ej. "miclavesecreta").
4. En Facebook Developers:
- Vaya a `Use cases > Connect with customers through WhatsApp > Customize`.
- Haga clic en **Configuration**.
- En **Callback URL**, ingrese la URL que encontrará en ZampiBot bajo `Configuración > WhatsApp > Cloud API > Configuration URL`.
- En **Verify Token**, ingrese la misma cadena aleatoria que puso en ZampiBot ("miclavesecreta").
- Haga clic en **Verificar y guardar**.
5. En **Webhook Fields**, suscríbase al evento `messages`.
6. **Pruebas:**
- Haga clic en **API testing**. Obtenga un número de prueba temporal.
- Añada su número personal como destinatario para verificarlo.
- Copie el **Phone number ID** y péguelo en ZampiBot: `Configuración > WhatsApp > Cloud API numbers > Phone number ID`.
- Genere un **Token de acceso temporal** y péguelo en ZampiBot: `Configuración > WhatsApp > Cloud API numbers > Token`.
- Envíe un mensaje de prueba desde Facebook y responda desde su WhatsApp personal; debería aparecer en ZampiBot.
**Activación para producción (Token Permanente):** Para que la integración funcione permanentemente sin caducar:
1. Vaya a [Configuración del Negocio de Facebook](https://business.facebook.com/settings).
2. Navegue a `Usuarios > Usuarios del sistema`. Cree un usuario administrador.
3. Haga clic en **Añadir Activos**, seleccione su App y marque **Control total**.
4. Vaya a `Cuentas > Cuentas de WhatsApp`, seleccione su cuenta, haga clic en **Asignar personas** y asigne al Usuario del Sistema con control total.
5. Vuelva a `Usuarios del sistema`, seleccione el usuario creado y haga clic en **Generar nuevo token**.
- Seleccione su App.
- Establezca la caducidad en **Nunca**.
- Marque los permisos: `whatsapp_business_management`, `whatsapp_business_messaging`, `business_management`.
6. Copie el token generado y péguelo en ZampiBot: `Configuración > WhatsApp > Cloud API numbers > Token`.
> \[!WARNING\] Si usa su número actual de WhatsApp Business en ZampiBot, dejará de funcionar en la app móvil de WhatsApp Business. Deberá completar un proceso de migración.
---
### **Configuración de Proveedores Externos**
#### 360dialog
1. Cree una cuenta en [360dialog](https://www.360dialog.com/).
2. En su panel, vaya a `WhatsApp Accounts` y genere una **API key**.
3. Pegue la clave en `Configuración > WhatsApp > 360dialog settings`.
4. Haga clic en **Sincronizar ahora**.
#### Twilio
1. Cree una cuenta en [Twilio](https://www.twilio.com).
2. Obtenga su **ACCOUNT SID** y **AUTH TOKEN** y péguelos en `Configuración > WhatsApp > Twilio settings`.
3. **Configuración Sandbox:**
- Vaya a `Messaging > Settings > WhatsApp sandbox settings`.
- En **WHEN A MESSAGE COMES IN**, pegue la URL de ZampiBot que encontrará en `Configuración > WhatsApp > Twilio settings > Get configuration URL`.
4. **Configuración Producción:**
- Compre un número de Twilio.
- Cree un **Messaging Service** en Twilio (`Messaging > Services`).
- Añada su número como remitente (**Sender**).
- Copie el **Service SID** y péguelo en ZampiBot en el campo **Sender**.
> \[!NOTE\] ZampiBot **no soporta APIs no oficiales** de WhatsApp. Solo funciona con Cloud API, 360dialog o Twilio.
---
\#whatsapp-templates### **Plantillas de Mensajes (Templates)**
Según las políticas de WhatsApp, no puede enviar mensajes a usuarios que no le hayan escrito en las últimas 24 horas. Para contactarlos, debe usar una **Plantilla de mensaje**.
#### WhatsApp Cloud API
1. Gestione sus plantillas en el [Administrador de WhatsApp](https://business.facebook.com/wa/manage/message-templates/).
2. En ZampiBot, vaya a `Configuración > WhatsApp > Cloud API template fallback`.
3. **Configuración de variables:**
- **Idiomas:** Ingrese los códigos de idioma soportados separados por comas (ej. `es, en_US`).
- **Header/Body variables:** Ingrese los valores dinámicos separados por comas. Puede usar campos de combinación como `{recipient_name}`. El orden debe coincidir con los parámetros de su plantilla.
- **Botones:** Si su plantilla tiene botones con URL dinámica, ingrese los enlaces. Si son estáticos, escriba `skip_parameter`.
**Enviar plantilla a usuarios nuevos:**
1. Ingrese su **ID de Cuenta Comercial** en `Configuración > WhatsApp > Cloud API numbers > Business Account ID`.
2. Vaya a la sección **Usuarios** de ZampiBot, seleccione los destinatarios y haga clic en el icono de WhatsApp en la esquina superior derecha.
---
#### Llamadas de WhatsApp
Permite iniciar llamadas de voz o video desde el panel de administración.
1. Habilite las llamadas en el Administrador de WhatsApp (`Settings > WhatsApp accounts > Settings`).
2. Cree una plantilla de tipo **Calling permissions request** (Solicitud de permiso de llamada) en Facebook.
3. Ingrese el ID de la plantilla en `Configuración > WhatsApp > Calls > Call permission template ID`.
4. Para llamar, abra el perfil de un usuario en ZampiBot y haga clic en el icono de teléfono o video.
---
#### Tienda en WhatsApp (WhatsApp Shop)
Muestre productos de su catálogo directamente en el chat.
- **Producto único:**`{catalog id="CATALOG_ID" product_id="PROD_ID"}`
- **Múltiples productos:**`{catalog id="CAT_ID" product_id_1_1="P1" section_1="Titulo Sección" ...}`
- **Webhook de Pedidos:** Configure la URL para procesar pedidos en `Configuración > WhatsApp > Order webhook`.
---
#### Información Adicional
- **Ventana de 24 horas:** Si intenta escribir a un usuario fuera de la ventana de 24 horas sin usar una plantilla, recibirá un error de "Re-engagement".
- **Mensajes Enriquecidos:** ZampiBot soporta el envío de botones y listas a WhatsApp. Si usa menús de selección con más de 3 opciones, use el atributo `whatsapp="Texto del menú"` en el shortcode.
- **Chatbot:** Totalmente compatible, incluyendo **Toma de control humana** y reconocimiento de voz (para audios de WhatsApp).
- **Limitaciones:** Twilio tiene un límite de 1600 caracteres por mensaje. Se recomienda encarecidamente usar la **API Oficial de Cloud API**.
---
\#messenger# MESSENGER
Aquí tiene la documentación completa para la integración de **Messenger (Facebook e Instagram).**
#### Instalación
1. Vaya a `Configuración > Apps.`
2. Simplemente haga clic en **Activo**.
---
#### Modo de sincronización automática
*Recomendado para la versión Cloud.*
1. Haga clic en el botón de sincronización.
2. Seleccione al menos **1 página de Facebook**.
3. Una vez completado, el sistema devolverá información que deberá verificar en `Configuración > Messenger > Facebook pages`.
**¡Listo!** Todos los mensajes nuevos enviados a las páginas de Facebook y cuentas de Instagram seleccionadas aparecerán en el área de administración de ZampiBot. *(Nota: Solo se sincronizarán los mensajes nuevos recibidos tras la activación; los mensajes antiguos no se importarán).*
---
#### Modo de sincronización manual
Siga estos pasos si necesita configurar la integración manualmente en su propio servidor:
1. Cree una cuenta o inicie sesión en [developers.facebook.com](https://developers.facebook.com).
2. Cree una nueva App:
- Nombre la aplicación.
- En **Casos de uso**, seleccione:
- **Manage messaging & content on Instagram** (Gestionar mensajería y contenido en Instagram).
- **Engage with customers on Messenger from Meta** (Interactuar con clientes en Messenger).
- **Manage everything on your Page** (Gestionar todo en tu Página).
- En la pestaña **Negocio**, seleccione "I don't want to connect a business portfolio yet" (No quiero conectar un portafolio de negocios todavía).
3. Configuración de Messenger:
- Vaya a `Use cases > Engage with customers on Messenger from Meta > Customize`.
- Haga clic en **Messenger API Setup**.
- En ZampiBot, establezca el **Modo de sincronización** en **manual** en `Configuración > Messenger`.
- Copie la **Callback URL** desde `Configuración > Messenger > Get configuration URL` y péguela en Facebook.
- Cree una cadena aleatoria (token) y péguela en `Configuración > Messenger > Secret key`. Use la misma cadena en el campo **Verify Token** de Facebook.
- **Campos del Webhook:** Seleccione `inbox_labels, message_deliveries, message_echoes, message_reactions, message_reads, messages, messaging_account_linking, messaging_handovers, messaging_optins, messaging_policy_enforcement, messaging_postbacks, messaging_referrals, feed`.
4. Generación de Tokens:
- En la sección **Generate access tokens**, haga clic en **Connect** y seleccione las páginas a sincronizar.
- En la columna **Webhook Subscription**, haga clic en **Add Subscriptions** y seleccione: `messages, messaging_postbacks, messaging_optins, message_reads, feed, message_echoes`.
- En la columna **Tokens**, haga clic en **Generate**.
- Copie el token y péguelo en ZampiBot: `Configuración > Messenger > Facebook pages` (en el campo Access Token).
- Copie también el **Page ID** y **Page Name** de Facebook y péguelos en ZampiBot. Repita para cada página.
5. Permisos:
- Vaya a `Use cases > Permissions and Features`.
- Añada: `pages_manage_metadata, pages_messaging, pages_read_engagement, pages_show_list`.
6. Sincronización de Comentarios (Opcional):
- Vaya a `Use cases > Manage everything on your Page > Customize`.
- En Permisos, añada: `pages_read_user_content, pages_manage_engagement`.
7. Sincronización de Instagram (Opcional):
- Vaya a `Use cases > Manage messaging & content on Instagram > Customize`.
- Haga clic en **API setup with Instagram login**.
- Configure el Webhook con la misma URL y Token que Messenger.
- **Campos del Webhook:**`messages, messaging_postbacks, messaging_seen, messaging_handover, message_reactions, standby, comments`.
- **Obtener Instagram ID:** Use la siguiente URL en su navegador (reemplazando los datos): `https://graph.facebook.com/FACEBOOK-PAGE-ID/?access_token=ACCESS-TOKEN&fields=instagram_business_account`
- Pegue el ID obtenido en `Configuración > Messenger > Facebook pages > Instagram ID`.
- En Permisos, añada: `instagram_basic, instagram_business_basic, instagram_manage_comments, instagram_manage_messages, instagram_business_manage_messages`.
8. **Revisión:** Haga clic en **Publish** y envíe su App a revisión para aprobar los permisos añadidos. (Nota: Nuestro soporte no cubre la asistencia para la aprobación de la App).
---
#### Vinculación de Instagram
Para vincular Instagram a su página de Facebook y ZampiBot:
1. Vaya a la configuración de su Página de Facebook: `Configuración > Cuentas vinculadas > Instagram`.
2. Haga clic en **Conectar cuenta** y complete el proceso.
3. Vuelva a sincronizar Messenger con ZampiBot para actualizar los permisos.
---
#### Comentarios
Los comentarios en sus publicaciones de Facebook e Instagram aparecerán en ZampiBot y podrá responderlos como un chat normal.
- **DM for Comments:** Permite enviar un mensaje directo automático a usuarios que comentan por primera vez en sus publicaciones. Deje el campo **Post ID** vacío para aplicarlo a todos los posts.
- **Chatbot:** El chatbot funciona en comentarios, incluyendo la **toma de control humana**. Puede desactivarlo en `Configuración > Messenger > Disable chatbot for comments`.
- **Limitaciones:** Los mensajes enriquecidos (imágenes, botones) no son compatibles en las respuestas a comentarios; solo texto.
---
#### ℹ️ Información Adicional y Solución de Problemas
- **No recibe mensajes de Instagram:**
- Verifique en la app móvil de Instagram: `Configuración > Privacidad > Mensajes > Herramientas conectadas - Permitir acceso`.
- Su cuenta de Instagram debe ser **Business** (Negocios), no Creador ni Profesional estándar.
- En **Meta Business Suite**, vaya a `Usuarios > Personas`, seleccione su cuenta de Instagram y asegúrese de tener todos los permisos activos.
- **No recibe mensajes de Facebook:** Asegúrese de no tener activas respuestas automáticas nativas de Facebook (como el mensaje de bienvenida).
- **Mensajes duplicados / Bucle infinito:** Si tiene dos instalaciones de ZampiBot conectadas a la misma cuenta, elimine el **Instagram ID** en una de ellas o use el botón **Unsubscribe** para desvincular el webhook.
- **Botón Unsubscribe:** Elimina la suscripción del webhook de todas sus páginas. Útil para detener la recepción de mensajes.
- **Usuarios:** Cada usuario de ZampiBot tiene solo 1 conversación de Facebook y 1 de Instagram.
- **Mensajes Enriquecidos:** Se convierten automáticamente cuando es posible. Botones y listas solo soportan máximo 3 opciones y funcionan principalmente en la app móvil de Instagram.
- **Privacidad:** Solo los mensajes privados llegan al inbox; las publicaciones en el muro no.
- **IA y Chatbot:** Soportan detección de idioma, corrección ortográfica, traducción y búsqueda en Google.
- **Límites:** Mensajes mayores a 1000 caracteres se truncarán. Solo se sincronizan mensajes nuevos.
**Solicitud de eliminación de datos (Versión Cloud):** Para eliminar sus datos de ZampiBot, haga clic en `Configuración > Messenger > Unsubscribe` y luego elimine su cuenta desde el panel de perfil.
---
## TWITTER (X)
Los siguientes ajustes están relacionados con la integración de la aplicación de Twitter.
#### Instalación
Siga estos pasos rigurosamente para conectar su cuenta de Twitter con ZampiBot:
1. **Registro:** Regístrese en [developer.twitter.com](https://developer.twitter.com).
- *Importante:* Asegúrese de verificar su número de teléfono en [twitter.com/settings/phone](https://twitter.com/settings/phone) o el registro fallará.
2. **Crear App:** Cree su primera aplicación ingresando un nombre y haga clic en **Get keys**.
- Copie la **API Key (Consumer key)** y la **API Key Secret (Consumer secret)**.
- Péguelas en `Configuración > Twitter` dentro de ZampiBot.
3. **Solicitar Acceso Elevado:** Solicite el acceso "Elevated" desde [este enlace](https://developer.twitter.com/en/portal/products/elevated). Haga clic en **Apply for Elevated** y complete el formulario de la siguiente manera:
- En el área *"In your words"* y en *"Will your app use Tweet, Retweet, Like, Follow, or Direct Message functionality?"*, ingrese el siguiente texto (en inglés): `I need access to the Account Activity API to start receiving Twitter Direct Messages to my chat software (ZampiBot) and to reply to them directly.`
- Desactive todos los demás campos respondiendo **No** a preguntas como: "¿Planea analizar datos de Twitter?", "¿Planea mostrar Tweets fuera de Twitter?", "¿Su producto hará disponible información a una entidad gubernamental?".
- Espere unos días a que Twitter revise y apruebe el acceso (recibirá un correo electrónico).
4. **Entorno de Desarrollo:** Una vez tenga el acceso Elevado, entre al [panel de desarrolladores](https://developer.twitter.com/en/portal/dashboard).
- Vaya a `Menú izquierdo > Products > Premium > Dev environments`.
- Bajo **Account Activity API / Sandbox**, haga clic en **Set up dev environment**.
- En **Dev environment label**, ingrese `sb` (o el mismo valor que haya ingresado en ZampiBot bajo `Configuración > Twitter > Synchronization > Dev environment label`).
5. **Autenticación:** Ingrese a la configuración de su app desde `Menú izquierdo > Projects & Apps > Su Proyecto > Su App`.
- Bajo **User authentication settings**, haga clic en **Set up** y active **OAuth 1.0a**.
- En **App permissions**, marque la opción **Read and write and Direct message** (Lectura, escritura y Mensajes directos).
- En **Callback URI / Redirect URL**, ingrese la URL que obtendrá en ZampiBot bajo `Configuración > Twitter > Get callback URL`.
- En **Website URL**, ingrese la URL de su sitio web.
6. **Tokens de Acceso:** Ingrese al área de claves desde `Menú izquierdo > Projects & Apps > Su Proyecto > Su App > Keys and tokens`.
- Bajo **Authentication Tokens**, genere el **Access Token and Secret**.
- Copie y pegue ambos valores en `Configuración > Twitter` en ZampiBot.
7. **Nombre de Usuario:** Ingrese su nombre de usuario de Twitter en `Configuración > Twitter > Your username`.
- Obténgalo de su perfil (el nombre que comienza con @ o la parte final de la URL, ej: `https://twitter.com/ZampiBot` -> `ZampiBot`).
8. **Suscripción:** Guarde los ajustes en ZampiBot y haga clic en el botón `Configuración > Twitter > Subscribe`.
¡Listo! Todos los mensajes directos enviados a su cuenta de Twitter serán recibidos en ZampiBot.
---
#### Información Adicional
- **Mensajes duplicados:** Si recibe mensajes duplicados durante las pruebas, es posible que la cuenta de Twitter que está utilizando para enviar el mensaje sea la misma que sincronizó. Intente enviar un mensaje desde una cuenta de Twitter diferente.
- **Requisitos del servidor:** Debe usar un dominio en vivo (**HTTPS**); *localhost* no es compatible.
- **Límites de respuesta:** Cuando se recibe un mensaje de un usuario de Twitter, puede enviar hasta **5 mensajes de respuesta** dentro de una ventana de 24 horas. No se pueden enviar mensajes después de 24 horas de haber recibido el último mensaje del usuario.
- **Adjuntos:** Puede enviar un máximo de 3 o 4 archivos adjuntos dependiendo del tipo de medio.
- **Mensajes enriquecidos:** Los siguientes tipos de mensajes enriquecidos de ZampiBot **no son compatibles**: control deslizante de imágenes, control deslizante (slider) y tarjetas.
- **Inteligencia Artificial:**
- El **chatbot** es compatible.
- La función de **toma de control humana** (human takeover) es compatible.
- Las funciones de IA soportadas incluyen: detección de idioma, corrección ortográfica, multilingüe vía traducción y búsqueda en Google.
---
# **TELEGRAM**
Los siguientes ajustes están relacionados con la aplicación de Telegram.
#### Instalación
1. Desde `Configuración > Apps`, haga clic en **Telegram** e ingrese su clave de licencia para instalar y activar la aplicación. Más detalles **aquí**. Si tiene la **versión Cloud**, haga clic en **Activo**.
2. Una vez instalada la aplicación, visite [https://t.me/botfather](https://t.me/botfather).
3. Si ya ha creado un bot de Telegram en el pasado, escriba el comando `/mybots`, abra su bot y haga clic en **API token**.
4. Si nunca ha creado un bot de Telegram antes, escriba el comando `/newbot` para crear un nuevo bot. El BotFather le pedirá un nombre y un nombre de usuario; ingréselos y genere el token de autenticación. Más detalles en \[suspicious link removed\].
5. Copie el token y péguelo en `ZampiBot > Telegram > Token`, luego haga clic en **Sincronizar ahora**. Su sitio web debe usar HTTPS (certificado SSL), HTTP no es compatible.
6. Ha terminado. Todos los mensajes enviados a su bot de Telegram aparecerán en el área de administración de conversaciones de Support Board.
#### Más información
- Los **mensajes enriquecidos** de ZampiBot se convierten automáticamente a mensajes enriquecidos de Telegram cuando es posible; de lo contrario, se eliminan del mensaje.
- Las conversaciones y mensajes de Telegram son compatibles con **cola y enrutamiento**.
- El **chatbot** es compatible. La función de **toma de control humana** es compatible.
- Las funciones de IA compatibles incluyen **detección de idioma**, **corrección ortográfica**, **multilingüe vía traducción** y **búsqueda en Google**.
- La función `Configuración > OpenAI > Reconocimiento de voz` no es compatible con los mensajes de audio de Telegram.
- El **mensaje de seguimiento** es compatible, pero el mensaje se envía siempre, incluso si un agente responde.
- El **mensaje offline** (fuera de línea) es compatible, pero el horario no se envía.
- Puede verificar el estado del webhook desde `https://api.telegram.org/bot/getWebhookInfo`. Reemplace `` con su token.
\#telegram-notifications#### Notificaciones
Los agentes pueden ser notificados a través de Telegram cuando llega un nuevo mensaje.
Las notificaciones se envían solo cuando es necesario, de acuerdo con los otros ajustes de notificación. Habilite Configuración > Telegram > Notificaciones > Todos los mensajes para recibir siempre notificaciones de todos los mensajes.
#### Activación
1. Navegue a `Configuración > Telegram > Notificaciones` y haga clic en **Activar**.
2. Ingrese el nombre del canal de Telegram en `Configuración > Telegram > Notificaciones > Nombre del canal`. El nombre debe coincidir exactamente con el nombre de su canal de Telegram. Este valor debe guardarse **antes** de crear el canal.
3. Abra Telegram en su teléfono o a través de la **aplicación web** y cree un **nuevo canal** utilizando el nombre definido anteriormente.
4. Después de crear el canal, edite su configuración y agregue el bot de Telegram sincronizado con Support Board como administrador.
---
# **VIBER**
Los siguientes ajustes están relacionados con la aplicación Viber.
#### Instalación
1. Desde `Configuración > Apps`, haga clic en **Activo**.
2. Cree el bot en [https://partners.viber.com/account/create-bot-account](https://partners.viber.com/account/create-bot-account).
3. Copie el token y péguelo en `ZampiBot > Viber > Token`, luego haga clic en **Sincronizar ahora**. Su sitio web debe usar HTTPS (certificado SSL), HTTP no es compatible.
4. Ha terminado. Todos los mensajes enviados a su bot de Viber aparecerán en el área de administración de conversaciones de ZampiBot
#### Más información
- Los **mensajes enriquecidos** de Support Board se convierten automáticamente a mensajes enriquecidos de Viber cuando es posible; de lo contrario, se eliminan del mensaje.
- Las conversaciones y mensajes de Viber son compatibles con **cola y enrutamiento**.
- El **chatbot** es compatible. La función de **toma de control humana** es compatible.
- Las funciones de IA compatibles incluyen **detección de idioma**, **corrección ortográfica**, **multilingüe vía traducción** y **búsqueda en Google**.
- El **mensaje de seguimiento** es compatible, pero el mensaje se envía siempre, incluso si un agente responde.
- El **mensaje offline** es compatible, pero el horario no se envía.
---
# **SLACK**
Los siguientes ajustes están relacionados con la aplicación Slack.
#### Instalación
1. Desde `Configuración > Apps`, haga clic en **Activo**.
2. Una vez instalada la aplicación, vaya a `Configuración > Slack`, haga clic en el botón **Sincronizar ahora** y siga las instrucciones.
#### ¿Tiene problemas?
La sincronización de Slack puede no ser exitosa por varias razones; a continuación se presentan las más comunes:
**Descripción del problema**
**Solución**
**Puede recibir mensajes en Slack, pero no puede enviar mensajes desde Slack a ZampiBot**
Navegue a `/zampibot/apps/slack/post.php` desde su navegador. Además, en `Configuración del espacio de trabajo > Permisos`, debe permitir que cualquiera cree canales públicos. Si tiene más problemas, comuníquese con el equipo de soporte de Slack en [https://api.slack.com/support](https://api.slack.com/support).
**La sincronización de Slack no funciona**
Verifique nuevamente si eligió o no un canal público de Slack cuando intentó sincronizar Slack. Si no lo hizo, intente sincronizar Slack una vez más, esta vez eligiendo un canal público en su lugar. El canal general es una buena opción.
#### Archivar canales manualmente
Para archivar un canal en Slack, siga estos pasos:
1. Abra el canal de Slack que desea archivar.
2. En la parte superior derecha, haga clic en el icono de engranaje y seleccione **Opciones adicionales**.
3. Haga clic en el icono de información en el área superior derecha de la pantalla, luego haga clic en el icono **Más**, y luego haga clic en **Opciones adicionales...**. Haga clic en **Archivar este canal**.
#### Vinculación de departamentos
Si la opción `Configuración > Slack > Department linking` está activa, cuando una conversación en ZampiBot se asigna a un **departamento**, se envía un nuevo mensaje al canal de Slack vinculado, informando a los usuarios de Slack que ha comenzado una nueva conversación e invitándolos a unirse al canal de Slack dedicado al usuario. Sin embargo, solo se puede acceder a la conversación completa en el canal de Slack dedicado del usuario específico.
- Obtenga los IDs de departamento en `Configuración > Misceláneas > Departamentos`.
- Obtenga los IDs de canal haciendo clic en el botón **Obtener IDs de canal**.
#### Campos de usuario
La opción `Configuración > Slack > User fields` le permite elegir qué detalles del usuario incluir en el mensaje enviado al canal principal cuando un nuevo usuario envía el primer mensaje. Puede incluir el slug de sus detalles de usuario personalizados o los siguientes slugs: `browser`, `browser_language`, `location`, `email`, `user_type`, `token`, `creation_time`, `country_code`, `current_url`, `os`, `city`, `address`, `postal_code`, `phone`, `birthdate`, `company`, `timezone`, `website`.
- **Predeterminado:**`email`, `browser`, `browser_language`, `location`.
#### Información
- Cuando un nuevo usuario envía el primer mensaje, se envía un mensaje de Slack con los detalles del usuario y un botón para unirse al canal del usuario al canal principal seleccionado durante la sincronización, o al canal vinculado al **departamento** de la conversación. Solo la cuenta de Slack utilizada durante la sincronización se unirá automáticamente al canal del usuario; otros miembros de Slack tendrán que unirse manualmente a través del botón.
- Cuando `Configuración > Slack > Vinculación de agentes` está configurado, si la conversación se asigna a un departamento, solo los agentes asignados a ese **departamento** recibirán el mensaje; si la conversación se asigna a un solo agente, solo ese agente recibirá el mensaje.
- Slack es de uso gratuito. Solo las grandes empresas pueden necesitar un plan de suscripción pago, más detalles **aquí**.
- Las notificaciones Push son compatibles con Slack; cuando los agentes envían mensajes a través de Slack, se envían notificaciones Push a los usuarios.
- Si está utilizando Dialogflow, no se recibirán mensajes en Slack si el chatbot conoce la respuesta. Una vez que la **toma de control humana** está activa, todos los mensajes de la conversación se envían a Slack.
- La aplicación Slack es compatible con **email piping** y las aplicaciones de mensajería.
- Eliminar o abandonar un canal no es compatible, solo se admite archivar un canal.
- Cuando una conversación se archiva en Support Board, el canal de Slack vinculado también se archiva.
- Al responder a través de Slack a un usuario, si el usuario es notificado por correo electrónico o mensaje de texto, se envía un mensaje de Slack para notificarle.
- Use el comando de Slack `/archive` para archivar una conversación desde Slack.
---
# **LINE**
Los siguientes ajustes están relacionados con la aplicación LINE.
#### Instalación
1. Desde `Configuración > Apps`, haga clic en **Activo**.
2. Inicie sesión en [https://developers.line.biz/console/](https://developers.line.biz/console/) o cree una nueva cuenta.
3. Cree un nuevo **Provider** y luego un nuevo **Messaging API channel**, seleccione **Messaging API** como tipo de canal.
4. Desde el área de **Basic settings** del canal, copie **Channel secret** y péguelo en `ZampiBoot > Configuración > Line > Synchronization > Channel secret`.
5. Desde el área de **Messaging API** del canal, genere un **Channel access token (long-lived)**, cópielo y péguelo en `Zampibot > Configuraciones > Line > Sincronización > Access token`.
6. Ingrese su URL de Webhook en **Webhook URL** y haga clic en **Verify**. Obtenga la URL de Webhook en `Zampibot > Configuaración > Line > Synchronization > Webhook URL`.
7. Habilite **Use webhook**.
8. Escanee el **código QR** con su aplicación móvil LINE para comenzar a escribir en su canal.
9. Desactive la configuración **Auto-reply messages**.
10. Ha terminado. Todos los mensajes enviados a su cuenta de bot de LINE aparecerán en el área de administración de conversaciones de Zampibot.
#### Más información
- Tiene 7 días desde que el mensaje del usuario final fue enviado desde WhatsApp para responder al mensaje (Nota: el texto original dice "WhatsApp", pero en este contexto se refiere a la ventana de respuesta de LINE).
- Los stickers no son compatibles.
- Los **mensajes enriquecidos** de ZampiBot se convierten automáticamente a mensajes enriquecidos de LINE cuando es posible; de lo contrario, se eliminan del mensaje.
- Las conversaciones y mensajes de LINE son compatibles con **cola y enrutamiento**.
- El **chatbot** es compatible. La función de **toma de control humana** es compatible.
- Las funciones de IA compatibles incluyen **detección de idioma**, **corrección ortográfica**, **multilingüe vía traducción** y **búsqueda en Google**.
- El **mensaje de seguimiento** es compatible, pero el mensaje se envía siempre, incluso si un agente responde.
- El **mensaje offline** es compatible, pero el horario no se envía.
---
# **WECHAT**
Los siguientes ajustes están relacionados con la aplicación WeChat.
#### Instalación
1. Desde `Configuración > Apps`, haga clic en **Activo**.
2. Visite [https://mp.weixin.qq.com/...](https://mp.weixin.qq.com/cgi-bin/readtemplate?t=register/step1_tmpl&lang=en_US) y registre una **Service account**.
3. Después del registro, ingrese al área de **Official accounts** y desde el menú de la izquierda haga clic en `Settings and development > WeChat verification`. Debe completar la verificación; toma algunas semanas y cuesta USD 99, o CNY 300 para entidades chinas.
4. Desde el menú de la izquierda, haga clic en `Settings and development > Basic configuration` y copie **Developer ID (App ID)** y **Developer Password (App Secret)**. Pegue la información en `Zampibot > Configuración > WeChat`.
5. Desde el menú de la izquierda, haga clic en `Settings and development > Basic configuration` y complete la configuración del servidor (服务器配置(已启用)). En **Server Address (URL)** ingrese la URL que obtiene de `Zampibot > Configuración > WeChat > Synchronization > Get configuration URL`. En **Token** inserte cualquier valor que desee; el mismo valor debe ingresarse en `Zampibot > Configuración > WeChat > Token`.
6. Ha terminado. Todos los mensajes enviados a su cuenta de WeChat aparecerán en el área de administración de conversaciones de ZampiBot.
#### Más información
- Si recibe un error como `{"errcode":41001,"errmsg":"access_token missing rid: 631111-470b3b22-48553870"}`, necesita incluir la dirección IP de su servidor en la lista blanca desde `Official Account > Settings and Development > Basic Configuration > IP whitelist`.
- Los archivos de WeChat y los adjuntos de ubicación no son compatibles y no son recibidos por ZampiBot.
- Los enlaces no son compatibles en WeChat, se convierten a texto.
- Los **mensajes enriquecidos** deZampiBot se convierten automáticamente a mensajes enriquecidos de WeChat cuando es posible; de lo contrario, se eliminan del mensaje.
- Las conversaciones y mensajes de WeChat son compatibles con **cola y enrutamiento**.
- El **chatbot** es compatible. La función de **toma de control humana** es compatible.
- Las funciones de IA compatibles incluyen **detección de idioma**, **corrección ortográfica**, **multilingüe vía traducción** y **búsqueda en Google**.
- El **mensaje de seguimiento** es compatible, pero el mensaje se envía siempre, incluso si un agente responde.
- El **mensaje offline** es compatible, pero el horario no se envía.
---
# **ZALO**
Los siguientes ajustes están relacionados con la aplicación Zalo.
#### Instalación
1. Desde `Configuración > Apps`, haga clic en **Activo**.
2. Regístrese en [https://developers.zalo.me/](https://developers.zalo.me/) y cree una nueva **App**. Ingrese la información requerida y guarde.
3. Copie el **Application ID** y la **Application secret key** de la aplicación que acaba de crear y péguelos en `Zampibot > Configuración > Synchronization > Zalo`.
4. Desde el menú de la izquierda, haga clic en **Webhooks** y configure la URL; obtenga la URL de `Zampibot > Configuración > Zalo > Synchronization > Webhook URL`.
5. Desde el menú de la izquierda, haga clic en **Webhooks**, copie la **OA Secret Key** y péguela en `Zampibot > Configuración > Zalo > Synchronization > OA secret key`.
6. Desde el menú de la izquierda, haga clic en **Webhooks** y habilite los siguientes eventos de webhook: `user_send_location`, `user_send_image`, `user_send_link`, `user_send_text`, `user_send_sticker`, `user_send_gif`, `user_received_message`, `user_seen_message`, `oa_send_text`, `oa_send_image`, `oa_send_list`, `oa_send_gif`, `user_send_audio`, `user_send_video`, `user_send_file`, `user_reacted_message`, `user_received_message`.
7. Desde el menú de la izquierda, haga clic en `Official Account > OA Management` y vincule su Cuenta Oficial.
8. Desde el menú superior, haga clic en `Tools > API Explorer` o vaya a [https://developers.zalo.me/tools/explorer/](https://developers.zalo.me/tools/explorer/). Como **Access token type** seleccione **OA Access Token**, haga clic en **Get Access Token** y seleccione su Cuenta Oficial. Copie el **Refresh token** y péguelo en `Zampibot > Configuración > Zalo > Synchronization > Refresh token`. Más detalles **aquí**.
9. Desde el menú de la izquierda, haga clic en **Role** y agregue un usuario de prueba como administrador. Usará este usuario para enviar mensajes a su Cuenta Oficial de Zalo y probar la integración.
10. Desde el menú de la izquierda, haga clic en `Sign up to use API > Official Account API`, habilite **User Management** y haga clic en **Submit for review**.
11. Ha terminado. Todos los mensajes enviados a su cuenta oficial de Zalo aparecerán en el área de administración de conversaciones de ZampiBot.
#### Más información
- Necesita una Cuenta Oficial de Zalo para usar esta integración. ZampiBot recibirá los mensajes enviados a su Cuenta Oficial de Zalo.
- El **mensaje enriquecido** de tipo control deslizante (slider) solo envía el primer elemento a Zalo.
- Los **mensajes enriquecidos** de Support Board se convierten automáticamente a mensajes enriquecidos de Zalo cuando es posible.
- Las conversaciones y mensajes de Zalo son compatibles con **cola y enrutamiento**.
- El **chatbot** es compatible. La función de **toma de control humana** es compatible.
- Las funciones de IA compatibles incluyen **detección de idioma**, **corrección ortográfica**, **multilingüe vía traducción** y **búsqueda en Google**.
- El **mensaje de seguimiento** es compatible, pero el mensaje se envía siempre, incluso si un agente responde.
- El **mensaje offline** es compatible, pero el horario no se envía.
---
# **ZENDESK**
Los siguientes ajustes están relacionados con la aplicación Zendesk.
#### Instalación
1. Desde `Configuración > Apps`, haga clic en **Zendesk** e ingrese su clave de licencia para instalar y activar la aplicación. Más detalles **aquí**. Si tiene la **versión Cloud**, haga clic en **Activo**.
2. Obtenga el **dominio** de la URL de su área de administración de Zendesk; copie la primera parte de la URL: `https://dominio.zendesk.com/`. Por ejemplo, el dominio de `https://zampibot.zendesk.com/agent/get-started/ticketing-system/ticketing-intro` es `zampibot`.
3. Obtenga la **clave API** (API key) desde `Menú izquierdo > Admin > Canales > API > Configuración` (*Left menu > Admin > Channels > API > Settings*). Haga clic en **Agregar token de API** (*Add API token*).
4. El **correo electrónico** es el correo de su cuenta de Zendesk.
#### Más información
- Los tickets convertidos por ZampiBot se sincronizan automáticamente cuando se envían y reciben nuevos mensajes en ZampiBot, y se vinculan a un usuario de Zendesk existente si lo hay; de lo contrario, se crea un nuevo usuario de Zendesk.
- ZampiBot vincula a los usuarios de Zendesk con los usuarios de ZampiBot a través del correo electrónico o número de teléfono.
---
# **Créditos**
Los créditos se utilizan únicamente en ZampiBot. Los créditos son utilizados por las siguientes funciones, solo en el modo de sincronización **Automático**.
El modo de sincronización **Manual** no utiliza créditos. Si no desea utilizar créditos, puede usar el modo de sincronización **Manual** y sus propias claves API.
### Funciones que consumen créditos:
- `Inteligencia Artificial > Google`: **Chatbot de Dialogflow**, **Traducciones automáticas**, **Detección de idioma** y **Multilingüe vía traducción**.
- `Inteligencia Artificial > OpenAI`: **Chatbot**, **Corrección ortográfica**, **Reescritura de mensajes** y **Reconocimiento de voz**.
- **Extracción de datos en notas** (Note data scraping).
Puede cambiar el modo de sincronización en cualquier momento desde `Configuración > Inteligencia Artificial > OpenAI > Sync mode` o `Configuración > Inteligencia Artificial > Google > Sync mode`.
---
## **Precios**
Los créditos deben adquirirse desde [https://chatbot.zampisoft.com/account/?tab=membership](https://chatbot.zampisoft.com/account/?tab=membership). A continuación se detallan los costos de las funciones que utilizan créditos:
- **Dialogflow ES:** $0.004 por solicitud.
- **Dialogflow CX:** $0.014 por solicitud.
- **Mensaje de audio Dialogflow ES:** $0.000866 por segundo de audio.
- **Mensaje de audio Dialogflow CX:** $0.002 por segundo de audio.
- **Traducciones de Google:** $0.00004 por carácter.
- **OpenAI gpt-3.5-turbo-instruct:** $0.000004 por token.
- **OpenAI gpt-3.5-turbo:** $0.000004 por token.
- **OpenAI gpt-3.5-turbo-0125:** $0.000001 por token.
- **OpenAI gpt-3.5-turbo-1106:** $0.000002 por token.
- **OpenAI gpt-5:** $0.00001 por token.
- **OpenAI gpt-5-mini:** $0.000002 por token.
- **OpenAI gpt-5-nano:** $0.0000004 por token.
- **OpenAI gpt-4:** $0.00012 por token.
- **OpenAI gpt-4-32k:** $0.00024 por token.
- **OpenAI gpt-4-turbo:** $0.00003 por token.
- **OpenAI gpt-4o:** $0.00001 por token.
- **OpenAI gpt-4o-mini:** $0.00000015 por token.
- **OpenAI gpt-4.1-nano:** $0.0000004 por token.
- **OpenAI gpt-4.1-mini:** $0.0000016 por token.
- **OpenAI gpt-4.1:** $0.000008 por token.
- **OpenAI o1:** $0.00006 por token.
- **OpenAI o1-mini:** $0.000012 por token.
- **OpenAI o3-mini:** $0.0000044 por token.
- **OpenAI o4-mini:** $0.0000044 per token.
- **OpenAI ada:** $0.0000001 por token.
- **OpenAI text-embedding-3-small:** $0.00000004 por token.
- **OpenAI audio-to-text whisper:** $0.0002 por segundo de audio.
- **OpenAI whisper:** $0.0001 por segundo de audio.
---
#### Información
- Cuando sus créditos se agoten, si la recarga automática no está habilitada, se le notificará por correo electrónico. Recibirá un máximo de dos notificaciones por correo electrónico.
- Active la **recarga automática** para evitar quedarse sin créditos.
- Cuando la recarga automática está habilitada, el crédito se recargará una vez que caiga por debajo de **1**.
Aquí tiene la documentación técnica completa para **ZampiBot**, traducida al español y adaptada con el formato y estilo solicitados.
---
/manual-de-usuario#pwa# **Progressive Web App (PWA)**
El área de administración de **ZampiBot** es una PWA (Aplicación Web Progresiva), lo que significa que puede instalarla en su escritorio, Mac, iPhone o dispositivos móviles y utilizarla como una aplicación totalmente funcional.
> \[!NOTE\]
>
> Esta función está optimizada para Google Chrome y Safari. Y es compatible con todas las versiones de ZampiBot.
#### Instalación en Escritorio (Desktop)
1. Ingrese a su área de administración.
2. Haga clic en el icono + ubicado en la parte superior derecha de la barra de URL de su navegador Chrome.
#### Instalación Móvil (Android y Windows)
1. Ingrese a su área de administración utilizando **Google Chrome**.
2. Abra el menú de configuración del navegador.
3. Desplácese hacia abajo y toque **Agregar a la pantalla principal** (*Add to Home screen*).
4. Confirme tocando **Agregar**.
#### Instalación Móvil (iPhone o Mac)
1. Ingrese a su área de administración utilizando **Safari**.
2. Presione el botón **Compartir** y seleccione **Agregar a inicio** (*Add to Home Screen*) en el menú emergente.
3. Toque **Agregar** en la esquina superior derecha para finalizar la instalación.
#### Personalización: Cambiar icono y nombre de la PWA
1. Descargue el archivo `manifest.json` proporcionado.
2. Edítelo reemplazando:
- `YOUR NAME`: Con el nombre de su marca.
- `YOUR NAME DESCRIPTION`: Con una descripción de su elección.
- `example.png`: Con la URL de su icono (debe ser de **512x512px**).
3. Mueva el archivo editado a la carpeta de instalación de ZampiBot donde se encuentra el archivo admin.php.
(Nota: Nuestro soporte no incluye asistencia para la edición de archivos; si requiere ayuda, puede contratar nuestros servicios).
---
## **Atajos de Teclado**
Los atajos de teclado del área de administración están habilitados tanto en PC como en MAC:
**Atajo**
**Descripción**
**ENTER** o **ESPACIO**
Confirma o cierra una alerta de diálogo; equivale a hacer clic en OK.
**ESC** o **CANCEL**
Rechaza una alerta de diálogo y la cierra. Cierra un lightbox.
**SHIFT + ENTER** o **CTRL + ENTER**
Añade un salto de línea en un mensaje (solo editor de administración).
**CANCEL**
En el área de conversaciones, archiva o elimina una conversación.
**CTRL + FLECHA ARRIBA/ABAJO**
Navega entre las conversaciones de la lista.
**CTRL + FLECHA DERECHA/IZQUIERDA**
Navega entre los usuarios en el área de usuarios.
**CTRL + V**
Pega una imagen del portapapeles y la envía como mensaje.
**CTRL + Clic izquierdo**
Selecciona múltiples conversaciones para realizar acciones en masa (archivar, eliminar, marcar como leído/no leído, etc.).
---
## **Parámetros de URL**
#### Chat Front-end (Widget)
Añada estos parámetros a cualquier URL de su sitio web que muestre el chat:
- `?token=TOKEN`: Inicia sesión automáticamente con un usuario existente.
- `?conversation=ID`: Abre una conversación específica. (Requiere el atributo `token` si el usuario no ha iniciado sesión).
- `?chat=open`: Abre el widget de chat automáticamente al cargar.
#### Área de Administración
Añada estos parámetros a su URL de administración (ej. `admin.php`):
- `?conversation=ID`: Abre una conversación específica.
- `?user=ID`: Abre el perfil de un usuario.
- `?setting=ID`: Abre un ajuste específico.
- `?report=ID`: Abre un reporte.
- `?area=name`: Abre un área específica (`conversations`, `users`, `settings`, `reports`).
- `?login_email=EMAIL&login_password=CONTRASEÑA`: Inicia sesión automáticamente como agente o administrador.
---
## **Calendly**
Siga estos pasos para enviar invitaciones de reserva de Calendly a través del chat:
1. Cree un tipo de evento en [Calendly](https://calendly.com/event_types/user/me).
2. Haga clic en **Compartir** y copie la URL.
3. Utilice un **mensaje enriquecido** de tipo botón en el chat de ZampiBot.
4. Incluya el atributo `success` para personalizar el mensaje de confirmación tras la reserva.
Ejemplo de código corto:
\[button link="https://calendly.com/usuario/sb" name="Agendar reunión" success="¡Gracias! Tu reunión ha sido programada."\]
---
## **Zapier**
#### Integración Manual (Todas las versiones)
La integración se basa en los **Webhooks** de ZampiBot. Cada webhook actúa como un disparador (trigger) en Zapier.
1. **Crear App en Zapier:**
- Vaya a [developer.zapier.com](https://developer.zapier.com/) y cree una nueva integración.
- Llene los campos requeridos.
2. **Configurar Trigger:**
- Vaya a `Triggers > Add Trigger`.
- En **API Configuration**, elija **REST Hook** como tipo de disparador.
- Guarde los cambios.
3. **Crear un Zap:**
- Vaya a sus Zaps y cree uno nuevo. Busque la app que acaba de crear.
- Seleccione su evento de disparo.
- Copie la **Webhook URL** proporcionada por Zapier.
4. **Configurar en ZampiBot:**
- Vaya a `Configuración > Misceláneas > Webhooks > URL`.
- Pegue la URL de Zapier, active los webhooks y guarde.
5. **Probar y Filtrar:**
- Realice una acción en ZampiBot (enviar mensaje) para probar el disparador en Zapier.
- **Importante:** Añada un paso de **Filtro** en Zapier. Como ZampiBot envía todos los webhooks a todos los Zaps, debe filtrar para que el Zap continúe solo si existe la variable deseada (ej. variable `message` para mensajes).
\[!TIP\] **Múltiples Zaps:** Para usar múltiples webhooks, añada los IDs de los Zaps separados por comas al final de la URL base en la configuración de ZampiBot. *Ejemplo:*`https://hooks.zapier.com/hooks/catch/10352851/bbad21f,aaaa66t/`
---
## 🔒 **Seguridad**
La seguridad es crítica aquí en ZampiBot. Trabajamos con expertos en seguridad que realizan auditorías periódicas. Implementamos continuamente las últimas tecnologías de seguridad y nos mantenemos actualizados sobre las amenazas más recientes. A continuación, encontrará algunas de las medidas de seguridad que se han implementado en ZampiBot.
#### Bloqueo de IP (IP Ban)
ZampiBot permite un máximo de **10 intentos fallidos de inicio de sesión** dentro de una hora. En caso de que un usuario, administrador o agente exceda este límite, no podrá acceder a su cuenta ni al área de administración durante un período de **1 hora**. Este mecanismo de bloqueo se basa en la dirección IP del usuario y sirve para disuadir ataques de fuerza bruta destinados a descubrir credenciales de acceso.
Si encuentra el error *"Too many login attempts. Please retry again in a few hours."* (Demasiados intentos de inicio de sesión. Por favor, inténtelo de nuevo en unas horas), tiene dos opciones:
1. Esperar unas horas.
2. Contactar al equipo de soporte de ZampiSoft.
#### Protección contra inyección XSS
Para prevenir ataques de inyección XSS (Cross-Site Scripting), todas las entradas de usuario sensibles se someten a un proceso de sanitización (limpieza de código malicioso).
#### Protección contra CSRF
Para prevenir ataques de falsificación de solicitudes entre sitios (Cross-Site Request Forgery o CSRF), todas las solicitudes se validan verificando la cookie de inicio de sesión y la cadena de inicio de sesión del lado del cliente.
#### Terminación de sesiones activas al actualizar usuario
Cada vez que se cambia la contraseña o los detalles de un administrador o agente, todas las sesiones activas se cierran automáticamente cuando se ejecutan operaciones sensibles o después de 1 hora.
#### Cifrado AES de 256 bits
Utilizamos cifrado AES de 256 bits para encriptar datos sensibles, como los datos de inicio de sesión de sesiones activas.
#### Protección de contraseña por nombre de archivo
ZampiBot asegura que todos los archivos subidos sean renombrados con una cadena alfanumérica aleatoria antepuesta al nombre original del archivo. Esto evita el descubrimiento de la URL y la descarga no autorizada de los archivos subidos. *Nota:* Para que esta función funcione correctamente, su servidor debe prohibir el listado de directorios (*directory listing*).
#### Conexiones cifradas MySQL
Para configurar ZampiBot y MySQL para usar conexiones cifradas, edite el archivo `config.php` de ZampiBot y agregue las siguientes constantes: `SB_DB_CERTIFICATE_PATH`, `SB_DB_CERTIFICATE_CLIENT_KEY`, `SB_DB_CERTIFICATE_CLIENT`, `SB_DB_CERTIFICATE_CA`. Ingrese los valores apropiados para cada constante.
---
\#performance## 🚀 **Rendimiento**
ZampiBot es uno de los sistemas de soporte más rápidos del mercado. El tamaño de sus archivos JavaScript y CSS es significativamente menor que el de la mayoría de los competidores, lo que garantiza tiempos de carga más rápidos. El rendimiento del lado del servidor es igualmente impresionante. El sistema es extremadamente ligero, construido sin frameworks ni código innecesario. Es modular, minimalista y totalmente optimizado para el máximo rendimiento.
Sin embargo, puede mejorar aún más el rendimiento desde: `Configuración > Misceláneas > Optimización de rendimiento`.
A continuación se describe cada ajuste de optimización disponible:
- **Minificar JS (Minify JS):** Habilite la carga de archivos JavaScript y CSS minificados para el widget de chat del frontend. Esto reduce el tamaño del archivo y mejora la velocidad de carga.
- **Desactivar reportes (Disable reports):** Desactiva el área de reportes y detiene el registro de datos de informes. Esto evita que el sistema consuma recursos para recopilar y almacenar información estadística.
- **Desactivar artículos (Disable articles):** Desactiva el área de artículos y la funcionalidad de la base de conocimientos. Esto reduce el uso de recursos al evitar que el sistema cargue artículos tanto en el lado del administrador como en el del cliente.
- **Archivar mensajes antiguos (Archive old messages):** Mueve los mensajes más antiguos que el intervalo especificado a una tabla de respaldo dedicada en la base de datos. Los mensajes archivados y sus conversaciones asociadas ya no aparecerán en las áreas de conversación del administrador o del usuario. Sin embargo, si un usuario envía un nuevo mensaje en el futuro, el sistema restaurará automáticamente la conversación y su historial. También puede acceder y restaurar manualmente las conversaciones archivadas en cualquier momento abriendo el perfil del usuario y seleccionando la conversación archivada.
- *Recomendación:* Active esta función si maneja un gran volumen de mensajes (millones). Mejorará drásticamente el rendimiento.
---
## **Personalización**
Puede personalizarla utilizando la **API de JavaScript** y la **Web API**, o mediante JavaScript y CSS personalizados. El widget de chat no utiliza un *iframe*, por lo que puede personalizarlo fácilmente con JavaScript y CSS directos.
---
## **🤝 Contrátenos**
Si desea que personalicemos ZampiBot para usted, por favor contáctenos y envíenos sus requisitos. Le proporcionaremos un presupuesto basado en la complejidad del trabajo.
- **Tarifa:** Nuestra tarifa por hora es de **50 USD.**
- **Contacto:** Puede contactarnos a través del chat en la esquina inferior derecha de la página oficial https://zampisoft.com o enviarnos un correo electrónico a servicios@zampisoft.com
- **Tiempo de respuesta:** Generalmente respondemos dentro de las 24 horas.