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.

Jun 26, 2026

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:

  1. Você vai em Configurações → Integrações.
  2. Encontra o conector e clica em Conectar.
  3. 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

  1. Vá em Configurações → Webhooks → Novo webhook.
  2. Cole a URL de destino (a que o n8n, Make, Zapier ou seu servidor fornece).
  3. Marque os eventos desejados: message.received, message.sent, conversation.created, conversation.closed, contact.created, contact.updated.
  4. Salve e clique em Enviar teste (test.ping) para confirmar que seu destino responde.

Opção C — Criar uma chave de API

  1. Vá em Configurações → Chaves API → Nova chave de API.
  2. Dê um nome, escolha o workspace, uma data de expiração e os escopos mínimos.
  3. 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 200 rápido; veja as retentativas no detalhe do webhook.
  • A chave de API retorna 401: confirme que envia o cabeçalho Authorization: Bearer e 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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp