Empezar en 2 minutos

Bytgon Chat crea agentes de atención al cliente con IA que responden con lo que saben de tu negocio. Funciona con tu cuenta de Bytgon API: mismo usuario y mismo saldo. Para empezar no hace falta saldo: los agentes responden con modelos gratuitos.

  1. Entra con tu cuenta (se crea en 20 segundos) y pulsa Nuevo agente.
  2. Escribe el nombre del negocio y la dirección de tu web: la leemos entera.
  3. Elige una plantilla por sector y un modelo (gratis, económico o máxima calidad).
  4. Pulsa Probar para hablar con él y Instalar para ponerlo en tu web.

Entrenar al agente

El agente solo sabe lo que hay en su conocimiento y en los datos del negocio. Puedes añadir:

  • Tu web entera: seguimos los enlaces internos y el sitemap, respetamos robots.txt y las páginas noindex, hasta 400 páginas. Se vuelve a rastrear cada 7 días (configurable).
  • Una página concreta.
  • Archivos: PDF, Word (DOCX), PowerPoint (PPTX), Excel (XLSX), CSV, TXT, Markdown, HTML y JSON, hasta 25 MB. Los PDF escaneados (imágenes) no tienen texto: pega el contenido.
  • Texto pegado (políticas, precios, condiciones).
  • Preguntas y respuestas: respuestas exactas que el agente usará tal cual.

Todo se trocea en fragmentos, se indexa con búsqueda léxica (BM25) y, si hay un modelo de embeddings disponible (hay varios gratuitos), también con búsqueda semántica. Al responder, el agente recibe los fragmentos más relevantes y cita las fuentes con números; el widget las enseña como enlaces.

Preguntas sin respuesta

Cuando un cliente pregunta algo que no estaba en el conocimiento, queda anotado en Entrenar → Preguntas sin respuesta. Pulsa «responder», escribe la respuesta y queda aprendida al instante.

Consejos

  • Pon en Datos del negocio el teléfono, correo, dirección y horario: se los damos siempre.
  • Escribe instrucciones concretas: «si preguntan por facturas, pide el número de pedido y escala a una persona».
  • Usa Pruebas para fijar 5–10 preguntas clave y lanzarlas tras cada cambio.

Instalar en tu web

Seis formas; todas en Instalar dentro del agente:

1 · Pegar código

Un fragmento antes de </body>. Carga en segundo plano, pesa menos de 40 KB y no toca tu diseño (usa Shadow DOM).

<script src="https://chat.bytgon.com/w/TU_AGENTE.js" async></script>

Atributos opcionales en la etiqueta: data-position="left", data-theme="dark", data-color="#ff6600".

2 · Subir tu HTML

Sube el archivo principal de tu web; te lo devolvemos con el fragmento ya dentro y lo subes a tu hosting.

3 · FTP / FTPS / SFTP

Nos conectamos a tu hosting, buscamos el archivo (index.html, index.php, header.php…), guardamos una copia, añadimos el fragmento y lo subimos. Las credenciales se usan una sola vez y no se guardan. Puedes restaurar la copia original desde el panel.

4 · WordPress

Descarga el plugin (un zip con tu agente) e instálalo en Plugins → Añadir nuevo → Subir plugin → Activar.

5 · Enlace alojado y QR

Una página de chat a pantalla completa (/c/TU_AGENTE) para Instagram, correos, códigos QR o un iframe. Si activas la llamada web, también /call/TU_AGENTE.

6 · Gestor de etiquetas

Etiqueta de HTML personalizado con activador «todas las páginas».

Plataformas

  • Shopify: Tienda online → Temas → Editar código → theme.liquid, antes de </body>.
  • Wix: Configuración → Código personalizado → final del body (plan premium).
  • Webflow: Project settings → Custom code → Footer code.
  • Squarespace: Configuración → Avanzado → Inyección de código → Pie de página.
  • PrestaShop / Joomla: plantilla del tema, antes de </body>.
  • Blogger, Google Sites, Notion: usa el enlace alojado o un iframe.

Comprobar

En «Comprobar la instalación» escribe tu URL: miramos si el fragmento está en el HTML. Además, en cuanto alguien abre tu web con el chat, el agente marca «instalado» con el dominio y la fecha.

El widget

Streaming de la respuesta, fuentes citadas, sugerencias, formulario de contacto, valoración, botón «hablar con una persona», mensaje proactivo, modo oscuro, móvil a pantalla completa, idioma automático (es, en, pt, fr, de, it). Desde tu web puedes controlarlo con JavaScript:

BytgonChat.open(); // abrir BytgonChat.send('Hola'); // enviar un mensaje BytgonChat.identify({ name: 'Ana', email: 'ana@ejemplo.com' }); BytgonChat.on('message', (m) => console.log(m));

Canales

Telegram

  1. En Telegram habla con @BotFather → /newbot → nombre y usuario (termina en «bot») → copia el token.
  2. En Canales → Telegram pega el token y pulsa Conectar: registramos el webhook.
  3. Pulsa Vincular mi Telegram como dueño para recibir avisos (contactos y clientes que piden una persona).
  4. Comparte t.me/tu_bot. El comando /humano pasa la conversación a una persona.

WhatsApp (API oficial de Meta)

  1. En developers.facebook.com crea una app de tipo Empresa y añade el producto WhatsApp.
  2. Copia el ID del número de teléfono y un token permanente (usuario del sistema con permiso whatsapp_business_messaging).
  3. En Canales → WhatsApp pega ambos, inventa un token de verificación y guarda.
  4. En Meta → WhatsApp → Configuración → Webhook: URL de devolución = la de tu agente, token = el mismo, suscribe messages.
  5. Opcional: pega el secreto de la app para verificar la firma de cada evento.

Para escribir tú primero a un cliente fuera de la ventana de 24 h necesitas una plantilla aprobada: añádela en «Plantillas» y úsala desde la bandeja («Nuevo») o con el seguimiento automático a contactos.

Twilio: SMS y WhatsApp

  1. Copia Account SID y Auth Token de la consola de Twilio; compra un número o activa el sandbox de WhatsApp.
  2. Pégalos en Canales → Twilio y guarda.
  3. En el número: Messaging → «A message comes in» → Webhook POST con la URL de SMS/WhatsApp de tu agente.

Teléfono (voz en tiempo real)

  1. Con Twilio configurado, en el número: Voice → «A call comes in» → Webhook POST con la URL de voz de tu agente.
  2. Activa Teléfono, escribe el saludo, elige la voz y, si quieres, un número de transferencia (el agente pasa la llamada cuando el cliente pide una persona o pulsa 0).
  3. Llama: el audio va por Twilio Media Streams, se transcribe, el agente responde y se sintetiza por frases. El cliente puede interrumpir.

Coste por minuto: transcripción + voz (lo ves al elegir los modelos) + la telefonía de Twilio. La transcripción de la llamada queda en la bandeja.

Llamada web

Activa «Llamada web» y el botón de llamada en Personalizar. El visitante pulsa el micrófono y habla; el agente contesta con voz. Sin número de teléfono.

Avisos al equipo

Telegram (vinculando tu chat), correo (si el servidor tiene correo configurado) y webhooks firmados. Eventos: conversation.created, message.created, lead.created, handoff.requested, conversation.rated, call.ended.

Bandeja y modo persona

Todas las conversaciones de todos los canales en un sitio. Cuando el agente no puede ayudar o el cliente pide una persona, la conversación se marca y te avisamos. Si escribes tú, el agente se aparta durante 30 minutos (configurable) y lo que escribes le llega al cliente por su canal (web al instante, WhatsApp, Telegram, SMS). Sugerir respuesta pide a la IA un borrador escrito como miembro del equipo. «Devolver al agente» cuando termines.

Desde la bandeja también puedes escribir primero a un cliente por WhatsApp o SMS («Nuevo»).

Contactos

Cuando un cliente deja su nombre, correo o teléfono (porque el agente lo pide o por el formulario del widget) se guarda en Contactos con la nota de lo que necesita y el enlace a la conversación. Exportable a CSV. Con el seguimiento automático activado, a los contactos con teléfono se les envía la plantilla de WhatsApp configurada.

Acciones (conectar tu API)

Una acción es un endpoint de tu sistema que el agente puede consultar: estado de un pedido, disponibilidad, precio actual. Lo defines sin programar: nombre, qué hace, cuándo usarla, URL con huecos {{parametro}}, cabeceras (por ejemplo Authorization) y los parámetros que debe pedir al cliente. El agente decide cuándo usarla, la llama (con límites de tiempo y tamaño) y usa el resultado para responder.

Nombre: estado_pedido Qué hace: Devuelve el estado de envío de un pedido Cuándo: cuando el cliente pregunte por su pedido y tengas el número URL (GET): https://mi-tienda.com/api/pedido?numero={{numero}} Parámetros: numero · Número del pedido · obligatorio

Solo con modelos que admiten herramientas (la mayoría, incluidos gratuitos). Las acciones integradas capture_lead (guardar contacto) y request_human (avisar al equipo) están siempre disponibles.

Modelos y precios

El agente responde con el modelo que elijas de Bytgon API. Los gratuitos no cuestan nada (tienen límites de ritmo del proveedor; si uno está saturado, prueba otro). Los de pago se descuentan de tu saldo al precio real de cada respuesta; en el panel ves el precio estimado por 1.000 respuestas antes de elegir y el coste exacto en cada mensaje. La búsqueda semántica usa un modelo de embeddings (gratuito por defecto). Voz y transcripción tienen su precio por minuto o por carácter.

API

Crea una key en Ajustes → API (empieza por bck_) y úsala como Authorization: Bearer.

Hablar con un agente

POST https://chat.bytgon.com/api/v1/agents/AGENTE/chat { "message": "¿Cuál es vuestro horario?", "conversation_id": null, "user_id": "cliente-42", "name": "Ana" } → { "ok": true, "conversation_id": "cv_…", "answer": "…", "sources": [...], "handoff": false, "cost": 0.0004 }

Con "stream": true la respuesta es un flujo SSE con eventos delta (texto acumulado), sources, handoff, lead y done; la cabecera x-conversation-id trae el id de la conversación.

Otros endpoints

  • GET /api/v1/agents · tus agentes.
  • GET /api/v1/agents/AGENTE/conversations y /conversations/ID · conversaciones y mensajes.
  • GET /api/v1/agents/AGENTE/leads · contactos.
  • POST /api/v1/agents/AGENTE/sources · añadir conocimiento (type: web, page, text, qa).

Webhooks

POST JSON { event, agent_id, at, data } con cabeceras x-bytgon-event y x-bytgon-signature (HMAC-SHA256 del cuerpo con el secreto del webhook). Dos intentos.

API del widget

El widget usa endpoints públicos bajo /api/w/AGENTE/… con un token de visitante firmado. Si configuras dominios permitidos, solo responden desde esas webs.

Rastreo de webs

Nuestro rastreador se identifica como BytgonChat/1.0, respeta robots.txt, noindex y un ritmo suave. Solo visita hosts públicos y descarta imágenes y archivos binarios. Si tu web se genera solo con JavaScript, sube el contenido como archivo o texto.

Seguridad y privacidad

  • Los datos se guardan en servidores de Bytgon en la UE. Conservación configurable por agente (por defecto 365 días).
  • Los tokens de Telegram, WhatsApp y Twilio se guardan cifrados; nunca se vuelven a mostrar.
  • Las credenciales FTP/SFTP no se guardan.
  • Cada agente puede limitarse a dominios concretos, con límites de mensajes por visitante y por minuto.
  • El agente no revela sus instrucciones y se mantiene en su papel.