Produto
Integrações
Catálogo de conectores está em construção. Os caminhos atuais para integrar são webhooks, chaves de API, Data Input pelos Atendentes e configuração de provedores em Canais.
Atualizado em
O que é
A área de Integrações é a vitrine prevista para conectores oficiais entre o Interaflow e sistemas externos (CRMs, BIs, ferramentas de marketing, ERPs). É o lugar onde, no estado final, o admin escolhe um conector pré-construído, autoriza a conexão e o Interaflow passa a sincronizar dados automaticamente.
A página existe como esqueleto na sidebar e mostra o catálogo de conectores planejados com badge “Em breve” — sinalizando que o ecossistema oficial está em construção.
O que está disponível hoje
Enquanto o catálogo oficial não está completo, existem quatro caminhos reais para integrar o Interaflow a sistemas externos — todos funcionais e documentados:
1. Webhooks
Eventos do Interaflow podem disparar requisições HTTP para o seu sistema — Conversa criada, mensagem recebida, Conversa encerrada, chamada finalizada, avaliação concluída. Você cadastra a URL externa, define os eventos de interesse e o Interaflow envia.
Ver Webhooks.
2. Chaves de API
Para integradores que precisam ler ou escrever no
Interaflow programaticamente — buscar Conversas, criar contatos,
disparar mensagens, etc. — gere uma chave de API e use no
header X-API-Key ou Authorization: Bearer ik_....
Ver Chaves de API.
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 (HubSpot, Salesforce, ferramenta proprietária) é 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 visíveis na página de Integrações refletem o roadmap publicado — conectores que vão chegar como caminho self-service. A lista inicial inclui:
- 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 |
|---|---|
| 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 |
| Conector oficial pré-construído | Página de Integrações (quando o conector estiver disponível) |
Boas práticas
- Comece por Webhooks + Chave de API. Cobre 80% dos cenários de integração de operação séria. O conector oficial vira conveniência — não bloqueia.
- Monitore os eventos antes de produzir o consumidor. Cadastre webhook em endpoint de teste primeiro, observe o payload real, só depois construa o consumer definitivo.
- 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 oficiais em construção. A maioria dos cards está como “Em breve”.
- 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
- Esperar conector oficial estar pronto antes de iniciar a integração. Webhook + API geralmente já cobrem o que se precisa.
- 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.