Canales y conectores del agente
Un agente se comunica con el mundo de dos maneras distintas:
| Canales | Conectores | |
|---|---|---|
| Para qué sirven | Recibir y enviar mensajes con clientes (es donde «vive» la conversación). | Dar al agente acceso a tus cuentas de correo y hojas de cálculo para leer o escribir datos. |
| Opciones | Telegram, WhatsApp, Slack | Gmail, Outlook, Google Sheets |
| Cómo se conectan | Pegando las credenciales del canal | Iniciando sesión con tu cuenta y aceptando el permiso |
Canales de mensajería
Agregar un canal
- En el constructor, dentro del disparador Mensaje del canal, haz clic en Conectar canal nuevo. También puedes administrar tus canales desde Mis canales.
Captura pendiente: Ventana Agregar canal con Telegram, WhatsApp y Slack
img/canales-agregar.png - Elige el tipo de canal: Telegram, WhatsApp o Slack.
- Escribe un Nombre del canal para reconocerlo (por ejemplo «Mi bot de Telegram»).
- Completa las credenciales del canal (ver abajo) y haz clic en Conectar.
Telegram
- En Telegram, crea un bot con @BotFather.
- Copia el token que te entrega y pégalo en Token del bot.
El webhook se registra automáticamente; no tienes que configurar nada más.
WhatsApp (Meta)
Este canal usa la API de WhatsApp de Meta. Necesitas una cuenta de Meta Business con un número configurado.
- ID del número de teléfono: el identificador del número en Meta.
- Token de acceso: el token del usuario del sistema de Meta Business.
- Token de verificación del webhook: una cadena secreta que tú eliges.
Después de conectar, usa Copiar URL del webhook en la tarjeta del canal y pégala en la configuración de webhooks de tu app en Meta, junto con el mismo token de verificación.
Slack
- Token del bot: el token del bot de tu app de Slack.
- Secreto de firma: en tu app de Slack, Basic Information > App Credentials.
Igual que en WhatsApp, copia la URL del webhook del canal y regístrala en tu app de Slack.
Administrar canales
En la lista de canales cada tarjeta permite Copiar URL del webhook, Actualizar webhook (si el canal dejó de recibir mensajes) y Quitar canal. Tu plan puede limitar cuántos canales puedes conectar.
img/canales-lista.pngConectores (Gmail, Outlook y Google)
Conectar una cuenta
- En Agentes de IA abre Conectores (o Administrar conectores desde el constructor).
- Haz clic en Agregar conector y elige Gmail, Outlook o Google Sheets.
Captura pendiente: Ventana de conectores disponibles
img/conectores-disponibles.png - Inicia sesión con tu cuenta y acepta los permisos.
- Al volver, el conector aparece con tu correo. Puedes Reconectar o Desconectar la cuenta cuando quieras.
Paso Gmail
Con una cuenta de Gmail conectada, el paso Gmail (categoría Utilidades) permite gestionar tu correo desde el agente. En Evento de acción elige una operación:
| Evento | Qué hace |
|---|---|
| Enviar correo | Envía un correo (campos: Para, Asunto, Cuerpo y, opcionalmente, De). |
| Responder correo | Responde a un correo existente. |
| Crear borrador / Crear borrador de respuesta | Deja el correo como borrador sin enviarlo. |
| Crear etiqueta | Crea una etiqueta nueva en Gmail. |
| Agregar etiqueta al correo / Quitar etiqueta del correo | Cambia las etiquetas de un correo (IDs de etiqueta separados por comas). |
| Quitar etiqueta de la conversación | Quita la etiqueta de todos los mensajes del hilo. |
| Archivar correo | Lo saca de la bandeja de entrada (queda en «Todos los mensajes»). |
| Eliminar correo | Elimina el correo. |
| Buscar correo | Busca correos con la sintaxis de búsqueda de Gmail. Se configura el Máximo de resultados y el Formato de respuesta (ID, asunto, cuerpo, remitente, fecha o todo como texto). |
| Obtener adjunto por nombre de archivo | Recupera un adjunto de un correo por su nombre. |
img/canales-paso-gmail.pngAl enviar, responder o crear borradores puedes elegir el Formato del cuerpo: Texto plano o HTML (para negritas, enlaces, botones, imágenes y colores; usa estilos en línea).
Como en cualquier paso, usa variables entre llaves en los campos, por ejemplo en Para: {correo}.
Paso Outlook
La cuenta de Outlook se conecta igual que Gmail, desde Conectores. Consulta con tu administrador qué operaciones de Outlook están habilitadas en tu cuenta antes de basar un agente en ellas.
Solución de problemas
| Problema | Qué hacer |
|---|---|
| Un canal ya no recibe mensajes | Usa Actualizar webhook en la tarjeta del canal y verifica que la URL del webhook esté registrada en Meta o Slack. |
| «La conexión falló» al conectar un conector | Repite el proceso con la cuenta correcta y acepta todos los permisos solicitados. |
| No puedo agregar otro canal | Alcanzaste el máximo de tu plan. Quita un canal que no uses. |
| El paso Gmail no encuentra correos | Revisa la consulta de búsqueda (misma sintaxis que el buscador de Gmail) y que la cuenta conectada sea la correcta. |