Gestionar usuarios

Gestione a los usuarios desde el Área de usuarios en el menú izquierdo del área de administración.

Importar usuarios

Puede importar usuarios desde Ajustes > Usuarios > Importar usuarios. Solo se admiten archivos CSV. Puede descargar un archivo CSV de ejemplo aquí. En el archivo de ejemplo, la primera fila es el encabezado y las columnas Height y Hair color son campos de usuario personalizados añadidos desde Ajustes > Usuarios > Campos personalizados.

Buscar usuarios

Puede buscar usuarios por nombre, apellido, correo electrónico y campos personalizados.

Eliminar usuarios

Puede eliminar un usuario abriendo el Cuadro de edición de usuario y haciendo clic en Eliminar usuario. Para eliminar varios usuarios a la vez, seleccione los usuarios que desea eliminar de la tabla de Usuarios y luego haga clic en el icono de eliminación en la parte superior derecha.

• 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 está activado, también se eliminarán los archivos de AWS S3.
• Si un usuario eliminado vuelve 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 uno directamente desde la tabla de usuarios. Seleccione dos usuarios cualesquiera y luego haga clic en el botón Fusionar usuarios en la parte superior.

• Cuando se fusionan dos usuarios, todas sus conversaciones se combinan bajo la nueva cuenta de usuario.
• El sistema identifica y fusiona automáticamente la información relevante de ambos usuarios en la nueva cuenta.

Columnas adicionales de la tabla de usuarios

Para mostrar columnas adicionales en la tabla de usuarios, vaya a Ajustes > Administración > Columnas adicionales de la tabla de usuarios y añada las nuevas columnas. El valor de cada columna es el slug del detalle de usuario o detalle de usuario extra que desea mostrar. El slug está en minúsculas y con los espacios reemplazados por el carácter -. Por ejemplo, el slug del detalle de usuario extra "Fecha de nacimiento" es "fecha-de-nacimiento".

Tipos de usuario

user

lead

visitor

Gestionar agentes y administradores

Gestione, cree y elimine agentes y administradores desde el Área de usuarios.

• Configure los privilegios y permisos de los agentes desde Ajustes > Administración > Privilegios de agentes.
• Se puede crear un supervisor desde Ajustes > Administración > Supervisor. El Supervisor es un agente especial con privilegios específicos, debe ser un administrador. Puede añadir múltiples supervisores agregando IDs de administrador separados por comas.
• Para crear un agente o un administrador, vaya al área de usuarios y haga clic en el botón Añadir usuario en la parte superior derecha.
• Solo los agentes y administradores pueden iniciar sesión en el área de administración de Isa.
• Cuando activa el plugin de Isa en WordPress, se crea automáticamente una cuenta de administrador utilizando el mismo nombre de usuario y contraseña que el usuario que ha iniciado sesión actualmente.

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 previo al chat utilizando el formulario de registro.
• Con el mensaje de seguimiento.
• Con los flujos del chatbot.

Registro

El formulario de registro es un formulario previo al chat que requiere que el usuario introduzca información específica antes de iniciar el chat. Úselo para exigir a los usuarios que proporcionen cierta información, como su nombre y correo electrónico, antes de iniciar un chat. Puede configurar el formulario de registro en Ajustes > Usuarios.

Información

• Puede usar el formulario de registro como un formulario previo al chat limitando la información solicitada al usuario solo a la dirección de correo electrónico o al nombre del usuario, por ejemplo. Para hacer eso, establezca la opción Requerir registro en Formulario de registro y active los campos de usuario requeridos en la lista de Campos de registro.
• El formulario de inicio de sesión se muestra solo si el campo de correo electrónico está activado.
• El campo de contraseña siempre se muestra cuando el sistema de usuarios está configurado en "WordPress".
• Puede iniciar sesión automáticamente a un usuario a través de parámetros de URL.
• Si un usuario intenta registrarse con un correo electrónico que ya está registrado, se enviará un OTP para permitirle iniciar sesión. Tenga en cuenta que en el uso real, los registros duplicados rara vez ocurren ya que los usuarios permanecen conectados en el mismo dispositivo, normalmente sucede solo durante las pruebas.

Información

OTP

La función OTP verifica el correo electrónico de un usuario durante el registro enviando 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. Actívelo desde Ajustes > Usuarios > Verificación de correo electrónico, y personalice el correo de OTP desde Ajustes > Usuarios > Correo de verificación de correo electrónico. El correo también utiliza la plantilla definida en Ajustes > Notificaciones > Plantilla de correo electrónico. Tenga en cuenta que el OTP siempre se envía — incluso si la función está desactivada — cuando un usuario intenta registrarse con un correo electrónico que ya está registrado.

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 Ajustes > Usuarios > URL de verificación de inicio de sesión en Isa. Esta función permite a Isa autenticar un inicio de sesión externo desde una fuente externa y registrar e iniciar sesión automáticamente al usuario. Isa enviará una solicitud a la URL especificada, añadiendo la dirección de correo electrónico del usuario y la contraseña introducida en el formulario de inicio de sesión del chat como parámetros de URL. Los parámetros se llaman email y password. Ejemplo: https://example.com/login.php?email=ejemplo@mail.com&password=12345678. La respuesta esperada de la URL debe ser un objeto JSON como el siguiente:

{
    "first_name": "John",
    "last_name": "Doe",
    "email": "johon@example.com",
    "profile_image": "https://isa.startupfit.co/user.svg",
    "department": null,
    "password": "",
    "details": {
        "location": [
            "Location",
            "New York, United States"
        ],
        "country_code": [
            "Country code",
            "America/New_York"
        ]
    }
}

El valor first_name es obligatorio.

Enlace de inicio de sesión y contraseña olvidada

Si un usuario olvida su contraseña, puede hacer clic en el botón Olvidé mi contraseña y se enviará un correo electrónico con un enlace de inicio de sesión a su dirección de correo electrónico registrada. Una vez que el usuario haga clic en el enlace, iniciará sesión automáticamente. Puede personalizar el correo enviado a los usuarios desde Ajustes > Usuarios > Correo de enlace de inicio de sesión. El correo utiliza la plantilla definida en Ajustes > Notificaciones > Plantilla de correo electrónico. Esta función solo está disponible si Requerir registro está configurado en Formulario de registro e inicio de sesión o Formulario de inicio de sesión.

Varios

• Los nuevos usuarios se muestran automáticamente en la tabla de usuarios en tiempo real.
• Para ver los usuarios en línea, active Ajustes > Usuarios > Registrar todos los visitantes.
• Para recibir la notificación de usuario en línea, debe activar Ajustes > Notificaciones > Notificación de usuarios en línea, Ajustes > Varios > Pusher (si está utilizando la versión en la nube, este ajuste se activa automáticamente) y Ajustes > Usuarios > Registrar todos los visitantes (activado por defecto). La función cubre todos los tipos de usuarios, incluidos visitantes y leads. Las notificaciones solo se envían una vez por usuario en un período de 24 horas.
• Los agentes y administradores pueden establecer su estado como en línea o fuera de línea desde el panel de perfil en la parte inferior izquierda. Si la opción Ajustes > Notificaciones > Modo ausente está activa, el estado fuera de línea 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 ningún clic de ratón, movimiento o pulsación de tecla. La función de estado fuera de línea automático no está habilitada en dispositivos móviles. Para que esta función funcione correctamente, debe estar habilitado Pusher.
• La tabla de usuarios utiliza auto-paginación, que está limitada a 100 resultados por scroll.

Ajustes

Horas de oficina

Puede configurar el horario de oficina desde Ajustes > Varios > Horas de oficina. Las horas de oficina se utilizan para:

• Enviar el mensaje fuera de línea.
• Desactivar y ocultar el chat durante las horas fuera de oficina.
• Desactivar el chatbot durante las horas de oficina habituales y activarlo durante las horas fuera de oficina.

Más información

• Si un día tiene solo una hora de inicio y fin, introdúzcalas en los dos primeros campos. Por ejemplo, use 10:00 AM a 5:00 PM y (vacío) a (vacío), no 10:00 AM a (vacío) y (vacío) a 5:00 PM.
• No deje valores vacíos. Configúrelos como cerrado en su lugar.
• Debe establecer los valores en cerrado si desea configurar un día completo como no laborable.
• Las horas de oficina están en formato UTC. Establezca su UTC desde Ajustes > 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 proporcionan respuestas instantáneas a los clientes para ayudar a reducir el volumen de soporte al cliente. Puede acceder a los artículos desde el menú izquierdo de Isa.

Cómo mostrar el área de artículos

• Los artículos se pueden mostrar en el panel del chat activándolos desde Ajustes > Artículos > Mostrar en el panel.
• Alternativamente, los artículos se pueden compartir en cualquier conversación de chat a través del shortcode de mensaje enriquecido, [articles].
• Siga estos pasos para mostrar los artículos en una página de su dominio y sitio web. Puede mostrarlos de tres maneras:

  • MÉTODO REST API

    Inserte el código de abajo en su página. Reemplace [ISA-URL] con la URL de su instalación de Isa y [YOUR-TOKEN] con cualquier token de administrador. Si está utilizando la versión en la nube, la URL es https://isa.startupfit.co/script/include/api.php, para obtener el token haga clic aquí, además, elimine los dos primeros scripts. Incluya el atributo nojquery => true si ya tiene jQuery incluido en su página. Incluya el atributo nojs => true si ya tiene el código de inserción del chat incluido en su página.

    <div id="sb-articles">
         <script src="[ISA-URL]/js/min/jquery.min.js"></script>
         <script id="sbinit" src="[ISA-URL]/js/main.js"></script>
         <?php
         $ch = curl_init('[ISA-URL]/include/api.php?articles=true&' . (empty($_GET['category']) ? (empty($_GET['article_id']) ? (empty($_GET['search']) ? '' : '&search=' . urlencode($_GET['search'])) : '&article_id=' . $_GET['article_id']) : '&category=' . $_GET['category']) . (empty($_GET['lang']) ? '' : '&lang=' . $_GET['lang']));
         $parameters = [
             CURLOPT_RETURNTRANSFER => true,
             CURLOPT_SSL_VERIFYPEER => false,
             CURLOPT_USERAGENT => 'Isa',
             CURLOPT_POST => true,
             CURLOPT_CONNECTTIMEOUT => 5,
             CURLOPT_POSTFIELDS => http_build_query([
                                       'token'=> '[YOUR-TOKEN]',
                                       'function' => 'init-articles'
                                   ])
         ];
         curl_setopt_array($ch, $parameters);
         $response = curl_exec($ch);
         curl_close($ch);
         echo $response;
         ?>
    </div>
    

  • MÉTODO PHP API

    Inserte el código de abajo en su página. Reemplace [ISA-URL] con su URL de instalación, obténgala de Ajustes > Varios > URL de instalación. Reemplace [ISA-PATH] con la ruta de su instalación de Isa. Este método no está disponible en la versión en la nube. Si jQuery ya está incluido en su página, no lo incluya de nuevo.

    <script src="[ISA-URL]/js/min/jquery.min.js"></script>
    <script id="sbinit" src="[ISA-URL]/js/main.js"></script>
    <link href="[ISA-URL]/css/main.css" type="text/css" rel="stylesheet">
    <link href="[ISA-URL]/css/articles.css" type="text/css" rel="stylesheet">
    <div id="sb-articles">
        <?php require('[ISA-PATH]/include/articles.php'); ?>
    </div>
    

  • MÉTODO JS

    Inserte el código de abajo en su página. Este método no se recomienda para fines de SEO, ya que los artículos se cargan asíncronamente y es posible que la página no sea indexada por los motores de búsqueda. Reemplace [ISA-URL] con su URL de instalación, obténgala de Ajustes > Varios > URL de instalación. Si está utilizando la versión en la nube, la URL es https://isa.startupfit.co/script.

    <script src="[ISA-URL]/js/min/jquery.min.js"></script>
    <script id="sbinit" src="[ISA-URL]/js/main.js"></script>
    <script>var SB_ARTICLES_PAGE = true;</script>
    <div id="sb-articles" class="sb-loading"></div>
    

  • MÉTODO WORDPRESS

    Si está utilizando la versión de WordPress, puede usar el shortcode [sb-articles]. Este método solo es compatible con la versión de WordPress.

  La página muestra las categorías de artículos, debe añadir categorías padre y asignarles artículos. Los artículos se mostrarán en la misma ubicación que el código anterior. Puede ocultar el widget de chat añadiendo el código JS var SB_DISABLED = true; a la página.

Navegación de una sola página

La navegación de una sola página del artículo aparece automáticamente en todos los artículos. Se genera a partir de los bloques de encabezado h2 y h3 del artículo.

Reescritura de URL

Puede habilitar la reescritura de URL desde Ajustes Artículos > Reescritura de URL. Las URL predeterminadas de Isa no son amigables para el usuario e incluyen parámetros. Puede reescribir las URL a través del archivo .htaccess. El código de abajo 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.

<IfModule mod_rewrite.c>
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]
</IfModule>

Cambie articles por el nombre de su página de artículos y establezca la URL de la página de artículos en Ajustes > Artículos > URL de la página de artículos.

Idioma

• Puede añadir nuevas traducciones de artículos abriendo un artículo. Haga clic en el icono + en la parte superior derecha y seleccione el idioma al que desea traducir el artículo. Para eliminar una traducción, coloque el cursor sobre el icono de la bandera del idioma y haga clic en el icono de la papelera.
• Puede añadir nuevas traducciones de categorías abriendo una categoría. Haga clic en el icono + en la parte superior derecha y seleccione el idioma al que desea traducir la categoría. Para eliminar una traducción, coloque el cursor sobre el icono de la bandera del idioma y haga clic en el icono de la papelera.
• Puede habilitar la traducción automática de artículos y categorías activando tanto la función multilingüe vía traducción como Ajustes > Artículos > Idioma > Traducción automática. También tiene que establecer el idioma predeterminado de sus artículos en Ajustes > Artículos > Idioma > Idioma predeterminado. El idioma utilizado para la traducción automática es el idioma del usuario detectado por Isa. También puede forzar un idioma específico añadiendo el parámetro de URL lang=CÓDIGO-DE-IDIOMA.
• El menú de idiomas se muestra en la parte inferior del artículo. Muestra todas las traducciones disponibles del artículo.
• Si hay al menos un artículo traducido en el idioma del usuario, solo se muestran los artículos traducidos en la página de categoría o en la página principal. De lo contrario, todos los artículos se muestran en el idioma original.
• Fuerce la visualización de la página de artículos en un idioma específico añadiendo el parámetro de URL lang=CÓDIGO-DE-IDIOMA. Reemplace CÓDIGO-DE-IDIOMA con el código de idioma de dos letras.

Más información

• Si utiliza categorías, todos los artículos deben estar asignados a una categoría.
• Puede crear un enlace de chat interno a un artículo con el mensaje enriquecido de botón.
• Puede crear un enlace a un artículo específico con el atributo de URL article=ID, reemplace ID con el ID del artículo. Ejemplo: https://isa.startupfit.co/articles-demo?article=Ucsx6.
• Puede crear un enlace a una categoría de artículo con el atributo de URL category=ID, reemplace ID con el ID de la categoría. Ejemplo: https://isa.startupfit.co/articles-demo?category=LnNaZ.
• Los artículos siempre se incluyen en el entrenamiento de su chatbot de OpenAI. Si actualiza un artículo, deberá entrenar el chatbot de nuevo, 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 e inténtelo de nuevo.
• 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

Isa es totalmente multilingüe y proporciona funciones potentes para detectar el idioma del usuario sobre la marcha.

Idioma del chat

Isa ya está traducido a más de 45 idiomas. Hay muchas opciones disponibles para establecer el idioma:

• OPCIÓN 1 Vaya a Ajustes > Chat y verifique la opción Idioma. Establézcalo en multilingüe para usar automáticamente el idioma del navegador del usuario o el idioma guardado en el perfil de usuario.
• OPCIÓN 2 Añada el parámetro de URL lang=CÓDIGO-DE-IDIOMA al script que carga el chat, reemplazando "CÓDIGO-DE-IDIOMA" con el código de idioma de dos letras que desea mostrar. Ej. https://isa.startupfit.co/isa/js/main.js?lang=es o https://isa.startupfit.co/account/js/init.js?id=123456&lang=es para la versión en la nube.
  Esta función obligará al chat a usar siempre el mismo idioma y se ignorará la opción Ajustes > Chat > Idioma. Consulte wikipedia.org/wiki/List_of_ISO_639-1_codes para ver la lista completa de códigos de idiomas (consulte la columna 639-1). Para chino tradicional use zt, para chino simplificado use zh, para portugués brasileño use pt.
• OPCIÓN 2 - SOLO WORDPRESS Vaya a Ajustes > WordPress y establezca la opción Forzar idioma. Esta función obligará al chat a usar siempre el mismo idioma y se ignorará la opción Ajustes > Chat > Idioma.
• OPCIÓN 3 - SOLO WORDPRESS La versión para WordPress de Isa utiliza 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 complementos multilingües. Esta función se desactiva automáticamente si la opción Ajustes > Chat > Idioma está activa.

Idioma de administración

Para traducir el área de administración, siga los pasos a continuación:

• Traduzca los textos a su idioma desde Ajustes > Traducciones.

Para establecer el idioma del área de administración tiene tres opciones:

• Active la opción Ajustes > Admin > 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.
• Edite el archivo config.php dentro de su directorio de instalación de Isa e ingrese el código define('SB_ADMIN_LANG', 'CÓDIGO-DE-IDIOMA'); al final del contenido del archivo. Reemplace CÓDIGO-DE-IDIOMA con el código del idioma que desea usar, use solo 2 letras, por ejemplo, inserte solo es, no es_ES. Esta opción no está disponible en la versión en la nube.

Traducciones de chatbots y mensajes

Para traducir automáticamente los mensajes del chatbot y otros textos, use la aplicación de Inteligencia Artificial y siga los pasos descritos quí.

Editar y añadir nuevas traducciones

Puede traducir casi cualquier contenido personalizado como mensajes enriquecidos, mensajes integrados, departamentos, encabezado de chat y más. Para añadir una nueva traducción o editar una traducción existente, siga los pasos a continuación:

• Vaya a Ajustes > Traducciones, si desea añadir una nueva traducción, haga clic en Nueva traducción.
• 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 código \n.
• Ingrese la traducción correspondiente en el segundo campo. Para añadir saltos de línea, use el código \n.
• Si tiene la aplicación de inteligencia artificial, también puede traducir todos los contenidos a cualquier idioma automáticamente a través de la función multilingüe vía traducción.

Añadir un nuevo idioma

Para añadir un nuevo idioma, siga los pasos a continuación:

• A través de FTP o un Administrador de archivos, vaya a isa\resources\languages\front.
• Duplique (copie y pegue en el mismo directorio) el archivo isa\resources\languages\front\source.json.
• Renombre el archivo con el código de idioma que desea añadir. Consulte wikipedia.org/wiki/List_of_ISO_639-1_codes para ver la lista completa de códigos de idiomas (consulte la columna 639-1).
• Vaya a Ajustes > Traducciones y el nuevo idioma debería aparecer automáticamente.

Para añadir un nuevo idioma para el área de administración, siga exactamente los mismos pasos, pero use la carpeta admin en su lugar. Los nuevos idiomas no se perderán ni se eliminarán en las actualizaciones del plugin.

Información

• Para eliminar traducciones de correos electrónicos, artículos y más, coloque el cursor sobre el icono de la bandera del idioma y haga clic en el icono de la papelera.
• Si falta una cadena de traducción, añádala 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 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 guarda una traducción, se crea una copia de seguridad en la carpeta uploads. La copia de seguridad se restaura automáticamente al actualizar y activar el plugin.
• Algunos caracteres especiales como & se reemplazan por el código HTML equivalente (consulte https://www.w3schools.com/html/html_entities.asp). Ej. & se reemplaza por &amp;.
• También puede añadir cadenas de traducción faltantes por código. Edite los archivos de idioma ubicados en isa\resources\languages. Después de editar un archivo, las nuevas cadenas serán visibles en Ajustes > Traducciones. Recuerde hacer clic en Guardar cambios para preservar sus traducciones y evitar perderlas cuando se actualice Isa.

Departamentos

Los departamentos permiten a los usuarios elegir con qué departamento quieren hablar. Active los departamentos desde Ajustes > Departamentos > Departamentos. Para empezar a usar los departamentos, siga los pasos a continuación:

• Vaya a Ajustes > Varios y añada, elimine y gestione los departamentos. Después de guardar, recargue la página.
• Vaya a Usuarios > Agentes y edite un agente, verá un nuevo campo donde puede establecer el departamento del agente.
• ¡Recargue la página y listo! En el área de Conversaciones, ahora verá una opción para establecer el departamento.

Ajustes

• Mostrar en el panel Muestra la lista de departamentos en el panel del chat y obliga a los usuarios a elegir un departamento antes de iniciar una conversació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.
• Una conversación por departamento Restringe a los usuarios de abrir múltiples conversaciones dentro del mismo departamento, permitiendo solo una conversación activa por departamento.
• Etiqueta Reemplace la etiqueta Departamentos (plural) con otro texto. El nombre se muestra en el área de administración y de tickets.
• Etiqueta individual Reemplace la etiqueta Departamento (singular) con otro texto. El nombre se muestra en el área de administración y de tickets.
• Título del panel Establezca el título de la lista del panel del chat. Por defecto: Departamentos.

Cómo funciona

• Los agentes y administradores sin 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 se asigna una conversación 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 conjunto de datos de Q&A o la función acciones de flujos.

Cómo asignar un departamento a una conversación

Puede asignar un departamento a una conversación de varias maneras:

• A través de la función conjunto de datos de Q&A.
• A través de la función acciones de flujos.
• A través de Ajustes > Varios > Ajustes de departamentos > Mostrar en el panel. En este caso, se requerirá que el usuario seleccione un departamento antes de iniciar una nueva conversación.
• A través de Ajustes > Automatizaciones > Más.
• A través de JavaScript, con la variable var SB_DEFAULT_DEPARTMENT = ID;. Ingrese el código en las páginas donde se muestra el chat y reemplace ID con el ID del departamento. Para más detalles consulte la API aquí.
• A través de la API.

Cola y enrutamiento

Cuando se activa la cola a través de Ajustes > Varios > Cola, o se activa el enrutamiento a través de Ajustes > Varios > Enrutamiento, Isa asigna automáticamente las conversaciones de los usuarios a todos los agentes disponibles proporcionalmente.

• Solo los agentes en línea se cuentan como agentes "disponibles" y recibirán nuevas conversaciones. Las conversaciones se asignan proporcionalmente entre todos los agentes en línea. Si no hay agentes en línea, la conversación permanecerá sin asignar y se asignará automáticamente al primer agente que se conecte.
• Los administradores no están incluidos; los administradores siempre ven todas las conversaciones.
• Los agentes deben archivar una conversación para marcarla como completada; esto les dará acceso automáticamente a la siguiente conversación en la cola. Una conversación está activa si no ha sido eliminada ni archivada.
• Los agentes pueden cambiar su estado entre en línea y fuera de línea pasando el cursor sobre su imagen de perfil y luego haciendo clic en la etiqueta del panel desplegable de perfil en la parte inferior izquierda del área de administración.
• Los agentes solo pueden buscar y filtrar sus propias conversaciones.
• Los agentes solo pueden ver sus propias conversaciones; sin embargo, pueden ver todas las conversaciones de un solo usuario.
• Para permitir que los agentes vean todas las conversaciones sin asignar, active Ajustes > Varios > Ocultar conversaciones de otros agentes y Ver conversaciones sin asignar.
• La cola y el enrutamiento son compatibles con los departamentos.
• Si la intervención humana está activa, la cola o el enrutamiento se activan tan pronto como el chatbot asigna la conversación a un agente humano.
• Cuando el enrutamiento o la cola están activos, el menú de agentes se habilitará automáticamente.

Más información - Solo cola

Cuando se activa la cola, los usuarios entran en una cola automáticamente cuando se alcanza el límite de chat de un agente. Cuando un usuario entra en la cola, se muestra un mensaje con la posición actual en la cola y el tiempo de espera estimado. Isa asigna automáticamente las conversaciones a todos los agentes disponibles proporcionalmente. Cuando un agente marca una conversación como completada (archivándola), la cola se actualiza y se recibe una nueva conversación.

• Si un usuario está en la cola y sale (ej. cerrando el navegador) por más de 1 minuto, la conversación se guarda; sin embargo, una vez que el usuario regresa, la cola se reinicia y el usuario perderá su posición anterior. Si el usuario sale, la conversación permanece sin asignar y, por lo tanto, es invisible para los agentes, pero solo visible para los administradores.
• Puede usar los siguientes campos de combinación en el mensaje de la cola: {position}, {minutes}. Serán reemplazados por los valores reales en tiempo real.
• El tiempo de espera se muestra en minutos y se calcula de la siguiente manera: posición en la cola X tiempo de respuesta = tiempo de espera. Por ejemplo, si un usuario es el 5º en la cola, y el tiempo de respuesta se ha establecido en 4 minutos (vía Ajustes > Varios > Cola), entonces el tiempo de espera total mostrado al usuario será de 20 minutos.
• Cuando la opción de sonido está activa, se reproduce un sonido cuando es el turno del usuario.
• Para las conversaciones iniciadas desde aplicaciones de mensajería como WhatsApp, no es posible respetar el límite de conversaciones por agente, todas las conversaciones se asignarán inmediata y proporcionalmente a un agente en línea. Si no hay agentes en línea, la conversación permanecerá sin asignar y se asignará automáticamente al primer agente que se conecte.
• Use el mensaje fuera de línea para evitar que el chat muestre el mensaje de actualización de la cola al usuario.

Para probar la cola, siga los pasos a continuación:

• Para simular múltiples usuarios y agentes, abra el chat en múltiples navegadores diferentes (ej. Opera, Firefox, Brave, Chrome, etc.). Cada navegador puede simular dos usuarios/agentes: uno en modo normal y otro en modo "privado" o "incógnito".
• Para reiniciar el chat y comenzar una nueva sesión de usuario, abra la consola del navegador, ingrese SBF.reset() y presione ENTER.

Más información - Solo enrutamiento

Cuando se activa el enrutamiento, Isa asigna automáticamente las conversaciones de los usuarios a todos los agentes disponibles proporcionalmente.

• Si la opción Enrutamiento > Desactivar verificación de estado en línea está activa, las conversaciones se distribuyen proporcionalmente entre todos los agentes, independientemente de si están en línea o fuera de línea.
• Cuando un agente vuelve a estar en línea después de haber estado fuera de línea, todas las conversaciones sin asignar se le asignan automáticamente.
• Cuando el enrutamiento está activo, los agentes pueden enrutar manualmente las conversaciones a otros agentes desde el panel derecho del área de conversaciones.
• Si la conversación se archiva y el usuario la vuelve a abrir en el futuro enviando un nuevo mensaje, si el agente asignado en la conversación está fuera de línea, la conversación se asigna a otro agente.

Enrutamiento manual

Cuando se activa el enrutamiento a través de Ajustes > Varios > Ocultar conversaciones de otros agentes, los agentes ven solo sus propias conversaciones y pueden seleccionar las que no están asignadas.

• Menú de agentes: habilite el menú de agentes.
• Enrutamiento si está fuera de línea: si la conversación se archiva y el usuario la vuelve a abrir en el futuro enviando un nuevo mensaje, si el agente asignado en la conversación está fuera de línea, la conversación se asigna a otro en línea si hay al menos uno, de lo contrario a ningún agente.
• Ver conversaciones sin asignar: permite a los agentes ver las conversaciones sin asignar, cuando un agente responde, la conversación se le asigna automáticamente y la conversación se elimina en tiempo real del área de administración de los otros agentes. Marque esta opción para habilitar el enrutamiento manual.

Menú de agentes

El Menú de Agentes le permite asignar conversaciones a agentes específicos. Aparece en el lado derecho del área de conversaciones y se habilita automáticamente cuando la cola o el enrutamiento están activos. Seleccione múltiples conversaciones (ver atajos de teclado) para asignar las conversaciones seleccionadas a un agente específico.

Asignar un agente a una conversación

Puede asignar un agente a una conversación de varias maneras:

• A través de la función conjunto de datos de Q&A.
• A través de la función acciones de flujos.
• A través de las funciones de cola o enrutamiento.
• Al habilitar la opción Ajustes > Chat > Menú de agentes. En este caso, se requerirá que el usuario seleccione un agente antes de iniciar una nueva conversación.
• A través de Ajustes > Automatizaciones > Más.
• A través de JavaScript, con la variable var SB_DEFAULT_AGENT = ID;. Ingrese el código en las páginas donde se muestra el chat y reemplace ID con el ID del agente. Para más detalles consulte la API aquí.
• A través de la API.

Email piping

Email piping le permite sincronizar múltiples direcciones de correo electrónico para recibir mensajes directamente en Isa. También le permite a usted, a sus agentes y a los usuarios responder a los mensajes del chat por correo electrónico.

Activation

• Vaya a Ajustes > Notificaciones > Email piping e ingrese la información de su servidor de correo POP3/IMAP.
• Vaya a Ajustes > Notificaciones > SMTP e ingrese la información de su servidor de correo SMTP. La dirección de correo electrónico debe ser la misma a la que se conecta el servidor de email piping. Isa enviará todos los correos electrónicos desde esta dirección y usted, sus agentes y sus usuarios responderán a esta dirección. Para más detalles consulte la sección de notificaciones por email.

Information

• La dirección de correo electrónico de Ajustes > Notificaciones > SMTP > Email del remitente debe coincidir con la utilizada por el servidor de email piping. Si la dirección no coincide, o si se configuran múltiples direcciones para email piping, y el ajuste de Nombre de usuario se define como una dirección de correo, Isa incluirá automáticamente un campo reply-to en la notificación por correo. Esto asegura que cuando el usuario responda, su respuesta se dirija a la dirección de email piping correcta, manteniendo la conversación vinculada adecuadamente.
• Los ajustes de Notificaciones > Notificaciones de email del usuario y Notificaciones > Notificaciones de email del agente se habilitan automáticamente cuando el email piping está activo. Cuando los agentes responden en Isa, los correos siempre se envían al usuario.
• If you're using the Artificial Intelligence app, and the human takeover feature is activated, no emails are sent if the chatbot knows the answer.
• Si la opción Convertir todos los correos está activa:
  • Todos los correos enviados a su bandeja de entrada se convertirán en mensajes de chat; tenga en cuenta que todos los correos, incluidos el spam, correos promocionales y más, también se convertirán erróneamente.
  • Los correos enviados por direcciones de correo de agentes y administradores serán ignorados, use otra dirección de correo para las pruebas.
  • Cada correo enviado directamente a la dirección de email piping generará una nueva conversación de usuario.
• No puede usar la misma dirección de correo electrónico utilizada para el email piping para responder. Todos sus agentes y administradores de Isa deben usar una dirección de correo diferente.
• Los agentes deben responder por correo electrónico desde la misma dirección de correo registrada en Isa.
• El correo se envía a los agentes solo si están fuera de línea. Si están en línea, no se envían correos.
• Para los correos de Google Gmail y Google Workspace, debe reemplazar su contraseña de Google por una contraseña de aplicación de Google, detalles en https://support.google.com/accounts/answer/185833 (sección Crear y usar contraseñas de aplicación). Ingrese imap.gmail.com como host y 993 como puerto. También debe permitir el acceso a Gmail a aplicaciones menos seguras, puede hacerlo desde https://myaccount.google.com/lesssecureapps. Si usa Google Workspace con un dominio personalizado, consulte Consola de administración > Seguridad > Control de acceso y datos > Controles de API > Control de acceso de aplicaciones. Asegúrese de que el acceso SMTP no esté restringido para aplicaciones de terceros.
• Email piping requiere el módulo php5-imap (módulo IMAP). Si no está instalado en su servidor, puede instalarlo con el comando apt-get install php5-imap. Si tiene problemas, contacte con el soporte de su hosting/servidor.
• La opción Delimitador añade un texto en la parte superior de todos los correos:
  ### Escriba su respuesta por encima de esta línea ###
  . Este texto le indica a Isa que elimine todo el contenido debajo de él y es útil para recortar todas las citas de respuesta. Actívelo si ve mensajes duplicados en el chat. Si esta opción está activa, usted y sus usuarios no pueden usar la cadena ### en los correos.
• Se admiten archivos adjuntos de correo electrónico.
• Para que el email piping funcione, las respuestas por correo deben contener el nombre del destinatario de Isa. Ej. Isa | SB2457-4734 <ejemplo@email.com>. Todos los principales clientes de correo como Outlook Web, Outlook, Gmail, Yahoo Mail, admiten el nombre del destinatario por defecto a través de la respuesta del chatbot o los botones de responder a todos.
• Debido a la naturaleza de cómo funcionan los correos electrónicos, cada cliente de correo utiliza sus códigos personales, delimitadores, cadenas automáticas y más. Por esta razón, algunos mensajes de chat convertidos de correos pueden contener textos no válidos. Estamos trabajando para optimizar tantos clientes de correo como sea posible, por ahora, los siguientes clientes de correo están optimizados y no deberían devolver ningún texto no válido: Outlook Web, Outlook, Gmail, Yahoo Mail.
• Email piping admite departamentos; si la conversación del usuario está asignada a un departamento, las notificaciones por correo se envían solo a los agentes asignados a ese departamento.
• Si el correo incluye el atributo reply-to, este servirá como la dirección de correo principal del usuario y las notificaciones se enviarán a ese correo.
• La opción Filtros le permite filtrar los correos electrónicos que se convierten en mensajes de chat. Añada palabras clave separadas por comas. Si el cuerpo del correo, el asunto o el remitente contiene una de las palabras clave, el correo no se convertirá en un mensaje de chat.

Tarea programada (Cron job)

• Isa intenta procesar los correos electrónicos a través de tareas programadas cada 60 segundos, detalles aquí.
• Si está utilizando la versión en la nube, la tarea programada ya está activada por defecto y se ejecutará al menos una vez cada 60 minutos.
• Puede activar manualmente la ejecución y acelerar las tareas programadas a través de la API con la función PHP sb_email_piping(), o la función de la API WEB email-piping.
• Puede crear una tarea programada que ejecute la URL [URL-DE-ISA]/include/api.php?piping=true. Use el comando */59 * * * * wget [URL-DE-ISA]/include/api.php?piping=true para ejecutarlo mediante un comando. Reemplace [URL-DE-ISA] con su URL de instalación. Para obtener la URL, siga estos pasos:
  Si utiliza la versión WP o PHP, vaya a Ajustes > Varios > URL de instalación. Si utiliza la versión en la nube, use esta URL: https://isa.startupfit.co/script/include/api.php?piping=true&cloud=TOKEN-API y reemplace TOKEN-API con su token de API.
• También puede usar este archivo de tarea programada: descargar. El comando de la tarea programada es php -f RUTA-DE-SU-ARCHIVO/cron.php.
• Si ejecuta manualmente la tarea programada, active la opción Desactivar tarea programada para evitar que Isa la active manualmente y para mejorar el rendimiento.

Mensajes directos

Los mensajes directos le permiten enviar un único mensaje de chat, correo electrónico o mensaje de texto a un solo usuario o a varios. Lea la información a continuación para comprender cómo funciona.

• Para enviar un mensaje, vaya al área de Usuarios y haga clic en el icono de mensaje directo. Los botones de mensaje directo también están disponibles en el cuadro de perfil del usuario.
• Para enviar un mensaje a todos los usuarios, ingrese All en el campo IDs de usuario.
• Para enviar un mensaje a un grupo de usuarios, ingrese sus IDs en el campo IDs de usuario. Puede marcar los usuarios y luego hacer clic en el icono de mensaje directo para ingresar los IDs automáticamente.
• Todos los tipos de mensajes admiten campos de combinación.
• Todos los tipos de mensajes admiten la traducción automática.

Mensaje de chat directo

• El mensaje de chat se envía a la conversación activa, si la hay, de lo contrario a una nueva conversación.
• Si la opción Ajustes > Notificaciones > Notificaciones de email del usuario está activa, todos los usuarios con un correo electrónico son notificados por correo.
• Si la opción Ajustes > Notificaciones > Notificaciones de mensajes de texto > Activa para usuarios está activa, todos los usuarios con un número de teléfono son notificados por mensaje de texto.
• Si la opción Ajustes > Notificaciones > Notificaciones push está activa, se envía una notificación push a todos los usuarios.
• El mensaje también se envía a aplicaciones de mensajería como WhatsApp y Messenger si el usuario está conectado a ellas.
• Para enviar un mensaje a todos los usuarios de una sola aplicación de mensajería, ingrese una de las siguientes cadenas: whatsapp, messenger, instagram, telegram, twitter, zalo, wechat, viber, line. Ingrese tickets para enviar un mensaje solo a los usuarios que crearon un ticket de Isa a través de la aplicación Tickets.

Correo electrónico directo

• Establezca la plantilla de correo electrónico desde Ajustes > Notificaciones > Plantilla de correo electrónico.
• El lenguaje HTML es compatible.
• El asunto admite campos de combinación.

Mensajes de texto directos

• Para habilitar los mensajes de texto directos, debe habilitar los SMS en Ajustes > Notificaciones > Notificaciones de mensajes de texto.

Mensajes de plantilla de WhatsApp directos

Para más detalles haga clic aquí.

Automatizaciones

Las automatizaciones le permiten a su bot realizar acciones específicas cuando se cumplen ciertas condiciones.

• Para crear una automatización, vaya a Ajustes > Automatizaciones y haga clic en Añadir nueva automatización.
• Puede elegir entre varios Disparadores:
  • Bot de chat: El chatbot no puede responder una pregunta.
  • Mensaje del usuario: El usuario envía un nuevo mensaje.
  • Mensaje del agente: Un agente envía un nuevo mensaje.
  • Nueva conversación: Se crea una nueva conversación.
  • Nuevo usuario: Se crea un nuevo usuario.
• Puede añadir múltiples Condiciones, todas las condiciones deben cumplirse para que se ejecute la automatización.
• Puede añadir múltiples Acciones, todas las acciones serán ejecutadas.

Condiciones

Las siguientes condiciones están disponibles:

• Tipo de usuario: El usuario es un invitado, un usuario registrado o un agente.
• Idioma: El idioma del usuario.
• Departamento: El departamento de la conversación.
• Fuente: La URL de la página del usuario o la fuente de la aplicación de mensajería.
• Mensaje: El texto del mensaje. Esta condición está disponible solo para disparadores relacionados con mensajes.

Acciones

Las siguientes acciones están disponibles:

• Enviar mensaje: Enviar un mensaje al usuario.
• Establecer departamento: Establecer el departamento de la conversación.
• Establecer agente: Establecer el agente de la conversación.
• Añadir etiqueta: Añadir una etiqueta a la conversación.
• Cerrar conversación: Cerrar la conversación.
• Intervención humana (Human takeover): Activar la intervención humana.

Boletín informativo (Newsletter)

Puede suscribir automáticamente a sus nuevos usuarios a su boletín de noticias de Mailchimp y otros servicios.

• Para habilitar la integración del boletín, vaya a Ajustes > Boletín, elija su servicio e ingrese los detalles requeridos.
• Para mostrar una casilla de verificación de suscripción al boletín en el formulario de registro o en el formulario de inicio, active la opción Mostrar casilla de verificación de suscripción.
• Los servicios admitidos son: Mailchimp, Brevo, SendGrid, Elastic Email, Campaign Monitor, HubSpot, Moosend, GetResponse, ConvertKit, ActiveCampaign, MailerLite, Mailjet, Sendy, SendFox, Klaviyo, Acumbamail.

Intervención humana (Human takeover)

La intervención humana permite que el chatbot redirija la conversación a un agente humano en situaciones específicas.

Información general

• Cuando se activa la intervención humana, el chatbot se desactiva automáticamente mientras el último agente humano que respondió a la conversación esté en línea. Si ningún agente ha respondido aún, el chatbot permanecerá activo. Después de eso, el chatbot se activa nuevamente, pero no se enviarán mensajes de respuesta predeterminados (fallback) dentro de los 10 días posteriores a la intervención humana si el chatbot no sabe la respuesta a la pregunta del usuario en la misma conversación.
• El chatbot se activa completamente de nuevo si la conversación se archiva o elimina.
• Si está utilizando Slack, no se enviarán mensajes si el chatbot conoce la respuesta. Una vez que la intervención humana esté activa, todos los mensajes de la conversación se enviarán a Slack.
• Cuando un agente humano responde a un usuario, la intervención humana se activa automáticamente.
• Para desactivar completamente el chatbot durante la intervención humana, marque la opción Intervención humana > Desactivar chatbot.
• Si la intervención humana ya está activa, no se activará de nuevo y no se enviará el mensaje de intervención humana. En su lugar, se enviará el mensaje de fallback.
• La función Ajustes > Inteligencia Artificial > Intervención humana > Mensaje de fallback envía un mensaje de respuesta automática cuando un usuario envía un nuevo mensaje mientras la intervención humana está activa. Es útil para informar a los usuarios que sus mensajes han sido recibidos y que un agente responderá pronto. El mensaje de fallback se envía como máximo una vez cada 30 minutos y solo si el nuevo mensaje del usuario se envía más de 30 minutos después de la última respuesta del agente.
• La intervención humana funciona sin problemas en todas las aplicaciones de mensajería, como WhatsApp, Messenger, Telegram y otras. Los usuarios no necesitan hacer clic en un botón de confirmación; cualquier respuesta de texto que confirme la solicitud activará la intervención humana automáticamente.

Opción de intervención humana

Cuando la opción Intervención humana está activa, sucede lo siguiente:

• Si está habilitada, la solicitud se envía solo si el mensaje enviado por el usuario tiene más de 3 caracteres y contiene al menos dos palabras. Esta optimización evita solicitudes erróneas.
• Las conversaciones a las que el chatbot pudo responder correctamente se marcan como leídas y se mueven al final de la lista de la Bandeja de entrada (Inbox).

Cuando el usuario confirma la intervención humana, o si es automática, sucede lo siguiente:

• La conversación se marca como no leída y se mueve a la parte superior de la Bandeja de entrada.
• Cualquier mensaje futuro del usuario en la misma conversación enviado dentro de los 10 días posteriores a la intervención humana activará las notificaciones para agentes.
• Las notificaciones se envían de acuerdo con sus ajustes; consulte notificaciones para más detalles.
• No se enviarán más solicitudes de intervención humana dentro de los 10 días posteriores en la misma conversación.
• El mensaje de seguimiento y el mensaje fuera de línea se activan.
• Si los ajustes de cola están activos, se activa la cola o el enrutamiento.
• Si la opción desactivar fuera del horario de oficina está activa, la intervención humana se desactiva fuera del horario de oficina o si todos los agentes están fuera de línea. Más detalles aquí.

Intervención humana manual

• La intervención humana puede ser solicitada manualmente por el usuario pidiendo explícitamente contactar con un agente humano. Este ajuste está activo por defecto.

Intervención humana vía Q&A

Puede habilitar la intervención humana para mensajes de usuario específicos a través de Q&A añadiendo la acción intervención humana (human takeover) en establecer datos y acciones.

Asistente de OpenAI

Para habilitar la intervención humana en un Asistente de OpenAI, añada la siguiente función en el área de funciones de OpenAI:

                                {
                                    "name": "sb-human-takeover",
                                    "description": "I want to contact a human support agent or team member. I want human support.",
                                    "parameters": {
                                        "type": "object",
                                        "properties": {},
                                        "required": []
                                    }
                                }
                            

Respuesta inteligente (Smart reply)

La Respuesta inteligente sugiere respuestas rápidas en tiempo real durante una conversación. Una vez activa, verá las respuestas sugeridas en el área de conversación, si las hay.

Información

• La Respuesta inteligente devuelve sugerencias de su chatbot de OpenAI.
• Si la función de detección de idioma está activa, las respuestas inteligentes también utilizarán la detección de idioma.
• Si la función multilingüe mediante traducción está habilitada, las respuestas inteligentes también utilizarán la traducción multilingüe.
• Para leer el texto completo de una respuesta inteligente, coloque el puntero del ratón sobre ella durante 3 segundos.
• Para restaurar el mensaje anterior, presione los atajos de teclado CTRL + Z.

Optimal configuration for the chatbot

Isa provides powerful tools to assist you in the process of creating the chatbot.

• Keep improviding the chatbot from the chatbot training panel.
• Siga mejorando el chatbot desde el panel de entrenamiento del chatbot.
• Active Inteligencia Artificial > Respuesta inteligente. Más detalles hier.
• Active los siguientes ajustes de OpenAI: Chatbot, Corrección ortográfica, Botón para reescribir mensajes. Más detalles aquí.
• Entrene a su chatbot de OpenAI con su propio contenido, más detalles aquí.
• Si su sitio web recibe tráfico de varios países, considere activar las siguientes opciones de Google: multilingüe mediante traducción, traducción automática, detección de idioma.
• Cambie el nombre del chatbot desde Ajustes > Usuarios > Nombre del bot.

¿Problemas?

Las razones más frecuentes por las que OpenAI o Google no funcionan correctamente se enumeran a continuación. Para obtener más detalles sobre el problema, abra las herramientas para desarrolladores del navegador y luego la pestaña de consola (console), envíe un mensaje a través del chat de Isa y debería aparecer un error en la consola. En Chrome, puede abrir la consola desde Ajustes > Más herramientas > Herramientas para desarrolladores > Consola.

OpenAI y Google

• Hay una intervención humana activa.
• Puede contratarnos para que realicemos la sincronización por usted; más detalles en la página de contratación.

OpenAI

• Haga clic en el botón Ajustes > Inteligencia Artificial > OpenAI > Solucionar problemas y compruebe si hay algún error. Si hay un error, estará relacionado con su cuenta de OpenAI; siga las instrucciones del mensaje de error para solucionar el problema.
• Asegúrese de marcar la opción Ajustes > Inteligencia Artificial > OpenAI > Chatbot.
• Ha alcanzado el límite de cuota o está experimentando problemas de facturación con su cuenta de OpenAI. Compruébelo en https://platform.openai.com/account/usage.
• Si el chatbot no responde en absoluto y tiene algún ajuste de Google activo, intente desactivar los ajustes de Google y compruebe si el chatbot funciona.
• Asegúrese de leer la información general.
• Si el entrenamiento no funciona como se espera (por ejemplo, si el chatbot no responde a preguntas relevantes de los datos de entrenamiento y no se muestran errores de entrenamiento), puede haber problemas de permisos de archivos. Para solucionar esto, asegúrese de que la carpeta de subidas (uploads) incluya la carpeta embeddings. Debe existir y contener archivos. Este problema solo afecta a las versiones de PHP o WordPress; si utiliza la versión en la nube, ignore este punto.
• Si el entrenamiento no funciona como se espera, intente eliminar todos los datos de entrenamiento desde Chatbot > Entrenamiento > Información > Eliminar todos los datos de entrenamiento y entrene al chatbot de nuevo.
• Si el entrenamiento no funciona como se espera (por ejemplo, si las respuestas del chatbot se cortan o son parcialmente incorrectas), intente hacer la misma pregunta unas cuantas veces más. Las respuestas deberían mejorar con el tiempo. OpenAI necesita aprender de las interacciones con el usuario.
• Si sus datos de entrenamiento provienen de un sitio web y el sitio web es multilingüe, asegúrese de que el atributo lang de la etiqueta <html> contenga el idioma correcto.
• Elimine todos sus ajustes de OpenAI, deje solo la clave de OpenAI e inténtelo de nuevo.
• Intente usar el asistente de OpenAI en su lugar.
• Si utiliza la versión en la nube, puede usar nuestra clave de OpenAI configurando Ajustes > Inteligencia Artificial > OpenAI > Modo de sincronización en Automático. Si esto resuelve sus problemas, significa que el problema se origina en su propia cuenta de OpenAI. Necesita comprar créditos para usar esta opción.

Google

• Haga clic en el botón Ajustes > Inteligencia Artificial > Google > Solucionar problemas y compruebe si hay algún error. Si hay un error, estará relacionado con su cuenta de Google; siga las instrucciones del mensaje de error para solucionar el problema.
• Si su sincronización no tuvo éxito, le sugerimos revisar nuestra documentación y repetir los pasos de sincronización para corregir cualquier error. Si es necesario, ofrecemos servicios de integración. Más detalles en la página de contratación.

OpenAI

Los ajustes a continuación están relacionados con la aplicación de Inteligencia Artificial.

Sincronización

Modo de sincronización automático

Esta función está disponible solo en la versión en la nube de Isa.

• El modo de sincronización automática está listo para usar y no requiere ajustes adicionales. Establézcalo en Ajustes > Inteligencia Artificial > OpenAI > Modo de sincronización.
• Si desea activar el chatbot, marque Ajustes > Inteligencia Artificial > OpenAI > Chatbot.
• Necesita comprar créditos para usar esta opción.

Modo de sincronización manual

La integración de OpenAI (ChatGPT) le da a su chatbot la capacidad de responder preguntas generales sobre casi cualquier cosa que pueda imaginar. Para comenzar a usarlo, siga los pasos a continuación.

• Register at https://platform.openai.com/.
• Get an API key from https://platform.openai.com/api-keys and paste it into Settings > Artificial Intelligence > OpenAI > API key. If you are using the cloud version, set Settings > Artificial Intelligence > OpenAI > Sync mode to Manual.
• Enable the chatbot from Settings > Artificial Intelligence > OpenAI > Chatbot.

Chatbot

To set up your first chatbot, follow these steps:

Integraciones del chatbot

Las siguientes integraciones están disponibles en Ajustes > Inteligencia Artificial y pueden usarse para mejorar las capacidades del chatbot de OpenAI. Las integraciones son conversacionales, multilingües y compatibles con cualquier aplicación de mensajería como WhatsApp, Messenger, Telegram y más.

Google Calendar

Habilite esta integración para permitir que el chatbot de OpenAI acceda a su Google Calendar, de modo que los usuarios puedan agendar citas y gestionarlas en su calendario.

Tareas

• Reservar un evento: El chatbot puede agendar eventos en su Google Calendar en nombre del usuario.
• Actualizar un evento: El chatbot puede actualizar un evento existente para un usuario en su Google Calendar.
• Cancelar un evento: El chatbot puede cancelar un evento existente para un usuario en su Google Calendar.
• Listar eventos: El chatbot puede listar los eventos de un usuario de su Google Calendar.
• Mostrar horarios de reserva disponibles: El chatbot puede mostrar los horarios de reserva disponibles.

Configuración

• Vaya a Ajustes > Inteligencia Artificial > Integración con Google Calendar y haga clic en Activar.
• Haga clic en Ajustes > Inteligencia Artificial > Google > Sincronizar y complete el proceso de sincronización.
• Establezca los horarios de reserva disponibles en Ajustes > Varios > Horario de oficina programado.
• Ya ha terminado. El chatbot ahora puede agendar y gestionar eventos en su Google Calendar.

Información

• El ajuste Duración de la franja es la duración del evento agendado.
• El ajuste Tiempo de margen (Buffer) se utiliza para añadir un margen (en minutos) entre las reservas para que no se agenden citas una tras otra sin pausa.
• El ajuste Tiempo mínimo de reserva es el tiempo mínimo (en minutos) requerido para agendar un evento desde el momento actual. Se utiliza para evitar reservas demasiado cercanas al tiempo presente.

TidyCal

Habilite esta integración para permitir que el chatbot de OpenAI acceda a su cuenta de TidyCal, de modo que los usuarios puedan agendar citas y gestionarlas en su cuenta de TidyCal.

Tareas

• Reservar un evento: El chatbot puede agendar eventos en su TidyCal en nombre del usuario.
• Actualizar un evento: El chatbot puede actualizar un evento existente para un usuario en su TidyCal.
• Cancelar un evento: El chatbot puede cancelar un evento existente para un usuario en su TidyCal.
• Listar eventos: El chatbot puede listar los eventos de un usuario de su TidyCal.
• Mostrar horarios de reserva disponibles: El chatbot puede mostrar los horarios de reserva disponibles.

Configuración

• Vaya a Ajustes > Inteligencia Artificial > Integración con TidyCal y haga clic en Activar.
• En su cuenta de TidyCal, vaya a Integrations > Advanced > API Keys o haga clic aquí. Cree un Token de acceso personal (Personal Access Token), cópielo y péguelo en Ajustes > Inteligencia Artificial > Integración con TidyCal > Token de acceso. Luego, guarde los cambios.
• Ingrese el título del tipo de reserva que desea utilizar en Ajustes > Inteligencia Artificial > Integración con TidyCal > Título del tipo de reserva y guarde los cambios.
• Configure los horarios de reserva disponibles, los tiempos de margen antes y después de las reservas y la duración de la franja directamente en su cuenta de TidyCal.
• Ya ha terminado. El chatbot ahora puede agendar y gestionar eventos en su cuenta de TidyCal.

Información

• Solo se admiten eventos sin precio.
• El tipo de reserva seleccionado se guarda en caché durante 24 horas. Si lo actualiza, es posible que deba esperar hasta 24 horas para que los cambios surtan efecto. Para aplicar los cambios de inmediato, cree un nuevo tipo de reserva o cambie su título y actualícelo en los ajustes de Isa.

Ajustes

Consulte información sobre la mayoría de los ajustes de OpenAI aquí.

Modo del chatbot

Esta función está relacionada con la opción Ajustes > Inteligencia Artificial > OpenAI > Modo del chatbot. Le permite configurar la información que OpenAI utilizará para responder a los mensajes del usuario.

• Solo preguntas generales OpenAI responderá solo a preguntas generales y preguntas relacionadas con mensajes previos del usuario en la misma conversación, sin utilizar ninguna información que usted proporcione. Este es el ajuste por defecto.
• Solo preguntas relacionadas con sus fuentes OpenAI solo responderá a preguntas relacionadas con la información que usted proporcione. Los mensajes del usuario serán ignorados. Primero debe entrenar al chatbot con sus fuentes.
• Todas las preguntas OpenAI responderá a preguntas relacionadas con la información que usted proporcione, a preguntas generales y a preguntas relacionadas con mensajes previos del usuario en la misma conversación. Primero debe entrenar al chatbot con sus fuentes. Este es el modo recomendado.
• Asistente Use este modo si está utilizando un Asistente de OpenAI.

Conversación casual (Small talk)

Esta función habilita preguntas y respuestas genéricas preestablecidas que permiten al chatbot gestionar conversaciones casuales, corteses y sociales como "Hola", "¿Cómo estás?" o "Cuéntame un chiste", haciendo que los bots se sientan más humanos y atractivos, en lugar de centrarse solo en tareas.

Asistente

Esta función le permite utilizar sus propios Asistentes creados en https://platform.openai.com/assistants.

• Si utiliza la versión en la nube, debe configurar Ajustes > Inteligencia Artificial > OpenAI > Modo de sincronización en Manual y usar su propia clave de API.
• Puede utilizar múltiples asistentes añadiendo sus IDs en Ajustes > Inteligencia Artificial > Asistentes de OpenAI - Vinculación de departamentos y seleccionando Asistente en Ajustes > Inteligencia Artificial > OpenAI > Modo del chatbot. Para activar un asistente, tanto el asistente como las conversaciones deben estar asignados a un departamento.
• El asistente se utiliza solo para el chatbot y las respuestas inteligentes, no para la reescritura de mensajes y otras funciones.

Chatbot

Seleccione el ajuste Modo del chatbot para especificar las preguntas que el chatbot es capaz de responder. Utilice la función de intervención humana para permitir que el chatbot redirija el chat a un agente humano según sea necesario.

Mensaje de reserva (Fallback message)

El mensaje de reserva se envía cuando OpenAI no puede entender la pregunta del usuario.

Instrucción (Prompt)

La instrucción (prompt) indica a OpenAI cómo responder proporcionando información relevante que puede utilizarse para contestar las consultas de los usuarios. Para comprender el proceso, consulte los ejemplos de prompts que se enumeran a continuación.

Si decide activar la función de intervención humana, debe indicar a OpenAI que responda con No lo sé si no puede proporcionar una respuesta a la pregunta del usuario. Siempre debe incluir el siguiente texto en el prompt: Responda "No lo sé" si no está seguro de la respuesta.

Las respuestas de las fuentes de entrenamiento pueden utilizarse con la función de prompt, ya que son compatibles.

Corrección ortográfica

Esta función corrige automáticamente cualquier error ortográfico en el mensaje del agente.

Idioma de los datos de entrenamiento

Si utiliza datos de entrenamiento y su chatbot es multilingüe, establezca aquí el idioma predeterminado de los datos de entrenamiento. Déjelo como predeterminado (default) si el idioma por defecto de los datos de entrenamiento es el inglés.

Respuesta inteligente (Smart reply)

Esta función permite habilitar la Respuesta inteligente también si el chatbot no está activo. Si el chatbot está activo, la función de Respuesta inteligente utilizará OpenAI automáticamente.

Reconocimiento de voz (Speech recognition)

OpenAI admite el uso de mensajes de voz a través del reconocimiento de voz. Cuando esta opción está activa, los mensajes de audio se convertirán en texto escrito.

• No es necesario activar esta función para que el chatbot entienda los mensajes de audio. La función de reconocimiento de voz del chatbot siempre está habilitada.
• Para que esta función trabaje mejor, se debe conocer el idioma del usuario. Para detectar automáticamente el idioma del usuario, puede habilitar la función de detección de idioma.
• El texto se mostrará junto al reproductor de audio.
• El texto generado es compatible con las funciones de traducción.

Análisis de imágenes y archivos

Cuando esta opción está habilitada, el chatbot analiza e interpreta imágenes y archivos enviados por los usuarios. Para ver la lista de archivos compatibles, haga clic aquí. Los archivos subidos se almacenan temporalmente en su cuenta de OpenAI y se eliminan inmediatamente después de que OpenAI devuelva una respuesta.

• Solo los modelos GPT-4 y más recientes admiten esta función.
• Esta función no funciona en localhost; requiere un servidor en línea o AWS S3.

Enlaces a las fuentes

Cuando esta opción está activa, la respuesta incluirá automáticamente los enlaces a las fuentes y datos de entrenamiento utilizados para generar la respuesta. Para incluir artículos como fuentes, primero debe configurar la página de artículos en Ajustes > Artículos > URL de la página de artículos.

Extracción de datos en notas

Cuando esta opción está activa, verá un menú en el panel de notas. El menú permite la extracción automática de información específica de los mensajes del usuario, como detalles de inicio de sesión, URLs o incluso el resumen de la conversación.

Parámetros de OpenAI

Isa le permite ajustar varios parámetros de OpenAI como la temperatura y logit_bias; para más detalles visite https://platform.openai.com/docs/api-reference/completions/create. No establezca ningún valor si no sabe qué hacen estos parámetros, o de lo contrario OpenAI podría dejar de funcionar.

Sesgo de logit (Logit bias)

El parámetro Sesgo de logit (Logit bias) debe ser una cadena JSON y las claves deben ser cadenas, por ejemplo: {"2435":-100, "640":-100}.

Generar preguntas de usuario

Cuando esta opción está activa, OpenAI generará nuevas preguntas de usuario en tiempo real cuando abra el panel de entrenamiento del chatbot.

Usar conversaciones para el entrenamiento

Utiliza automáticamente las conversaciones para entrenar al chatbot a intervalos regulares. Encontrará los datos de entrenamiento en Chatbot > Entrenamiento > Conversaciones. el entrenamiento se realiza mediante un cron job cada 24 horas. Solo se utilizan los mensajes del usuario y del agente; los mensajes del chatbot se ignoran. Más detalles aquí.

Reconocimiento del contexto

Cuando esta opción está habilitada, OpenAI reconocerá el contexto de la página web desde la cual el usuario está escribiendo el mensaje. El contexto incluye solo los textos del título meta y la descripción meta de la página. Esta opción solo es compatible con el widget de chat y no es compatible con los canales de mensajería.

Reescritura de mensajes

Esta función añade un botón al campo de texto del área de conversación; haga clic en él para reescribir su mensaje y hacerlo más amigable y profesional.

• Los saludos se añadirán automáticamente si no hay mensajes previos del agente.
• Si su idioma no es el inglés, actualice su perfil de agente o administrador y seleccione el idioma correcto.
• Configure la Instrucción (Prompt) para guiar a OpenAI sobre cómo reescribir los mensajes.
• Establezca el Modo de ejecución en automático para reescribir todos los mensajes, o en sentimiento negativo para reescribir solo los mensajes marcados como negativos por el análisis de sentimiento de OpenAI.

Entrenamiento

Con esta función, su chatbot puede someterse a un entrenamiento utilizando su sitio web, textos, documentos PDF y más. Una vez que el entrenamiento se haya completado con éxito, el chatbot podrá responder preguntas relacionadas con sus contenidos.

Entrenamiento mediante archivos

Este proceso de entrenamiento le permite entrenar al chatbot utilizando archivos PDF y TXT.

• Para acceder a esta función, navegue a Chatbot > Entrenamiento > Archivos.
• Seleccione sus archivos, haga clic en el botón Entrenar chatbot y espere a que finalice el proceso de entrenamiento.
• Solo es posible subir archivos en formatos PDF y TXT.
• Tan pronto como se completa el entrenamiento, los archivos subidos son eliminados.

Entrenamiento mediante un sitio web

Este proceso de entrenamiento le permite entrenar al chatbot utilizando sitios web.

• Para acceder a esta función, navegue a Chatbot > Entrenamiento > Sitio web.
• Ingrese las URLs del sitio web, haga clic en el botón Entrenar chatbot y espere a que finalice el proceso de entrenamiento.
• Si vuelve a entrenar el mismo sitio web, primero debe eliminar los datos de entrenamiento del sitio anterior; de lo contrario, solo se entrenarán las nuevas URLs.
• Puede proporcionar la URL del sitio web y todas las URLs secundarias serán incluidas y rastreadas, pero con sitios web grandes, es más eficiente y menos propenso a errores y bucles de enlaces infinitos utilizar un sitemap XML en lugar de depender de la URL del sitio web. Puede crearlo con un servicio como https://www.xml-sitemaps.com.
• Si desea entrenar a su chatbot utilizando páginas específicas de su sitio web en lugar de todas ellas, puede hacer uso de un sitemap XML. Cree uno utilizando una herramienta como https://www.xml-sitemaps.com, y luego elimine las páginas que no desee incluir editando el archivo en un editor de texto. Para usar el sitemap XML, debe subirlo a su servidor o a una ubicación externa en línea. Después, añada la URL del sitemap en Chatbot > Entrenamiento > Sitio web. Si su sitemap contiene más de 1000 URLs, es recomendable dividirlo en múltiples archivos y entrenar al chatbot con un archivo a la vez para evitar caídas del servidor.
• Puede subir archivos grandes y su sitemap XML con un servicio como https://tmpfiles.org.

Entrenamiento mediante preguntas y respuestas

Este proceso de entrenamiento le permite entrenar al chatbot añadiendo preguntas y respuestas de forma individual.

• Para acceder a esta función, navegue a Chatbot > Entrenamiento > P&R.
• Para más detalles, haga clic aquí.

Entrenamiento mediante artículos

Este proceso de entrenamiento le permite entrenar al chatbot utilizando los artículos.

• Para entrenar al chatbot, añada sus artículos y luego haga clic en el botón Entrenar chatbot. Los artículos se utilizan como fuentes de entrenamiento automáticamente.
• Para más detalles, haga clic aquí.

Entrenamiento mediante flujos

Este proceso de entrenamiento le permite entrenar al chatbot utilizando los flujos.

• Para acceder a esta función, navegue a Chatbot > Flujos.
• Para más detalles, haga clic aquí.

Entrenamiento mediante conversaciones

Este proceso de entrenamiento le permite entrenar al chatbot utilizando las conversaciones de los usuarios y agentes.

• Para habilitar esta función, marque la opción Ajustes > Inteligencia Artificial > OpenAI > Usar conversaciones para el entrenamiento.
• Los datos de entrenamiento comenzarán a generarse en los próximos días y estarán disponibles en el área Chatbot > Entrenamiento > Conversaciones.
• Aunque este método es potente y automatizado, puede producir datos de entrenamiento de baja calidad si las respuestas de sus agentes humanos o los mensajes de los usuarios no son útiles o son incorrectos. Recomendamos encarecidamente revisar los datos de entrenamiento con regularidad. Este método no es recomendable para la mayoría de los chatbots. Utilice el panel de entrenamiento del chatbot en su lugar.

Entrenamiento mediante el panel de entrenamiento del chatbot

Una vez que haya terminado de entrenar a su chatbot, es posible que desee seguir mejorándolo. Esta función le permite seleccionar mensajes de las conversaciones y utilizarlos para añadir nuevas preguntas y respuestas o mejorar las existentes. Puede abrir el panel de entrenamiento del chatbot desde el área de conversación pasando el ratón sobre un mensaje, abriendo el menú del mensaje y seleccionando Entrenar chatbot.

• El chatbot de OpenAI se entrenará automáticamente con la nueva información. Puede controlar las preguntas y respuestas generadas desde esta ventana en Chatbot > Entrenamiento > Preguntas y respuestas.
• La ventana de entrenamiento no es compatible con los asistentes de OpenAI.

Entrenamiento mediante información en tiempo real

Esta función permite que el chatbot responda a preguntas que requieren información en tiempo real, como por ejemplo: "¿Cuál es la temperatura hoy en Londres?".

• Para más detalles, haga clic aquí.

Información

• Para añadir nuevos datos de entrenamiento, simplemente vuelva a entrenar al chatbot. Los datos de entrenamiento anteriores no se perderán, y solo se añadirán las nuevas fuentes.
• Si utiliza la versión en la nube, existen límites de caracteres para entrenar al chatbot. Sin embargo, si utiliza la versión PHP o WP, no hay límites impuestos. Puede ver los límites de caracteres aquí.
• El modelo de embeddings es esencial para entrenar a su chatbot y procesar todos los mensajes de los usuarios. Actualmente utilizamos el modelo text-embedding-3-small. Es necesario para estos escenarios y no se puede desactivar ni cambiar. Puede encontrar información sobre precios en https://openai.com/pricing. Consulte los precios del modelo text-embedding-3-small en la sección de Embedding models.
• Vaya a Chatbot > Entrenamiento > Información y haga clic en el botón Eliminar todos los datos de entrenamiento para borrar todos los datos de entrenamiento anteriores del chatbot.
• Los embeddings se almacenan como archivos JSON en la carpeta de subidas (uploads) de Isa y están protegidos mediante el enfoque de contraseña-en-nombre-de-archivo.

Ejecutar el entrenamiento mediante cron job

Si utiliza la versión en la nube, solo tiene que habilitar la opción Ajustes > Inteligencia Artificial > OpenAI > Entrenamiento mediante cron job y el cron job se activará. Puede ignorar las instrucciones a continuación.

Para entrenar automáticamente al chatbot con el contenido de su sitio web a intervalos regulares, cree un cron job que ejecute la URL [ISA-URL]/include/api.php?open-ai-training=true, o use el comando */59 * * * * wget [ISA-URL]/include/api.php?open-ai-training=true para ejecutarlo desde la línea de comandos. Reemplace [ISA-URL] con su URL de instalación, que puede obtener en Ajustes > Varios > URL de instalación. Si utiliza la versión en la nube, use esta URL: https://isa.startupfit.co/script/include/api.php?open-ai-training=true&cloud=API-TOKEN y reemplace API-TOKEN con su token de API.

• Para la versión en la nube, el cron job se puede ejecutar como máximo una vez cada 7 días.
• Recomendamos encarecidamente proporcionar un sitemap XML en lugar de la URL del sitio web por razones de rendimiento.
• El entrenamiento automático se limita a sitios web; los archivos, P&R y artículos están excluidos. El re-entrenamiento eliminará los datos de entrenamiento anteriores del sitio web.

Entrenamiento multilingüe

Si su base de usuarios es multilingüe, puede entrenar al chatbot con contenido en varios idiomas y limitar al chatbot para que recupere respuestas solo de las fuentes en el idioma del usuario. Para activar esta función, marque la opción Ajustes > Inteligencia Artificial > OpenAI > Fuentes de entrenamiento multilingües.

• Archivos: Actualmente los archivos solo admiten un idioma.
• Sitios web: El idioma del sitio web se detecta automáticamente. Para que Isa comprenda el idioma de sus páginas web, la etiqueta <html> debe contener el atributo lang.
• P&R: Actualmente P&R solo admite un idioma.
• Artículos: Todos los idiomas de los artículos se utilizan automáticamente.
• Conversaciones: Si la traducción automática está activa, solo se utilizarán los mensajes en el idioma del agente.

P&R

La información a continuación está relacionada con la sección de Preguntas y Respuestas del área de entrenamiento del chatbot. Añada preguntas y respuestas al chatbot para mejorar su rendimiento. El chatbot utilizará esta información para responder a las consultas de los usuarios.

Pregunta

Ingrese los mensajes del usuario que activarán la respuesta. Añada tantas variaciones de preguntas como sea necesario. Por ejemplo, las preguntas para la respuesta ¡Soy un chatbot! podrían ser ¿Quién eres?, ¿Qué eres?, ¿Eres un bot?.

Respuesta

Ingrese el texto que se utilizará para responder a la pregunta del usuario.

Llamada a herramientas (Tools calling)

Para más detalles, vaya aquí.

Establecer datos y acciones

Establezca los valores de usuario especificados cuando se realice la pregunta. Verá dichos valores en el panel de detalles del usuario. Puede utilizar los siguientes campos de combinación para asignar valores extraídos de los mensajes del usuario. Incluya estos campos en la respuesta y se reemplazarán con los valores reales: {language}. También puede utilizar esta función para realizar acciones como asignar departamentos, agentes y etiquetas a la conversación.

Flujos

La información a continuación está relacionada con el área de flujos del chatbot disponible en Chatbot > Flujos. Los flujos le permiten crear fácilmente flujos de conversación impulsados por el chatbot. Úselos para guiar al usuario hacia un objetivo específico con una serie de mensajes predefinidos.

Bloques de flujo

• Inicio (Start): Utilice el bloque de inicio para establecer cuándo deben comenzar los flujos. Puede ser cada vez que el usuario inicie una nueva conversación, cuando envíe un mensaje específico o al cargar la página. Si establece condiciones, el flujo solo comenzará cuando se cumplan todas las condiciones. Si establece un departamento, el flujo solo comenzará para las conversaciones asignadas a ese departamento. Si establece una fuente, el flujo solo comenzará para las conversaciones de esa fuente, por ejemplo, WhatsApp o Instagram.
• Enviar mensaje: Envía un mensaje al usuario.
• Enviar opciones: Envía una lista de botones al usuario o le permite elegir uno. Cuando el modo conversacional está habilitado, los botones se ocultan, el chatbot envía solo texto y los usuarios seleccionan opciones respondiendo con texto. La IA interpreta el mensaje y selecciona la opción correspondiente, continuando el flujo como si se hubiera presionado el botón. Esto crea una experiencia más natural, tipo chat, y se activa automáticamente, solo cuando es necesario, en canales de mensajería como WhatsApp e Instagram. Si la respuesta del usuario no coincide con ninguna opción, se enviará un mensaje de reserva con las opciones disponibles. Puede añadir variaciones a los textos de los botones separándolos con el carácter |, por ejemplo: Sí|Claro|Por supuesto. Esto ayudará a la IA a comprender la respuesta del usuario.
• Enviar video: Envía un video al usuario.
• Obtener detalles del usuario: Obtiene los detalles del usuario y los almacena en Isa. Verá dichos valores en el panel de detalles del usuario. Puede dejar el campo descripción vacío para los detalles predeterminados, pero es obligatorio si utiliza campos de usuario personalizados. Tenga en cuenta que los detalles del usuario no se guardarán si prueba este flujo en el playground, ya que el usuario allí es temporal. Para ver los detalles guardados, pruebe el flujo con un usuario real.
• Establecer datos: Establece los valores de usuario especificados cuando se ejecuta el bloque. Verá dichos valores en el panel de detalles del usuario.
• Acciones: Ejecuta las acciones especificadas cuando se ejecuta el bloque.
• Condiciones: Úselo para crear diferentes ramas en el flujo. Si se cumplen las condiciones, el flujo seguirá la rama establecida como verdadero (true); de lo contrario, la establecida como falso (false).
• Rest API: Úselo para enviar datos a su servidor. El cuerpo debe ser un array JSON. Los detalles como el ID de usuario y el ID de conversación se incluyen automáticamente en los datos enviados a su servidor bajo la clave sb. Use la sección guardar respuesta para guardar detalles de usuario especificados con valores de la respuesta de su servidor. Utilice la notación de punto JSON. Nuestro soporte no incluye asistencia con esta función, ya que es para usuarios avanzados y requiere código personalizado en su servidor. Para obtener ayuda con esto, no dude en contratarnos.
• Llamada a herramientas (Tools calling): Para más detalles, vaya aquí.
• Conector de flujo: Conecta el flujo con otro flujo y lo inicia.

Información

• Los flujos pueden ser multilingües. Añada traducciones para mensajes, textos de botones y otro contenido en el área de traducciones. También puede usar la función de multilingüe mediante traducción para traducciones automáticas. Si el idioma predeterminado de sus flujos no es el inglés, también debe establecer el idioma predeterminado en Ajustes > Inteligencia Artificial > OpenAI > Idioma de las fuentes de entrenamiento.
• Los usuarios pueden retroceder a pasos anteriores y actualizar detalles introducidos previamente de manera conversacional. Por ejemplo, podrían decir "Perdón, puse el correo equivocado", "Necesito actualizar mi correo y teléfono", o incluso un mensaje general como "Perdón, puse mal los datos, vuelve atrás", lo que los devolverá al paso anterior.

Llamada a herramientas (Tools calling)

La llamada a herramientas permite conectar el chatbot con herramientas y sistemas externos para recuperar la información necesaria para responder al usuario. El chatbot consultará a su servidor y devolverá la información de su servidor al usuario. Los datos enviados a su servidor se encuentran en el cuerpo e incluyen la entrada del usuario, el ID de usuario y el ID de conversación. La llamada a herramientas es utilizada por P&R y Flujos. Más detalles aquí. Nuestro soporte no incluye asistencia con esta función, ya que es para usuarios avanzados y requiere código personalizado en su servidor. Para obtener ayuda con esto, no dude en contratarnos.

Parámetros

• URL: Ingrese la URL del punto final de la API (endpoint) que suministrará los valores necesarios para la función.
• Encabezados (Headers): Si está configurando una P&R, ingrese los parámetros de encabezado clave-valor, separados por comas. Ej. apikey:123345, json:true. Si está configurando un flujo, añada los parámetros de encabezado clave-valor haciendo clic en el botón Añadir nuevo elemento.
• Propiedades: Ingrese los valores que el usuario debe proporcionar al chatbot. Por ejemplo, una ciudad, un número de seguimiento, etc. El chatbot le pedirá al usuario estos valores. Si ya conoce todos los valores posibles, puede ingresarlos en el campo de Valores permitidos.

Datos enviados a su servidor

Isa enviará la siguiente información a su servidor. Si utiliza el método POST, se incluirá en el cuerpo JSON; si utiliza el método GET, se incluirá en el encabezado (header).

{
    "sb": {
        "user_id": "123",
        "conversation_id": "123",
        "user_language": "es"
    },
    "arguments": {}
}

El array arguments contiene los valores proporcionados por el usuario. Las claves son el nombre convertido a kebab-case; por ejemplo, si el nombre de la propiedad es Order Number, la clave será order-number. user_id es el ID del usuario en Isa y conversation_id es el ID de la conversación. Puede usar estos IDs para recuperar más información sobre el usuario y la conversación a través de la API REST.

Respuesta de su servidor

Su servidor debe devolver un array JSON con los valores requeridos por el chatbot. Incluya success: true solo cuando la solicitud sea exitosa y se devuelva la información esperada. No lo incluya si la información no se puede recuperar (p. ej., cuando se proporciona un número de pedido no válido). Vea el ejemplo a continuación para más detalles.

{
    "order_status": "Delivered 2 hours and 25 minutes ago",
    "success": true
}

Información

• If OpenAI is not working, click here.
• Los siguientes ajustes son compatibles con OpenAI: respuesta inteligente, intervención humana, desactivar para el área de tickets, desactivar durante el horario de oficina, retraso en la respuesta del bot, responder a correos electrónicos de usuarios, responder a mensajes de texto de usuarios.
• Los siguientes ajustes de Google son compatibles con OpenAI: multilingüe mediante traducción, traducción automática, detección de idioma.
• Establezca el idioma del chatbot de OpenAI en Ajustes > Chat > Idioma. Establézcalo en Multilingüe si su sitio web admite varios idiomas o si sus usuarios hablan diferentes idiomas. Si utiliza canales de mensajería como WhatsApp o Instagram, debe detectar el idioma del usuario a través de la detección de idioma. Para más detalles, haga clic aquí.
• Si un humano toma el control, el chatbot de OpenAI se desactiva.
• El modelo por defecto es gpt-5-mini.
• Los mensajes consecutivos del usuario son tratados como un solo mensaje por el chatbot, lo que resulta en una respuesta unificada.

Google

Los ajustes a continuación están relacionados con la aplicación de Inteligencia Artificial.

Sincronización

Para comenzar a utilizar los servicios de IA de Google, siga los pasos a continuación.

Modo de sincronización automática

Esta función solo está disponible en la versión en la nube de Isa.

• Haga clic en Sincronizar ahora y complete el procedimiento.
• Es necesario comprar créditos para usar esta opción.

Modo de sincronización manual

• Vaya a console.cloud.google.com e inicie sesión.
• Active Cloud Natural Language API, Cloud Translation API y Google Calendar API.
• Seleccione el proyecto y luego vaya al Menú izquierdo > APIs 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 e Información de contacto del desarrollador ingrese su correo electrónico. Haga clic en Guardar y continuar.
• En el área de Acceso a datos, haga clic en Agregar o quitar alcances, desplácese hasta el final y en el área Agregar alcances manualmente ingrese 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 y luego en Actualizar y Guardar y continuar.
• En el área de Audiencia, haga clic en Agregar usuarios y agregue su correo electrónico de Google, use el mismo correo que la cuenta con la que ha iniciado sesión. Haga clic en Guardar y continuar. Haga clic en PUBLICAR APLICACIÓN. No es necesario completar el proceso de revisión, déjelo en estado de revisión pendiente.
• Vaya al Menú izquierdo > APIs y servicios > Credenciales y haga clic en Crear credenciales, seleccione ID de cliente de OAuth. Como Tipo de aplicación seleccione Aplicación web. Ingrese el nombre que desee. En URI de redireccionamiento autorizados ingrese la URL de redireccionamiento, obténgala de Isa > Ajustes > Inteligencia Artificial > Google > URI de redireccionamiento autorizados. Haga clic en Crear.
• Copie el ID de cliente y el Secreto de cliente y péguelos en Isa > Ajustes > Inteligencia Artificial > Google. Guarde los ajustes.
• Haga clic en Isa > Ajustes > Inteligencia Artificial > Google > Sincronizar. Inicie sesión con la misma cuenta de Google que ha utilizado hasta ahora. En la siguiente pantalla, haga clic en Continuar. En la siguiente pantalla, seleccione todos los alcances y haga clic en Continuar.
• Copie el Token de actualización (Refresh token) y péguelo en Isa > Ajustes > Inteligencia Artificial > Google > Token de actualización.
• ¡Ya ha terminado! Tenga en cuenta que la aplicación no necesita ser aprobada por Google.
• Si es usuario de Google Workspace, vaya a https://admin.google.com/ y haga clic en Control de sesiones de Google Cloud. Establezca la Política de re-autenticación en No requerir nunca re-autenticación.

Traducción automática

La función de traducción automática traduce automáticamente los mensajes de los usuarios al idioma del agente y los mensajes del agente al idioma del usuario. Para habilitarla, marque la opción Ajustes > Inteligencia Artificial > Traducción automática. Si está utilizando la versión en la nube y Inteligencia Artificial > Google > Modo de sincronización está configurado en Automático, las funciones multilingües funcionarán automáticamente. De lo contrario, deberá completar la sincronización y la configuración a continuación. Las funciones de multilingüe mediante traducción y detección de idioma también requieren estos pasos.

Configuración

• Inicie sesión en https://console.cloud.google.com con su cuenta de Google.
• En la barra de búsqueda superior escriba cloud translation, seleccione el servicio Cloud Translation API y actívelo. Tenga en cuenta que este es un servicio de pago con un nivel gratuito; pueden producirse cargos adicionales.
• Active la facturación haciendo clic en Menú izquierdo > Facturación y habilitando una cuenta de facturación con un método de pago válido.

Información

• Los mensajes del usuario en el área de administración se traducen automáticamente en tiempo real para coincidir con el idioma del agente.
• Los mensajes del agente se traducen automáticamente en tiempo real para coincidir con el idioma del usuario.
• Los agentes pueden ver el mensaje original abriendo el menú del mensaje y haciendo clic en Ver mensaje original.
• El idioma del agente se basa en el detalle de usuario idioma (language) del agente si está configurado, de lo contrario en el idioma del navegador o el idioma del área de administración.
• El idioma del usuario se basa en el detalle de usuario idioma (language) si está configurado, de lo contrario en el idioma del chat si está configurado, de lo contrario en el idioma del navegador. El idioma también se puede detectar con la función de detección de idioma.
• Las notificaciones también se traducen.
• Para evitar traducir una cadena, enciérrela entre los caracteres ` o ```.

Multilingüe mediante traducción

La función en Ajustes > Inteligencia Artificial > Multilingüe mediante traducción traduce automáticamente los mensajes del usuario al idioma por defecto de OpenAI, y traduce los mensajes de OpenAI al idioma hablado por el usuario. Además, esta función traduce todo el texto que se muestra dentro del chat, como los mensajes enriquecidos del chatbot, artículos, formularios de registro y notificaciones emergentes (pop-up). Para mejorar el rendimiento y minimizar los costes de traducción, las traducciones se integran automáticamente en los archivos de traducción. Combine esta función con la de detección de idioma para obtener resultados óptimos.

• Si el inglés es uno de los idiomas, el inglés debe ser el idioma por defecto, los textos originales deben estar en inglés.
• Si está utilizando OpenAI con datos de entrenamiento, establezca el idioma por defecto de los datos de entrenamiento en Ajustes > Inteligencia Artificial > OpenAI > Idioma de las fuentes de entrenamiento. Déjelo como default si el idioma por defecto de los datos de entrenamiento es el inglés.

Detección de idioma

Detecta el idioma de los mensajes del usuario y cambia el idioma del usuario en consecuencia, si está disponible; de lo contrario, muestra un mensaje de reserva (fallback). Puede utilizar el siguiente campo de combinación en el mensaje: {language_name}.

• El mensaje del usuario debe tener al menos 2 palabras.
• La detección de idioma se ejecuta solo para los primeros 2 mensajes de usuario de una conversación.
• Siempre que el chatbot de OpenAI esté operativo y programado para responder a consultas genéricas, el mensaje de reserva nunca se enviará, ya que OpenAI proporcionará respuestas de forma constante a cualquier mensaje de uso.

Búsqueda en Google

La función de búsqueda en Google en Ajustes > Inteligencia Artificial > Búsqueda en Google le da a su chatbot la capacidad de buscar respuestas en Google. Esta función es útil para proporcionar respuestas a preguntas que requieren información en tiempo real.

• Regístrese en https://programmablesearchengine.google.com/.
• Cree un motor de búsqueda y configúrelo como desee. Recomendamos añadir solo su sitio web y Wikipedia si desea que su chatbot responda a preguntas generales; deje desactivada la opción Buscar en toda la web. Use la opción Entities para excluir resultados inválidos.
• Vaya a Editar motor de búsqueda > Configuración > Básica y copie el valor ID del motor de búsqueda, péguelo en Isa.
• Para obtener la clave API, visite https://developers.google.com/custom-search/v1/overview y haga clic en Obtener una clave.

Información

• La búsqueda en Google se realiza solo 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.
• No es necesario tener activada la búsqueda en Google para habilitar la corrección ortográfica. Puede desactivar la búsqueda en Google y activar solo la corrección ortográfica.
• La búsqueda en Google es compatible con el chatbot de OpenAI.

Tickets

Los ajustes a continuación están relacionados con la aplicación Tickets. La aplicación Tickets permite a los usuarios crear conversaciones y enviar mensajes a través de una interfaz de usuario diferente al chat.

Instalación

• En Ajustes > Aplicaciones, haga clic en Tickets e introduzca 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.

Mostrar el área de tickets

VERSIÓN PHP

Para mostrar el área de tickets, incluya el siguiente script en su página.

                                <script src="isa/js/min/jquery.min.js"></script> <!-- No es necesario si ya se ha cargado jQuery -->
                                <script id="sbinit" src="isa/js/main.js?mode=tickets"></script>
                            

• No puede incluir el chat y el área de tickets en la misma página. Asegúrese de eliminar el script que carga el chat. También puede mostrar el área de tickets insertando el código <script>SB_TICKETS = true;</script> en cualquier página que muestre el chat.
• Para establecer la posición del área de tickets, introduzca el código <div id="sb-tickets"></div>. El área de tickets se mostrará dentro de este elemento div. Añada el atributo data-offset="123" para establecer un desplazamiento de altura en píxeles. La altura mínima del área de tickets en escritorio es de 450px. De forma predeterminada, el área de tickets se añade al body.

VERSIÓN WORDPRESS

Para mostrar los tickets use el shortcode [sb-tickets]. Insértelo en cualquier página, entrada o tipo de publicación.

VERSIÓN CLOUD

Para mostrar el área de tickets, incluya el código de inserción del chat en su página y añada el atributo &mode=tickets a la URL del script, por ejemplo, <script id="chat-init" src="https://isa.startupfit.co/account/js/init.js?id=65895623&mode=tickets"></script>. También puede mostrar el área de tickets insertando el código <script>SB_TICKETS = true;</script> en cualquier página que muestre el chat.

Información

• Si el área de tickets no es visible, asegúrese de desmarcar la opción Tickets > Inicialización manual. Además, puede explorar otros motivos potenciales para este problema aquí.
• También puede utilizar el área de tickets para mostrar un panel de chat en línea o de ancho completo.
• Los tickets son lo mismo que las conversaciones de chat en el lado del administrador; la única diferencia con las conversaciones de chat es la interfaz de usuario frontal.
• La mayoría de los ajustes del chat son compatibles con la aplicación Tickets, pero no todos. Los ajustes del panel de control, el mensaje emergente y otros no son compatibles.
• Las API dedicadas para la aplicación Tickets están disponibles en la sección API.
• Para eliminar el formulario obligatorio de 'Nuevo ticket' para nuevos usuarios, active el mensaje de bienvenida en Ajustes > Mensajes y Formularios > Mensaje de bienvenida. El retraso del mensaje de bienvenida se ignora en el área de tickets, el mensaje se envía inmediatamente.
• Para desactivar manualmente el registro obligatorio solo en una página específica, use el código JavaScript var SB_REGISTRATION_REQUIRED = true. Establezca el valor en true para forzar el registro en su lugar.
• El área de tickets es compatible con Google reCaptcha v3.

WhatsApp

Los ajustes a continuación están relacionados con la aplicación WhatsApp.

Instalación

• En Ajustes > Aplicaciones, haga clic en WhatsApp e introduzca 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.

Configuración de la API de WhatsApp Cloud - Modo de sincronización automática

Esta función solo está disponible en la versión cloud de Isa.

• Haga clic en Sincronizar ahora y complete el procedimiento.
• Para añadir nuevos números, visite https://business.facebook.com/wa/manage/phone-numbers/. Si añade nuevos números después del proceso de sincronización, tendrá que volver a sincronizarlos. Todos los números se sincronizarán automáticamente. Si desea desactivar números específicos, puede eliminarlos de Ajustes > WhatsApp > Números de la API Cloud.
• Si vuelve a sincronizar con el mismo número de teléfono y no recibe el SMS o la llamada de verificación, puede introducir el último PIN que recibió y funcionará.

Si no recibe en Isa los mensajes enviados a su número de WhatsApp, compruebe lo siguiente:

• Haga clic en Reconectar y complete el procedimiento.
• Vaya al Meta Business Suite y añada un método de pago.

Configuración de la API de WhatsApp Cloud - Modo de sincronización manual

• Cree una nueva cuenta en https://developers.facebook.com o inicie sesión con su cuenta existente.
• Cree una nueva aplicación, introduzca el nombre de la aplicación, como casos de uso seleccione Conectarse con los clientes a través de WhatsApp, y seleccione la cuenta comercial utilizada para WhatsApp.
• En Isa > Ajustes > WhatsApp > API Cloud > Clave secreta introduzca una cadena aleatoria, luego vaya a https://developers.facebook.com/apps y seleccione su aplicación.
• En el menú de la izquierda, haga clic en Casos de uso > Conectarse con los clientes a través de WhatsApp > Personalizar.
• Haga clic en Configuración. En la sección Configuración de webhooks introduzca la URL de devolución de llamada (Callback URL) y el Token de verificación (Verify Token):
  • Obtenga la URL de devolución de llamada en Isa > Ajustes > WhatsApp > API Cloud > URL de configuración.
  • Establezca el Token de verificación en Isa > Ajustes > WhatsApp > Clave secreta y guarde los cambios, luego úselo para verificar el webhook.
  • En Campos de Webhook seleccione lo siguiente: messages, history, smb_app_state_sync, smb_message_echoes.
• Haga clic en Prueba de API.
  • Obtenga un número de teléfono de prueba haciendo clic en Obtener nuevo número de texto.
  • Haga clic en Añadir un número de teléfono de destinatario y añada su número personal de WhatsApp para verificarlo.
  • Copie el ID del número de teléfono y péguelo en Isa > Ajustes > WhatsApp > Números de API Cloud > ID del número de teléfono.
  • Envíe el mensaje, compruebe si ha recibido el mensaje en su cuenta personal de WhatsApp y envíe una respuesta; entonces debería aparecer en Isa.
  • Para responder al número de prueba desde Isa, genere el Token de acceso temporal y péguelo en Isa > Ajustes > WhatsApp > Números de API Cloud > Token.
• Para activar la integración de WhatsApp para todos los números de teléfono y añadir un número de teléfono real, consulte las siguientes directrices.
  En Isa > Ajustes > WhatsApp > Números de API Cloud > Token introduzca el token de acceso permanente; siga las instrucciones a continuación para obtenerlo.
  • Visite https://business.facebook.com y vaya a Menú izquierdo > Ajustes > Ajustes del negocio, luego vaya a Usuarios > Usuarios del sistema para ver su usuario administrador del sistema, o cree uno nuevo. Abra el usuario y haga clic en Añadir activos, luego seleccione la aplicación utilizada para la integración de la API de WhatsApp y marque Desarrollar aplicación o Control total. El usuario del sistema debe ser administrador. Si no ve la opción, haga clic en Ajustes del negocio.
  • Haga clic en Menú izquierdo > Cuenta > Aplicaciones. Seleccione su aplicación o añádala. Asegúrese de que el usuario del sistema esté allí y tenga control total. Si no es así, haga clic en Añadir usuario, seleccione el usuario del sistema, haga clic en Control total y haga clic en Asignar.
  • Haga clic en Menú izquierdo > Aplicaciones y en Seleccionar activos elija su aplicación, asigne Control total y guarde.
  • En Menú izquierdo > Cuentas de WhatsApp seleccione la cuenta de WhatsApp vinculada a su aplicación, luego haga clic en Asignar personas y seleccione el Usuario del sistema, otorgándole Control total.
  • En Usuarios > Usuarios del sistema seleccione el usuario que acaba de crear y haga clic en Generar nuevo token, haga clic en Aplicaciones y seleccione la aplicación utilizada para la integración de la API de WhatsApp, establezca la Expiración del token en Nunca, habilite los siguientes permisos: whatsapp_business_management, whatsapp_business_messaging, business_management. Haga clic en Generar token y guarde. Pegue el token en Isa > Ajustes > WhatsApp > Números de API Cloud > Token.
• Para añadir números de teléfono adicionales, vaya a https://developers.facebook.com, seleccione su aplicación y haga clic en Menú izquierdo > WhatsApp > Configuración de API. Para empezar, haga clic en Añadir número de teléfono en la parte inferior y siga las instrucciones proporcionadas.
  • Tras activar el número, copie el ID del número de teléfono y péguelo en Isa > Ajustes > WhatsApp > Números de API Cloud > ID del número de teléfono.
  • Si el número está en estado pendiente, debe entrar en el panel de su aplicación y luego, en Menú izquierdo > WhatsApp > Configuración de API, hacer clic en Generar token de acceso.
  • Tenga en cuenta que si utiliza su número actual de WhatsApp Business en Isa, ya no podrá utilizarlo con su aplicación WhatsApp Business, y tendrá que migrarlo siguiendo estas instrucciones.
• Su aplicación debe ser enviada a revisión y aprobada por Meta. Desde el menú de la izquierda, haga clic en Revisión y complete el proceso de envío para todos los permisos que añadió. Tenga en cuenta que la ayuda con esto no está incluida en nuestro soporte. Si necesita asistencia, puede contratarnos.

Configuración de la cuenta 360dialog

• Vaya a https://www.360dialog.com/ y cree una nueva cuenta.
• Entre en su panel de control y, en Menú izquierdo > Cuentas de WhatsApp, genere la Clave API (API key), cópiela y péguela en Isa > Ajustes > WhatsApp > Ajustes de 360dialog.
• Haga clic en Isa > Ajustes > WhatsApp > Ajustes de 360dialog > Sincronizar ahora.
• ¡Listo! Isa debería empezar a recibir los mensajes de WhatsApp enviados a su número, y usted podrá responder a esos mensajes desde Isa.
• Tenga en cuenta que también puede utilizar la cuenta gratuita de sandbox para realizar pruebas; más detalles en https://docs.360dialog.com/whatsapp-api/whatsapp-api/sandbox. La cuenta de sandbox tiene limitaciones y algunas funciones, como los archivos adjuntos multimedia, no funcionarán.

Configuración de la cuenta Twilio

• Vaya a https://www.twilio.com y cree una nueva cuenta.
• Verifique su número de teléfono.
• Complete el formulario y elija WhatsApp, Alertas y Notificaciones, Sin código alguno, Integraciones de terceros.
• Desde la consola de Twilio copie el ACCOUNT SID y el AUTH TOKEN y péguelos en Isa > Ajustes > WhatsApp > Ajustes de Twilio, guarde los cambios.
• Ahora configurará una cuenta de prueba gratuita para realizar algunas pruebas y asegurarse de que la integración funciona con Isa. En el menú de la izquierda, haga clic en Mensajería > Ajustes > Ajustes de sandbox de WhatsApp e introduzca en CUANDO LLEGUE UN MENSAJE y URL DE DEVOLUCIÓN DE ESTADO (STATUS CALLBACK URL) la URL de Isa; obténgala en Isa > Ajustes > WhatsApp > Ajustes de Twilio > Obtener URL de configuración. Tenga en cuenta que localhost no funcionará; necesita una URL pública y un servidor en vivo.
• En el menú de la izquierda, haga clic en Mensajería > Pruébelo > Enviar un mensaje de WhatsApp. Siga las instrucciones y envíe el mensaje con el código al número de WhatApp proporcionado. Haga clic en los botones siguientes hasta que la configuración se complete.
• ¡Listo! Isa debería empezar a recibir los mensajes de WhatsApp enviados a la cuenta de sandbox, y usted podrá responder a esos mensajes desde el panel de Isa.
• Para utilizar públicamente la integración de WhatsApp con sus clientes, también debe completar los pasos a continuación:
  • Actualice su cuenta y habilite la facturación, puede hacerlo aquí.
  • Compre un número de Twilio, que será el número de teléfono de su cuenta oficial de WhatsApp Business. Más detalles aquí. No puede utilizar el número de teléfono de su cuenta actual de WhatsApp Business; debe utilizar un número de Twilio. Más detalles aquí.
  • Desde la consola de Twilio vaya a Mensajería > Servicios y cree un nuevo Servicio de mensajería. Haga clic en Añadir remitentes, seleccione Número de WhatsApp como tipo de remitente y añada el número de Twilio que compró. Copie el SID del servicio (Service SID) y péguelo en Isa > Ajustes > WhatsApp > Ajustes de Twilio > Remitente.

API de WhatsApp no oficial

Isa solo admite la API oficial de WhatsApp Cloud, 360dialog o Twilio. Lamentablemente, las API de WhatsApp no oficiales no son compatibles. Sin embargo, aún puede implementarlas utilizando la API y los webhooks de Isa. Para más detalles, visite https://isa.startupfit.co/docs/api/web. Tenga en cuenta que debe poseer habilidades de programación como desarrollador para proceder con esta tarea. Además, nuestras integraciones predeterminadas están equipadas con funciones avanzadas que incluyen soporte para chatbot, mensajes automáticos, intervención humana, mensajes enriquecidos de WhatsApp, archivos adjuntos y más. En consecuencia, aunque configurar una integración básica para enviar y recibir mensajes de texto es relativamente sencillo, garantizar su funcionalidad impecable es un proceso más complejo.

Plantillas

De acuerdo con la Política Comercial de WhatsApp, no puede enviar mensajes de marketing y captación salientes a los usuarios finales. Los usuarios finales deben ponerse en contacto con usted primero. Tiene 24 horas desde que se envió el mensaje del usuario final desde WhatsApp para responder al mensaje. Para comunicarse con un usuario que no le ha contactado antes o con el que no ha estado en contacto durante más de 24 horas, debe optar por el respaldo por mensaje de texto o la plantilla de mensaje de WhatsApp.

• Para enviar plantillas de mensajes tiene que añadir un método de pago a su cuenta de WhatsApp Business. Puede hacerlo desde https://business.facebook.com/billing_hub/.
• Para enviar una plantilla de mensaje específica a un grupo de usuarios, utilice la función de mensajes directos.

Respaldo por mensaje de texto (SMS)

Para habilitar el respaldo por mensaje de texto debe configurar los SMS en Ajustes > Notificaciones > Notificaciones por mensaje de texto.
Más detalles aquí.

Plantillas de mensajes de WhatsApp

Una plantilla de mensaje de WhatsApp es un formato de mensaje que puede utilizar repetidamente para enviar mensajes a los usuarios una vez que han aceptado y dado permiso a su aplicación para enviarles mensajes. No puede introducir el mensaje original directamente en la plantilla; debe utilizarla para notificar al usuario de un nuevo mensaje e instruirle sobre cómo verlo, por ejemplo, proporcionando un enlace a su sitio web donde se muestra el chat.

API de WhatsApp Cloud

• Para obtener el Nombre de la plantilla y gestionar las plantillas, visite https://business.facebook.com y vaya a Menú izquierdo > Ajustes > Más ajustes del sistema, luego vaya a Cuentas > Cuentas de WhatsApp > Ajustes y haga clic en Administrador de WhatsApp.
• En Idiomas de la plantilla, introduzca todos los códigos de idioma compatibles con su plantilla, separados por comas. Lista de códigos de idioma aquí (copie solo el código de idioma, ej. it, es, en_US). Si utiliza una plantilla que admite varios idiomas, el idioma correspondiente para el usuario se seleccionará automáticamente. De lo contrario, se utilizará el idioma predeterminado de la plantilla.
• En Variables de cabecera y Variables de cuerpo, introduzca los valores separados por comas; puede utilizar los siguientes campos de combinación: {recipient_name}, {recipient_email}. El número de parámetros introducidos aquí debe coincidir con el número de parámetros de la plantilla. Utilice esta función si su plantilla utiliza valores dinámicos. Para cabeceras de imagen, pase la URL de la imagen como primer parámetro. El orden es importante, el primer campo de combinación se utilizará como primer parámetro de la plantilla.
• En Variables de botón, introduzca el enlace de sus botones personalizados o el texto de las respuestas rápidas con el prefijo quick_reply_, ej. quick_reply_abcde. Cada valor debe estar separado por una coma. El número de parámetros introducidos aquí debe coincidir con el número de parámetros de la plantilla. Si hay botones o llamadas a la acción con valores estáticos como una URL estática, introduzca skip_parameter. El orden es importante. Ejemplo:

Respaldo de plantilla (Fallback)

Configure la plantilla de WhatsApp que se envía como respaldo desde Ajustes > WhatsApp > Respaldo de plantilla de API Cloud. Si utiliza varios números con diferentes Cuentas Comerciales de WhatsApp, debe crear una plantilla dedicada para cada cuenta; puede establecer una plantilla diferente para cada número, pero el nombre de la plantilla y el código de idioma deben ser los mismos. El botón Probar plantilla envía una plantilla de prueba desde el primer número.

Enviar mensajes de plantilla a un usuario que no le ha contactado antes

• En Ajustes > WhatsApp > Números de API Cloud > ID de la cuenta comercial introduzca su ID de cuenta comercial (Business Account ID). Obténgalo de https://developers.facebook.com seleccionando su aplicación y yendo a Menú izquierdo > WhatsApp > Configuración de API.
• Para enviar la plantilla a usuarios específicos, vaya a la sección Usuarios de Isa y elija los destinatarios. Luego, haga clic en el icono de WhatsApp situado en la esquina superior derecha.
• Si utiliza la API de WhatsApp Cloud con una plantilla que admite varios idiomas, se seleccionará automáticamente el idioma del usuario. De lo contrario, se usará el idioma por defecto.
• Si utiliza Twilio y tiene parámetros en su plantilla, introduzca los valores de los parámetros separados por comas en la sección Cuerpo.
• Para más detalles haga clic aquí.

Twilio

Introduzca el SID de la plantilla y los atributos de la plantilla separados por comas en Isa > Ajustes > Plantilla de Twilio.

360dialog

• Obtenga el valor de Namespace en Menú izquierdo > Cuentas de WhatsApp > Detalles.
• Obtenga el Nombre de la plantilla y el Idioma predeterminado de la plantilla del área de plantillas de 360dialog.
• En Parámetros personalizados, introduzca los valores separados por comas; puede utilizar los siguientes campos: {recipient_name}, {recipient_email}.
• Isa intentará usar la plantilla en el idioma del usuario; si no está disponible, usará el idioma por defecto. Los siguientes idiomas no son compatibles: en_GB (use en_US), pt_PT (use pt_BR), zh_HK y zh_TW (use zh_CN), es_AR y es_MX (use es_ES).

Llamadas de WhatsApp

Las funciones de llamada de WhatsApp permiten a usuarios y agentes iniciar y recibir llamadas de voz o vídeo directamente desde la interfaz de chat y el área de administración.

• Las llamadas de WhatsApp están habilitadas por defecto para todos los números integrados en Isa. También puede gestionarlas desde el Administrador de WhatsApp, yendo a su número y activando o desactivando la opción de Llamadas de voz y vídeo.
• Para iniciar una llamada desde el admin, abra el perfil del usuario y haga clic en el icono de teléfono o vídeo. Debe crear una plantilla de solicitud de permisos de llamada desde el Administrador de WhatsApp > Plantillas de mensajes y elegir Solicitud de permisos de llamada como tipo de plantilla. Introduzca el ID en Ajustes > WhatsApp > Llamadas > ID de plantilla de permiso de llamada. Debe añadir un método de pago antes de poder enviar la plantilla.

Flujos de WhatsApp (WhatsApp flows)

Para más detalles sobre los flujos de WhatsApp (WhatsApp Flows), haga clic aquí.

Flujos integrados

Isa genera y envía automáticamente los siguientes flujos. Para regenerar un flujo, haga clic en el botón Ajustes > WhatsApp > Borrar flujos.

• Registro (Registration) - Este flujo se envía cuando un nuevo usuario envía su primer mensaje al número de WhatsApp, y la opción Ajustes > Usuarios > Requerir registro está activada.
• Seguimiento (Follow-up) - Este flujo se envía si la opción Ajustes > Mensajes y Formularios > Mensaje de seguimiento está activa y el usuario no tiene una dirección de correo electrónico.

Enviar flujos personalizados

Para enviar flujos personalizados use el campo de combinación {wa_flow id="123" header="" body="" button=""}. Reemplace 123 con el ID del flujo e introduzca un texto para los atributos header, body y button.

Tienda de WhatsApp

Para mostrar los productos de su tienda use los campos de combinación a continuación.

• Cuando el usuario envía el pedido, la información se envía a la URL especificada en Ajustes > WhatsApp > Webhook de pedido. La página en esa URL debe procesar el pedido y enviar un mensaje al usuario a través de la función de la API PHP sb_whatsapp_send_message().
• Para conectar la tienda con WooCommerce haga clic aquí.

Más información

• No puede enviar un mensaje de WhatsApp a un usuario que le haya enviado un mensaje hace más de 24 horas o que nunca le haya enviado un mensaje antes. WhatsApp prohíbe esta acción. En su lugar, debe usar una plantilla de WhatsApp o enviar un mensaje de texto (SMS). Si encuentra un "Mensaje de error: Re-engagement", indica esta situación.
• Si no recibe mensajes de WhatsApp, asegúrese de no estar asignando las conversaciones de WhatsApp a un departamento y que el número de WhatsApp utilizado para las pruebas no sea el número de teléfono de un administrador o agente de Isa. Además, si no usa la versión cloud, asegúrese de configurar correctamente la URL del webhook de WhatsApp.
• Si no puede enviar mensajes, debería aparecer un error en el área de administración cuando intente enviar un mensaje al usuario.
• No podemos proporcionar soporte para la configuración de Twilio o 360dialog, incluyendo todos los problemas relacionados.
• No podemos proporcionar soporte para que aprueben su cuenta de WhatsApp o su plantilla de mensajes de WhatsApp.
• Las conversaciones y mensajes de WhatsApp son compatibles con la cola y enrutamiento.
• Si está probando con el sandbox y después de 72 horas ya no puede enviar mensajes a su número de teléfono, debe volver a vincular su número a su sandbox.
• Puede enviar mensajes enriquecidos a WhatsApp. Si envía chips, botones o mensajes enriquecidos de selección con más de 3 opciones, puede usar el atributo de shortcode whatsapp="Su texto de menú" para establecer el texto del menú del mensaje de WhatsApp.
• El mensaje de seguimiento es compatible, pero el mensaje se envía siempre, incluso si un agente responde.
• El mensaje fuera de línea es compatible, pero el horario no se envía.
• El chatbot es compatible. La función de intervención humana también es compatible. Para habilitar el soporte del chatbot de Dialogflow para mensajes de audio, active Ajustes > Inteligencia Artificial > OpenAI > Reconocimiento de voz.
• Las funciones de IA compatibles incluyen detección de idioma, corrección ortográfica, multilingüe mediante traducción y búsqueda en Google.
• Twilio y 360dialog tienen muchas limitaciones. Por ejemplo, Twilio no admite mensajes de más de 1600 caracteres. Recomendamos encarecidamente utilizar la API oficial de WhatsApp.

Messenger

Los ajustes a continuación están relacionados con la aplicación Messenger.

Instalación

• Desde Ajustes > Apps, haga clic en Messenger e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. Si tiene la versión cloud, haga clic en Activar.

Modo de sincronización automática

• Complete la sincronización eligiendo al menos 1 página de Facebook e introduzca la información devuelta en Ajustes > Messenger > Páginas de Facebook.
• ¡Listo! Todos los mensajes enviados a las páginas de Facebook y cuentas de Instagram seleccionadas aparecerán en el área de administración de conversaciones de Isa. Tenga en cuenta que solo se sincronizarán los mensajes nuevos, los antiguos no se importarán.

Modo de sincronización manual

• Cree una nueva cuenta en https://developers.facebook.com/ o inicie sesión con su cuenta existente.
• Cree una nueva aplicación, introduzca el nombre de la aplicación y, en Casos de uso (Use cases), seleccione Administrar mensajes y contenido en Instagram, Interactuar con clientes en Messenger de Meta y Administrar todo en tu página.
• En la pestaña Empresa, seleccione Todavía no quiero conectar una cartera comercial.
• En el menú de la izquierda, haga clic en Casos de uso > Interactuar con clientes en Messenger de Meta > Personalizar, luego haga clic en Configuración de la API de Messenger. En la sección Configurar webhooks, introduzca la URL de devolución de llamada (Callback URL) y el Token de verificación (Verify Token):
  • Vaya a Isa > Ajustes > Messenger y establezca el Modo de sincronización en manual.
  • Obtenga la URL de devolución de llamada en Isa > Ajustes > Messenger > Obtener URL de configuración.
  • Establezca el Token de verificación en Isa > Ajustes > Messenger > Clave secreta y guarde los cambios; luego úselo para verificar el webhook.
  • En Campos del Webhook, seleccione lo siguiente: 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
• En la sección Generar tokens de acceso, haga clic en Conectar. Seleccione las páginas que desea sincronizar y complete el proceso.
  • En la columna Suscripción de Webhook, haga clic en Añadir suscripciones. Seleccione los siguientes permisos (scopes): messages, messaging_postbacks, messaging_optins, message_reads, feed, and message_echoes.
  • En la columna Tokens, haga clic en Generar. Copie el token de acceso proporcionado y péguelo en Ajustes > Messenger > Páginas de Facebook.
  • Copie el ID de la página y el Nombre de la página y péguelos en Ajustes > Messenger > Páginas de Facebook.
  • Repita estos pasos para todas las páginas.
• Guarde los cambios.
• En el menú de la izquierda, haga clic en Casos de uso > Permisos y funciones y añada los siguientes permisos: pages_manage_metadata, pages_messaging, pages_read_engagement, pages_show_list.
• Si desea sincronizar comentarios, siga estos pasos:
  • En el menú de la izquierda, haga clic en Casos de uso > Administrar todo en tu página > Personalizar.
  • En el menú de la izquierda, haga clic en Casos de uso > Permisos y funciones y añada los siguientes permisos: pages_read_user_content, pages_manage_engagement.
• Si también desea sincronizar Instagram, siga estos pasos:
  • En el menú de la izquierda, haga clic en Casos de uso > Administrar mensajes y contenido en Instagram > Personalizar, luego haga clic en Configuración de la API con inicio de sesión de Instagram.
  • Obtenga la URL de devolución de llamada en Isa > Ajustes > Messenger > Obtener URL de configuración.
  • Establezca el Token de verificación en Isa > Ajustes > Messenger > Clave secreta y guarde los cambios; luego úselo para verificar el webhook.
  • En Campos del Webhook, seleccione lo siguiente: messages, messaging_postbacks, messaging_seen, messaging_handover, message_reactions, standby, comments.
  • Introduzca su ID de Instagram en Ajustes > Messenger > Páginas de Facebook > ID de Instagram. Para obtenerlo, abra su navegador web e introduzca la siguiente URL: https://graph.facebook.com/ID-DE-PAGINA-FACEBOOK/?access_token=TOKEN-DE-ACCESO&fields=instagram_business_account. Reemplace ID-DE-PAGINA-FACEBOOK y TOKEN-DE-ACCESO con el ID de página y el token de acceso correspondientes de la página de Facebook vinculada a Instagram.
  • Guarde los cambios.
  • En el menú de la izquierda, haga clic en Casos de uso > Permisos y funciones y añada los siguientes permisos: instagram_basic, instagram_business_basic, instagram_manage_comments, instagram_manage_messages, instagram_business_manage_messages.
• En el menú de la izquierda, haga clic en Publicar.
• Su aplicación debe ser enviada para revisión y aprobada por Meta. En el menú de la izquierda, haga clic en Revisión y complete el proceso de envío para todos los permisos que añadió. Tenga en cuenta que la ayuda con esto no está incluida en nuestro soporte. Si necesita asistencia, puede contratarnos.

Instagram

Para vincular Instagram a su página de Facebook e Isa siga los pasos a continuación.

• Entre en el área de Configuración de su página de Facebook y haga clic en Menú de la izquierda > Instagram (https://www.facebook.com/SU-SLUG-DE-PAGINA/settings/).
• Haga clic en Conectar cuenta y complete la configuración.
• Sincronice Messenger con Isa de nuevo y listo. Tenga en cuenta que solo se sincronizarán los mensajes nuevos, los antiguos no se importarán.

Comentarios

Los comentarios publicados en su cuenta de Instagram y páginas de Facebook conectadas se envían a Isa, donde puede responder a ellos como lo haría en una conversación normal.

• La función DM para comentarios le permite enviar un mensaje directo automáticamente a los usuarios que comentan por primera vez en sus publicaciones de Instagram o página de Instagram. Deje el campo ID de la publicación vacío para habilitar esta función en todas las publicaciones.
• El chatbot es compatible con los comentarios, incluida la función de intervención humana. Puede desactivar el chatbot para los comentarios desde Ajustes > Messenger > Desactivar chatbot para comentarios.
• Se incluye soporte para mensajes enriquecidos en los comentarios. Sin embargo, algunos elementos como imágenes, vídeos, chips, botones y opciones de selección no son compatibles. Verá el comentario real renderizado después de enviar el mensaje.

Información

• Si no recibe mensajes de Instagram:
  • Asegúrese de habilitar Ajustes > Privacidad > Mensajes y herramientas adicionales > Herramientas conectadas - Permitir acceso a los mensajes desde su aplicación móvil de Instagram.
  • Asegúrese de que su cuenta de Instagram esté configurada como una cuenta de empresa (Business Account), no personal.
  • Vaya a Meta Business Suite, seleccione su cuenta y vaya a Usuarios > Personas. En Cuenta de Instagram, haga clic en Administrar y asegúrese de habilitar todos los permisos.
• Si no recibe mensajes de Facebook Messenger, asegúrese de que la página de Facebook no envíe respuestas automáticas, como el mensaje de bienvenida.
• En caso de que encuentre mensajes duplicados o un ciclo de chat continuo entre el chatbot y los mensajes de Instagram, se enfrenta a un problema debido a la presencia de dos instalaciones de Isa o cuentas de Isa Cloud sincronizadas con la misma cuenta de Instagram. Para resolverlo, acceda al segundo área de administración de Isa, vaya a Ajustes > Messenger > Páginas de Facebook, elimine el valor de ID de Instagram y guarde los cambios. Intente también hacer clic en el botón Cancelar suscripción (Unsubscribe).
• El botón Cancelar suscripción elimina la suscripción del webhook de todas sus páginas de Facebook; es útil si desea dejar de recibir mensajes de una página de Facebook.
• Cada usuario de Isa tiene solo 1 conversación de Facebook y 1 conversación de Instagram.
• Los mensajes enriquecidos de Isa se convierten automáticamente en mensajes enriquecidos de Facebook cuando es posible; algunas partes podrían eliminarse o cambiarse. Los botones, chips y selecciones admiten un máximo de tres opciones y solo son compatibles con la aplicación móvil de Instagram.
• Solo los mensajes privados de Facebook se enviarán a su bandeja de entrada. Si alguien publica un mensaje en su muro de Facebook, no aparecerá en la bandeja de entrada del equipo.
• Cuando alguien envía un mensaje a la página de Facebook o cuenta de Instagram de su empresa, será designado como un cliente potencial (lead) en Isa. Solo podrá ver el nombre de Facebook o Instagram del usuario y su foto de perfil.
• Las conversaciones y mensajes de Messenger son compatibles con la cola y enrutamiento.
• El chatbot es compatible. La función de intervención humana es compatible.
• Las funciones de IA compatibles incluyen detección de idioma, corrección ortográfica, multilingüe mediante traducción y búsqueda en Google.
• Si el chatbot está habilitado, es necesario desactivar cualquier respuesta automática en Facebook Messenger, como el mensaje de bienvenida.
• El mensaje de seguimiento es compatible, pero el mensaje se envía siempre, incluso si un agente responde.
• El mensaje fuera de línea es compatible, pero el horario no se envía.
• Solo se puede sincronizar 1 cuenta de Facebook; para vincular páginas de múltiples cuentas de Facebook, la cuenta sincronizada en Isa debe ser administradora de todas las páginas de Facebook de las otras cuentas.
• El uso de esta integración de Instagram y Facebook Messenger no tiene coste adicional.
• Si el mensaje supera los 1000 caracteres, solo se transmitirán los primeros 1000 debido al límite de caracteres.
• Solo se sincronizarán los mensajes nuevos enviados después de la sincronización; los antiguos no se importarán.
• Solicitud de eliminación de datos de usuario (solo para la versión cloud): Para eliminar todos sus datos de Isa, haga clic en Ajustes > Messenger > Cancelar suscripción y luego elimine su cuenta desde aquí.
• Para habilitar el indicador de escritura en Messenger, debe configurar y habilitar el proceso PHP asíncrono.

Twitter

Los ajustes a continuación están relacionados con la aplicación Twitter.

Instalación

• Regístrese en https://developer.twitter.com. Asegúrese de verificar su teléfono en https://twitter.com/settings/phone o el registro fallará.
• Cree su primera aplicación introduciendo el nombre de la app y haga clic en Get keys, copie la API Key (Consumer key) y el API Key Secret (Consumer secret) y péguelos en Isa > Ajustes > Twitter.
• Solicite el acceso Elevated en https://developer.twitter.com/en/portal/products/elevated. Haga clic en Apply for Elevated y complete el formulario de la siguiente manera: En la primera área In your words y en Will your app use Tweet, Retweet, Like, Follow, or Direct Message functionality? introduzca: I need access to the Account Activity API to start receiving Twitter Direct Messages to my chat software (Isa) and to reply to them directly from Isa, details at https://isa.startupfit.co/twitter.. Desactive todos los demás campos haciendo clic en No (Are you planning to analyze Twitter data?, etc.).
• Espere unos días a que Twitter revise y apruebe el acceso Elevated; recibirá un correo electrónico de Twitter.
• Una vez que tenga acceso Elevated, entre en el panel de desarrolladores (https://developer.twitter.com/en/portal/dashboard) y, en el menú de la izquierda, haga clic en Products > Premium > Dev environments. En Account Activity API / Sandbox, haga clic en Set up dev environment. En Dev environment label, introduzca sb o el mismo valor introducido en Ajustes > Twitter > Sincronización > Etiqueta del entorno de desarrollo.
• Entre en el área de Settings de su aplicación desde Menú izquierdo > Projects & Apps > Su proyecto > Su aplicación y, en User authentication settings, haga clic en Set up y active OAuth 1.0a. En App permissions marque Read and write and Direct message. En Callback URI / Redirect URL introduzca la URL que obtiene en Isa > Ajustes > Twitter > Obtener URL de retorno. En Website URL introduzca la URL de su sitio web.
• Entre en el área de Keys and tokens de su aplicación y, en Authentication Tokens, genere el Access Token and Secret; cópielos y péguelos en Isa > Ajustes > Twitter.
• Introduzca su nombre de usuario de Twitter en Isa > Ajustes > Twitter > Su nombre de usuario. Obténgalo de su página de perfil de Twitter, copiando el nombre que empieza por @ o la parte de la URL que contiene su nombre de usuario. Ej. https://twitter.com/isa1.
• Guarde los ajustes de Isa y haga clic en el botón Isa > Ajustes > Twitter > Subscribe y listo. Todos los mensajes enviados a su cuenta de Twitter serán recibidos por Isa.

Más información

• Si recibe mensajes duplicados, es posible que la cuenta de Twitter que está usando para las pruebas sea la misma que sincronizó. Intente enviar un mensaje desde otra cuenta de Twitter.
• Use un dominio en vivo; localhost no es compatible.
• Cuando se recibe un mensaje de un usuario de Twitter, puede enviar hasta 5 mensajes en respuesta dentro de una ventana de 24 horas. No se pueden enviar mensajes después de 24 horas de haber recibido el mensaje de Twitter.
• Puede enviar un máximo de 3 o 4 archivos adjuntos dependiendo del tipo de medio.
• Los siguientes mensajes enriquecidos de Isa no son compatibles: carrusel de imágenes (images slider), carrusel (slider) y tarjeta (card).
• El chatbot es compatible. La función de intervención humana es compatible.
• Las funciones de IA compatibles incluyen detección de idioma, corrección ortográfica, multilingüe mediante traducción y búsqueda en Google.

Telegram

Los ajustes a continuación están relacionados con la aplicación Telegram.

Instalación

• En Ajustes > Aplicaciones, haga clic en Telegram e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. Si tiene la versión cloud, haga clic en Activar.
• Una vez instalada la aplicación, visite https://t.me/botfather.
• Si ya ha creado un bot de Telegram en el pasado, escriba el comando /mybots y abra su bot, luego haga clic en API token.
• 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; introdúzcalos y genere el token de autenticación. Más detalles en https://core.telegram.org/bots.
• Copie el token y péguelo en Isa > Telegram > Token, luego haga clic en Sincronizar ahora. Su sitio web debe usar HTTPS (certificado SSL); no se admite HTTP.
• ¡Listo! Todos los mensajes enviados a su bot de Telegram aparecerán en el área de administración de conversaciones de Isa.

Más información

• Los mensajes enriquecidos de Isa se convierten automáticamente en mensajes enriquecidos de Telegram cuando es posible; de lo contrario, se eliminan del mensaje.
• Las conversaciones y mensajes de Telegram son compatibles con la cola y el enrutamiento.
• El chatbot es compatible. La función de intervención humana es compatible.
• Las funciones de IA compatibles incluyen detección de idioma, corrección ortográfica, multilingüe mediante traducción y búsqueda en Google.
• La función Ajustes > 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 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<tu_token_de_bot>/getWebhookInfo. Reemplace <tu_token_de_bot> por su token.

Notificaciones

Los agentes pueden ser notificados vía Telegram cuando llega un nuevo mensaje.

• Las notificaciones se envían solo cuando es necesario, de acuerdo con los demás ajustes de notificaciones. Active Ajustes > Telegram > Notificaciones > Todos los mensajes para recibir siempre notificaciones de todos los mensajes.

Activación

• Vaya a Ajustes > Telegram > Notificaciones y haga clic en Activar.
• Introduzca el nombre del canal de Telegram en Ajustes > 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.
• Abra Telegram en su teléfono o mediante la aplicación web y cree un canal nuevo usando el nombre definido previamente.
• Después de crear el canal, edite su configuración y añada el bot de Telegram sincronizado con Isa como administrador.

Viber

Los ajustes a continuación están relacionados con la aplicación Viber.

Instalación

• En Ajustes > Aplicaciones, haga clic en Viber e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. Si tiene la versión cloud, haga clic en Activar.
• Cree el bot en https://partners.viber.com/account/create-bot-account.
• Copie el token y péguelo en Isa > Viber > Token, luego haga clic en Sincronizar ahora. Su sitio web debe usar HTTPS (certificado SSL); no se admite HTTP.
• ¡Listo! Todos los mensajes enviados a su bot de Viber aparecerán en el área de administración de conversaciones de Isa.

Más información

• Los mensajes enriquecidos de Isa se convierten automáticamente en mensajes enriquecidos de Viber cuando es posible; de lo contrario, se eliminan del mensaje.
• Las conversaciones y mensajes de Viber son compatibles con la cola y el enrutamiento.
• El chatbot es compatible. La función de intervención humana es compatible.
• Las funciones de IA compatibles incluyen detección de idioma, corrección ortográfica, multilingüe mediante traducción y búsqueda en Google.
• El mensaje de seguimiento es compatible, pero el mensaje siempre se envía, incluso si un agente responde.
• El mensaje fuera de línea es compatible, pero el horario no se envía.

Slack

Los ajustes a continuación están relacionados con la aplicación Slack.

Instalación

• En Ajustes > Aplicaciones, haga clic en Slack e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. Si tiene la versión cloud, haga clic en Activar.
• Una vez instalada la aplicación, vaya a Ajustes > Slack, haga clic en el botón Sincronizar ahora y siga las instrucciones.

¿Tiene problemas?

La sincronización de Slack puede fallar por varias razones; a continuación se detallan las más comunes:

Archivar canales manualmente

Para archivar un canal en Slack, siga estos pasos:

• Abra el canal de Slack que desea archivar.
• En la parte superior derecha, haga clic en el icono de engranaje y seleccione Opciones adicionales.
• Haga clic en el icono de información en el área superior derecha de la pantalla, luego haga clic en el Icono de más y, a continuación, haga clic en Opciones adicionales.... Haga clic en Archivar este canal.

Vinculación de departamentos

Si la opción Ajustes > Slack > Vinculación de departamentos está activa, cuando se asigna una conversación en Isa 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 del usuario. Sin embargo, la conversación completa solo se puede acceder en el canal de Slack dedicado del usuario específico.

• Obtenga los IDs de los departamentos en Ajustes > Miscelánea > departamentos.
• Obtenga los IDs de los canales haciendo clic en el botón Obtener IDs de canal.

Campos de usuario

La opción Ajustes > Slack > Campos de usuario 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. Por defecto: 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 deberán unirse manualmente mediante el botón.
• Cuando se establece Ajustes > Slack > Vinculación de agentes, 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.
• El uso de Slack es gratuito. Solo las grandes empresas pueden necesitar un plan de suscripción de pago; más detalles aquí.
• Las notificaciones push son compatibles con Slack; cuando los agentes envían mensajes a través de Slack, las notificaciones push se envían a los usuarios.
• Si utiliza el chatbot, no se recibirán mensajes en Slack si el chatbot conoce la respuesta. Una vez que la intervención humana está activa, todos los mensajes de la conversación se envían a Slack.
• La aplicación Slack es compatible con el reenvío de correo (email piping) y las aplicaciones de mensajería.
• No se admite eliminar o abandonar un canal; solo se admite archivar un canal.
• Cuando se archiva una conversación en Isa, el canal de Slack vinculado también se archiva.
• Al responder a través de Slack a un usuario, si este 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.
• Si no ve el canal del usuario en Slack, vaya a Directorios > Canales y únase manualmente al canal.

LINE

Los ajustes a continuación están relacionados con la aplicación LINE.

Instalación

• En Ajustes > Aplicaciones, haga clic en LINE e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. Si tiene la versión cloud, haga clic en Activar.
• Inicie sesión en https://developers.line.biz/console/ o cree una cuenta nueva.
• Cree un nuevo Provider y luego un nuevo Messaging API channel; seleccione Messaging API como tipo de canal.
• Desde el área Basic settings del canal, copie el Channel secret y péguelo en Isa > Ajustes > Line > Sincronización > Channel secret.
• Desde el área Messaging API del canal, genere un Channel access token (long-lived); cópielo y péguelo en Isa > Ajustes > Line > Sincronización > Access token.
• Introduzca su URL de Webhook en Webhook URL y haga clic en Verify. Obtenga la URL de Webhook en Isa > Ajustes > Line > Sincronización > URL de Webhook.
• Active Use webhook.
• Escanee el código QR con su aplicación móvil LINE para comenzar a escribir en su canal.
• Desactive el ajuste Auto-reply messages.
• ¡Listo! Todos los mensajes enviados a su cuenta de bot de LINE aparecerán en el área de administración de conversaciones de Isa.

Más información

• Tiene 7 días desde que se envió el mensaje del usuario final desde LINE para responder al mensaje.
• Los stickers no son compatibles.
• Los mensajes enriquecidos de Isa se convierten automáticamente en mensajes enriquecidos de LINE cuando es posible; de lo contrario, se eliminan del mensaje.
• Las conversaciones y mensajes de LINE son compatibles con la cola y el enrutamiento.
• El chatbot es compatible. La función de intervención humana es compatible.
• Las funciones de IA compatibles incluyen detección de idioma, corrección ortográfica, multilingüe mediante traducción y búsqueda en Google.
• El mensaje de seguimiento es compatible, pero el mensaje siempre se envía, incluso si un agente responde.
• El mensaje fuera de línea es compatible, pero el horario no se envía.

WeChat

Los ajustes a continuación están relacionados con la aplicación WeChat.

Instalación

• En Ajustes > Aplicaciones, haga clic en WeChat e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. Si tiene la versión cloud, haga clic en Activar.
• Visite https://mp.weixin.qq.com/cgi-bin/readtemplate?t=register/step1_tmpl&lang=en_US y registre una Service account.
• Después del registro, ingrese al área Official accounts y, en el menú de la izquierda, haga clic en Settings and development > WeChat verification. Debe completar la verificación; tarda unas semanas y cuesta 99 USD (o 300 CNY para entidades chinas).
• En el menú de la izquierda, haga clic en Settings and development > Basic configuration y copie el Developer ID (App ID) y el Developer Password (App Secret). Pegue la información en Isa > Ajustes > WeChat.
• En el menú de la izquierda, haga clic en Settings and development > Basic configuration y complete la configuración del servidor (服务器配置(已启用). En Server Address (URL), introduzca la URL que obtiene de Isa > Ajustes > WeChat > Sincronización > Obtener URL de configuración. En Token, inserte cualquier valor que desee; debe introducir el mismo valor en Isa > Ajustes > WeChat > Token.
• ¡Listo! Todos los mensajes enviados a su cuenta de WeChat aparecerán en el área de administración de conversaciones de Isa.

Más información

• Si recibe un error como {"errcode":41001,"errmsg":"access_token missing rid: 631111-470b3b22-48553870"}, debe incluir la dirección IP de su servidor en la lista blanca en 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 Isa.
• Los enlaces no son compatibles en WeChat; se convierten a texto.
• Los mensajes enriquecidos de Isa se convierten automáticamente en mensajes enriquecidos de WeChat cuando es posible; de lo contrario, se eliminan del mensaje.
• Las conversaciones y mensajes de WeChat son compatibles con la cola y el enrutamiento.
• El chatbot es compatible. La función de intervención humana es compatible.
• Las funciones de IA compatibles incluyen detección de idioma, corrección ortográfica, multilingüe mediante traducción y búsqueda en Google.
• El mensaje de seguimiento es compatible, pero el mensaje siempre se envía, incluso si un agente responde.
• El mensaje fuera de línea es compatible, pero el horario no se envía.

Zalo

Los ajustes a continuación están relacionados con la aplicación Zalo.

Instalación

• En Ajustes > Aplicaciones, haga clic en Zalo e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. Si tiene la versión cloud, haga clic en Activar.
• Regístrese en https://developers.zalo.me/ y cree una nueva App. Introduzca la información requerida y guarde.
• Copie el Application ID y la Application secret key de la aplicación que acaba de crear y péguelos en Isa > Ajustes > Sincronización > Zalo.
• En el menú de la izquierda, haga clic en Webhooks y configure la URL; obtenga la URL de Isa > Ajustes > Zalo > Sincronización > URL de Webhook.
• En el menú de la izquierda, haga clic en Webhooks, copie la OA Secret Key y péguela en Isa > Ajustes > Zalo > Sincronización > OA secret key.
• En el menú de la izquierda, haga clic en Webhooks y active 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.
• En el menú de la izquierda, haga clic en Official Account > OA Management y vincule su cuenta oficial (Official Account).
• En el menú superior, haga clic en Tools > API Explorer o vaya a 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 Isa > Ajustes > Zalo > Sincronización > Refresh token. Más detalles aquí.
• En el menú de la izquierda, haga clic en Role y añada un usuario de prueba como administrador. Utilizará este usuario para enviar mensajes a su cuenta oficial de Zalo y probar la integración.
• En el menú de la izquierda, haga clic en Sign up to use API > Official AccountAPI, active User Management y haga clic en Submit for review.
• ¡Listo! Todos los mensajes enviados a su cuenta oficial de Zalo aparecerán en el área de administración de conversaciones de Isa.

Más información

• Necesita una cuenta oficial de Zalo para usar esta integración. Isa recibirá los mensajes enviados a su cuenta oficial de Zalo.
• El slider de mensajes enriquecidos solo envía el primer elemento a Zalo.
• Los mensajes enriquecidos de Isa se convierten automáticamente en mensajes enriquecidos de Zalo cuando es posible.
• Las conversaciones y mensajes de Zalo son compatibles con la cola y el enrutamiento.
• El chatbot es compatible. La función de intervención humana es compatible.
• Las funciones de IA compatibles incluyen detección de idioma, corrección ortográfica, multilingüe mediante traducción y búsqueda en Google.
• El mensaje de seguimiento es compatible, pero el mensaje siempre se envía, incluso si un agente responde.
• El mensaje fuera de línea es compatible, pero el horario no se envía.

Zendesk

Los ajustes a continuación están relacionados con la aplicación Zendesk.

Instalación

• En Ajustes > Aplicaciones, haga clic en Zendesk e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. Si tiene la versión cloud, haga clic en Activar.
• Obtenga el dominio (domain) 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://isa.zendesk.com/agent/get-started/ticketing-system/ticketing-intro es isa.
• Obtenga la clave API (API key) en Menú izquierdo > Administrador > Canales > API > Ajustes. Haga clic en Añadir token API.
• El correo electrónico (email) es el correo electrónico de su cuenta de Zendesk.

Más información

• Los tickets convertidos por Isa se sincronizan automáticamente cuando se envían y reciben nuevos mensajes en Isa, y se vinculan a un usuario de Zendesk existente, si lo hay; de lo contrario, se crea un nuevo usuario de Zendesk.
• Isa vincula a los usuarios de Zendesk con los usuarios de Isa a través del correo electrónico o el número de teléfono.

Perfex

Los ajustes a continuación están relacionados con la aplicación Perfex.

Instalación

La instalación requiere dos pasos:

• En Ajustes > Aplicaciones, haga clic en Perfex e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. La versión cloud no es compatible con la aplicación Perfex.
• Una vez instalada la aplicación, vaya a Ajustes > Perfex e introduzca la información de la base de datos y la URL de Perfex. Puede obtener la información del archivo application/config/app-config.php en su carpeta de instalación de Perfex. Si no conoce el prefijo de Perfex, déjelo vacío; el prefijo por defecto es tbl.
• Vaya al área de administración de Perfex, luego a Ajustes > Módulos e instale el módulo Isa subiendo el archivo module.zip. Una vez instalado el módulo, vaya a Ajustes > Isa e introduzca la URL del plugin Isa; obténgala en Ajustes > Miscelánea > URL de instalación. Si utiliza la versión de WordPress, la URL debe ser así: https://ejemplo.com/wp-content/plugins/isa/isa.

Para mostrar Isa dentro del área de administración de Perfex, Isa debe estar instalado en el mismo dominio y mismo sistema de archivos que la instalación de Perfex. Si tiene problemas, o si ha cambiado los detalles de la base de datos de Perfex, asegúrese de que el archivo isa/config.php use los detalles correctos de la base de datos de Perfex. Actualizar los detalles en Isa no actualizará los detalles en el archivo config.php.

WHMCS

Los ajustes a continuación están relacionados con la aplicación WHMCS.

Instalación

El proceso requiere dos instalaciones: una es el complemento (add-on) de WHMCS y otra es la aplicación Isa.

Instalación de la aplicación

• En Ajustes > Aplicaciones, haga clic en WHMCS e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. La versión cloud no es compatible con la aplicación WHMCS.
• Una vez instalada la aplicación, vaya a Ajustes > WHMCS e introduzca la información de la base de datos y la URL de WHMCS.

Instalación del complemento (add-on) WHMCS

• Introduzca la carpeta isa que se encuentra dentro del archivo addon.zip (descárguelo aquí) en el directorio /modules/addons/ de su instalación de WHMCS.
• Vaya a Configuración > Ajustes del sistema > Módulos de complementos, busque el módulo Isa y haga clic en Activar. Más detalles en https://docs.whmcs.com/8-13/addon-modules/addon-modules/
• Haga clic en el botón Configurar e introduzca la URL del plugin Isa.

Cómo actualizar

Actualizar la aplicación WHMCS en Isa es fácil; puede habilitar las actualizaciones automáticas o actualizarla manualmente. Detalles aquí. Para actualizar el complemento de WHMCS, deberá descargar la última versión del complemento desde https://isa.startupfit.co/docs/files/whmcs/addon.zip y reemplazar manualmente el directorio /modules/addons/isa/ de su instalación de WHMCS por el nuevo recién descargado.

Si tiene problemas, o si ha cambiado los detalles de la base de datos de WHMCS, asegúrese de que el archivo isa/config.php use los detalles correctos de la base de datos de WHMCS. Actualizar los detalles en Isa no actualizará los detalles en el archivo config.php.

OpenCart

Los ajustes a continuación están relacionados con la aplicación OpenCart.

Instalación

• En Ajustes > Aplicaciones, haga clic en OpenCart e introduzca su clave de licencia para instalar y activar la aplicación. Más detalles aquí. Si tiene la versión cloud, haga clic en Activar.
• Una vez instalada la aplicación, vaya a Ajustes > OpenCart e introduzca los detalles de OpenCart. Para obtener el Nombre de usuario (Username) y la clave API (API key), entre en el área de administración de OpenCart y vaya a Sistema (System) > Usuarios (Users) > API. Verá un usuario predefinido llamado Default. Edítelo, genere la clave API y luego establezca el Estado (Status) en Habilitar (Enable). A continuación, añada su IP a la lista de permitidas para el acceso API.
• Con un administrador de archivos o FTP, edite el archivo catalog/controller/common/header.php en la carpeta de instalación de OpenCart y añada el siguiente par clave-valor en la variable $data:

                                          $data['isa'] = $this->customer->getFirstName() ? 'var SB_DEFAULT_USER = { first_name: "' . $this->customer->getFirstName() . '", last_name: "' . $this->customer->getLastName() . '", email: "' . $this->customer->getEmail() . '", extra: { opencart_id: ["' . $this->customer->getId() . '|' . (isset($_COOKIE['OCSESSID']) ? $_COOKIE['OCSESSID'] : '') . '", "Open Cart ID"], phone: ["' . $this->customer->getTelephone() . '", "Phone"], opencart_store: ["' . $this->config->get('config_name') . '", "OpenCart Store"], opencart_store_url: ["' . $_SERVER['HTTP_HOST'] . '", "OpenCart Store URL"] } };' : '';
                                      

• Edite el archivo /catalog/view/theme/default/template/common/header.twig y añada <script>{{ isa }}</script> en algún lugar dentro de la etiqueta <head>. Tenga en cuenta que si no está utilizando el tema predeterminado, la ruta será diferente.
• Entre en la página de Extensions (Extensiones) de OpenCart y haga clic en el botón superior derecho Update (Actualizar).
• Descargue el archivo sb.php y súbalo a catalog/controller/api.

Más información

• Esta aplicación es compatible con OpenCart Multistore.
• Al actualizar OpenCart, deberá volver a aplicar el código anterior.
• Actualmente, solo es compatible con Opencart 3.

Versión Cloud

La información de esta sección está relacionada exclusivamente con la versión cloud de Isa, accesible en https://isa.startupfit.co.

Créditos

Los créditos se utilizan únicamente en la versión cloud de Isa. Los créditos son consumidos 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 de API.

• Inteligencia Artificial > Google > Traducciones automáticas, Detección de idioma, Multilingüe mediante traducción.
• Inteligencia Artificial > OpenAI > Chatbot y Corrección ortográfica, Reescritura de mensajes, Reconocimiento de voz.
• Extracción de datos de notas (Scraping)
• Copilot

Puede cambiar el modo de sincronización en cualquier momento desde Ajustes > Inteligencia Artificial > OpenAI > Modo de sincronización o Ajustes > Inteligencia Artificial > Google > Modo de sincronización.

Precios

Los créditos deben adquirirse en https://isa.startupfit.co/account?tab=membership. A continuación se detallan los costes de las funciones que utilizan créditos.

• Traducciones de Google y detección de idioma: $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 por token.
• OpenAI ada: $0.0000001 por token.
• OpenAI text-embedding-3-small: $0.00000004 por token.
• OpenAI whisper de audio a texto: $0.0002 por segundo de audio.
• OpenAI whisper: $0.0001 por segundo de audio.

Información

• Cuando se agoten sus créditos, si la recarga automática no está habilitada, se le notificará por correo electrónico. Recibirá un máximo de dos notificaciones. Active la recarga automática para evitar quedarse sin créditos.
• Cuando la recarga automática está activada, el crédito se recargará una vez que caiga por debajo de 1.

Shopify

La integración con Shopify está disponible únicamente en la versión cloud de Isa y le permite sincronizar su tienda Shopify y sus usuarios con Isa.

• Para usar la integración con Shopify, debe tener una tienda Shopify e instalar la App de Shopify de Isa. Tras la instalación, el widget de chat debería aparecer en su tienda Shopify. Si no aparece, vaya a Canales de venta > Tienda online y en el menú de la izquierda, haga clic en Incrustaciones de aplicaciones (App embeds); asegúrese de que el bloque Isa esté allí y esté activo.
• El chatbot puede acceder a los productos, colecciones, etiquetas, variantes y proveedores de su tienda para responder a las preguntas del usuario. No se requiere configuración. Funciona automáticamente. Para habilitar el chatbot, vaya a Ajustes > Inteligencia Artificial > OpenAI > Chatbot y active la opción. Más detalles aquí.
• Si su tienda es multilingüe, vaya a Ajustes > Chat > Idioma y establézcalo en Multilingüe. El chat y el chatbot utilizarán automáticamente el idioma de la tienda.
• Los detalles del usuario conectado a Shopify se detectan y sincronizan con Isa.
• Utilice el siguiente campo de combinación para mostrar tarjetas y controles deslizantes de productos en el chat: {shopify product_id="12345678"}. Reemplace 12345678 con el ID del producto. Muestre un control deslizante de varios productos añadiendo varios ID de producto separados por comas.
• La función de búsqueda de la ventana emergente de productos del área de administración solo busca por título del producto y tipo de producto.
• Las colecciones, etiquetas, variantes y proveedores de Shopify se almacenan en caché y se actualizan cada 10 días. El chatbot los utilizará para responder a las preguntas del usuario.
• Si la URL de su tienda cambia, debe eliminar y volver a instalar la aplicación Isa Shopify.

Información

• Puede encontrar su token de API en https://isa.startupfit.co/account/?tab=installation.
• Puede cambiar entre cuentas sin tener que cerrar sesión e iniciarla añadiendo las cuentas en Ajustes > Administrador > Cambiar cuentas.
• La versión cloud está alojada en nuestro servidor Amazon AWS.
• Si experimenta una pantalla en blanco al acceder a la versión cloud, añada el atributo de URL reset-login a la URL y ábrala de nuevo. Por ejemplo: https://isa.startupfit.co/?reset-login.

Varios

Esta sección contiene ayuda para otras funciones no listadas anteriormente.

Progressive Web App (PWA)

El área de administración de Isa es una PWA, lo que significa que puede instalarla en escritorio, Mac, iPhone o dispositivos móviles y utilizarla como una aplicación totalmente funcional. Nota: Esta función está optimizada para Google Chrome y Safari. La PWA es compatible con todas las versiones de Isa.

Instalación en escritorio

Acceda a su área de administración (por ejemplo, https://www.su-sitio.com/isa/admin.php o https://isa.startupfit.co) y haga clic en el icono + en la parte superior derecha de la barra de direcciones de su navegador Chrome. Si utiliza la versión de WordPress, consulte la información a continuación.

Instalación móvil - Android - Solo versión Cloud - No recomendado

Si utiliza la versión cloud de Isa en Android, puede usar las aplicaciones disponibles en Google Play. Recomendamos utilizar la PWA en lugar de la aplicación de Android para disponer de las últimas funciones y actualizaciones.

Google Play

Instalación móvil - Android y Windows - Todas las versiones

• Acceda a su área de administración con Google Chrome (por ejemplo, https://www.su-sitio.com/isa/admin.php o https://isa.startupfit.co/).
• Abra los ajustes de su navegador.
• Desplácese hacia abajo y toque Añadir a la pantalla de inicio.
• Confirme tocando Añadir.

Instalación móvil - iPhone o Mac - Todas las versiones

• Acceda a su área de administración con Safari (por ejemplo, https://www.su-sitio.com/isa/admin.php o https://isa.startupfit.co/).
• Pulse el botón Compartir y seleccione Añadir a la pantalla de inicio en el menú emergente.
• Toque Añadir en la esquina superior derecha para finalizar la instalación de la PWA.

Instalación en WordPress

Para instalar la PWA en WordPress, debe acceder directamente al área de administración yendo a:

[URL-DE-ISA]/admin.php

Reemplace [URL-DE-ISA] con su URL de instalación; obténgala en Ajustes > Varios > URL de instalación.

Cambiar el icono y el nombre de la PWA

Descargue el archivo manifest.json aquí. Edítelo y reemplace YOUR NAME con su nombre de marca, YOUR NAME DESCRIPTION con el texto que desee, y example.png con la URL de su icono (el tamaño del icono debe ser de 512x512px). Una vez terminada la edición del archivo, muévalo a la carpeta de instalación de Isa donde se encuentra el archivo admin.php. Tenga en cuenta que la ayuda con esto no está incluida en nuestro soporte. Si necesita asistencia, puede contratarnos.

Atajos de teclado

Los atajos de teclado del área de administración están habilitados tanto en PC como en MAC y funcionan de la siguiente manera:

ENTER

SPACE

ESC

CANCEL

CTRL + ENTER

ESC

CANCEL

CTRL + UN ARRIBA/ABAJO

CTRL + UN DERECHA/IZQUIERDA

CTRL + V

CTRL + clic izquierdo del ratón

define('SB_UPLOAD_URL', 'SU-URL')

define('SB_UPLOAD_PATH', 'SU-RUTA')

$GLOBALS['SB_LOCAL_SETTINGS'] = []

Tareas programadas (Cron Jobs)

• Las tareas programadas se ejecutan por el primer usuario que visita el sitio web a cualquier hora del día.
• Las tareas programadas se ejecutan cada 60 minutos (cada 60 segundos para la recepción de correos), pero puede tardar más, o puede tardar menos, en función del tráfico de su sitio web.
• Debido a que las tareas programadas son iniciadas por los usuarios, si tiene menos de 1 visitante por hora (por minuto para la recepción de correos), podría tardar más. Mientras haya al menos un usuario activo en el sitio, la ejecución cada 60 minutos (60 segundos para la recepción de correos) está garantizada.
• Puede acelerar la ejecución de las tareas programadas ejecutándolas manualmente a través de la API WEB o la API PHP.
• También puede acelerar las tareas programadas creando un cron job que ejecute la URL [URL-DE-ISA]/include/api.php?cron=true. Utilice el comando */59 * * * * wget [URL-DE-ISA]/include/api.php?cron=true para ejecutarlo mediante un comando. Reemplace [URL-DE-ISA] con su URL de instalación. Para obtener la URL, siga estos pasos:
  Si utiliza la versión WP o PHP, vaya a Ajustes > Varios > URL de instalación. Si utiliza la versión cloud, utilice esta URL: https://isa.startupfit.co/script/include/api.php?piping=true&cloud=TOKEN-API y reemplace TOKEN-API con su token de API.

Parámetros de URL

Chat de usuario (Front-end)

Los parámetros de URL permiten que el chat realice acciones específicas al cargar la página. Para utilizarlos, añada los parámetros de URL siguientes a cualquier URL de su sitio web que muestre el chat. Ej.: https://ejemplo.com/?conversation=1234

?token=TOKEN

?conversation=ID

?chat=open

Área de administración

Los parámetros de URL permiten que el área de administración realice acciones específicas al cargar la página. Para utilizarlos, añada los parámetros de URL siguientes a su URL de administración. Ej.: https://ejemplo.com/isa/admin.php?conversation=1234 o https://isa.startupfit.co/?conversation=1234.

?conversation=ID

?user=ID

?setting=ID

?report=ID

?area=nombre

?login_email=email&login_password=contraseña

Calendly

Siga los pasos a continuación para enviar una invitación de reserva de Calendly.

• Cree un tipo de evento en https://calendly.com/event_types/user/me.
• Haga clic en compartir (share) y copie la URL.
• Para enviar la invitación de Calendly, utilice el tipo de botón de mensaje enriquecido. Asegúrese de introducir la URL de Calendly que copió en el paso anterior como URL. Además, incluya el atributo success para personalizar el mensaje que se enviará después de que la reserva se haya completado correctamente. Ej.: [button link="https://calendly.com/tu-perfil/sb" name="Programar una reunión" success="¡Gracias! Su reunión ha sido programada."]

Zapier

Aplicación de Zapier - Solo versión Cloud

Si utiliza la versión cloud, utilice la aplicación de Zapier disponible en https://zapier.com/apps/isa-startup/integrations.

Integración manual - Todas las versiones

Integre Zapier con Isa siguiendo los pasos a continuación. La integración se basa en los webhooks de Isa; cada webhook es un disparador (trigger) de Zapier, por lo que tiene más de 15 disparadores de Zapier disponibles. Para más detalles, visite la página de webhooks. Si utiliza la versión PHP o WordPress, la integración manual es la única opción disponible.

• Vaya a https://developer.zapier.com/ e inicie sesión o registre una nueva cuenta.
• Cree una nueva integración haciendo clic en Start a Zapier Integration, o visite https://developer.zapier.com/app/new. Rellene todos los campos obligatorios, como el nombre y la descripción, y haga clic en Create. Puede introducir el texto que desee, pero tenga en cuenta el nombre de la aplicación porque lo necesitará más adelante.
• En el menú de la izquierda, haga clic en Triggers y luego en Add Trigger.
• Rellene todos los campos obligatorios, como la clave (key) y la descripción, y haga clic en Save And Continue. Puede introducir el texto que desee.
• En la parte superior, haga clic en API Configuration, elija REST Hook como Trigger Type y haga clic en Save.
• Vuelva al área de Settings del disparador, o vaya a https://zapier.com/app/zaps y haga clic en Create a Zap.
• Busque su aplicación recién creada introduciendo el nombre de la aplicación y haga clic en ella. En Trigger Event, seleccione su disparador y haga clic en continue.
• Copie la URL del Webhook, haga clic en Continue, y luego entre en el área de administración de Isa e introdúzcala en Ajustes > Varios > Webhooks > URL. Active los webhooks, guarde los ajustes y recargue Isa.

Validación del código de compra de Envato

• Obtenga el token en https://build.envato.com/create-token. Seleccione los siguientes alcances (scopes): View and search Envato sites, View the user's items' sales history, Verify purchases of the user's items, Verify purchases the user has made, View the user's purchases of the app creator's items.
• Añada varios IDs de producto separados por comas.

Seguridad

La seguridad es fundamental en Isa. Trabajamos con expertos en seguridad que realizan auditorías periódicas. Implementamos continuamente las últimas tecnologías de seguridad y nos mantenemos al día sobre las amenazas más recientes. A continuación, encontrará algunas de las medidas de seguridad implementadas en Isa.

Bloqueo de IP (IP ban)

Isa permite un máximo de 10 intentos fallidos de inicio de sesión en una hora. En caso de que un usuario, administrador o agente supere el límite, no podrá acceder a su cuenta ni al área de administración durante un periodo 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 "Demasiados intentos de inicio de sesión. Por favor, vuelva a intentarlo en unas horas.", tiene dos opciones: o bien esperar unas horas o bien realizar cambios en la base de datos de Isa eliminando la fila ip-ban de la tabla sb_settings.

Protección contra inyección XSS

Para prevenir ataques de inyección XSS, todas las entradas sensibles del usuario se someten a un proceso de saneamiento (sanitization).

Protección contra falsificación de petición en sitios cruzados (CSRF)

Para prevenir ataques CSRF, todas las peticiones se validan comprobando la cookie de sesión y la cadena de inicio de sesión del lado del cliente.

Finalizació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 las sesiones activas.

Protección de nombre de archivo

Isa garantiza que todos los archivos subidos sean renombrados con una cadena alfanumérica aleatoria antepuesta al nombre original del archivo para evitar el descubrimiento de la URL y la descarga no autorizada del archivo subido. Tenga en cuenta que, para que esta función funcione correctamente, su servidor debe prohibir el listado de directorios.

Conexiones cifradas MySQL

Para configurar Isa y MySQL para utilizar conexiones cifradas, edite el archivo config.php de Isa y añada las siguientes constantes: SB_DB_CERTIFICATE_PATH, SB_DB_CERTIFICATE_CLIENT_KEY, SB_DB_CERTIFICATE_CLIENT, SB_DB_CERTIFICATE_CA.

Performance

Isa 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 competidores, lo que garantiza tiempos de carga más rápidos. El rendimiento del lado del servidor es igual de impresionante. El sistema es extremadamente ligero, construido sin frameworks ni código innecesario. Es modular, minimalista y está totalmente optimizado para el máximo rendimiento. No obstante, puede mejorar aún más el rendimiento desde Ajustes > Varios > Optimización del rendimiento. A continuación se describen los ajustes de optimización disponibles.

• Minificar JS: Habilita la carga de archivos JavaScript y CSS minificados para el widget de chat del lado del cliente, reduciendo el tamaño del archivo y mejorando la velocidad de carga.
• Desactivar informes: Desactiva el área de informes y detiene el registro de datos de informes. Esto evita que el sistema consuma recursos para recopilar y almacenar información relacionada con los informes.
• Desactivar artículos: Desactiva el área de artículos y la funcionalidad de artículos. 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: Mueve los mensajes más antiguos del intervalo especificado a una tabla de copia de seguridad de la base de datos dedicada. 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 mensaje nuevo en el futuro, el sistema restaurará automáticamente la conversación y su historial de mensajes. También puede acceder y restaurar manualmente las conversaciones archivadas en cualquier momento abriendo el perfil del usuario y seleccionando la conversación archivada. Active esta función si gestiona un gran volumen de mensajes (en millones). Mejorará drásticamente el rendimiento.

Personalización

Puede editar totalmente el código fuente de las versiones PHP y WordPress de Isa. Consulte los términos de servicio para más detalles. El código fuente de la versión cloud no es editable, pero puede personalizarlo utilizando la API de JavaScript y la API Web, o con JavaScript y CSS. El widget de chat no utiliza un iframe, por lo que puede personalizarlo fácilmente con JavaScript y CSS.

Contrátenos

Si desea que personalicemos Isa para usted, póngase en contacto con nosotros y envíenos sus requisitos. Le proporcionaremos un presupuesto basado en la complejidad del trabajo. Nuestra tarifa por hora es de 100 USD. Contáctenos a través del chat en la esquina inferior derecha de la página o envíenos un correo electrónico a sales@isa.startupfit.co. Normalmente respondemos en 24 horas.