Saltar al contenido
GUREN AI Docs

Ana · Inbound y voz

Integraciones y conectores

El catálogo de conectores de Ana Connect: canales, fuentes de leads, voz, agenda, CRM, aviso y MCP, con lo que hace cada uno y las credenciales que necesita.

ConfigurableActualizado el

Ana Connect es la capa que conecta a Ana con los sistemas de tu empresa sin tocar su lógica. Cada sistema se integra con un conector: verifica lo que entra, lo traduce a un evento de negocio y ejecuta lo que Ana decide. En tu implementación instalamos los que necesitas, con tus credenciales. Ver Cómo funciona la plataforma.

#Canales de conversación

ConectorQué hace AnaCredenciales
WhatsApp Business (Cloud API de Meta)Responde, envía plantillas aprobadas, ofrece horarios como lista interactiva, marca como leído y muestra “escribiendo”. Recibe mensajes, estados de entrega y avisos de llamadas.Token de acceso del sistema (más secreto de app y token de verificación si usas tu propia app de Meta)
Messenger e InstagramResponde mensajes y ofrece respuestas rápidas en la página de Facebook o la cuenta de Instagram de tu empresa.Token de acceso de la página
SMS (Twilio)Responde y envía mensajes de texto desde tu número.Token de autenticación de Twilio
Chat webEl chat de tu sitio, con el mismo motor y los mismos guardrails. Ver Chat web.—

#Voz

ConectorQué hace AnaCredenciales
VapiLlama a los leads según la cadencia, contesta llamadas y, durante la llamada, consulta la agenda y crea la reunión en vivo. Al cortar, recibe el resultado y el resumen.Clave de API y secreto del servidor

Ver Llamadas telefónicas.

#Fuentes de leads

ConectorQué entraCredenciales
Meta Lead AdsCada formulario completado en Facebook o Instagram. Ana lee el lead completo desde Meta y parte la cadencia.Token de acceso de la página
Google Ads (formularios de clientes potenciales)Cada formulario de tus campañas de Google, por webhook.Clave del webhook
Ingreso firmado (tu sistema)Leads y eventos de tu CRM, tu plataforma o tu bot, firmados con HMAC. Ver ingreso firmado.Secreto de firma

#Agenda

ConectorQué hace AnaCredenciales
Google CalendarConsulta disponibilidad y crea la reunión con enlace de Google Meet. Con varios calendarios, reparte entre los anfitriones.Cliente OAuth y token de actualización
Microsoft Calendar (Outlook / 365)Consulta disponibilidad y crea la reunión con enlace de Microsoft Teams.Cliente de aplicación de Microsoft Entra ID

Ver Agenda y recordatorios.

#CRM y sistemas propios

ConectorQué hace AnaCredenciales
HubSpotCrea o actualiza el contacto, registra cada actividad como nota y cambia su estado.Token de app privada
PipedriveCrea o actualiza la persona, registra actividades y cambia su estado.Token de API
Webhook saliente firmadoEnvía a tu sistema cada actualización de contacto, actividad, estado y aviso, firmada con HMAC. Ver webhook saliente.Secreto de firma
MCP (Model Context Protocol)Si tu sistema expone un servidor MCP, cualquier capacidad (agenda, CRM, consultas) se mapea a una de sus herramientas.Token (opcional)

#Aviso y traspaso a tu equipo

ConectorQué haceCredenciales
SlackAvisa leads, reuniones y traspasos. En un traspaso abre un hilo por contacto: lo que tu equipo responde en el hilo le llega al cliente, y Ana retoma cuando se lo indican.Token del bot y secreto de firma (o un webhook de entrada solo para avisos)
Microsoft TeamsAvisos a un canal mediante Workflows.URL del flujo
CorreoAvisos por email a tu equipo.Clave de API del proveedor de envío

Ver Traspaso a tu equipo.

#Versiones de las APIs

  • Meta (WhatsApp, Messenger, Instagram, Lead Ads): Graph API v26.0 por defecto, configurable por cliente.
  • HubSpot: API v3 por defecto; acepta versiones por fecha.
  • MCP: usa la revisión sin estado más reciente del protocolo y, si tu servidor es anterior, cambia solo al flujo clásico con sesión.

#Cómo se conecta un sistema

  1. Descubrimiento

    Listamos tus canales (números, páginas, cuentas), tus fuentes de leads, tu CRM o plataforma propia, tu agenda, quién recibe los traspasos, tu horario y qué permiso de contacto tiene cada fuente.
  2. Manifiesto

    Escribimos la configuración de tu implementación en modo borrador, con tu perfil de conversación.
  3. Credenciales

    Cada credencial se carga como secreto cifrado de tu instancia, nunca en el código ni por correo. Una revisión automática de salud indica exactamente cuál falta y, si corresponde, prueba la conexión en vivo.
  4. Avisos entrantes

    Registramos las URL de aviso en cada proveedor: la app de Meta de Guren AI (o la tuya), el servidor de Vapi con sus herramientas de agenda y las suscripciones de eventos de Slack.
  5. Plantillas

    Si hay WhatsApp, se aprueban en Meta las plantillas que usan las cadencias. Ver Plantillas.
  6. Ensayo y salida

    Inyectamos eventos de prueba, revisamos el registro de acciones y, con el checklist completo, pasamos a vivo.

#Si tu sistema no está en la lista

Hay tres caminos, en este orden de preferencia: un servidor MCP si tu plataforma lo ofrece; el ingreso y el webhook firmados, que cualquier equipo técnico implementa con herramientas estándar (HTTP y HMAC-SHA256); o un conector nuevo, que construimos sobre el mismo contrato que los demás, con sus pruebas, sin tocar la lógica de Ana.

#Límites conocidos

  • Llamadas por WhatsApp: está lista la parte de permisos y eventos; el audio requiere conectar el proveedor de voz por SIP o WebRTC y que Meta habilite la función en tu número.
  • Reparto entre calendarios: asigna al primer anfitrión disponible; todavía no balancea por carga.
  • Registro por contacto: la sesión guarda las últimas 60 acciones. Para auditoría de largo plazo, conecta tu CRM o el webhook saliente.