Helios Vision AIHelios Vision AI

Integraciones

Conecta proveedores de IA, Twilio, Gmail, Outlook y calendarios de Google y Microsoft para potenciar tus agentes.

Objetivo

Conecta los servicios externos de los que dependen tus agentes: proveedores de IA (chat, RAG, texto a voz, búsqueda web), Twilio para teléfono y WhatsApp, 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.

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

Roles

  • owner, admin, agent

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. Las tarjetas se dividen en dos secciones:

  • 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í.

ControlValoresNota
Chips de categoríaAll, AI, Communication, Email, CalendarsFiltra las tarjetas por tipo
Searchtexto libreCoincide con el nombre y la descripción de la integración

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

Badges de estado

BadgeSignificadoQué hacer
ConnectedConfigurado y funcionandoNada
Action requiredConectado pero fallando en ejecución (por ejemplo, una cuenta de IA sin saldo o una clave rechazada)Corrige la cuenta y vuelve a comprobar
Needs reconnectionConectado, pero el acceso de una cuenta expiróReconecta la cuenta

Resumen de Integraciones

Proveedores de IA

OpenAI

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

CampoObligatorioFormatoNota
OpenAI API Keysk-...Desde la OpenAI Platform

Acciones: Save OpenAI Key, Remove OpenAI Key.

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. Agrega fondos en tu cuenta de OpenAI y usa Re-check para confirmar.

Google AI (Gemini)

Proveedor de IA alternativo con ventanas de contexto grandes. Se usa para la búsqueda en documentos (RAG).

CampoObligatorioFormatoNota
Google AI API KeyAIza...Desde Google AI Studio

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.

CampoObligatorioFormatoNota
ElevenLabs API Keyelevenlabs_...Desde el ElevenLabs Dashboard

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.

CampoObligatorioFormatoNota
Deepgram API KeyProject API KeyDesde la Deepgram Console

Acciones: Save Deepgram Key, Remove Deepgram Key.

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

CampoObligatorioFormatoNota
Web Search API Keytvly-...Desde Tavily

Acciones: Save Key, Remove Key.

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

Communication

Twilio (Voice & WhatsApp)

Guarda tus credenciales de Twilio una sola vez; se reutilizan para llamadas telefónicas y números de WhatsApp.

CampoObligatorioFormatoNota
Twilio Account SIDEmpieza por AC, 34 caracteresDesde la Twilio Console (panel Account Info)
Twilio Auth Token32 caracteresDesde la Twilio Console (panel Account Info)

Acciones: Save Twilio Credentials, Disconnect Twilio.

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 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).

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.
  • Acciones de la tarjeta: Connect (cuando no hay ninguna conectada), Manage (cuando está sana) o Reconnect (cuando el acceso de una cuenta expiró).

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.
  • Acciones de la tarjeta: Connect, Manage o Reconnect, igual que en Google Calendar.

En la página de calendarios cada cuenta conectada muestra su estado (Active, o Expired - reconnect) y su propio control de desconexión.

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.
  • Guarda Twilio una vez y reutiliza las mismas credenciales en WhatsApp y Voice.
  • 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.

Notas comunes

  • Las credenciales se cifran y se guardan de forma segura; las API keys nunca se vuelven a mostrar tras guardarse.
  • Desconectar un proveedor también elimina las herramientas de agent que dependían de él; la confirmación indica cuántas se eliminaron.
  • 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.
  • Verifica tu correo primero — las cuentas restringidas no pueden guardar claves ni conectar cuentas.

Relacionado