Integraciones
Las integraciones amplían tus agentes de voz IA conectándolos con servicios externos. Esta sección cubre todas las integraciones disponibles y cómo configurarlas.
Integraciones disponibles
| Integración | Propósito | Estado | Planes |
|---|---|---|---|
| Números de teléfono | Números de teléfono y llamadas | Disponible | Todos |
| Troncal SIP | Trae tu propio operador (sipgate, Placetel, TENIOS, easybell, Zadarma, Twilio BYO, Telnyx, Custom) | Disponible | Todos — requiere aprobación de cumplimiento |
| Google Calendar | Agendar citas vía Google | Disponible | Todos |
| Outlook Calendar | Agendar citas vía Microsoft Outlook | Disponible | Todos |
| HubSpot CRM | Leer/escribir contactos y oportunidades desde tu agente de voz IA | Disponible | Todos |
| Servidores MCP | Trae tu propio servidor de herramientas compatible con MCP y expón sus herramientas a los agentes — consulta Servidores MCP | Disponible | Todos |
| Claves API | Acceso de aplicaciones externas | Disponible | Todos |
| Webhooks | Notificaciones de eventos en tiempo real | Disponible | Todos |
Las integraciones de calendario, SIP, HubSpot, servidores MCP, acceso API y webhooks están disponibles en todos los planes, incluido Free. La troncal SIP requiere una aprobación de cumplimiento única antes de que se desbloquee el asistente de conexión.
Configuración de número de teléfono
Los números de teléfono permiten a tus agentes recibir y hacer llamadas telefónicas reales.
Pasos de configuración
- Ve a Números de teléfono en la barra lateral
- Haz clic en "Comprar número"
- Selecciona país y tipo de número
- Completa la compra
- Asigna un agente al número
Los números se configuran automáticamente y están listos para usar tras la compra.
Integración con troncal SIP
Trae tu propio operador SIP — HANC habla SIP de forma nativa y enruta llamadas entrantes a tu agente de voz IA (y llamadas salientes de vuelta por tu troncal). Disponible en todos los planes incluido Free tras una aprobación de cumplimiento única.
Operadores admitidos
HANC tiene adaptadores afinados para los siguientes operadores, más una opción genérica para cualquier otro:
| Operador | Importación automática de números vía API | Notas |
|---|---|---|
| sipgate | Sí (Personal Access Token) | Troncal SIP de la UE |
| Placetel | Manual | VoIP alemán, credenciales del Webportal |
| TENIOS | Manual | SIP europeo |
| easybell | Manual | Operador alemán, credenciales del Kundencenter |
| Zadarma | Sí (clave API opcional) | Números globales |
| Twilio (BYO) | Sí | Account SID + Auth Token |
| Telnyx | Sí | SIP y DIDs gestionados por API |
| Troncal SIP personalizada | Manual | Cualquier otro proveedor — proporciona host, puerto, transporte |
Aprobación de cumplimiento
Las conexiones con operadores SIP comparten el mismo flujo de cumplimiento que las campañas salientes. Hasta que tu cuenta esté aprobada, el botón Conectar SIP abre un modal de muestra que lista todos los operadores admitidos con un CTA mailto:support@hanc.ai. La aprobación suele ser dentro del mismo día laborable.
Pasos de configuración (tras la aprobación)
- Ve a Números de teléfono → Conectar SIP.
- Elige tu operador.
- Introduce las credenciales SIP (y la clave/secreto API opcional si tu operador admite importación automática).
- Para SIP personalizado, proporciona también host, puerto (por defecto 5060) y transporte (UDP / TCP / TLS).
- Haz clic en Conectar — HANC registra tu usuario SIP y, donde se admita, lista tus números de teléfono.
- Selecciona los números a importar (o añádelos manualmente por E.164).
- Asigna un agente entrante y/o saliente en cada número.
Cuándo usar SIP vs. comprar un número
| Escenario | Recomendación |
|---|---|
| Nuevo en servicios telefónicos | Compra números a través de HANC (más simple — sin paso de cumplimiento) |
| PBX o contrato de operador existente | Conecta vía SIP — conserva tu número |
| Telefonía empresarial con requisitos estrictos del operador | SIP para control total |
| Múltiples regiones / grupos de números | SIP para flexibilidad |
Integración con Google Calendar
Conecta Google Calendar para que tus agentes de voz IA puedan comprobar disponibilidad y agendar citas durante las llamadas.
Pasos de configuración
- Ve a Integración → Calendarios
- Haz clic en "Conectar Google Calendar"
- Inicia sesión con Google
- Autoriza el acceso de Hanc.AI
Permisos solicitados:
- Ver eventos del calendario (para comprobar disponibilidad)
- Crear eventos del calendario (para agendar citas)
Configuración del calendario
Tras conectarlo, configura la herramienta de calendario en tu agente:
| Ajuste | Descripción |
|---|---|
| calendar_id | Qué Google Calendar usar para agendar |
| timezone | Zona horaria para agendar citas (p. ej., Europe/Vienna) |
| work_hours | Horario disponible para reservas (p. ej., lunes-viernes 9:00-18:00) |
| slot_duration | Duración por defecto de la cita (p. ej., 30 minutos) |
| buffer | Tiempo de margen entre citas (p. ej., 15 minutos) |
Uso del calendario en agentes
Una vez conectado y configurado, los agentes pueden:
- Comprobar disponibilidad para fechas y horas específicas
- Agendar citas automáticamente
- Respetar el horario laboral y los tiempos de margen
- Gestionar peticiones de reprogramación
Conversación de ejemplo:
Cliente: "¿Puedo reservar una cita para el martes a las 3pm?"
Agente: [Comprueba el calendario]
"Sí, el martes a las 3pm está disponible.
¿Me puedes dar tu nombre para completar la reserva?"
Integración con Outlook Calendar
Conecta Microsoft Outlook Calendar para habilitar la agenda de citas a través de tus agentes de voz IA.
Pasos de configuración
- Ve a Integración → Calendarios
- Haz clic en "Conectar Outlook Calendar"
- Inicia sesión con tu cuenta de Microsoft
- Autoriza el acceso de Hanc.AI
Permisos solicitados:
- Ver eventos del calendario (para comprobar disponibilidad)
- Crear eventos del calendario (para agendar citas)
Configuración del calendario
Tras conectarlo, configura la herramienta de calendario en tu agente:
| Ajuste | Descripción |
|---|---|
| Calendario | Qué calendario de Outlook usar para agendar |
| Zona horaria | Zona horaria para agendar citas (p. ej., Europe/Vienna) |
| Horario laboral | Horario disponible para reservas (p. ej., lunes-viernes 9:00-18:00) |
| Duración del bloque | Duración por defecto de la cita (p. ej., 30 minutos) |
| Margen | Tiempo de margen entre citas (p. ej., 15 minutos) |
Diferencias respecto a Google Calendar
Ambas integraciones de calendario funcionan de forma idéntica desde la perspectiva del agente. La única diferencia es el proceso de inicio de sesión — elige el servicio de calendario que ya uses.
Puedes conectar calendarios de Google y Outlook al mismo tiempo, pero cada agente solo puede usar una herramienta de calendario.
Cancelación de citas
Quienes reservan una cita reciben un enlace de cancelación. Pueden cancelar su cita directamente sin necesidad de volver a llamar.
Integración con HubSpot CRM
Conecta tu espacio de trabajo de HubSpot para que tus agentes de voz IA puedan leer y escribir contactos y oportunidades durante la llamada, y para que el CRM integrado de HANC pueda reflejar tus pipelines de HubSpot.
Lo que habilita
- Herramienta en vivo —
HubSpot CRMen la pestaña Acciones del agente. El agente puede emparejar a quien llama con un contacto de HubSpot por teléfono, obtener la etapa de la oportunidad y actualizar propiedades desde la conversación en vivo. Consulta Acciones y herramientas. - Reflejo de pipelines en el CRM de HANC. Tus etapas de oportunidad de HubSpot aparecen en el kanban Oportunidades para que puedas ver las llamadas y el contexto de HubSpot uno al lado del otro.
- Toggle de IA por pipeline — decide en qué pipelines de HubSpot puede actuar la IA; todo lo demás permanece de solo lectura.
Pasos de configuración
- Abre la página Integraciones y haz clic en Conectar HubSpot.
- Autoriza HANC en tu cuenta de HubSpot.
- Elige qué pipelines deben reflejarse (visible en los ajustes de CRM → Pipeline) y cuáles deben permitir actualizaciones de etapa por el agente.
- Añade la herramienta HubSpot CRM a cualquier agente que deba interactuar con HubSpot durante la llamada.
No tienes que usar HubSpot para usar el CRM de HANC. El CRM integrado funciona de forma autónoma — la integración con HubSpot es puramente para organizaciones que ya viven en HubSpot y quieren ambos mundos sincronizados.
Servidores MCP
El Model Context Protocol (MCP) es un estándar abierto para conectar asistentes de IA con herramientas externas. Si ejecutas un servidor compatible con MCP, puedes registrarlo una vez en la página de Integración y hacer que tus agentes llamen a sus herramientas en medio de la conversación.
Pasos de configuración (resumen)
- Ve a Integración → Servidores MCP.
- Haz clic en Conectar servidor MCP, introduce una etiqueta y la URL HTTPS de tu servidor, elige autenticación (Ninguna o Bearer token) y guarda.
- Abre el agente que debe usar las herramientas, ve a Acciones → Añadir acción → Servidores MCP y activa las conexiones que debe usar este agente.
El agente descubrirá y usará las herramientas del servidor al inicio de cada llamada.
Consulta la página completa de Servidores MCP para configuración detallada, solución de problemas y cómo MCP encaja junto a las herramientas integradas.
Claves API
Genera claves API para integrar Hanc.AI con tus propias aplicaciones.
Crear una clave API
Puedes crear hasta 3 claves API por usuario.
- Ve a Integración → Claves API
- Haz clic en "Crear clave API"
- Introduce un nombre (p. ej., "Integración CRM")
- Establece permisos (lectura, escritura, admin)
- Copia la clave inmediatamente (se muestra solo una vez)
Seguridad de las claves API
- Almacena las claves de forma segura (variables de entorno, gestor de secretos)
- Nunca subas las claves al control de versiones
- Rota las claves periódicamente
- Elimina las claves no utilizadas
Usar claves API
Incluye en las peticiones API:
curl -X GET "https://api.hanc.ai/v1/agent/list" \
-H "x-api-key: TU_CLAVE_API"
Permisos de claves API
| Permiso | Acceso |
|---|---|
| Lectura | Ver agentes, llamadas, analíticas |
| Escritura | Crear/modificar agentes, subir KB |
| Admin | Todas las operaciones, eliminar, ajustes |
Endpoints disponibles
La lista completa de endpoints de la API, agrupada por recurso (Llamadas, Agentes, Base de conocimiento, Números de teléfono, Voces, Suscripción, Clientes, Espacios de trabajo) vive en su propia página:
→ Referencia completa de la API
Webhooks
Configura webhooks para recibir notificaciones en tiempo real sobre eventos en tu cuenta de Hanc.AI.
Configuración
- Ve a Integración → Webhooks
- Introduce la URL de tu endpoint webhook
- Selecciona los eventos a los que suscribirte
- Guarda la configuración
Los webhooks envían peticiones HTTP POST a tu endpoint con los datos del evento en formato JSON.
Acciones posteriores a la llamada
Las acciones posteriores a la llamada se disparan automáticamente tras finalizar una conversación con el agente de voz IA. Configúralas en agentes individuales.
Tipos de acción disponibles
| Acción | Descripción |
|---|---|
| Correo | Envía un resumen de la llamada por correo (al dueño del negocio, al cliente o a ambos) |
| SMS | Envía una notificación SMS tras la llamada |
| Envía un mensaje de WhatsApp tras la llamada | |
| Llamada API | Hace una petición HTTP a un endpoint externo con los datos de la llamada |
Configuración
- Ve a Agentes de voz IA → selecciona tu agente
- Abre la pestaña Acciones
- Haz clic en "Añadir acción"
- Selecciona el tipo de acción y configura:
- Disparador: Cuándo se ejecuta la acción (p. ej., tras cada llamada, solo en resultados específicos)
- Destinatarios: Quién recibe la notificación
- Contenido: Plantilla del mensaje con variables de datos de llamada
Integraciones personalizadas
Usar la API
Construye integraciones personalizadas usando la API de Hanc.AI:
Base URL: https://api.hanc.ai/v1
Autenticación: Bearer token (clave API)
Formato: JSON
Documentación de la API
Consulta la Referencia de la API para la lista completa de endpoints disponibles.
Buenas prácticas de integración
Seguridad
- Almacena las credenciales de forma segura
- Rota las claves API regularmente
- Limita los permisos al mínimo necesario
Fiabilidad
- Registra todos los eventos de integración
- Monitoriza la salud de la integración
Pruebas
- Prueba las integraciones primero en staging
- Verifica el flujo de datos en ambas direcciones
- Prueba escenarios de error
- Documenta la configuración de la integración
Solución de problemas
La integración no conecta
- Verifica que las credenciales son correctas
- Comprueba errores de tipeo
- Asegúrate de que la cuenta de terceros está activa
- Prueba desconectar y volver a conectar
El calendario no se sincroniza
- Re-autoriza el acceso al calendario
- Comprueba los permisos del calendario
- Verifica que el calendario seleccionado es el correcto
- Comprueba si hay retrasos de sincronización (hasta 5 minutos)
Temas relacionados
- Números de teléfono — Gestión de números de teléfono
- Agentes de voz IA — Uso de integraciones en agentes
- Analíticas — Seguimiento de eventos de integración