Integraciones

Objetivo

Conecta los servicios externos de los que dependen tus agentes: proveedores de IA (chat, texto a voz, búsqueda web), Twilio para llamadas telefónicas y números de teléfono, cuentas de correo (Gmail, Outlook) y calendarios (Google, Microsoft). Todo se presenta como un marketplace de tarjetas que conectas, gestionas y desconectas desde una sola página — cada tarjeta lleva un badge de salud en vivo para que una conexión rota nunca pase desapercibida.

WhatsApp no se conecta aquí: tiene su propio flujo guiado (consulta Conecta WhatsApp con Meta).

Acceso

Sidebar -> Integrations Ruta: /app/{tenant}/integrations

Páginas de detalle por proveedor (se abren desde las tarjetas):

• /app/{tenant}/integrations/gmail
• /app/{tenant}/integrations/outlook
• /app/{tenant}/integrations/calendar?provider=google
• /app/{tenant}/integrations/calendar?provider=microsoft

La página de calendarios siempre muestra un solo proveedor. Ya no existe una vista combinada de calendarios — el marketplace de Integraciones es el resumen, y un marcador antiguo sin proveedor redirige de vuelta a él.

Roles

• Ver la página: owner, admin, agent
• Guardar claves, conectar cuentas, desconectar: owner, admin

Requisitos previos

• Un correo verificado. A las cuentas pendientes de verificación se les pide confirmar su correo antes de poder guardar o conectar cualquier integración.
• Para conectar Gmail u Outlook y enviar correo necesitas al menos un agent con el canal Email habilitado — ese agent se asigna al conectar la cuenta.
• Las claves de ElevenLabs y Deepgram solo surten efecto cuando seleccionas ese proveedor en Voice Agents.

Cómo funciona la página

La página lista cada integración como una tarjeta, dividida en dos secciones que muestran sus conteos:

• Connected — integraciones ya configuradas, con su badge de estado.
• Available — integraciones que aún puedes conectar.

Usa los chips de categoría y el buscador para acotar la lista. Categoría y búsqueda se combinan entre sí.

Haz clic en cualquier tarjeta para abrir su diálogo de detalle, donde introduces la clave, conectas la cuenta o desconectas.

Badges de estado

Las tarjetas con Action required o Needs reconnection también llevan un borde izquierdo de color para destacar a simple vista. Una cuenta que la plataforma desactivó tras fallos repetidos de acceso sigue visible en Connected con su badge de aviso — nunca vuelve en silencio a "no conectada". Una desconexión deliberada tuya no deja badge.

Proveedores de IA

OpenAI

Potencia las respuestas de chat y las funciones de IA (análisis de sentimiento, resúmenes, generación de respuestas).

Acciones: Save OpenAI Key; una vez conectado, la eliminación es el pequeño enlace Remove OpenAI Key al pie del diálogo.

Al guardar, la clave se verifica en vivo con OpenAI:

• Una clave que OpenAI rechaza (inválida, revocada o sin permiso de chat) no se guarda — corrígela e inténtalo de nuevo.
• Una clave válida en una cuenta sin saldo se guarda, pero la tarjeta muestra Action required y avisa de que las funciones de IA fallarán en silencio hasta que agregues fondos.

Después, la salud de la clave se comprueba automáticamente cada vez que carga la página. El detalle de la tarjeta muestra el resultado con la hora de la última comprobación y, cuando algo va mal, lo explica en lenguaje llano (sin saldo, clave rechazada, permiso denegado, límite de peticiones, o no se pudo contactar con OpenAI) con enlaces directos: Re-check, Add funds in OpenAI y Manage your OpenAI keys. Si la comprobación no pudo ejecutarse, el badge muestra Not verified en lugar de fingir que la clave funciona.

Google AI (Gemini)

Proveedor de IA alternativo para modelos Gemini con ventanas de contexto grandes.

Acciones: Save Google AI Key, Remove Google AI Key.

ElevenLabs (TTS)

Voces premium para llamadas telefónicas. Requerido cuando seleccionas ElevenLabs como proveedor de voz en Voice Agents.

Acciones: Save ElevenLabs Key, Remove ElevenLabs Key.

Deepgram Aura-2 (TTS)

Voz de calidad telefónica empresarial (8kHz nativo). Requerido cuando seleccionas Deepgram como proveedor de voz. Si se elimina, los Voice Agents que usan voces de Deepgram vuelven a OpenAI.

Acciones: Save Deepgram Key, Remove Deepgram Key.

Web Search

Habilita la herramienta de búsqueda web para que los agentes respondan con resultados frescos de la web.

Acciones: Save Key, Remove Key.

La clave se verifica en vivo antes de guardarse; una clave rechazada no se almacena.

Communication

Twilio (Voice)

Guarda tus credenciales de Twilio una sola vez; se usan para llamadas telefónicas y números de teléfono.

Acciones: Save Twilio Credentials, Disconnect Twilio.

El diálogo incluye una guía "Where do I find these?" y ambos campos validan su formato mientras escribes, así que un SID o token mal tecleado se marca antes de guardar.

Se requiere el Auth Token (no una API Key) porque se usa para verificar que las solicitudes de webhook entrantes provienen realmente de Twilio.

Email

Gmail (Email)

Envía correos con Gmail mediante OAuth (compatible con Google Workspace). Puedes conectar varias cuentas.

• Abre /app/{tenant}/integrations/gmail.
• Al conectar, elige el agent que enviará correo desde esta cuenta (el agent debe tener el canal Email habilitado). Si aún no tienes un agent elegible, se te pide crear uno primero.
• Acciones de la tarjeta: Connect (cuando no hay ninguna conectada), o Manage y Go to Inbox (cuando hay conexión).
• Si un buzón conectado deja de recibir correo, la tarjeta pasa a Action required y muestra las direcciones afectadas con un botón Fix in Email que te lleva a la configuración de Email para reconectar.
• Si a una cuenta le falta el permiso más reciente para sincronizar etiquetas y correo enviado, la tarjeta muestra un aviso Reconnect required con la acción Reconnect Gmail.

La cantidad de cuentas de correo que puedes conectar depende de tu plan. Al alcanzar el límite se muestra un aviso de plan con opción de mejora.

Gmail Inbox

Lee los correos entrantes de Gmail para que los agentes trabajen una bandeja de entrada, no solo envíen. Es una función de acceso anticipado con despliegue gradual; la tarjeta solo aparece cuando está habilitada para tu espacio de trabajo — contacta a soporte si quieres acceso.

Acciones de la tarjeta: Connect Inbox (cuando no está conectado), o Go to Inbox y Reconnect (cuando lo está).

Outlook (Email)

Envía correos con Microsoft 365 / Outlook mediante OAuth. Puedes conectar varias cuentas.

• Abre /app/{tenant}/integrations/outlook.
• Al conectar, elige el agent que enviará correo desde esta cuenta (el agent debe tener el canal Email habilitado).
• Acciones de la tarjeta: Connect (cuando no hay ninguna conectada) o Manage (cuando hay conexión).
• Igual que en Gmail, un buzón de Outlook que deja de recibir correo pone esta tarjeta en Action required — la alerta aparece en el proveedor al que pertenece.

El límite de cuentas de correo según el plan también aplica aquí.

Calendars

Google Calendar

Permite que los agentes de IA consulten disponibilidad y creen eventos en Google Calendar. Puedes conectar varias cuentas.

• Abre /app/{tenant}/integrations/calendar?provider=google.
• Acción de la tarjeta: Connect (cuando no hay ninguna conectada), y después un único botón que dice Manage mientras al menos una cuenta está sana, o Reconnect cuando reconectar es el siguiente paso (ninguna cuenta funcionando, o un acceso expirado).

Outlook Calendar

Permite que los agentes de IA consulten disponibilidad y creen eventos en Microsoft Calendar. Puedes conectar varias cuentas.

• Abre /app/{tenant}/integrations/calendar?provider=microsoft.
• Acción de la tarjeta: Connect, Manage o Reconnect, con las mismas reglas que Google Calendar.

En la página de calendarios cada cuenta conectada muestra su estado (Active, Expired - reconnect o Disconnected) con su propio botón Reconnect y su control de desconexión. Reconnect siempre apunta a esa cuenta concreta.

Buenas prácticas

• Conecta un proveedor de IA (OpenAI o Google AI) antes de crear agents, para que las respuestas funcionen desde el primer mensaje.
• Después de agregar fondos a una cuenta de OpenAI marcada, usa Re-check en lugar de volver a introducir la clave.
• Asigna el agent correcto al conectar una cuenta de correo — ese agent es el que enviará en tu nombre.
• Trata un badge ámbar o rosa como un pendiente: la tarjeta nombra la cuenta exacta que necesita atención y el botón te lleva a la solución.

Errores comunes

• Una clave de OpenAI o de Web Search incorrecta se rechaza al guardar y nunca se almacena.
• Twilio rechaza un Account SID que no empiece por AC y tenga 34 caracteres, o un Auth Token que no tenga 32 caracteres — el formulario marca ambos mientras escribes.
• Alcanzar el límite de cuentas de correo de tu plan durante una conexión OAuth muestra el diálogo de límite de plan en lugar de agregar la cuenta.
• Las cuentas restringidas (correo sin verificar) no pueden guardar claves ni conectar cuentas — verifica tu correo primero.
• Desconectar un proveedor también elimina las herramientas de agent que dependían de él; la confirmación indica cuántas se eliminaron.
• Las credenciales se cifran y se guardan de forma segura; las API keys nunca se vuelven a mostrar tras guardarse.

Relacionado

• Configuración de Twilio (Voz y Números)
• Conecta WhatsApp con Meta
• Voice Agents
• Bandeja y correo
• Webhooks