Manual visual paso a paso.

sem.chat documentación

Un manual de SEMJAT respaldado por capturas de pantalla creado a partir del flujo real del panel de sem.chat. Cada guía le indica en qué hacer clic, qué debe suceder después del clic, cómo probarlo, cómo solucionarlo y qué hacer a continuación.

No se encontraron guías coincidentes. Pruebe con una palabra clave más corta, como widget, API, voz, facturación, webhook, WordPress, SendPulse o programación.
Nota de captura de pantalla: Cada imagen de este manual se capturó desde la app real de sem.chat usando un espacio de trabajo de demostración. Los datos sensibles de cuenta, clientes, claves API, pagos y conversaciones privadas se ocultan antes de publicarse.
01

Empezando

Cree la cuenta, finalice la incorporación, comprenda el panel, cree el primer bot, pruébelo de forma privada, instálelo y elija el plan adecuado.

/autenticaciónRegistro, prueba y primer bot
Captura real del espacio de trabajo de demostración de sem.chat
1Comience con Registrarse o Iniciar sesión desde el sitio o aplicación pública.
2Verifique la dirección de correo electrónico antes de depender de notificaciones o mensajes de facturación.
3Utilice la incorporación para crear el primer bot antes de abrir el panel.
/descripción generalDescripción general después de iniciar sesión
Captura real del espacio de trabajo de demostración de sem.chat
1Utilice acciones rápidas para crear un bot, ver bots, abrir análisis o administrar la facturación.
2Revise los bots activos, conversations, los minutos de voz y la satisfacción antes de realizar cambios.
3Verifique la actividad reciente después de cada prueba de configuración.
Primer lanzamiento

Regístrese, inicie la prueba y comprenda el panel

Para qué es esto: Utilice este flujo de trabajo para un espacio de trabajo nuevo o cuando incorpore a un compañero de equipo que nunca haya usado sem.chat.

Antes de empezar
  • Utilice un correo electrónico comercial que pueda recibir correos electrónicos de verificación y facturación.
  • Decida quién debería ser el propietario del espacio de trabajo antes de invitar al resto del equipo.
  • Mantenga un sitio web de prueba seguro o una página de prueba lista para la instalación del widget.
1

Abra la página de registro de la aplicación

Vaya a app.sem.chat/auth desde el botón Iniciar sesión/Registrarse del sitio web.

Resultado esperado: La página de autenticación muestra opciones de inicio de sesión y creación de cuenta.
2

Crea la cuenta

Ingrese el correo electrónico comercial, cree la contraseña y envíe el formulario de registro.

Resultado esperado: La aplicación solicita verificación o pasa a la incorporación después de que se acepta la cuenta.
3

Verificar el correo electrónico

Abra el correo electrónico de verificación y haga clic en el enlace de confirmación.

Resultado esperado: La cuenta puede recibir mensajes de facturación, invitación, informes y alertas.
4

Incorporación completa

Ingrese el nombre de la empresa, describa el objetivo del asistente, elija un color inicial y cree el primer bot.

Resultado esperado: El espacio de trabajo se abre con un borrador de bot y un estado de prueba activo.
5

Abrir descripción general

Haga clic en Descripción general en la barra lateral izquierda.

Resultado esperado: El panel muestra usage tarjetas, acciones rápidas y actividad reciente.
6

Elige la siguiente acción

Utilice Crear nuevo bot para la configuración, Ver todos los bots para la administración, Análisis para el rendimiento o Facturación para los límites del plan.

Resultado esperado: Sabes dónde continuar según el estado del espacio de trabajo.
Cómo probarlo: Cree un bot de prueba privado y envíe un mensaje de prueba antes de invitar a compañeros de equipo. Confirme los cambios en la actividad general después de la prueba.
problemaArreglar
El correo electrónico de verificación no llegaVerifique el spam, confirme la ortografía del correo electrónico y luego solicite otro correo electrónico de verificación.
El panel se abre en FacturaciónEs posible que el espacio de trabajo necesite una prueba o un plan activo. Inicie la prueba o elija el plan correcto antes de la configuración.
Un compañero de equipo no puede acceder al espacio de trabajo.Invítelos desde Configuración, Equipo en lugar de compartir el inicio de sesión del propietario.

Qué hacer a continuación: Cree el primer bot, pruébelo de forma privada y luego instale el widget en una página de prueba.

Prueba de lanzamiento privada

Cree la primera prueba de bot privada antes de publicarla

Para qué es esto: Úselo para verificar el seguimiento de la cuenta, el bot, el widget y el historial antes de que los clientes vean al asistente.

Antes de empezar
  • Tenga listo un ejemplo de pregunta de un cliente.
  • Tenga lista una página de prueba o una página de prueba HTML local.
  • No utilice datos reales del cliente en la primera prueba.
1

Abrir My Bots

Haga clic en My Bots en la barra lateral o use Ver todos los bots desde la descripción general.

Resultado esperado: Puede ver el bot creado durante la incorporación o un estado vacío con un botón Nuevo bot.
2

Abre el generador de bots

Haga clic en Nuevo bot o Editar en el bot existente.

Resultado esperado: El Bot Builder se abre con controles básicos, widgets, conocimientos, voz y integración.
3

Guarde el bot una vez

Complete el nombre del bot requerido y el primer mensaje, luego haga clic en Guardar.

Resultado esperado: El bot recibe una identificación válida y puede generar un código para insertar.
4

Vista previa privada

Utilice el panel de vista previa y haga su pregunta de muestra.

Resultado esperado: La respuesta debe coincidir con sus instrucciones o revelar qué conocimientos faltan.
5

Instalar en escena

Abra Insertar, copie el fragmento HTML y péguelo antes de la etiqueta del cuerpo de cierre en la página de prueba.

Resultado esperado: El widget aparece en la esquina configurada en computadoras de escritorio y dispositivos móviles.
6

Confirmar seguimiento

Abra la Bandeja de entrada o Chat History después de la conversación de prueba.

Resultado esperado: La conversación de prueba aparece con el bot, el canal y el historial de mensajes correctos.
Cómo probarlo: Envíe un mensaje de texto y una prueba de voz si la voz está habilitada. Confirma que ambos aparecen en Chat History.
problemaArreglar
El código para insertar no está disponibleGuarde el bot primero. Si la sincronización de voz aún está pendiente, espere la sincronización o guárdela nuevamente después de completar los campos obligatorios.
El widget muestra el bot incorrectoConfirme que data-bot-id en el fragmento coincida con el ID del bot del modo Insertar.
No aparece ninguna conversación en el historial.Actualice Chat History, confirme que el bot esté activo y asegúrese de que la prueba se haya realizado en el widget instalado, no en una página obsoleta.

Qué hacer a continuación: Pase a Bot Builder configuración y capacitación de conocimientos.

02

Crear y configurar un bot

Cree, edite, obtenga una vista previa, active, transfiera o elimine bots de My Bots y Bot Builder.

/panelMy Bots centro de control
Captura real del espacio de trabajo de demostración de sem.chat
1Haga clic en Nuevo Bot para iniciar un nuevo asistente.
2Utilice Editar, Incrustar, Transferir, Activar o Eliminar en cada tarjeta de bot.
3Verifique el estado activo y la hora de la última actualización antes de realizar la prueba.
/bots/:id/editarBot Builder pestaña de conceptos básicos
Captura real del espacio de trabajo de demostración de sem.chat
1Complete el nombre del bot, el avatar, el primer mensaje y las instrucciones del sistema.
2Utilice Vista previa para probar antes de publicar.
3Guarde y sincronice antes de copiar el código para insertar.
crear robot

Crea un nuevo bot desde My Bots

Para qué es esto: Utilice este flujo de trabajo cuando una nueva marca, sitio web, cola de soporte o campaña necesite su propio asistente.

Antes de empezar
  • Prepare el nombre del bot, el objetivo, el primer mensaje y dos o tres preguntas de muestra.
  • Recopile el sitio web público URL si planea importar contenido.
  • Confirma que el plan permite la cantidad de bots y funciones de voz/avatar que necesitas.
1

Abrir My Bots

Haga clic en My Bots en la barra lateral.

Resultado esperado: Los bots existentes y el botón Nuevo Bot son visibles.
2

Haga clic en Nuevo robot

Inicie un nuevo bot desde la página My Bots.

Resultado esperado: Bot Builder se abre con un asistente de borrador.
3

Establecer identidad del bot

Ingrese el nombre del bot, cargue o elija un avatar y escriba el primer mensaje que verán los visitantes.

Resultado esperado: El panel de vista previa refleja el nombre, el avatar y el saludo del asistente.
4

Escribir instrucciones del sistema

Describe qué debe hacer el robot, cómo debe hablar, qué debe evitar y cuándo debe pedir ayuda humana.

Resultado esperado: El asistente tiene reglas de comportamiento claras antes de agregar conocimientos.
5

Añadir conocimientos básicos

Pegue la información esencial de la empresa, el producto, el soporte, los precios y el contacto en el área de conocimiento.

Resultado esperado: El bot puede responder preguntas comunes sin necesidad de importar el sitio web todavía.
6

guarda el robot

Haga clic en Guardar y espere la confirmación guardada o sincronizada.

Resultado esperado: El bot tiene una identificación estable, se puede probar una vista previa y las opciones de inserción están disponibles.
7

Vista previa del resultado

Haga las preguntas de muestra preparadas en Vista previa.

Resultado esperado: Las respuestas deben seguir las instrucciones y utilizar el conocimiento que ingresó.
8

Activar solo cuando esté listo

Active el bot después de que pase la prueba privada.

Resultado esperado: El bot está listo para el tráfico de widgets o canales.
Cómo probarlo: Haga al menos cinco preguntas realistas. Compruebe si la respuesta es correcta, si se ajusta a la marca y si solicita ayuda humana cuando es necesaria.
problemaArreglar
La respuesta es demasiado genérica.Agregue conocimientos más específicos y reescriba instrucciones con ejemplos de buenas respuestas.
El robot rechaza las preguntas que debería responder.Elimine instrucciones demasiado estrictas y agregue conocimientos confiables para ese tema.
Guardar no genera código para insertarVerifique los campos obligatorios y guárdelos nuevamente después de que finalice la sincronización del proveedor de voz.

Qué hacer a continuación: Configure los ajustes del widget, agregue conocimiento del sitio web y luego instale el bot.

Administrar robots

Editar, clonar flujo de trabajo, transferir, desactivar o eliminar un bot

Para qué es esto: Utilice este flujo de trabajo cuando un bot necesite actualizaciones, cambios de propiedad, pausa temporal o eliminación permanente.

Antes de empezar
  • Exporta cualquier conversación o información de contacto que debas conservar antes de eliminar un bot.
  • Confirme que el bot no esté integrado en un sitio web activo antes de eliminarlo o transferirlo.
  • Informe a sus compañeros de equipo antes de desactivar un bot de producción.
1

Abrir My Bots

Busque la tarjeta del bot por nombre o estado.

Resultado esperado: La tarjeta muestra el estado actual y las acciones disponibles.
2

Haga clic en Editar

Abra el generador de bots y realice los cambios necesarios.

Resultado esperado: El editor carga la configuración actual.
3

Guardar y volver a probar

Haga clic en Guardar después de cada cambio de material y luego ejecute preguntas de vista previa.

Resultado esperado: La configuración guardada es utilizada por la vista previa y el widget instalado.
4

Desactivar temporalmente

Utilice la palanca activa si el bot deja de manejar visitantes por ahora.

Resultado esperado: El bot deja de atender tráfico en vivo mientras conserva la configuración.
5

Transferir propiedad

Utilice Transferir, introduzca el correo electrónico del destinatario y confirme.

Resultado esperado: La cuenta seleccionada recibe propiedad según el flujo de transferencia de la aplicación.
6

Eliminar solo después de las comprobaciones

Utilice Eliminar, lea la advertencia y confirme solo cuando el bot ya no sea necesario.

Resultado esperado: El bot y la configuración relacionada se eliminan según la advertencia.
Cómo probarlo: Después de editar, abra el widget instalado y haga la pregunta exacta que motivó el cambio. Confirme que la respuesta en vivo cambió.
problemaArreglar
La antigua respuesta todavía aparece.Actualice la página del sitio web, confirme que guardó el bot correcto y verifique si el conocimiento importado necesita sincronización.
La transferencia fallaConfirme que el correo electrónico del destinatario sea válido y que la cuenta de destino pueda aceptar el bot.
Se hizo clic en Eliminar por error.Deténgase antes de la confirmación final. Existen advertencias de eliminación porque la acción puede eliminar los datos del bot de forma permanente.

Qué hacer a continuación: Revise los análisis y el historial después de los cambios en vivo para asegurarse de que la experiencia de los visitantes mejore.

03

Instalar el widget

Copie el código de inserción correcto, instálelo en contextos HTML, WordPress, React o SDK avanzados y luego verifique el comportamiento en dispositivos móviles y de escritorio.

Insertar modalCopie el fragmento de instalación del sitio web
Captura real del espacio de trabajo de demostración de sem.chat
1Elija HTML, WordPress, React o NPM/SDK según la pila del sitio.
2Copie el código después de guardar y sincronizar el bot.
3Pegue el fragmento antes de la etiqueta del cuerpo de cierre o en el diseño del marco.
HTML instalar

Instale el widget en un sitio web estándar HTML

Para qué es esto: Úselo cuando pueda editar la plantilla de página, el pie de página del tema o el diseño global HTML.

Antes de empezar
  • Guarde el bot primero para que el modal de inserción tenga una ID de bot real.
  • Utilice un sitio de preparación antes de la producción.
  • Mantenga la versión exacta del script y data-bot-id del modal.
1

Abrir My Bots

Busque el bot que desea instalar y haga clic en Insertar.

Resultado esperado: El modal Insertar se abre con pestañas de instalación.
2

Seleccione HTML

Elija la pestaña HTML y haga clic en Copiar código.

Resultado esperado: El script del widget se copia con el ID del bot adjunto.
3

Abra la plantilla del sitio web

Edite el pie de página global o el archivo de diseño que se muestra en cada página donde debería aparecer el widget.

Resultado esperado: Está editando el shell del sitio compartido, no una sola página aislada a menos que sea intencional.
4

Pegar antes de cerrar el cuerpo.

Pegue el fragmento inmediatamente antes de la etiqueta del cuerpo de cierre.

Resultado esperado: El script se carga después del contenido de la página y puede montar el contenedor del widget.
5

Publicar o implementar

Guarde la plantilla e implemente el sitio.

Resultado esperado: El script del widget está activo en las páginas de destino.
6

Pruebe computadoras de escritorio y dispositivos móviles

Abra el sitio en una nueva ventana del navegador y en una ventana gráfica móvil.

Resultado esperado: El widget aparece en la posición configurada y se abre sin errores de consola.
Cómo probarlo: Envíe un mensaje desde la página en vivo, luego abra la Bandeja de entrada y Chat History para confirmar que la conversación pertenece al bot correcto.
problemaArreglar
Falta el widgetConfirme que el código esté antes de la etiqueta del cuerpo de cierre, que el creador del sitio no bloquee los scripts y que el bot esté activo.
Aparece un bot incorrectoCopie el fragmento nuevamente y compare data-bot-id con el bot deseado.
El widget se superpone a los controles de la páginaCambie la posición o el tamaño en la configuración del widget y vuelva a probar en el dispositivo móvil.

Qué hacer a continuación: Ajuste la configuración del widget y la captura de clientes potenciales después de la instalación.

HTML insertar
<!-- sem.chat Voice & Text Widget -->
<script
  src="https://app.sem.chat/widget-v2.js?v=16"
  data-bot-id="YOUR_BOT_ID"
></script>
Instalación de plataforma

Instalar en WordPress, React o flujos de voz avanzados SDK

Para qué es esto: Úselo cuando el sitio web esté administrado por un CMS, una aplicación React o una integración de voz personalizada.

Antes de empezar
  • Sepa qué pila posee el diseño compartido.
  • Utilice el fragmento exacto que se muestra en sem.chat para el bot seleccionado.
  • Para un uso avanzado de SDK, confirme que tiene la clave pública Vapi y el ID de asistente requeridos.
1

Opción WordPress

Utilice Apariencia, Editor de temas, footer.php o un complemento confiable de encabezados y pies de página.

Resultado esperado: El fragmento se carga en páginas públicas WordPress.
2

Opción React

Cree un pequeño componente ChatWidget, agregue el script en useEffect y renderícelo en el diseño raíz.

Resultado esperado: El widget se carga una vez y se limpia si el diseño se desmonta.
3

Opción avanzada SDK

Utilice la pestaña NPM/SDK solo cuando necesite controles de llamadas de voz personalizados más allá del widget predeterminado.

Resultado esperado: Su aplicación controla la sesión de voz mientras sem.chat sigue siendo la fuente de asistente configurada.
4

Verificar ID del bot

Confirme que el código instalado haga referencia al ID del bot del modo Insertar.

Resultado esperado: El widget en vivo se conecta con el asistente deseado.
5

comprobar consola

Abra las herramientas de desarrollo del navegador y vuelva a cargar.

Resultado esperado: No hay errores de secuencia de comandos bloqueados, contenedores duplicados o de red.
Cómo probarlo: Complete un mensaje de prueba del sitio instalado y luego confirme que aparece en la Bandeja de entrada con la página esperada URL.
problemaArreglar
React carga widgets duplicadosProteja la inserción del script con una referencia o represente el componente solo en el diseño raíz.
WordPress elimina las etiquetas de scriptUtilice un complemento de inyección de pie de página o un archivo de tema que permita scripts.
La llamada SDK no puede iniciarseVerifique la clave pública, la identificación del asistente, los permisos del navegador y planifique el acceso para voz.

Qué hacer a continuación: Vaya a Configuración de widgets para controlar el comportamiento, la marca y la captura de clientes potenciales.

WordPress fragmento de pie de página
<!-- sem.chat Widget (WordPress Compatible) -->
<script>
window.SEMCHAT_CONFIG = { botId: "YOUR_BOT_ID" };
</script>
<script src="https://app.sem.chat/widget-v2.js?v=16"></script>
React componente
import { useEffect, useRef } from 'react';

export function ChatWidget() {
  const loaded = useRef(false);

  useEffect(() => {
    if (loaded.current) return;
    loaded.current = true;

    const script = document.createElement('script');
    script.src = 'https://app.sem.chat/widget-v2.js?v=16';
    script.setAttribute('data-bot-id', 'YOUR_BOT_ID');
    script.async = true;
    document.body.appendChild(script);

    return () => {
      const container = document.getElementById('semchat-widget-container');
      if (container) container.remove();
      script.remove();
    };
  }, []);

  return null;
}
Voz avanzada SDK
npm install @vapi-ai/web

import Vapi from '@vapi-ai/web';

const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');

vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04

Configuración de widgets

Configure el modo, tema, tamaño, posición, color, marca, reacciones, sonido, consentimiento, captura de clientes potenciales, calificaciones, correo electrónico de seguimiento y estado de activación.

Bot Builder / WidgetApariencia del widget y comportamiento de los visitantes.
Captura real del espacio de trabajo de demostración de sem.chat
1Elija chat, voz o modo híbrido.
2Establezca tema, color, posición, tamaño, marca, consentimiento y sonido.
3Configure la captura de clientes potenciales, las calificaciones, las reacciones y el comportamiento de seguimiento.
Comportamiento de los widgets

Configurar el comportamiento del widget de cara al visitante

Para qué es esto: Úselo después de la primera instalación o en cualquier momento que el widget necesite coincidir con el sitio web y capturar mejores clientes potenciales.

Antes de empezar
  • Instale el widget en una página de prueba.
  • Sepa si los visitantes deben comenzar con chat, voz o ambas.
  • Prepare el consentimiento y la copia de captura de clientes potenciales si es necesario para la región.
1

Abre el generador de bots

Abra My Bots, haga clic en Editar y luego elija la pestaña Widget.

Resultado esperado: Los controles de widget aparecen para el bot seleccionado.
2

Elige el modo

Seleccione Chat, Voz o Híbrido según la experiencia del visitante que desee.

Resultado esperado: La vista previa cambia para mostrar el modo elegido.
3

Establecer apariencia

Elija tema, color, tamaño, posición del botón y opciones de marca.

Resultado esperado: El widget coincide con el sitio sin cubrir contenido importante.
4

Habilitar controles de visitantes

Active o desactive las reacciones, el sonido, las calificaciones y las solicitudes de consentimiento.

Resultado esperado: Los visitantes solo ven los controles que usted desea que utilicen.
5

Configurar la captura de clientes potenciales

Elija los campos obligatorios, el campo de descripción opcional y cuándo aparece el formulario.

Resultado esperado: Los contactos se recopilan antes o durante conversations según su configuración.
6

Establecer correo electrónico de seguimiento

Configure el comportamiento del correo electrónico de seguimiento si su plan lo incluye.

Resultado esperado: Los visitantes pueden recibir mensajes de seguimiento después de resolver conversations.
7

Guardar y probar

Haga clic en Guardar, vuelva a cargar la página de preparación y abra el widget.

Resultado esperado: El widget en vivo coincide con la configuración guardada.
Cómo probarlo: Abra el widget en computadoras de escritorio y dispositivos móviles, envíe un formulario para clientes potenciales, deje una calificación y confirme que el contacto y la conversación estén grabados.
problemaArreglar
El color no se actualizóGuarde el bot, actualice completamente el sitio web y confirme que el widget instalado utilice el mismo ID de bot.
Faltan campos de clientes potencialesConfirme que la captura de clientes potenciales esté habilitada y que se cumpla la condición de activación seleccionada.
Los visitantes no pueden usar la voz.Verifique la configuración de voz, el permiso del micrófono del navegador, el acceso al plan y los límites de minutos de voz.

Qué hacer a continuación: Agregue configuraciones de voz/avatar y fuentes de conocimiento antes del lanzamiento de la producción.

05

Voz y avatares

Seleccione voces estándar, configure el modo y los límites de voz, lea transcripciones, clone voces, asigne voces clonadas y administre avatares estándar o personalizados.

Bot Builder / VozVoz, límites, transcripciones y avatares.
Captura real del espacio de trabajo de demostración de sem.chat
1Elija una voz estándar o una voz clonada guardada.
2Establezca límites de minutos de voz y guarde transcripciones.
3Elija avatares de stock o cargue un avatar personalizado si el plan lo permite.
Configuración de voz

Configurar llamadas de voz y transcripciones

Para qué es esto: Úselo cuando los visitantes deban hablar con el bot en lugar de simplemente escribir.

Antes de empezar
  • Confirme que el plan incluye minutos de voz y las opciones de voz/avatar deseadas.
  • Utilice un entorno de navegador silencioso para las pruebas.
  • Prepare una pregunta realista de soporte o ventas para probarla por voz.
1

Abrir configuración de voz

Abra el generador de bots y seleccione el área Voz o Voz y Avatares.

Resultado esperado: Los controles de voz y la selección de voz actual son visibles.
2

Seleccione una voz común

Obtenga una vista previa de las voces disponibles, elija la que mejor se adapte y guarde la selección.

Resultado esperado: El bot utiliza la voz elegida para las llamadas.
3

Configurar el modo de voz

Utilice la configuración del widget para elegir Voz o Híbrido cuando la voz debería estar disponible para los visitantes.

Resultado esperado: Los visitantes ven una opción de voz en el widget.
4

Establecer límites de voz

Defina límites por usuario o espacio de trabajo, si están disponibles.

Resultado esperado: Las llamadas largas o repetidas no pueden consumir más minutos de los previstos.
5

Habilitar transcripciones

Active el guardado de transcripciones si necesita revisar las llamadas en el historial.

Resultado esperado: Las llamadas de voz crean transcripciones legibles después de la sesión.
6

Probar una llamada

Abra el widget, permita el acceso al micrófono, inicie una llamada y haga la pregunta preparada.

Resultado esperado: El bot responde por voz y la llamada finaliza limpiamente.
7

Leer la transcripción

Abra Chat History y busque la conversación de voz.

Resultado esperado: La transcripción muestra lo que dijeron el visitante y el bot.
Cómo probarlo: Complete una llamada breve y confirme que se graben los minutos de voz, la transcripción y el modo de conversación.
problemaArreglar
El navegador bloquea el micrófonoPermita el permiso del micrófono en el navegador y vuelva a cargar la página.
La opción de voz está bloqueadaAbra Facturación y confirme que el plan del espacio de trabajo incluye funciones de voz.
La transcripción está vacíaConfirme que el guardado de la transcripción esté habilitado y que la llamada finalizó normalmente.

Qué hacer a continuación: Agregue o perfeccione conocimientos para que las respuestas de voz sean precisas.

Clon de voz y avatar

Clona una voz y asigna un avatar personalizado

Para qué es esto: Úselo cuando el asistente necesite una voz de marca o una experiencia de avatar parlante.

Antes de empezar
  • Utilice únicamente audio e imágenes para las que tenga permiso.
  • Grabe muestras de voz limpias con poco ruido de fondo.
  • Confirme los límites del plan para voces clonadas y avatares personalizados.
1

Clonación de voz abierta

Haga clic en Clonar voz en el área Voz.

Resultado esperado: El cuadro de diálogo de carga muestra los requisitos de muestra aceptados.
2

Cargar muestras

Cargue de una a cinco grabaciones claras y envíe la solicitud de clonación.

Resultado esperado: La voz clonada aparece después del procesamiento o el cuadro de diálogo muestra el siguiente requisito.
3

Asignar la voz clonada

Seleccione la voz clonada en el selector de voz y guárdela.

Resultado esperado: Las llamadas futuras utilizan la voz clonada.
4

Elige un avatar común

Elija un avatar incluido si no es necesario cargar un avatar personalizado.

Resultado esperado: La experiencia de la voz tiene una identidad visual.
5

Subir avatar personalizado

Sube una imagen de rostro clara o un video corto si tu plan lo admite.

Resultado esperado: El avatar se procesa y queda disponible para su selección.
6

Ejecute una vista previa completa

Inicie una llamada de voz y confirme el comportamiento de voz, avatar y transcripción juntos.

Resultado esperado: La experiencia del visitante coincide con la marca configurada.
Cómo probarlo: Haga una pregunta breve con la voz clonada seleccionada y confirme que la llamada utiliza la voz/avatar esperado.
problemaArreglar
La calidad del clon es mala.Grabe muestras más limpias con un altavoz, volumen estable y sin música.
La carga de avatar personalizado no está disponibleConsulta Facturación para conocer los límites de avatar según el plan.
La vieja voz todavía suena.Guarde el bot después de seleccionar la nueva voz y vuelva a cargar la página del widget.

Qué hacer a continuación: Continúe con Conocimiento y Datos para que la experiencia de voz tenga respuestas precisas.

06

Conocimiento y datos

Agregue conocimiento manual, importe contenido del sitio web, aplique resultados de rastreo, sincronice contenido importado, agregue feeds de productos URLs, actualice o elimine feeds y verifique las respuestas con preguntas de prueba.

Bot Builder / ConocimientoFuentes de conocimiento y pruebas de respuestas.
Captura real del espacio de trabajo de demostración de sem.chat
1Agregue conocimiento manual para políticas, precios y reglas de marca.
2Importe páginas de sitios web y aplique resultados de rastreo.
3Agregue feeds de productos y sincronícelos cuando cambie el inventario.
Fuentes de conocimiento

Entrene al bot con conocimientos manuales, importación de sitios web y feeds de productos.

Para qué es esto: Utilícelo siempre que el asistente dé respuestas incompletas o necesite información nueva sobre productos, políticas o sitios web.

Antes de empezar
  • Prepare la fuente URLs y el feed de productos URLs.
  • Decida qué páginas no se deben importar, como páginas de administración o privadas.
  • Crea preguntas de prueba para cada tema que agregues.
1

Conocimiento abierto

Abra Bot Builder y elija la pestaña Conocimiento o Datos.

Resultado esperado: El conocimiento manual, la importación de sitios web y las herramientas de alimentación de productos son visibles.
2

Agregar conocimiento manual

Pegue datos concisos, políticas, precios, detalles de contacto y notas de estilo de respuesta.

Resultado esperado: El bot tiene una fuente confiable inmediata para respuestas de alta prioridad.
3

Importar contenido del sitio web

Pegue el sitio web público URL e inicie el rastreo/importación.

Resultado esperado: Los resultados del rastreo muestran las páginas descubiertas o el estado de la importación.
4

Revisar y aplicar resultados

Mantenga las páginas útiles, elimine las páginas irrelevantes y luego aplique el contenido seleccionado.

Resultado esperado: Sólo el contenido del sitio web aprobado ingresa a la base de conocimientos.
5

Agregar feed de productos URLs

Pegue Google Merchant Center o el feed admitido URLs e importe.

Resultado esperado: Los productos, precios, disponibilidad y atributos quedan disponibles para el bot.
6

Actualizar o eliminar feeds

Utilice la actualización cuando cambien los datos del catálogo y elimine los feeds que ya no se utilizan.

Resultado esperado: El bot evita datos de productos obsoletos o duplicados.
7

Guardar y sincronizar

Guarde el bot y espere a que se complete la sincronización.

Resultado esperado: Los conocimientos más recientes se utilizan mediante la vista previa y las respuestas del widget en vivo.
8

Haga preguntas de verificación

Haga una pregunta de prueba por cada fuente que haya agregado.

Resultado esperado: La respuesta cita o refleja con precisión el contenido actualizado.
Cómo probarlo: Haga preguntas sobre precios, devoluciones, disponibilidad, información de la empresa y temas no admitidos. Confirme que el bot responde a temas conocidos y no inventa detalles desconocidos.
problemaArreglar
El rastreador importa páginas irrelevantesElimine esas páginas de los resultados seleccionados y agregue instrucciones manuales más claras.
Los precios de los productos están obsoletos.Actualice el feed y confirme que el feed URL contiene los valores actuales.
Bot inventa respuestasAgregue una regla según la cual el bot debe decir que no está seguro y ofrecer apoyo humano cuando falte conocimiento.

Qué hacer a continuación: Vuelva a Vista previa, pruebe nuevamente y luego instale o actualice el widget.

07

Bandeja de entrada, Live Support, Historial, Contactos

Maneje conversations diariamente, reclame solicitudes de soporte en vivo, devuelva el control a AI, exporte el historial, administre contactos y sincronice contactos con SendPulse.

/bandeja de entradaFlujo de trabajo de conversación en la bandeja de entrada
Captura real del espacio de trabajo de demostración de sem.chat
1Filtrar por bot o canal.
2Abra una conversación y responda como humano cuando sea necesario.
3Utilice con cuidado los controles de traducción, resolución y transferencia.
/soporte-en-vivoControl de transferencia de soporte en vivo
Captura real del espacio de trabajo de demostración de sem.chat
1Reclame rápidamente los traspasos en espera.
2Responda como agente o devuelva la conversación a AI.
3Resolver cuando el visitante ya no necesite ayuda humana.
/chat-historialHistorial de conversaciones y exportaciones.
Captura real del espacio de trabajo de demostración de sem.chat
1Busque por visitante, bot, canal o fecha.
2Abra transcripciones completas para sesiones de texto y voz.
3Exporte CSV o JSON cuando sea necesario.
/contactosExportación de contactos y SendPulse
Captura real del espacio de trabajo de demostración de sem.chat
1Filtrar contactos por bot o fuente.
2Abrir detalles de contacto y contexto de conversación.
3Exporte o sincronice los contactos seleccionados a SendPulse.
Responder a la bandeja de entrada

Abre una conversación y envía una respuesta humana

Para qué es esto: Úselo cuando un operador necesite responder a un cliente desde sem.chat en lugar de dejar que AI continúe sola.

Antes de empezar
  • Confirme que el operador tenga acceso al bot o al espacio de trabajo.
  • Lea la conversación antes de responder.
  • Sepa si el visitante espera el mismo idioma.
1

Abrir bandeja de entrada

Haga clic en Bandeja de entrada en la barra lateral.

Resultado esperado: Los conversations recientes aparecen con bot, canal, visitante, estado y hora.
2

Filtrar si es necesario

Utilice filtros de canal, bot, no leídos o de estado para encontrar la conversación.

Resultado esperado: La lista se reduce al conjunto de conversaciones que necesita.
3

abre la conversación

Haga clic en la fila de visitantes.

Resultado esperado: El hilo completo, la información del visitante y los controles de respuesta son visibles.
4

Traducir si es necesario

Utilice controles de traducción cuando el idioma del visitante difiera del idioma del agente.

Resultado esperado: El agente puede comprender y responder adecuadamente.
5

Enviar una respuesta

Escribe la respuesta humana y envíala.

Resultado esperado: El mensaje se agrega al hilo como una respuesta de agente/humano.
6

Resolver o mantener abierto

Resuelva la conversación si está completa o déjela abierta para seguimiento.

Resultado esperado: El estado de la bandeja de entrada coincide con el estado real del cliente.
Cómo probarlo: Envíe una respuesta de prueba segura a una conversación de prueba y confirme que aparezca en el widget de visitante y en Chat History.
problemaArreglar
La respuesta no se envíaVerifique el estado de la red, el estado de la conversación y si se ha solicitado soporte en vivo.
El idioma del visitante es incorrecto.Utilice la traducción o actualice la configuración de idioma del bot antes de responder.
La conversación no está en la bandeja de entradaBusque Chat History y confirme que la prueba del widget utilizó el bot correcto.

Qué hacer a continuación: Utilice Live Support para colas de transferencia activas y Chat History para auditorías.

Soporte en vivo

Reclamar, responder, devolver a la IA y resolver un traspaso

Para qué es esto: Utilícelo cuando la IA solicite un ser humano o un visitante necesite explícitamente un agente.

Antes de empezar
  • Tenga un agente disponible antes de habilitar el soporte en vivo.
  • Defina cuándo la IA debe solicitar la transferencia en las instrucciones del bot.
  • Mantenga habilitadas las configuraciones de notificación para alertas de transferencia.
1

Abrir Live Support

Haga clic en Live Support en la barra lateral.

Resultado esperado: La espera y la transferencia activa conversations son visibles.
2

Reclamar la solicitud

Haga clic en Reclamar en la conversación en espera.

Resultado esperado: Otros agentes pueden ver que la conversación se maneja activamente.
3

Leer contexto

Abra los mensajes y los detalles del visitante antes de responder.

Resultado esperado: El agente comprende por qué ocurrió el traspaso.
4

Enviar la respuesta humana

Responda claramente y mantenga el hilo actualizado.

Resultado esperado: El visitante recibe una respuesta humana.
5

Devolver a AI si corresponde

Utilice la mano de regreso cuando se resuelva el problema y la IA pueda continuar.

Resultado esperado: La IA continúa manejando la conversación.
6

Resolver cuando haya terminado

Haga clic en Resolver después de que el visitante ya no necesite ayuda.

Resultado esperado: La transferencia se cierra y se elimina de la cola activa.
Cómo probarlo: Cree una transferencia de prueba, reclámela, responda una vez, devuélvala y confirme los cambios de estado en Live Support y Chat History.
problemaArreglar
Los agentes pierden solicitudesHabilite el navegador/correo electrónico/notificaciones push y agregue un proceso para la propiedad de la cola.
La IA sigue asumiendo el control demasiado prontoAjuste las instrucciones y las reglas de transferencia para que el control humano permanezca activo hasta que se resuelva o se devuelva.
El CRM externo no está sincronizadoUtilice webhooks o encuestas de la sección Recetas para desarrolladores.

Qué hacer a continuación: Conecte CRM/webhooks si los equipos de soporte trabajan fuera de sem.chat.

Historia y contactos

Buscar, exportar y utilizar registros de conversaciones/contactos

Para qué es esto: Úselo para auditorías, revisión de clientes potenciales, exportación de CSV y sincronización de SendPulse.

Antes de empezar
  • Decide si necesitas conversations, contactos o ambos.
  • Aplique el rango de fechas correcto antes de exportar.
  • No exportes más datos personales de los necesarios.
1

Abrir Chat History

Haga clic en Chat History en la barra lateral.

Resultado esperado: Los filtros de conversación, las estadísticas y la lista de transcripciones son visibles.
2

Buscar y filtrar

Filtre por bot, canal, modo, visitante o rango de fechas.

Resultado esperado: Solo las coincidencias conversations permanecen visibles.
3

Abrir una transcripción

Haga clic en una conversación para leer el hilo de mensajes completo.

Resultado esperado: El contexto completo, los detalles de contacto y los metadatos de la conversación son visibles.
4

Exportar conversations

Haga clic en Exportar y elija el formato requerido si está disponible.

Resultado esperado: La exportación contiene los datos de la conversación filtrados.
5

Abrir contactos

Haga clic en Contactos en la barra lateral.

Resultado esperado: Los registros de clientes potenciales/contactos aparecen con fuente, bot y estado.
6

Filtrar y exportar contactos

Busque contactos, seleccione los registros deseados y luego exporte o sincronice con SendPulse.

Resultado esperado: Los contactos seleccionados están disponibles fuera de sem.chat según la acción elegida.
Cómo probarlo: Exporte un pequeño CSV filtrado y ábralo localmente para confirmar que las columnas y el rango de fechas sean correctos.
problemaArreglar
Falta contacto en ContactosConfirme que la captura de clientes potenciales esté habilitada y que el visitante haya enviado el formulario.
La exportación es demasiado grandeLimite el rango de fechas o el filtro de bots antes de exportar.
SendPulse sincronización no disponiblePrimero conecta SendPulse en Integraciones y luego regresa a Contactos.

Qué hacer a continuación: Revise Analytics para comprender las tendencias de rendimiento después de que se ejecuten las operaciones.

08

Canales e integraciones

Conecte Slack, Facebook, Instagram, WhatsApp, Telegram a través de BotFather, credenciales manuales, enlaces alternativos chat, integraciones SendPulse y CRM.

/integracionesCanales, CRM y conexiones de correo electrónico
Captura real del espacio de trabajo de demostración de sem.chat
1Elige el canal o tarjeta de integración CRM.
2Siga los pasos de OAuth o credenciales para cada proveedor.
3Desconecta o vuelve a probar las integraciones desde la misma página.
Conectar canales

Conectar un canal de mensajería o integración CRM

Para qué es esto: Utilice esto cuando sem.chat deba recibir conversations fuera del widget del sitio web o enviar contactos a otras herramientas.

Antes de empezar
  • Tener acceso de administrador a la plataforma externa.
  • Sepa qué bot debería recibir mensajes del canal.
  • Utilice canales de prueba antes de conectar cuentas de producción.
1

Integraciones abiertas

Haga clic en Integraciones en la barra lateral.

Resultado esperado: Los canales disponibles, las herramientas CRM, SendPulse y las opciones del widget del sitio web están visibles.
2

Elige la integración

Haga clic en Conectar en Slack, Metacanales, Telegram, SendPulse, CRM o credenciales manuales.

Resultado esperado: Se abre el cuadro de diálogo de configuración o el flujo de OAuth.
3

Configuración completa del proveedor

Para canales OAuth, apruebe los permisos solicitados. Para canales manuales, pegue el token, secreto, ID de cuenta o webhook requerido URL.

Resultado esperado: sem.chat almacena la conexión y muestra la integración como conectada.
4

Asignar el bot

Elija qué bot debe manejar los mensajes de ese canal cuando el cuadro de diálogo lo solicite.

Resultado esperado: Los mensajes entrantes se dirigen al asistente correcto.
5

prueba el canal

Envía un mensaje de prueba desde el canal externo.

Resultado esperado: El mensaje aparece en la Bandeja de entrada o Chat History en el canal correcto.
6

Desconectar si es necesario

Utilice Desconectar de la tarjeta de integración cuando el canal deba detenerse.

Resultado esperado: sem.chat deja de recibir o enviar a través de esa integración.
Cómo probarlo: Envíe un mensaje de prueba a través del canal conectado y confirme la respuesta del bot, la fila de la Bandeja de entrada y el registro del historial.
problemaArreglar
El token Telegram fallaCree o restablezca el token en BotFather y péguelo nuevamente.
Slack mensajes no lleganVerifique los alcances de la aplicación, la suscripción al evento URL, el token del bot, el secreto de firma y la membresía del canal.
La conexión del metacanal fallaConfirme que la cuenta Facebook/Instagram/WhatsApp tiene permisos de administrador y acceso comercial requerido.
SendPulse falla la sincronizaciónVuelva a conectar SendPulse y confirme que los campos de contacto estén asignados.

Qué hacer a continuación: Documente la propiedad del canal para el equipo y supervise la bandeja de entrada después del lanzamiento.

09

Programación

Cree tipos de eventos, configure la disponibilidad, conecte calendarios, administre reservas, cree enlaces únicos, configure correos electrónicos de reservas, revise análisis, establezca eventos pagos y pruebe enlaces de reservas públicas.

/programaciónEspacio de trabajo de programación
Captura real del espacio de trabajo de demostración de sem.chat
1Utilice pestañas para tipos de eventos, reservas, análisis, enlaces únicos, calendarios, correos electrónicos y configuraciones.
2Edite, copie, incruste, active o suspenda tipos de eventos.
3Copie el enlace público y ejecute una prueba de reserva privada.
editor de eventosConfiguración del tipo de evento
Captura real del espacio de trabajo de demostración de sem.chat
1Introduzca el nombre, la descripción, la duración, la ubicación y las zonas de influencia.
2Establezca disponibilidad, períodos de reserva, preguntas, opciones de eventos pagos y reglas de cancelación.
3Guarde el evento antes de compartir el enlace.
/libro/:nombre de usuario/:eventSlugPágina de reserva pública
Captura real del espacio de trabajo de demostración de sem.chat
1Los visitantes eligen una fecha en la página de reservas públicas.
2Los visitantes eligen un horario disponible.
3Los visitantes confirman la reserva y reciben correos electrónicos de confirmación.
Tipo de evento

Crear un tipo de evento y publicar un enlace de reserva

Para qué es esto: Utilícelo cuando los visitantes deban reservar demostraciones, consultas, llamadas de ventas, incorporación o sesiones de soporte.

Antes de empezar
  • Elija el nombre del evento, la duración, el tipo de reunión y el propietario.
  • Establezca la zona horaria y la disponibilidad antes de compartir enlaces.
  • Conecte calendarios si es importante realizar una doble reserva.
1

Programación abierta

Haga clic en Programación en la barra lateral.

Resultado esperado: El espacio de trabajo de programación muestra pestañas para tipos de eventos, reservas, análisis, enlaces únicos, calendarios, correos electrónicos y configuraciones.
2

Crear un tipo de evento

Haga clic en Crear, luego agregue el nombre, la descripción, la duración, la ubicación, la zona de influencia y las reglas de reserva.

Resultado esperado: El evento tiene suficiente información pública para que los visitantes lo entiendan.
3

Establecer disponibilidad

Configure horas semanales, anulaciones de fechas, ventanas de aviso y ventanas de reserva.

Resultado esperado: Los visitantes sólo ven los momentos que usted está dispuesto a ofrecer.
4

Agregar preguntas

Agregue preguntas obligatorias como teléfono, empresa, sitio web u objetivo de reunión.

Resultado esperado: Las reservas recopilan el contexto que su equipo necesita antes de la llamada.
5

Conectar calendarios

Abra Calendarios y conecte Google, Outlook o iCal si están disponibles.

Resultado esperado: Las horas punta se pueden bloquear y las reservas confirmadas se pueden escribir en el calendario.
6

Configurar correos electrónicos y recordatorios

Abra Correos electrónicos y configure mensajes de confirmación, recordatorio, cancelación y reprogramación.

Resultado esperado: Los visitantes reciben una comunicación de reserva correcta.
7

Comparte y prueba el enlace público.

Copie el enlace del evento, ábralo en una ventana privada, elija un horario y complete una reserva de prueba.

Resultado esperado: La reserva aparece en la pestaña Reservas y se envían mensajes de confirmación.
Cómo probarlo: Complete una reserva de prueba, una reprogramación y una cancelación. Confirme que cada evento aparezca en Programación y calendarios conectados.
problemaArreglar
No aparecen horarios en la página pública.Verifique la zona horaria, la disponibilidad semanal, las anulaciones de fechas, la ventana de aviso y los conflictos del calendario conectado.
Falta el correo electrónico de reservaVerifique la configuración del correo electrónico y la carpeta de spam, luego envíe otra reserva de prueba.
El pago falla en un evento pagadoConfirme que la moneda y la configuración de integración de facturación/pagos sean válidas antes de publicar.

Qué hacer a continuación: Inserte enlaces de reserva en el bot, el sitio web o los correos electrónicos de seguimiento.

Programación avanzada

Utilice enlaces únicos, análisis, incrustaciones y eventos pagos

Para qué es esto: Úselo cuando la programación necesite disponibilidad temporal, informes, reservas integradas o pagos.

Antes de empezar
  • Primero cree al menos un tipo de evento.
  • Conecte calendarios antes de utilizar enlaces únicos en gran medida.
  • Defina la política de reembolso/cancelación antes de habilitar eventos pagos.
1

Crea un enlace único

Abra Enlaces únicos, seleccione los espacios o reglas ofrecidos y luego genere el enlace.

Resultado esperado: El destinatario puede reservar únicamente desde la disponibilidad seleccionada.
2

Programación integrada

Utilice la opción de inserción de tarjeta de evento si el flujo de reserva debe aparecer en su sitio web.

Resultado esperado: La interfaz de usuario de reservas se puede colocar en la página donde los visitantes realizan la conversión.
3

Revisar análisis de programación

Abra Analytics dentro de Programación.

Resultado esperado: Puede ver las reservas, las tendencias de finalización y el rendimiento del tipo de evento.
4

Habilitar eventos pagos

Abra el editor de eventos, establezca el precio, la moneda y el comportamiento de pago.

Resultado esperado: Los visitantes deben completar el paso de pago de acuerdo con la configuración del evento.
5

Reservas de auditoría

Abra Reservas y revise las entradas próximas, completadas, canceladas y reprogramadas.

Resultado esperado: El equipo puede gestionar la asistencia y el seguimiento.
Cómo probarlo: Reserva a través de la página pública y a través de una página incrustada si se utiliza. Confirme que ambos crean el mismo tipo de registro de reserva.
problemaArreglar
Un enlace único expone espacios incorrectosVuelva a generar el enlace con un conjunto de espacios más pequeño o un rango de fechas más estricto.
La reserva integrada es demasiado limitadaColoque la inserción en un contenedor de contenido más amplio y verifique el diseño móvil.
Los análisis parecen vacíosCree o espere reservas reales; Los análisis dependen de los registros de reservas.

Qué hacer a continuación: Conecte los resultados de la programación con informes y análisis.

10

Análisis e informes

Elija rangos de fechas, use fechas personalizadas, lea métricas principales, exporte CSV, revise las tendencias de satisfacción y conversación, configure informes por correo electrónico y verifique la entrega.

/análisisPanel de análisis
Captura real del espacio de trabajo de demostración de sem.chat
1Elija rangos de fechas o fechas personalizadas.
2Lea métricas de conversación, satisfacción, idioma, canal y conversión.
3Exporte CSV para análisis sin conexión.
Configuración / InformesConfiguración de informes por correo electrónico
Captura real del espacio de trabajo de demostración de sem.chat
1Elija la cadencia de informe diaria, semanal o mensual.
2Agregue destinatarios del informe.
3Envíe un informe instantáneo para probar la entrega.
Revisión analítica

Leer análisis y exportar datos de rendimiento

Para qué es esto: Úselo para revisiones semanales, verificaciones de lanzamiento, revisión de calidad de soporte y análisis de conversión.

Antes de empezar
  • Elija el rango de fechas antes de leer las métricas.
  • Sepa qué bot o canal está evaluando.
  • Excluya las fechas de pruebas privadas al informar sobre el rendimiento de la producción.
1

Abrir análisis

Haga clic en Análisis en la barra lateral.

Resultado esperado: Las métricas del panel y los paneles de gráficos son visibles.
2

Elige rango de fechas

Seleccione hoy, 7 días, 30 días o fechas personalizadas.

Resultado esperado: Todos los gráficos se actualizan al período seleccionado.
3

Leer métricas principales

Revise conversations, minutos de voz, satisfacción, conversión y combinación de canales.

Resultado esperado: Entiendes el volumen y la calidad de las interacciones con los clientes.
4

Revisar tendencias

Observe las tendencias de conversación, los cambios en la satisfacción, las preguntas principales y los patrones de idioma/canal.

Resultado esperado: Puede identificar dónde mejorar las instrucciones del bot o la dotación de personal.
5

Exportar CSV

Utilice Exportar CSV cuando el equipo necesite un análisis de hoja de cálculo.

Resultado esperado: El CSV contiene el rango de fechas y las métricas seleccionadas.
6

Convertir los hallazgos en cambios

Actualice las instrucciones del bot, el conocimiento, la configuración de los widgets o la cobertura de soporte según los datos.

Resultado esperado: Los análisis conducen a mejoras concretas del producto.
Cómo probarlo: Exporte una pequeña fecha personalizada CSV y verifique que el rango de fechas y las métricas coincidan con lo que muestra el panel.
problemaArreglar
Las métricas parecen demasiado altasCompruebe si la preparación/prueba conversations está incluida en el rango de fechas seleccionado.
La satisfacción está vacía.Habilite las calificaciones en la configuración del widget y espere a que los visitantes dejen calificaciones.
Los minutos de voz no cumplen con las expectativasConfirme que el modo de voz esté habilitado solo en los bots previstos.

Qué hacer a continuación: Programe informes por correo electrónico para obtener visibilidad recurrente.

Informes

Configure informes de correo electrónico recurrentes y pruebe la entrega

Para qué es esto: Utilícelo cuando los propietarios, administradores o clientes necesiten resúmenes automáticos de rendimiento.

Antes de empezar
  • Decida quién debe recibir los informes.
  • Utilice direcciones de correo electrónico verificadas.
  • Elija una cadencia que coincida con los ritmos de revisión empresarial.
1

Abra Configuración, luego Informes

Vaya a Configuración y seleccione la pestaña Informes, o utilice la redirección de Informes si está disponible.

Resultado esperado: La cadencia del informe, los destinatarios y el historial son visibles.
2

Elige cadencia

Habilite informes diarios, semanales o mensuales.

Resultado esperado: La programación del informe se almacena para el espacio de trabajo.
3

Agregar destinatarios

Ingrese las direcciones de correo electrónico que deberían recibir informes.

Resultado esperado: Los informes se envían a las partes interesadas correctas.
4

Enviar informe instantáneo

Haga clic en Enviar ahora o en una acción de informe instantáneo equivalente.

Resultado esperado: Se envía un correo electrónico de informe inmediatamente para su verificación.
5

Revisar el historial del informe

Consulte el panel de historial después de enviar los informes.

Resultado esperado: Puede confirmar el estado y el momento de la entrega.
Cómo probarlo: Envíe un informe instantáneo a un destinatario de prueba y confirme la recepción y el formato.
problemaArreglar
El correo electrónico del informe no llegaVerifique la ortografía del destinatario, la carpeta de spam y el estado del historial de informes.
Las personas equivocadas reciben informesActualice los destinatarios y guárdelos antes del próximo envío programado.
El contenido del informe se siente ruidosoAjuste las expectativas del rango de fechas y utilice Analytics para una revisión manual más profunda.

Qué hacer a continuación: Utilice la cadencia del informe como ritmo operativo para las mejoras del bot.

11

Facturación, Equipo, Seguridad, Configuración, Afiliado

Inicie o actualice planes, administre el portal de facturación, invite a compañeros de equipo, establezca roles, edite perfil/idioma, configure notificaciones, habilite 2FA, use acciones de zona de peligro y ejecute el flujo de trabajo de afiliado.

/facturaciónControles de plan y facturación.
Captura real del espacio de trabajo de demostración de sem.chat
1Revise el plan actual, el estado de prueba y los límites de usage.
2Compare las características del plan antes de actualizar.
3Abre el portal de facturación para facturas, métodos de pago, cancelación o reactivación.
/configuracionesConfiguración, equipo y seguridad
Captura real del espacio de trabajo de demostración de sem.chat
1Utilice General para perfil e idioma.
2Utilice Equipo para invitaciones y roles.
3Utilice Seguridad para 2FA, claves API y acciones en zonas peligrosas.
/afiliadoControles del programa de afiliados
Captura real del espacio de trabajo de demostración de sem.chat
1Únase al programa para crear un enlace de referencia.
2Copie el enlace de referencia para campañas.
3Establezca un correo electrónico de pago y solicite pagos elegibles.
Facturación

Iniciar, actualizar, cancelar o reactivar un plan

Para qué es esto: Úselo cuando el espacio de trabajo necesite activación de prueba, más límites, facturas, actualizaciones de pagos o cambios de suscripción.

Antes de empezar
  • El propietario de la cuenta o el administrador de facturación deben realizar acciones de facturación.
  • Confirme qué funciones están controladas por el plan: voz, voces clonadas, avatares personalizados, API, equipo, CRM y canales.
  • Utilice el portal de facturación seguro para realizar cambios en el método de pago y en la factura.
1

Facturación abierta

Haga clic en Facturación en la barra lateral.

Resultado esperado: El plan actual, el estado de prueba, los límites de usage y las tarjetas del plan son visibles.
2

Comparar planes

Revise chat, voz, equipo, API, avatar, integración, programación y límites de soporte.

Resultado esperado: Sabes qué plan desbloquea la función necesaria.
3

Elija el intervalo de facturación

Seleccione mensual o anual si la opción está disponible.

Resultado esperado: Actualización de precios y ahorros para el intervalo seleccionado.
4

Actualizar o iniciar el pago

Elija el plan deseado y complete el pago.

Resultado esperado: La suscripción se activa después de la confirmación del pago.
5

Abrir portal de clientes

Utilice el portal de facturación para método de pago, facturas, cancelación o reactivación.

Resultado esperado: Las acciones de facturación confidenciales ocurren en el portal seguro del proveedor.
6

Verificar el acceso a las funciones

Regrese a la función que estaba bloqueada y vuelva a cargar la aplicación.

Resultado esperado: La función desbloqueada ahora está disponible si el plan la incluye.
Cómo probarlo: Después de actualizar, abra la función previamente bloqueada, como la clonación de voz o las claves API, y confirme que el bloqueo haya desaparecido.
problemaArreglar
La función permanece bloqueada después de la actualizaciónActualice la aplicación, espere un momento para que se sincronice la suscripción y luego verifique Facturación nuevamente.
El pago fue canceladoRegrese a Facturación y comience a pagar nuevamente; no se realizan cambios de plan después de un pago cancelado.
Necesita cambio de factura o tarjetaAbra el portal del cliente en lugar de editar los detalles de pago dentro de la aplicación.

Qué hacer a continuación: Invita a compañeros de equipo y asegura la cuenta del propietario.

Equipo y seguridad

Invite a compañeros de equipo, establezca roles, edite perfiles, habilite 2FA y administre configuraciones

Para qué es esto: Utilícelo cuando el espacio de trabajo pase de una configuración individual a una operación en equipo.

Antes de empezar
  • Conozca el rol de cada compañero de equipo antes de enviar invitaciones.
  • Utilice acceso con privilegios mínimos: propietario, administrador, editor, espectador.
  • Tenga lista una aplicación de autenticación para 2FA.
1

Abrir configuración

Haga clic en Configuración en la barra lateral.

Resultado esperado: Las pestañas generales, notificaciones, equipo, informes, desarrolladores, seguridad y relacionadas son visibles.
2

Editar perfil e idioma

Actualice el nombre para mostrar, la información del perfil y el idioma preferido en general.

Resultado esperado: La aplicación identifica correctamente al usuario y utiliza el idioma elegido cuando esté disponible.
3

Invitar a miembros del equipo

Abra Equipo, ingrese un correo electrónico, elija un rol y envíe la invitación.

Resultado esperado: El compañero de equipo recibe un enlace de invitación y aparece como pendiente hasta que sea aceptado.
4

Establecer permisos de rol

Utilice Propietario para control total, Administrador para administración, Editor para cambios de contenido y Visor para acceso de solo lectura.

Resultado esperado: Cada usuario tiene un acceso adecuado a su responsabilidad.
5

Configurar notificaciones

Elija correo electrónico, navegador, push, soporte en vivo, facturación y notificaciones de informes.

Resultado esperado: Las personas adecuadas reciben alertas sin ruido innecesario.
6

Habilitar 2FA

Abra Seguridad, habilite la autenticación de dos factores, escanee el código y almacene los detalles de recuperación.

Resultado esperado: La cuenta requiere un segundo factor después de iniciar sesión con contraseña.
7

Utilice las acciones de la zona de peligro con cuidado

Exporte los datos necesarios y confirme los widgets/integraciones activos antes de acciones destructivas en la cuenta.

Resultado esperado: El espacio de trabajo evita la pérdida accidental de datos.
Cómo probarlo: Invite a un compañero de equipo de prueba, acepte la invitación en un navegador independiente y confirme que la función solo expone las funciones previstas.
problemaArreglar
Falta el correo electrónico de invitaciónRevisa el spam, reenvía la invitación y verifica la dirección.
Compañero de equipo ve demasiadoReduzca su rol y revise la configuración de acceso del bot.
La configuración 2FA fallaVerifique la hora del dispositivo, vuelva a escanear el código QR y almacene los detalles de recuperación antes de confiar en él.

Qué hacer a continuación: Configure claves API solo para usuarios y servicios que las necesiten.

afiliado

Únase al afiliado, copie el enlace de referencia, configure el correo electrónico de pago y solicite el pago

Para qué es esto: Úselo cuando un socio o cliente quiera recomendar nuevos usuarios de sem.chat y realizar un seguimiento de la actividad de las comisiones.

Antes de empezar
  • Utilice la cuenta que debería poseer la atribución de referencia.
  • Prepare el correo electrónico de pago antes de solicitar el pago.
  • Consulte las reglas del programa antes de publicar campañas de referencia.
1

Afiliado abierto

Haga clic en Afiliar en la barra lateral o abra la pestaña de afiliados desde Configuración si está vinculada allí.

Resultado esperado: La página del programa de afiliados muestra las áreas de registro, referencias, pagos e historial.
2

Únete al programa

Haga clic en Unirse si la cuenta aún no se ha unido.

Resultado esperado: Se crean un código de referencia y un enlace de referencia.
3

Copiar enlace de referencia

Copie el enlace único y utilícelo en contenido, campañas o mensajes de socios.

Resultado esperado: Los registros a través del enlace se pueden atribuir a la cuenta de afiliado.
4

Establecer correo electrónico de pago

Ingrese el correo electrónico de pago y guárdelo.

Resultado esperado: Los pagos elegibles se pueden enviar correctamente.
5

Revisar referencias y comisiones.

Verifique la lista de referencias, el estado de las comisiones y el historial de pagos.

Resultado esperado: Sabes lo que está pendiente, elegible o ya pagado.
6

Solicitar pago

Haga clic en Solicitar pago cuando se cumplan las reglas y los mínimos del programa.

Resultado esperado: La solicitud de pago se registra para su procesamiento.
Cómo probarlo: Abra el enlace de referencia en un navegador privado y confirme que llegue al flujo de registro esperado con seguimiento de referencias.
problemaArreglar
Falta el enlace de referenciaÚnase al programa primero o actualice la página de afiliado después de unirse.
Solicitud de pago no disponibleVerifique el umbral mínimo de pago, el estado de la comisión elegible y el correo electrónico de pago.
Referencia no atribuidaConfirme que el visitante utilizó el enlace de referencia exacto y no eliminó los parámetros de seguimiento.

Qué hacer a continuación: Utilice análisis e informes para monitorear el impacto del cliente referido, si corresponde.

12

Notificaciones y App Updates

Revise alertas, marque notificaciones como leídas, filtre eventos importantes y use actualizaciones de aplicaciones para comprender los cambios de nuevos productos.

/notificacionesCentro de notificaciones
Captura real del espacio de trabajo de demostración de sem.chat
1Utilice Marcar todo como leído después de revisar las alertas no leídas.
2Filtre por eventos no leídos, de facturación, de soporte en vivo o del sistema.
3Abra la función relacionada después de leer la alerta.
/actualizaciones-de-aplicacionesFeed de actualizaciones de aplicaciones
Captura real del espacio de trabajo de demostración de sem.chat
1Lea las notas de la versión para conocer nuevas funciones y correcciones.
2Utilice detalles para capacitar a sus compañeros de equipo antes de que cambie el flujo de trabajo.
3Verifique las actualizaciones después de notar cambios en la interfaz de usuario o en el comportamiento.
Notificaciones

Revisar notificaciones y actuar según las alertas

Para qué es esto: Úselo cuando la aplicación informe transferencias, estado de facturación, eventos del sistema, entrega de informes o actividad importante en el espacio de trabajo.

Antes de empezar
  • Asegúrese de que las preferencias de notificación estén configuradas en Configuración.
  • Tenga cobertura de soporte en vivo si las alertas de transferencia están habilitadas.
  • Revise las alertas no leídas antes de marcarlas como leídas.
1

Notificaciones abiertas

Haga clic en Notificaciones en la barra lateral o en la entrada de notificación del encabezado de la aplicación.

Resultado esperado: El centro de notificaciones enumera las alertas recientes.
2

Filtrar alertas

Utilice filtros de categorías o no leídos para centrarse en la facturación, el soporte en vivo, el bot, el informe o los eventos del sistema.

Resultado esperado: Sólo las alertas coincidentes permanecen visibles.
3

Abra la página relacionada

Haga clic en la alerta o use su contexto para abrir Facturación, Live Support, Informes o el bot correspondiente.

Resultado esperado: Actúa sobre la notificación en lugar de simplemente leerla.
4

marcar leído

Marque una única alerta como leída o utilice Marcar todas las leídas después de la revisión.

Resultado esperado: Los recuentos no leídos y los elementos revisados ya no están resaltados.
5

Ajustar preferencias

Abra Configuración, Notificaciones si llegan demasiadas o muy pocas alertas.

Resultado esperado: El flujo de notificaciones coincide con las necesidades del equipo.
Cómo probarlo: Cree un evento de prueba seguro, como una solicitud de soporte en vivo o un informe instantáneo, luego confirme que aparece la notificación y se puede marcar como leída.
problemaArreglar
No llega ninguna notificaciónVerifique las preferencias de notificación de Configuración, el permiso del navegador y si el evento realmente ocurrió.
Demasiadas alertasDesactive las categorías ruidosas o envíelas solo a los miembros responsables del equipo.
El recuento de no leídos parece atascadoActualice la aplicación después de marcar todos los leídos y confirme que los filtros no ocultan elementos no leídos.

Qué hacer a continuación: Revise App Updates cuando haya cambios de comportamiento o aparezcan nuevos controles.

Actualizaciones de aplicaciones

Utilice las actualizaciones de la aplicación para comprender los cambios del producto

Para qué es esto: Úselo cuando los compañeros de equipo necesiten saber qué cambió antes de usar una nueva función.

Antes de empezar
  • Abra las actualizaciones después de lanzamientos importantes o cuando cambie la interfaz de usuario.
  • Comparta notas de actualización relevantes con usuarios de soporte y ventas.
  • Vuelva a probar los flujos de trabajo críticos después de cambios importantes.
1

Abrir App Updates

Haga clic en App Updates en la barra lateral.

Resultado esperado: La fuente de actualización muestra nuevas funciones, correcciones y notas de la versión.
2

Lea la última actualización

Abra la tarjeta de actualización más reciente o la vista detallada.

Resultado esperado: Ves qué cambió y a qué flujo de trabajo afecta.
3

Asigne el cambio a su flujo de trabajo

Identifique si la actualización afecta a los bots, los widgets, el soporte, la programación, la facturación o los desarrolladores.

Resultado esperado: Los miembros adecuados del equipo saben qué comprobar.
4

Vuelva a probar las rutas críticas

Si la actualización afecta un flujo de trabajo de producción, repita los pasos manuales relevantes de esta documentación.

Resultado esperado: El equipo confirma que el flujo de trabajo modificado aún funciona.
5

Compartir internamente

Envíe el resumen de la actualización a los usuarios propietarios del área afectada.

Resultado esperado: La adopción en equipo es más fluida y las preguntas de soporte disminuyen.
Cómo probarlo: Después de una actualización relevante, repita la guía para la función afectada y confirme que las capturas de pantalla o los nombres de los pasos aún coincidan.
problemaArreglar
La actualización menciona una función bloqueadaAbra Facturación para confirmar si el plan actual lo incluye.
El equipo se perdió un cambioAgregue App Updates revisión al lanzamiento o a las rutinas de operaciones semanales.
La documentación parece obsoleta después de una actualizaciónUtilice la Guía del ingeniero para actualizar capturas de pantalla y pasos.

Qué hacer a continuación: Mantenga la documentación pública actualizada a medida que evolucionan las funciones.

13

Recetas para desarrolladores

Genere claves API, use autenticación x-api-key, llame a puntos finales basados en acciones, conecte el soporte en vivo a un CRM, registre webhooks, verifique firmas e incruste el widget en el código.

Configuración / DesarrolladoresAPI teclas, inicio rápido y pestañas usage
Captura real del espacio de trabajo de demostración de sem.chat
1Genere y revoque claves API desde la pestaña Claves API.
2Utilice Quick Start para ejemplos del primer rizo.
3Revise el uso antes de habilitar la automatización de gran volumen.
API inicio rápido

Genera una clave API y realiza las primeras llamadas API

Para qué es esto: Úselo para generar scripts, aplicaciones personalizadas, puentes CRM, soporte externo en vivo o automatización.

Antes de empezar
  • Utilice un entorno del lado del servidor. No exponga las claves API en el navegador JavaScript.
  • Genere una clave separada para cada integración.
  • Copie la clave inmediatamente porque los secretos se muestran una vez.
1

Desarrolladores abiertos

Abra Configuración y seleccione Desarrolladores, o utilice la redirección de Desarrolladores si está disponible.

Resultado esperado: Las pestañas API Claves, Quick Start, Documentación y Uso están visibles.
2

Generar una clave

Haga clic en Generar clave, asígnele una etiqueta clara y cópiela inmediatamente.

Resultado esperado: La clave comienza con sk_live_ y está disponible para solicitudes del lado del servidor.
3

Enviar encabezado x-api-key

Incluya x-api-key en cada solicitud pública API.

Resultado esperado: El API público puede autenticar la solicitud y determinar su alcance para el propietario.
4

Listar robots

Llame a action=list-bots para encontrar el ID del bot que necesita.

Resultado esperado: La respuesta devuelve ID de bot, nombres, estado activo y resumen de configuración.
5

Enviar un mensaje chat

POST acción chat con botId y mensaje.

Resultado esperado: La respuesta devuelve información de respuesta, modelo y usage.
6

Marque usage

Llame a action=usage antes de ejecutar trabajos de gran volumen.

Resultado esperado: Conoce el plan actual y el estado de usage antes de que se ejecute la automatización.
7

Gire las teclas cuando sea necesario

Revocar claves no utilizadas y generar claves nuevas para proveedores o servicios modificados.

Resultado esperado: Los servicios antiguos no pueden seguir usando credenciales obsoletas.
Cómo probarlo: Ejecute list-bots y chat desde una terminal local o entorno de servidor, luego confirme que la conversación aparece en Chat History si se envió chat.
problemaArreglar
401 o respuesta no autorizadaVerifique la ortografía de x-api-key, copie la clave completa y confirme que no haya sido revocada.
Bot no encontradoUtilice list-bots nuevamente y confirme que el bot pertenece al propietario de la clave API.
Problema CORS del navegadorMueve la llamada API a tu backend; Las claves API están diseñadas para uso en el lado del servidor.

Qué hacer a continuación: Utilice /api-docs como referencia de punto final enfocada y mantenga esta página como guía de flujo de trabajo.

Listar robots
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
  -H "x-api-key: sk_live_your_key_here"
Enviar un mensaje chat
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "chat",
    "botId": "YOUR_BOT_ID",
    "message": "What can you help me with?"
  }'
Puente CRM de soporte en vivo

Encuesta o envía solicitudes de soporte en vivo a CRM

Para qué es esto: Utilícelo cuando los agentes trabajen en otro sistema pero sem.chat reciba la conversación del visitante.

Antes de empezar
  • Cree una clave API dedicada denominada para el puente CRM.
  • Decida si las encuestas o los webhooks se adaptan a su infraestructura.
  • Asegúrese de que CRM almacene los ID de conversación para futuras respuestas/resoluciones.
1

Lista de traspasos en espera

GET acción=live-support-list con estado=solicitado o estado=todos.

Resultado esperado: El CRM recibe conversations abierto que requiere atención humana.
2

Obtener mensajes

GET acción=live-support-messages con conversationId.

Resultado esperado: El CRM tiene el contexto completo del hilo y detalles del visitante.
3

Reclama antes de responder

POST acción=live-support-claim.

Resultado esperado: sem.chat marca la conversación como manejada activamente.
4

Enviar respuesta del agente

POST acción=live-support-reply con conversationId, mensaje y nombre de agente.

Resultado esperado: El visitante recibe la respuesta humana y las actualizaciones del hilo.
5

Resolver o devolver

POST action=live-support-resolve con resolución o devolución.

Resultado esperado: La conversación sale de la cola de espera o la IA retoma el control.
6

Estado de registro en CRM

Almacene el último estado de transferencia, ID de mensaje y marcas de tiempo.

Resultado esperado: CRM y sem.chat siguen siendo auditables.
Cómo probarlo: Cree un traspaso seguro, reflejelo en CRM, responda desde el puente y confirme las actualizaciones del hilo de visitantes.
problemaArreglar
Boletos CRM duplicadosUtilice conversationId como clave de idempotencia en su puente CRM.
Las respuestas llegan desordenadasAlmacene marcas de tiempo de mensajes y evite respuestas simultáneas de múltiples sistemas.
La IA responde mientras el agente está trabajandoReclame la transferencia primero y devuélvala solo cuando el agente haya terminado.

Qué hacer a continuación: Registre webhooks si el sondeo es demasiado lento o demasiado costoso.

Ganchos web

Registre webhooks y verifique X-SemChat-Signature

Para qué es esto: Úselo cuando su sistema necesite eventos en tiempo real para transferencias, mensajes y actualizaciones de resolución.

Antes de empezar
  • El webhook URL debe ser HTTPS y ser accesible desde la Internet pública.
  • Guarde el secreto del webhook inmediatamente; se muestra una vez.
  • Verifique las firmas antes de procesar eventos.
1

Registrar el webhook

POST acción webhook-register con url y eventos.

Resultado esperado: La respuesta incluye detalles del webhook y un secreto de firma único.
2

guarda el secreto

Guarde el secreto en su entorno de servidor o administrador de secretos.

Resultado esperado: Se pueden verificar entregas futuras.
3

Verificar firma

Lea X-SemChat-Signature y compárelo con un HMAC SHA-256 sobre el cuerpo de la solicitud sin formato.

Resultado esperado: Solo se aceptan entregas genuinas de sem.chat.
4

Manejar los reintentos de forma idempotente

Utilice el ID de evento o el ID de conversación/mensaje para evitar el procesamiento duplicado.

Resultado esperado: Los reintentos no crean registros CRM duplicados.
5

Listar webhooks

GET acción webhook-list para auditar los puntos finales configurados.

Resultado esperado: Puede ver URLs, eventos, estado habilitado y estado de entrega reciente.
6

Eliminar webhooks obsoletos

POST acción webhook-delete con ID de webhook.

Resultado esperado: Los puntos finales antiguos dejan de recibir eventos.
Cómo probarlo: Registre un punto final de prueba, active un evento de soporte en vivo, verifique la firma y confirme que su controlador devuelva 2xx.
problemaArreglar
La firma no coincideUtilice el cuerpo sin formato, no analizado JSON, y confirme el secreto del webhook correcto.
Webhook no recibe eventosConfirme que la lista de eventos incluya el evento que está probando y que el punto final sea HTTPS.
Se agota el tiempo de espera del webhookReconozca rápidamente y procese trabajos largos de forma asincrónica.

Qué hacer a continuación: Vincule a los ingenieros con /api-docs para obtener detalles y ejemplos de puntos finales.

Registrar webhook
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "webhook-register",
    "url": "https://your-crm.example.com/semchat/webhook",
    "events": ["handoff.requested", "message.user", "handoff.resolved"]
  }'
Verificar la firma del webhook
import crypto from 'node:crypto';

function verifySemChatSignature(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');

  return crypto.timingSafeEqual(
    Buffer.from(signature || ''),
    Buffer.from(expected)
  );
}
Mapa de puntos finales

Utilice correctamente el API público basado en acciones

Para qué es esto: Úselo al elegir la acción correcta para una función.

Antes de empezar
  • Cada solicitud utiliza la misma función de API pública URL.
  • Las acciones GET utilizan parámetros de consulta. Las acciones POST utilizan el cuerpo JSON.
  • Envíe x-api-key en todas las solicitudes.
Cómo probarlo: Llame a usage y list-bots como prueba de humo después de cualquier cambio de clave o punto final de API.
problemaArreglar
El método no coincideUtilice el método que se muestra en la tabla de puntos finales. Algunas acciones son solo GET o solo POST.
Falta valor requeridoVerifique botId, conversationId, la identificación del webhook y la ortografía de la acción.

Qué hacer a continuación: Utilice Quick Start para las primeras solicitudes, luego /api-docs para la referencia completa.

MétodoacciónPropósito
GETlist-botsEnumere todos los bots disponibles para el propietario de la clave API.
GETget-botObtenga una configuración de bot por ID de bot.
POSTchatEnvíe un mensaje de visitante a un bot y devuelva la respuesta de la IA.
GETconversationsEnumere conversations recientes para un bot, hasta 100 registros.
GETusagePlan de devolución, créditos, recuento de bots, conversations y API clave usage.
GETlive-support-listLista conversations esperando o manejado por un agente humano.
GETlive-support-messagesObtenga un hilo de transferencia con mensajes e información de visitantes.
POSTlive-support-replyEnvíe una respuesta de agente humano desde un sistema externo.
POSTlive-support-claimReclame una conversación de transferencia en espera.
POSTlive-support-resolveResuelva el traspaso o devuelva el control a la IA.
POSTwebhook-registerRegistre un punto final de webhook HTTPS.
GETwebhook-listEnumere los registros de webhooks sin devolver secretos.
POSTwebhook-deleteEliminar un registro de webhook por ID.
14

Guía del ingeniero: agregar funciones

Agregue rutas, navegación en el panel, configuración del generador de bots, Supabase tablas/funciones/migraciones, API documentos, documentación pública, comprobaciones de SEO y verificación local.

Flujo de trabajo de funciones de la aplicación

Agregar una ruta de aplicación, una página, un elemento de navegación y una entrada de documentos

Para qué es esto: Úselo cuando agregue una nueva función de panel de atención al cliente.

Antes de empezar
  • Crea una rama antes de editar.
  • Identifique si la función pertenece al repositorio de la aplicación o al repositorio de interfaz público sem.chat.
  • Inspeccione los patrones de ruta, barra lateral, i18n y configuración existentes antes de agregar una nueva estructura.
1

Añadir la ruta

Actualice src/App.tsx con una ruta protegida para páginas de clientes, o una ruta pública solo cuando la página deba ser pública.

Resultado esperado: El URL se resuelve en la aplicación sin presionar NotFound.
2

Crear o actualizar el componente de la página.

Utilice patrones de página, carga de datos, estados vacíos, estados de carga y permisos existentes.

Resultado esperado: La característica se comporta de manera consistente con el tablero.
3

Agregar navegación al panel

Actualice la barra lateral/fuente de navegación con etiqueta, icono, ruta y plano de puertas si es necesario.

Resultado esperado: Los usuarios pueden descubrir la nueva página desde el shell de la aplicación.
4

Agregar pestaña o configuración del generador de bots

Si la función pertenece a un bot, agréguela dentro de las pestañas Bot Builder y consérvela en los flujos de guardado existentes.

Resultado esperado: La configuración específica del bot se guarda con el bot, no queda varada en el estado local.
5

Agregar cambios de esquema/función Supabase

Cree migraciones para tablas/políticas y funciones perimetrales para el trabajo del lado del servidor.

Resultado esperado: El comportamiento de la base de datos y del servidor se puede implementar repetidamente.
6

Actualizar la forma API si es pública

Agregue o amplíe el manejo de acciones en supabase/functions/public-api/index.ts y documente el comportamiento de x-api-key.

Resultado esperado: Las integraciones pueden utilizar la función de forma segura.
7

Actualizar documentos de aplicaciones y documentación pública

Actualice los documentos para desarrolladores de la aplicación y esta página de documentación con capturas de pantalla y pasos clic a clic.

Resultado esperado: Los usuarios e ingenieros ven la función en ambos lugares.
8

Ejecutar controles

Ejecute pruebas/compilación de aplicaciones, optimizador SEO en el sitio público, comprobaciones de mapas del sitio y verificación del navegador.

Resultado esperado: La función funciona localmente y el sitio público sigue siendo rastreable.
Cómo probarlo: Abra la nueva ruta, use la función de un extremo a otro, inspeccione los errores de la consola/red y verifique cualquier cambio en la base de datos desde la interfaz de usuario.
problemaArreglar
La ruta funciona pero el navegador no resaltaVerifique la coincidencia de rutas de la barra lateral y las rutas de redireccionamiento.
Los datos funcionan localmente pero no se implementanConfirme la migración, las políticas RLS y las variables de entorno de la función perimetral.
Faltan documentos públicos en el mapa del sitioEjecute el optimizador de SEO e inspeccione sitemap.xml en busca del URL canónico.

Qué hacer a continuación: Capture o regenere capturas de pantalla de la documentación cada vez que cambie la interfaz de usuario.

Flujo de trabajo de mantenimiento de documentos

Actualice esta página de documentación pública después de cambios en el producto

Para qué es esto: Úselo cuando cambien capturas de pantalla, flujos de trabajo, comportamiento de API o navegación.

Antes de empezar
  • Utilice únicamente datos de demostración seguros.
  • Nunca exponga clientes reales, correos electrónicos, detalles de pago, claves API o conversations privados.
  • Actualice primero el manual en inglés y luego actualice cada página de documentación localizada antes de las comprobaciones de SEO.
1

Auditar la ruta cambiada

Abra la ruta de la aplicación e identifique qué cambió visual y procedimentalmente.

Resultado esperado: Sabes qué filas de guía, captura de pantalla y solución de problemas necesitan modificaciones.
2

Capture o genere una captura de pantalla segura

Utilice un espacio de trabajo de demostración y oculte los secretos antes de guardar los recursos WebP en activos/documentación.

Resultado esperado: La captura de pantalla es precisa y segura de publicar.
3

actualizar la guía

Edite las secciones relevantes Para qué sirve, Antes de comenzar, Pasos, Resultados esperados, Prueba, Solución de problemas y Siguiente.

Resultado esperado: La guía les dice a los usuarios en qué hacer clic y qué debe suceder después de cada clic.
4

Actualiza la navegación si es necesario

Agregue la sección al índice fijo, al selector de secciones móviles y al índice visual si es una página principal.

Resultado esperado: Los lectores pueden encontrar el nuevo contenido rápidamente.
5

Ejecute herramientas de SEO

Ejecute node tools/seo-optimize-static-pages.js y node tools/seo-optimize-static-pages.js --check.

Resultado esperado: Los resultados canónicos, de metadatos, de mapas del sitio y de robots se mantienen correctos.
6

Ejecute comprobaciones de limpieza y diferencias

Ejecute node tools/static-translation-cleanup.js --audit y git diff --check.

Resultado esperado: Las traducciones estáticas y los espacios en blanco están limpios.
7

Verificación del navegador

Sirve el sitio localmente y prueba/documentación en computadoras de escritorio y dispositivos móviles.

Resultado esperado: Las imágenes se cargan, la búsqueda funciona, los botones de copia funcionan, el TOC se resalta y el diseño no se superpone al banner de cookies.
Cómo probarlo: Busque el nombre de la función modificada en /documentación y confirme que aparece el bloque de guía correcto.
problemaArreglar
Los marcadores de captura de pantalla se desplazan en el móvilMantenga los marcadores dentro de la imagen de la captura de pantalla o utilice coordenadas de marcador receptivas.
La búsqueda pierde la nueva guía.Agregue palabras clave útiles al título de datos e incluya los términos de producto exactos que buscan los usuarios.
La documentación localizada queda desactualizadaDespués de editar el manual en inglés, actualice cada página de documentación localizada, vuelva a ejecutar el optimizador de SEO y confirme que sitemap.xml incluya cada URL de documentación.

Qué hacer a continuación: Confirme la página de documentos, los recursos, los enlaces de encabezado/pie de página, .htaccess y los cambios del mapa del sitio juntos.

¿Necesita la referencia específica de API?

La página anterior /api-docs permanece disponible para detalles de nivel de punto final API.

Abrir documentos API