Produto
Integrações
A integração Salesforce para telefonia e registro de chamadas em Lead tem guia próprio. Outros caminhos dependem do sistema e do escopo da operação.
Atualizado em
O que é
A área de Integrações reúne conexões com sistemas externos, como CRMs, provedores e ferramentas de dados. Cada integração tem seu próprio escopo, pré-requisitos e forma de configuração.
O catálogo continua em evolução, mas a integração de telefonia com Salesforce Lightning já tem configuração própria. Ela coloca o softphone na barra do Salesforce e pode registrar chamadas vinculadas a Lead.
O que está disponível hoje
Além da integração Salesforce descrita abaixo, o Interaflow oferece caminhos gerais de integração. A disponibilidade de cada caminho depende da operação e da configuração do destino.
Salesforce: telefonia e registro de chamadas
O softphone usa Open CTI no Salesforce Lightning. O atendente pode discar pelo telefone de um Lead e receber chamadas com busca da ficha pelo número. Com o registro ativado, a ligação vinculada ao Lead é enviada ao endpoint configurado na org, com resultado e duração; materiais como transcrição, resumo e link da gravação são acrescentados quando disponíveis.
Siga o guia de configuração do Salesforce para preparar o Call Center, o app conectado, as permissões e os testes.
1. Webhooks
Provedores de canal usam webhooks para enviar eventos ao Interaflow. Notificações de saída para um sistema externo exigem verificar o escopo e o caminho disponíveis para a sua operação.
Ver Webhooks.
2. Chaves de API
Para consultar URA, etapas, transcrição, chamadas, gravações e cadastros,
use a API de Integração com uma chave no header X-API-Key ou
Authorization: Bearer ik_... e os escopos exigidos pela rota.
Endpoints da aplicação que exigem usuário usam JWT e permissões próprias.
Veja a referência de endpoints e o guia de autenticação.
Agentes de IA externos
O nó Controle Externo envia os turnos da conversa ao webhook do seu agente, que devolve ações para responder, transferir para uma fila humana ou encerrar. O contrato inclui callback assíncrono e consulta das tentativas de entrega. Veja como integrar um agente externo ou avalie a conexão do seu robô à operação.
3. Data Input pelo Atendente
Durante o atendimento, o Atendente pode enviar dados para um sistema externo via ação configurada (envio para CRM, abertura de ticket, atualização de cadastro). Esses envios ficam rastreáveis no relatório Data Input com status (enviado, falhou, processando).
A configuração específica de cada destino é feita pela equipe Interaflow no onboarding — não há painel self-service de cadastro de destino hoje.
4. Configuração de provedores em Canais
Cada Canal é uma integração com um provedor de comunicação (Meta Cloud API para WhatsApp oficial, Baileys/MyPhone para WhatsApp comum, Mailgun para e-mail, Zenvia para SMS, etc.). Configurar o canal já é a integração com o provedor — credenciais, endpoint, formatos.
Conectores no catálogo
Os cards da página de Integrações incluem conexões disponíveis e itens planejados. Entre eles:
- Salesforce — softphone no Lightning e registro de chamadas em Lead, com configuração por administradores do Salesforce e do Interaflow.
- Qualitalk — plataforma de monitoria de qualidade omnichannel.
Mais conectores estarão visíveis na página conforme entram em disponibilidade. Conectores marcados como “Em breve” não estão ativos — não tente clicar e configurar; o card é informativo.
Como escolher o caminho certo
| Necessidade | Caminho recomendado |
|---|---|
| Fazer e receber chamadas no Salesforce Lightning | Integração Salesforce |
| Receber notificação de eventos no meu sistema | Webhooks |
| Buscar dados ou criar recursos no Interaflow programaticamente | Chaves de API |
| Atendente envia ficha do cliente para meu CRM durante atendimento | Data Input (alinhar com Interaflow) |
| Conectar canal de comunicação novo (WhatsApp, SMS, e-mail) | Canais |
| Configurar provedor de IA (chave OpenAI) | OpenAI por tenant |
| Avaliar os conectores disponíveis | Página de Integrações |
Boas práticas
- Defina o fluxo antes de configurar. Liste quais dados entram, saem, quem pode acessá-los e como uma falha aparece para o administrador.
- Teste com registros reais de homologação. No Salesforce, confirme separadamente autenticação, chamada, vínculo ao Lead e complementação posterior do registro.
- Use chave de API de escopo restrito. Evite chaves “master” para todos os usos — segregue por finalidade (uma para importação, outra para sincronização, etc.).
- Documente o fluxo internamente. Quem mantém a integração amanhã precisa saber qual webhook está cadastrado, qual chave está em uso e onde rotacionar.
Limites conhecidos
- Catálogo de conectores em evolução. Verifique o escopo de cada card antes de planejar a implantação.
- Sem marketplace público de integrações com submissão de terceiros.
- Data Input self-service ainda não está exposto na UI — cadastro de destino exige envolvimento do time Interaflow.
- Sem orquestração visual (no-code/Zapier-like) integrada ao produto. Para isso, use ferramenta externa (Zapier, Make, n8n) com webhook + API.
Erros comuns
- Supor que o card Salesforce sincroniza todos os objetos do CRM. O guia atual cobre telefonia e chamadas vinculadas a Lead.
- Confundir Integrações com Canais. Canais são touchpoints omnichannel; Integrações é o hub de conectores externos.
- Tentar configurar Qualitalk pela UI hoje. Card é informativo, ainda não está ativo.