Makia AI Docs Ir a makia.ai

Canales y conectores del agente

Un agente se comunica con el mundo de dos maneras distintas:

CanalesConectores
Para qué sirvenRecibir 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.
OpcionesTelegram, WhatsApp, SlackGmail, Outlook, Google Sheets
Cómo se conectanPegando las credenciales del canalIniciando sesión con tu cuenta y aceptando el permiso
Chatbots ya conectadosSi ya tienes un chatbot con WhatsApp o Messenger, no necesitas crear un canal nuevo: en el disparador del agente elige «Un chatbot de IA existente» y el agente reutiliza esos canales.

Canales de mensajería

Agregar un canal

  1. 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
  2. Elige el tipo de canal: Telegram, WhatsApp o Slack.
  3. Escribe un Nombre del canal para reconocerlo (por ejemplo «Mi bot de Telegram»).
  4. Completa las credenciales del canal (ver abajo) y haz clic en Conectar.

Telegram

  1. En Telegram, crea un bot con @BotFather.
  2. 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.

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

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.

Captura pendiente: Lista Mis canales con las acciones de cada canal
img/canales-lista.png

Conectores (Gmail, Outlook y Google)

Conectar una cuenta

  1. En Agentes de IA abre Conectores (o Administrar conectores desde el constructor).
  2. Haz clic en Agregar conector y elige Gmail, Outlook o Google Sheets.
    Captura pendiente: Ventana de conectores disponibles
    img/conectores-disponibles.png
  3. Inicia sesión con tu cuenta y acepta los permisos.
  4. Al volver, el conector aparece con tu correo. Puedes Reconectar o Desconectar la cuenta cuando quieras.
ImportanteConecta la cuenta que realmente usarás en el agente. Para Google Sheets, además debes elegir qué hojas puede ver Makia (ver Google Sheets en un agente de IA).

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:

EventoQué hace
Enviar correoEnvía un correo (campos: Para, Asunto, Cuerpo y, opcionalmente, De).
Responder correoResponde a un correo existente.
Crear borrador / Crear borrador de respuestaDeja el correo como borrador sin enviarlo.
Crear etiquetaCrea una etiqueta nueva en Gmail.
Agregar etiqueta al correo / Quitar etiqueta del correoCambia las etiquetas de un correo (IDs de etiqueta separados por comas).
Quitar etiqueta de la conversaciónQuita la etiqueta de todos los mensajes del hilo.
Archivar correoLo saca de la bandeja de entrada (queda en «Todos los mensajes»).
Eliminar correoElimina el correo.
Buscar correoBusca 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 archivoRecupera un adjunto de un correo por su nombre.
Captura pendiente: Paso Gmail con el selector de evento de acción
img/canales-paso-gmail.png

Al 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

ProblemaQué hacer
Un canal ya no recibe mensajesUsa 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 conectorRepite el proceso con la cuenta correcta y acepta todos los permisos solicitados.
No puedo agregar otro canalAlcanzaste el máximo de tu plan. Quita un canal que no uses.
El paso Gmail no encuentra correosRevisa la consulta de búsqueda (misma sintaxis que el buscador de Gmail) y que la cuenta conectada sea la correcta.