Integraciones

Finn funciona mejor cuando está conectado a los sistemas que ya usas: tu CRM, tu calendario, tu proveedor telefónico, el chat de tu equipo. Esta página recorre cada uno partiendo de la base de que nunca has configurado una integración en tu vida.

No necesitas todas. La mayoría de los usuarios empiezan solo con un calendario (para que el Finn pueda agendar citas) y quizá un CRM. Añade las demás cuando tengas una necesidad concreta.

Todas las conexiones son reversibles. Puedes desconectar cualquiera en cualquier momento desde la misma pantalla que usaste para conectarla. La plataforma nunca retiene tus datos.

Dónde encontrar las integraciones

Barra lateral → Configuración → Integraciones.

Verás un mosaico por cada integración disponible con una etiqueta que muestra su estado: No conectada, Conectada o Requiere atención. Haz clic en cualquier mosaico para configurarla o gestionarla.

CRMs

Un CRM es donde guardas los registros de tus clientes y contactos. Conectar tu CRM te permite:

1. Importar contactos para no tener que subir archivos CSV manualmente.
2. Devolver los resultados de las llamadas para que tu equipo de ventas vea qué pasó en cada llamada sin salir de su CRM.

HubSpot

La configuración es casi toda de apuntar y hacer clic. Calcula 10 minutos.

1. Configuración → Integraciones → HubSpot → Conectar.
2. Se te redirigirá a HubSpot. Inicia sesión (si aún no lo has hecho) y haz clic en Autorizar.
3. Volverás a Finn con una insignia verde de "Conectado".
4. Ahora decide qué quieres importar. Haz clic en Elegir listas. Marca las listas de HubSpot que quieras usar como audiencias.
5. Define una frecuencia de sincronización: cada 15 minutos es un buen valor por defecto para campañas activas; diaria basta para listas de menor movimiento.
6. Asigna los campos: indica a Finn qué propiedad de HubSpot es el nombre, cuál el teléfono y cuál el código de país. Opcional: asigna propiedades adicionales a campos personalizados para que el Finn pueda usarlas durante la llamada.

Listo. Tus listas de HubSpot ya aparecen como audiencias en Finn.

Para que los resultados de las llamadas se escriban de vuelta en HubSpot, activa Sincronización de resultados durante la configuración (o más adelante en la misma pantalla). Cada llamada completada se convierte en una interacción de HubSpot; los campos del análisis posterior a la llamada pasan a ser actualizaciones de propiedades.

Salesforce

El flujo general es el mismo que en HubSpot. Algunas notas específicas de Salesforce:

• Puedes conectar Producción o Sandbox. El flujo de configuración te pregunta cuál.
• Requisitos de permisos: necesitas un usuario con "API Enabled" y "Lectura/Escritura" en Leads, Contactos y, si los usas, Objetos personalizados. La mayoría de los administradores de CRM pueden hacerlo.
• Compatible con objetos personalizados. Si tu proceso de ventas usa un objeto personalizado (p. ej. "Llamadas del responsable de oportunidad"), puedes asignarlo en lugar del Lead/Contacto estándar.

Pipedrive

Pipedrive usa un token de API en lugar de OAuth.

1. En Pipedrive: Configuración → Preferencias personales → API → Generar token.
2. Pega el token en Finn → Configuración → Integraciones → Pipedrive.
3. Continúa con el resto de la configuración igual que con HubSpot.

"Mi CRM no aparece en la lista"

Usa la integración Webhook (más abajo en esta página) para enviar los resultados de las llamadas a cualquier sitio donde puedas recibir peticiones HTTP. O usa una herramienta como Zapier/Make como puente; consulta la sección de Zapier más abajo.

Calendario: para agendar citas

Si quieres que tu Finn agende citas, necesitas un calendario conectado.

Google Calendar

1. Configuración → Integraciones → Google Calendar → Conectar.
2. Inicia sesión en Google y concede los permisos de calendario.
3. Elige qué calendario usar para las reservas. La mayoría de la gente tiene varios: selecciona el correcto.
4. Define las reglas de disponibilidad:
   • Horario laboral: cuándo se permiten las reservas
   • Margen entre eventos: intervalo mínimo entre citas consecutivas (p. ej. 10 min)
   • Máximo de eventos por día: límite de seguridad opcional
5. Guarda.

Ahora, en cualquier Finn, puedes añadir una tarea o acción de flujo de trabajo "Reservar calendario" y usará este calendario.

Microsoft Outlook / Microsoft 365

Igual que Google. Autoriza mediante Microsoft, elige un calendario y define la disponibilidad.

Calendly / Cal.com

Funcionan de otra forma: no permiten reservas directas por API como Google u Outlook. En su lugar, el Finn dice "Te enviaré un enlace de reserva" y se envía un SMS o correo con la URL.

Funciona, pero resulta menos natural que la reserva directa. Si puedes elegir, conecta Google u Outlook directamente.

Proveedores telefónicos: si traes tu propio número

Si ya tienes un número de teléfono con otro proveedor (Twilio, Vonage, la centralita PBX de tu oficina), puedes seguir usándolo a través de Finn.

Consulta Números de teléfono → Traer tu propio número para la guía completa.

Proveedores compatibles: Twilio, Plivo, Bandwidth, Vonage y operadores genéricos compatibles con SIP.

Webhooks: para enviar datos a tus propios sistemas

Un webhook es una URL de tu lado a la que Finn envía datos cuando ocurre algo (una llamada finaliza, un despliegue termina, etc.).

Útil cuando:

• Quieres que cada llamada completada llegue a tu almacén de datos para analíticas personalizadas
• Quieres activar un mensaje de Slack o un correo cuando ocurra algo concreto
• Tu CRM o aplicación de negocio no es compatible de forma nativa, pero puedes recibir peticiones HTTP
• Quieres usar Zapier/Make/n8n para automatizar acciones posteriores

Configurar un webhook

1. Configuración → Integraciones → Webhooks → Añadir endpoint.
2. Introduce la URL a la que Finn debe enviar los datos.
3. Elige a qué eventos suscribirte:
   • Llamada iniciada: se activa en el momento en que empieza una llamada
   • Llamada completada: se activa cuando termina una llamada (transcripción lista, pero aún sin analizar)
   • Llamada analizada: se activa cuando finaliza el análisis posterior a la llamada (lo más útil para automatizaciones posteriores)
   • Despliegue lanzado: se activa cuando un despliegue entra en funcionamiento
   • Despliegue completado: se activa cuando termina un despliegue, con métricas agregadas
4. Guarda. Finn te muestra un secreto de firma: cópialo en un lugar seguro (solo lo verás una vez).
5. Verifica el secreto de firma en tu endpoint para confirmar que las peticiones proceden realmente de Finn.

Cómo son los datos

Cada evento envía JSON a tu URL. Un evento call.analyzed tiene aproximadamente este aspecto:

{
  "event": "call.analyzed",
  "call": {
    "id": "call_abc123",
    "deployment_id": "deploy_xyz",
    "started_at": "2026-06-15T10:30:00Z",
    "duration_seconds": 142,
    "contact": { "name": "Alice Chen", "phone_number": "+15551234567" },
    "transcript": [ ...turn-by-turn... ],
    "post_call_analysis": {
      "appointment_booked": true,
      "appointment_time": "2026-06-22 14:00"
    },
    "sentiment": "positive"
  }
}

El esquema completo está en nuestra referencia para desarrolladores en api.hirefinn.ai/docs.

Cuando los webhooks no funcionan

Si Finn no puede alcanzar tu endpoint (error de DNS, timeout, respuesta 5xx), reintenta con backoff durante un máximo de 24 horas. Cada entrega fallida aparece en Configuración → Integraciones → Webhooks → Registro de entregas con el mensaje de error — útil para depurar.

Webhooks durante una llamada (consulta de datos en vivo)

Existe otro tipo de webhook: uno que tu Finn llama durante una conversación para consultar datos en vivo.

Ejemplo: un cliente llama por su pedido. El Finn necesita saber el estado del pedido, pero eso está en tu sistema, no en Finn. El Finn llama a tu endpoint /lookup con el número de teléfono del cliente, tu endpoint devuelve { "order_status": "shipped", "tracking": "1Z..."}, y el Finn lo usa en su respuesta: "Tu pedido se envió ayer — el número de seguimiento termina en..."

Para configurarlo: en el Workflow de tu Finn, añade un nodo Acción → Webhook. Configura la URL y qué enviar. La respuesta queda disponible como variables del workflow.

API REST — para control programático

Algunos equipos quieren controlar Finn desde su propio código — lanzar despliegues de forma programática, extraer datos de llamadas a paneles personalizados, etc.

Configuración → Integraciones → Claves de API → Generar nueva clave. Copia y guarda la clave de forma segura.

Luego usa la API:

POST https://api.hirefinn.ai/v1/deployments
Authorization: Bearer your_api_key

{
  "finn_id": "finn_abc",
  "audience_id": "aud_xyz",
  "from_number": "+15551234567"
}

Tenemos SDK oficiales para Node, Python, Go y Ruby. Referencia completa en api.hirefinn.ai/docs.

Si no eres desarrollador y esta sección te suena intimidante: no la necesitas. El panel hace todo lo que hace la API. La API solo sirve para equipos que quieren automatizar mediante scripts.

Slack — recibe notificaciones en el chat de tu equipo

Útil para el seguimiento operativo — "el despliegue X terminó, estas son las cifras" — sin obligar a todos a iniciar sesión en Finn.

1. Configuración → Integraciones → Slack → Añadir al espacio de trabajo.
2. Autoriza en Slack.
3. Elige un canal para las notificaciones.
4. Elige de qué quieres recibir notificaciones:
   • Despliegue lanzado
   • Despliegue completado (con estadísticas resumidas)
   • Despliegue fallido
   • Resumen diario matutino
   • Alertas por umbral (p. ej. "la tasa de éxito bajó del X")

Puedes conectar varios canales — distintos equipos pueden querer distintos tipos de notificación.

Zapier / Make / n8n

Para automatización sin código, usa la integración de Webhook anterior como fuente del disparador en tu herramienta de automatización preferida.

También estamos trabajando en una app nativa de Zapier — solicita acceso anticipado en Configuración → Integraciones → Zapier.

SSO (Enterprise)

El inicio de sesión único permite que tu equipo acceda con su identidad corporativa existente (Okta, Azure AD, Google Workspace, etc.) en lugar de contraseñas independientes de Finn.

Disponible en planes Enterprise.

• SAML 2.0 — funciona con todos los principales proveedores de identidad.
• SCIM — aprovisionamiento automático de usuarios. Cuando añades a alguien al grupo correcto en tu IdP, obtiene automáticamente una cuenta de Finn. Cuando lo eliminas, pierde el acceso.

La configuración se realiza en Configuración → Seguridad → SSO. Los equipos de TI de la mayoría de las empresas ya lo han hecho antes — el flujo es estándar.

Cumplimiento y residencia de datos

No es exactamente una integración, pero conviene saberlo:

• GDPR — totalmente compatible. Derecho de supresión, exportación y residencia de datos en la UE.
• HIPAA — Solo Enterprise, con BAA firmado.
• SOC 2 Type II — vigente. Informes de auditoría disponibles bajo NDA.
• Residencia de datos — elige la región de EE. UU., UE o India al crear la cuenta. (No se puede cambiar después sin una migración manual: elígela con cuidado al registrarte.)

Más información en hirefinn.ai/platform/security.

Preguntas frecuentes

P: ¿Puedo sincronizar con varios CRM a la vez? R: Sí. Cada conexión de CRM es independiente. Distintas audiencias pueden sincronizarse desde distintos CRM.

P: Mi webhook se activa, pero mi sistema no recibe los datos. R: Consulta el error en Configuración → Integraciones → Webhooks → Registro de entregas. Lo más común: problema con el certificado SSL, bloqueo de IP o que tu endpoint devuelva un código distinto de 200.

P: Desconecté mi CRM por error. ¿Perdí datos? R: No. Desconectar solo detiene las sincronizaciones futuras. Todos los datos de audiencia, el historial de llamadas, etc. se conservan. Vuelve a conectarlo cuando quieras.

P: ¿Puedo usar la API y el panel con la misma cuenta? R: Sí. Muchos equipos usan la API para la automatización y el panel para las operaciones manuales. Ambos reflejan el mismo estado subyacente.

Siguiente

• Flujos de trabajo →: usar integraciones como nodos de acción dentro de un Finn.
• Facturación →: cuotas de API y webhooks por plan.
• Cumplimiento →: con qué deben cumplir tus integraciones.