Llevarlo a los usuarios — Manual del operador | AI Agent Builder

Capítulo 6

Llevarlo a los usuarios

Widget web, WhatsApp, Slack, Teams, voz y API: qué normaliza cada canal y cómo una conversación se vuelve una sesión.

6 min de lectura · Actualizado 10 de noviembre de 2026

Este capítulo en video · 2:03 · en inglés, con subtítulos · Todos los videos del manual

El mismo agente de la clínica atiende en el sitio web, por WhatsApp y, para el personal, desde Slack. No son tres agentes: es uno, con tres canales. Este capítulo explica qué hace un canal, cómo decide la plataforma qué mensajes pertenecen a la misma conversación y qué hay que configurar en cada uno.

Un canal traduce, el agente no se entera

Cada canal tiene un adaptador que hace dos cosas: normaliza lo que llega —un mensaje de WhatsApp, un evento de Slack, una llamada de voz— a una forma común, y formatea la respuesta del agente para ese canal. El agente siempre recibe lo mismo: el texto, la sesión, los adjuntos y algunos datos del canal. Por eso el workflow que diseñaste en el capítulo 3 funciona igual en todos lados.

Los canales difieren en cómo devuelven la respuesta. El widget web la va mostrando a medida que se genera. WhatsApp, Slack, Teams, la API REST y A2A la juntan completa y la mandan de una vez, porque así funcionan esos medios.

Cómo una conversación se vuelve una sesión

La plataforma agrupa los mensajes en sesiones. Una sesión tiene su historial, su resumen y su memoria, y es lo que le permite al agente recordar lo que se dijo antes. La pregunta clave es: ¿cuándo dos mensajes pertenecen a la misma sesión?

Cada canal arma una identidad de conversación con los datos que tiene:

CanalQué identifica la conversación
WhatsAppEl número del negocio y el número del usuario
SlackEspacio de trabajo, app, canal, hilo y usuario
TeamsInstalación, organización, conversación y usuario
InstagramCuenta, usuario y publicación (o mensaje directo)
VozLa llamada: cada llamada es una sesión nueva
Widget webEl despliegue del widget y un identificador privado del visitante
API RESTLa clave de API que llama

En los canales de mensajería, una sesión sigue abierta mientras haya actividad. Después de 24 horas sin mensajes, el próximo mensaje archiva la sesión anterior y empieza una nueva.

Un ejemplo en Slack. Una recepcionista pregunta algo en un hilo; el agente responde. Otra recepcionista responde en el mismo hilo: para la plataforma es otra sesión, porque el usuario es parte de la identidad. Y si la primera vuelve al hilo dos días después, también empieza de cero. Es intencional: una conversación no hereda el contexto de otra persona, ni uno viejo que ya no aplica.

Widget web

El widget se instala en un sitio con una sola etiqueta <script>. La pantalla del agente genera el código listo para copiar, con la URL, el tenant, el agente, el idioma y la clave pública ya cargados:

<script defer src="…/widget/std-chat-widget.iife.js"
  data-api-url="…" data-tenant-id="…" data-agent-key="turnos-clinica"
  data-api-key="pk_…" data-locale="es"></script>

Atributos opcionales controlan la posición del lanzador, el modo del panel (lateral, flotante o integrado), su ancho y la entrada por voz. El modo integrado (data-panel-mode="inline" con data-container="#chat") muestra el chat ya abierto dentro de un elemento de tu página, sin el botón del lanzador: útil para una página dedicada al asistente.

Código de inserción del widget, en el detalle del agente
Código de inserción del widget, en el detalle del agente

Dos controles protegen el widget, porque su clave está a la vista en el código del sitio:

  • Clave pública restringida. La clave del widget solo sirve para el chat web de ese despliegue; no se puede usar para llamar a la API ni a otro canal.
  • Orígenes permitidos. El tenant define desde qué dominios se acepta el widget. Un sitio que copie el código desde otro dominio es rechazado.

La apariencia del widget —colores, tipografía, avatar— se define una vez para el tenant en Experiencia → Apariencia del Agente. Las plantillas de widget son otra cosa: tarjetas estructuradas que el agente muestra dentro de la conversación, como la confirmación de un turno con fecha, profesional y botones.

WhatsApp

WhatsApp se conecta de dos maneras: con Twilio o directo con Meta (WhatsApp Cloud). Las dos se configuran desde el catálogo de integraciones y verifican la firma de cada mensaje entrante, así nadie puede hacerse pasar por WhatsApp para hablarle al agente.

La conexión con WhatsApp es del tenant. Con Twilio, el agente lo decide la URL de webhook que se configura en Twilio para cada número, y la pestaña Canales del agente define cómo responde (Conectar Twilio). Con Meta, el agente se elige en Integraciones → Meta Business, y hay un solo número por tenant; la guía Conectar Meta: WhatsApp e Instagram lo explica paso a paso.

Canales de un agente: WhatsApp, voz, REST y A2A
Canales de un agente: WhatsApp, voz, REST y A2A

Slack, Teams e Instagram

Estos tres se configuran a nivel tenant, en su integración, y no por agente. Cada uno verifica el origen de los mensajes: Slack con una firma y protección contra reenvíos de más de cinco minutos, Teams con el token de Microsoft, Instagram con la firma de Meta.

Voz

El canal de voz atiende llamadas telefónicas por Twilio, Telnyx o una central Asterisk propia. Cada llamada es una sesión nueva: el agente no recuerda llamadas anteriores del mismo número. El capítulo 14 lo explica de punta a punta.

API y otros agentes

  • API REST. Un sistema propio le escribe al agente con una clave de API. Si el cuerpo trae un mensaje, es una conversación; si no trae mensaje, todo el cuerpo se pasa al agente como datos de disparo, para automatizaciones.
  • Compatible con OpenAI. El agente se expone con la misma forma que la API de chat de OpenAI, para herramientas que ya saben hablar con ella.
  • A2A. El agente se publica para que agentes de otras plataformas lo llamen con el protocolo A2A. Su tarjeta de agente se pide con una clave de API.

Las claves de API tienen rol, permisos y vencimiento (capítulo 8). Los contratos y errores de las tres formas están en la guía Llamar a un agente desde tu sistema.

Dónde termina

  • El widget admite español e inglés.
  • WhatsApp por Meta e Instagram solo procesan texto y botones: audios, imágenes y documentos se descartan.
  • La voz no retoma conversaciones entre llamadas.
  • REST y A2A no transmiten la respuesta a medida que se genera; la devuelven completa.
  • Slack, Teams e Instagram no se configuran por agente, sino por tenant.
  • Las sesiones de mensajería se renuevan a las 24 horas de silencio; ese plazo no se ajusta.

Para revisar

  • Los orígenes permitidos del tenant incluyen todos los dominios donde está el widget, y ninguno más.
  • El código del widget publicado usa una clave pública de widget, no una clave de API común.
  • Cada número de WhatsApp tiene asignado el agente correcto: en la URL del webhook con Twilio, en Meta Business con Meta.
  • Si el agente necesita recordar algo más allá de 24 horas, lo guarda en memoria y no depende del historial de la sesión.
  • Las integraciones de canal muestran su verificación de firma configurada.