Introdução às integrações (webhook / OAuth / chave de API)
Conecte o Omnifox às suas outras ferramentas: o que está disponível hoje, o que chega em breve e quando usar um webhook, uma conexão OAuth ou uma chave de API.
Veja este passo no vídeo · As formas de conectar o Omnifox
O que é uma integração?
Uma integração conecta o Omnifox a outras ferramentas (seu CRM, uma planilha, n8n, Make, Zapier, Slack, HubSpot…) para que a informação flua automaticamente entre elas. No Omnifox você tem três formas de integrar, conforme a necessidade:
- Webhook — o Omnifox avisa outra ferramenta quando algo acontece (chega uma mensagem, um contato é criado).
- OAuth — você conecta um serviço externo com dois cliques, sem copiar chaves (é o que os conectores da galeria usam; hoje eles estão em Em breve, veja abaixo).
- Chave de API — você puxa dados do Omnifox ou envia ações a ele a partir do seu código ou de uma ferramenta no-code.
Este guia ajuda a escolher a opção certa e a encontrar onde elas ficam.
O que está disponível hoje e o que está em Em breve
Disponível hoje:
- n8n, Make e Zapier (webhooks nos dois sentidos) e Slack (avisos): em Configurações → Integrações.
- Webhook próprio (sua URL) e Cal.com (você cola sua API key): também em Configurações → Integrações.
- API REST, webhooks de saída, servidor MCP e SDK: a partir do plano Crece.
- Webhooks de entrada que disparam fluxos de trabalho: a partir do plano Escala.
Em breve: HubSpot, Salesforce, Shopify, Google Sheets, Google Meet, Gmail, Calendly, Stripe Payments, Zoom, Microsoft Teams, DocuSign, Dropbox Sign, PandaDoc, Notion e Outlook. Já estão construídas, mas ainda não podem ser conectadas: em Configurações → Integrações os cartões delas aparecem como «Em breve» e serão ativadas quando estiverem disponíveis. Enquanto isso, você chega à maioria dessas ferramentas por meio do n8n, Make ou Zapier.
Qual eu escolho?
- Quero que algo que acontece no Omnifox dispare uma ação em outro app → Webhook.
- Quero conectar um serviço pronto da galeria (HubSpot, Zoom etc.) → OAuth (botão Conectar), quando estiver disponível. Enquanto isso → n8n, Make ou Zapier.
- Quero ler ou criar dados no Omnifox a partir do meu sistema → Chave de API.
Requisitos
- Papel Administrador do workspace.
- Webhooks e chaves de API exigem um plano com Acesso à API (disponível a partir do plano Crece).
Passos
Opção A — Conectar pela galeria (OAuth, em breve)
Os conectores OAuth (HubSpot, Google, Microsoft, Zoom etc.) ainda mostram «Em breve». Quando estiverem disponíveis:
- Você vai em Configurações → Integrações.
- Encontra o conector e clica em Conectar.
- Faz login no serviço externo e autoriza o acesso.
Hoje, nessa mesma tela, você já pode conectar n8n, Make, Zapier, Slack, um webhook próprio e o Cal.com.
Opção B — Criar um webhook de saída
- Vá em Configurações → Webhooks → Novo webhook.
- Cole a URL de destino (a que o n8n, Make, Zapier ou seu servidor fornece).
- Marque os eventos desejados:
message.received,message.sent,conversation.created,conversation.closed,contact.created,contact.updated. - Salve e clique em Enviar teste (
test.ping) para confirmar que seu destino responde.
Opção C — Criar uma chave de API
- Vá em Configurações → Chaves API → Nova chave de API.
- Dê um nome, escolha o workspace, uma data de expiração e os escopos mínimos.
- Copie a chave na hora — ela só é exibida uma vez.
Verificação
- Em Integrações o conector aparece como Conectado.
- Em Webhooks, o envio de teste retorna
200. - Sua chave de API funciona com o cabeçalho
Authorization: Bearer.
Se não funcionar
- Você não vê Webhooks nem Chaves de API: seu plano não inclui Acesso à API; faça upgrade para Crece ou superior.
- O webhook não chega: confira se a URL é pública (https) e retorna
200rápido; veja as retentativas no detalhe do webhook. - A chave de API retorna 401: confirme que envia o cabeçalho
Authorization: Bearere que a chave não expirou.
Dicas
- Comece pelo caminho no-code (n8n/Make/Zapier) com um webhook antes de escrever código.
- Dê a cada integração apenas os escopos necessários.
Artigos relacionados
Artigos relacionados
-
Como conectar integrações e apps externos
Conecte o Omnifox às suas ferramentas favoritas a partir do catálogo de integrações em poucos passos.
-
Integrar o Omnifox com Azur, Siigo, Alegra, QuickBooks ou outro sistema contábil ou ERP
O Omnifox não tem hoje um conector nativo com sistemas contábeis ou ERP. Veja como fazer essa conexão mesmo assim com fluxos de trabalho, o nó HTTP, n8n, Make, Zapier ou a API, com exemplos.
-
Guia completo de integrações e API
Integrações e API a fundo, em 30 capítulos: chaves de API, chamadas reais, webhooks assinados, n8n, MCP e SDKs, tudo funcionando de verdade.
-
Gerar e usar API keys e webhooks
Crie chaves de API para acessar o Omnifox por código e configure webhooks para receber eventos em tempo real.
-
A API REST do Omnifox: introdução e requisitos de plano
O que é a API REST do Omnifox, qual plano você precisa (a partir do Crece), como autenticar com o cabeçalho X-API-Key e onde fica a documentação.