Integrações

O Finn funciona melhor quando está conectado aos sistemas que você já usa — seu CRM, sua agenda, sua operadora telefônica, o chat da sua equipe. Esta página explica cada um deles partindo do princípio de que você nunca configurou uma integração na vida.

Você não precisa de todas elas. A maioria dos usuários começa apenas com uma agenda (para que o Finn possa marcar compromissos) e talvez um CRM. Adicione as demais quando tiver uma necessidade específica.

Todas as conexões são reversíveis. Você pode desconectar qualquer integração a qualquer momento na mesma tela usada para conectá-la. A plataforma nunca retém seus dados como refém.

Onde encontrar as integrações

Barra lateral → Configurações → Integrações.

Você verá um bloco para cada integração disponível com um rótulo indicando seu status: Não conectada, Conectada ou Requer atenção. Clique em qualquer bloco para configurar ou gerenciar.

CRMs

Um CRM é onde você mantém os registros de clientes/contatos. Conectar seu CRM permite:

1. Importar contatos para que você não precise enviar CSVs manualmente.
2. Enviar os resultados das chamadas de volta para que sua equipe de vendas veja o que aconteceu em cada chamada sem sair do CRM.

HubSpot

A configuração é quase toda por cliques. Reserve 10 minutos.

1. Configurações → Integrações → HubSpot → Conectar.
2. Você será redirecionado ao HubSpot. Faça login (se ainda não estiver conectado) e clique em Autorizar.
3. Você voltará ao Finn com um selo verde de "Conectado".
4. Agora decida o que deseja importar. Clique em Escolher listas. Marque as listas do HubSpot que deseja usar como públicos.
5. Defina uma frequência de sincronização — a cada 15 minutos é um bom padrão para campanhas ativas; diariamente funciona bem para listas com menos movimento.
6. Mapeie os campos — informe ao Finn qual propriedade do HubSpot é o nome, qual é o telefone e qual é o código do país. Opcional: mapeie propriedades extras para campos personalizados, para que o Finn possa usá-las durante a chamada.

Pronto. Suas listas do HubSpot agora aparecem como públicos no Finn.

Para que os resultados das chamadas sejam gravados de volta no HubSpot, ative o Outcome Sync durante a configuração (ou depois, na mesma tela). Cada chamada concluída vira um engagement do HubSpot; os campos da análise pós-chamada viram atualizações de propriedades.

Salesforce

O fluxo geral é o mesmo do HubSpot. Algumas observações específicas do Salesforce:

• Você pode conectar Produção ou Sandbox. O fluxo de configuração pergunta qual.
• Requisitos de permissão — você precisa de um usuário com "API Enabled" e "Read/Write" em Leads, Contacts e (se usar) Custom Objects. A maioria dos administradores de CRM consegue fazer isso.
• Objetos personalizados são suportados. Se o seu processo de vendas usa um objeto personalizado (por exemplo, "Opportunity Owner Calls"), você pode mapear para ele em vez do Lead/Contact padrão.

Pipedrive

O Pipedrive usa um token de API em vez de OAuth.

1. No Pipedrive: Settings → Personal preferences → API → Generate token.
2. Cole o token no Finn → Configurações → Integrações → Pipedrive.
3. Continue o restante da configuração como no HubSpot.

"Meu CRM não está na lista"

Use a integração por Webhook (mais abaixo nesta página) para enviar os resultados das chamadas a qualquer lugar que receba requisições HTTP. Ou use uma ferramenta como Zapier/Make para fazer a ponte — veja a seção sobre Zapier abaixo.

Agenda — para marcar compromissos

Se você quer que seu Finn marque compromissos, precisa ter uma agenda conectada.

Google Calendar

1. Configurações → Integrações → Google Calendar → Conectar.
2. Faça login no Google e conceda as permissões de agenda.
3. Escolha qual calendário usar para agendamentos. A maioria das pessoas tem vários — escolha o correto.
4. Defina regras de disponibilidade:
   • Horário de trabalho — quando agendamentos são permitidos
   • Intervalo entre eventos — intervalo mínimo entre compromissos consecutivos (ex.: 10 min)
   • Máximo de eventos por dia — limite de segurança opcional
5. Salve.

Agora, em qualquer Finn, você pode adicionar uma tarefa ou ação de fluxo de trabalho "Book Calendar" e ela usará este calendário.

Microsoft Outlook / Microsoft 365

Igual ao Google. Autorize pela Microsoft, escolha um calendário e defina a disponibilidade.

Calendly / Cal.com

Esses funcionam de forma diferente — não permitem agendamento direto via API como Google/Outlook. Em vez disso, o Finn diz "Vou te enviar um link de agendamento" e um SMS/e-mail é enviado com a URL.

Funciona, mas parece menos natural do que o agendamento direto. Se puder escolher, conecte o Google ou o Outlook diretamente.

Provedores de telefonia — se você trouxer seu próprio número

Se você já tem um número de telefone com outro provedor (Twilio, Vonage, o PBX do seu escritório), pode continuar usando-o pela Finn.

Consulte Números de telefone → Trazer seu próprio número para o guia completo.

Provedores compatíveis: Twilio, Plivo, Bandwidth, Vonage e operadoras genéricas compatíveis com SIP.

Webhooks — para enviar dados aos seus próprios sistemas

Um webhook é uma URL do seu lado para a qual a Finn envia dados quando algo acontece (uma chamada terminou, uma implantação foi encerrada etc.).

Útil quando:

• Você quer que cada chamada concluída chegue ao seu data warehouse para análises personalizadas
• Você quer disparar uma mensagem no Slack ou um e-mail quando algo específico acontecer
• Seu CRM ou aplicativo de negócios não é compatível nativamente, mas consegue receber requisições HTTP
• Você quer usar Zapier/Make/n8n para automatizar ações posteriores

Configurando um webhook

1. Configurações → Integrações → Webhooks → Adicionar endpoint.
2. Informe a URL para a qual a Finn deve enviar os dados.
3. Escolha quais eventos assinar:
   • Chamada iniciada — dispara no momento em que a chamada começa
   • Chamada concluída — dispara quando a chamada termina (transcrição pronta, mas ainda não analisada)
   • Chamada analisada — dispara quando a análise pós-chamada termina (mais útil para automações posteriores)
   • Implantação lançada — dispara quando uma implantação entra no ar
   • Implantação concluída — dispara quando uma implantação termina, com métricas agregadas
4. Salve. A Finn mostrará um segredo de assinatura — copie-o para um local seguro (você só o verá uma vez).
5. Verifique o segredo de assinatura no seu endpoint para confirmar que as requisições são realmente da Finn.

Como são os dados

Cada evento envia JSON para a sua URL. Um evento call.analyzed tem aproximadamente este formato:

{
  "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"
  }
}

O schema completo está na nossa referência para desenvolvedores em api.hirefinn.ai/docs.

Quando os webhooks não funcionam

Se a Finn não conseguir acessar seu endpoint (erro de DNS, timeout, resposta 5xx), ela tenta novamente com backoff por até 24 horas. Cada falha de entrega aparece em Configurações → Integrações → Webhooks → Registro de entregas com a mensagem de erro — útil para depuração.

Webhooks durante uma chamada (consulta de dados ao vivo)

Existe outro tipo de webhook: um que seu Finn chama durante uma conversa para consultar dados ao vivo.

Exemplo: um cliente liga para saber do pedido. O Finn precisa do status do pedido, mas ele está no seu sistema, não na Finn. O Finn chama seu endpoint /lookup com o telefone do cliente, seu endpoint retorna { "order_status": "shipped", "tracking": "1Z..."} e o Finn usa isso na resposta: "Seu pedido foi enviado ontem — o número de rastreio termina em..."

Para configurar: no Workflow do seu Finn, adicione um nó Ação → Webhook. Configure a URL e o que enviar. A resposta fica disponível como variáveis do workflow.

API REST — para controle programático

Algumas equipes querem controlar a Finn a partir do próprio código — iniciar implantações programaticamente, puxar dados de chamadas para dashboards personalizados etc.

Configurações → Integrações → Chaves de API → Gerar nova chave. Copie e guarde a chave em local seguro.

Depois use a API:

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

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

Temos SDKs oficiais para Node, Python, Go e Ruby. Referência completa em api.hirefinn.ai/docs.

Se você não é desenvolvedor e esta seção parece assustadora: você não precisa dela. O dashboard faz tudo o que a API faz. A API serve apenas para equipes que querem automatizar por script.

Slack — receba notificações no chat da equipe

Útil para a visibilidade da operação — "a implantação X terminou, aqui estão os números" — sem obrigar todo mundo a entrar na Finn.

1. Configurações → Integrações → Slack → Adicionar ao workspace.
2. Autorize no Slack.
3. Escolha um canal para as notificações.
4. Escolha o que notificar:
   • Implantação iniciada
   • Implantação concluída (com estatísticas resumidas)
   • Implantação com falha
   • Resumo diário pela manhã
   • Alertas de limite (ex.: "taxa de sucesso caiu abaixo de X")

Você pode conectar vários canais — equipes diferentes podem querer tipos de notificação diferentes.

Zapier / Make / n8n

Para automação no-code, use a integração de Webhook acima como origem do gatilho na sua ferramenta de automação preferida.

Também estamos desenvolvendo um app nativo do Zapier — solicite acesso antecipado em Configurações → Integrações → Zapier.

SSO (Enterprise)

O Single Sign-On permite que sua equipe faça login com a identidade corporativa existente (Okta, Azure AD, Google Workspace etc.) em vez de senhas separadas da Finn.

Disponível nos planos Enterprise.

• SAML 2.0 — funciona com todos os principais provedores de identidade.
• SCIM — provisionamento automatizado de usuários. Quando você adiciona alguém ao grupo certo no seu IdP, a pessoa recebe automaticamente uma conta na Finn. Quando você a remove, ela perde o acesso.

A configuração fica em Configurações → Segurança → SSO. As equipes de TI da maioria das empresas já fizeram isso antes — o fluxo é padrão.

Conformidade e residência de dados

Não é exatamente uma integração, mas vale saber:

• GDPR — totalmente suportado. Direito ao esquecimento, exportação e residência de dados na UE.
• HIPAA — Apenas Enterprise, com BAA assinado.
• SOC 2 Type II — atual. Relatórios de auditoria disponíveis sob NDA.
• Residência de dados — escolha a região EUA, UE ou Índia na criação da conta. (Não pode ser alterada depois sem migração manual — escolha com cuidado no cadastro.)

Mais em hirefinn.ai/platform/security.

Perguntas frequentes

P: Posso sincronizar com vários CRMs ao mesmo tempo? R: Sim. Cada conexão de CRM é independente. Públicos diferentes podem sincronizar a partir de CRMs diferentes.

P: Meu webhook está disparando, mas meu sistema não recebe os dados. R: Verifique o erro em Configurações → Integrações → Webhooks → Registro de entrega. Os mais comuns: problema no certificado SSL, bloqueio de IP ou seu endpoint retornando algo diferente de 200.

P: Desconectei meu CRM por engano. Perdi dados? R: Não. Desconectar apenas interrompe sincronizações futuras. Todos os dados de público, histórico de chamadas etc. permanecem. Reconecte quando quiser.

P: Posso usar a API e o painel na mesma conta? R: Sim. Muitas equipes usam a API para automação e o painel para operações manuais. Ambos refletem o mesmo estado subjacente.

Próximos passos

• Fluxos de trabalho → — usar integrações como nós de Ação dentro de um Finn.
• Faturamento → — cotas de API e webhook por plano.
• Conformidade → — com o que suas integrações precisam estar em conformidade.