Webhooks de saída: o que são, criar assinatura e selecionar eventos
Entenda o que é um webhook de saída no Omnifox e crie sua primeira assinatura para receber eventos no seu sistema em tempo real.
Veja este passo no vídeo · Webhooks: criar uma assinatura
O que é um webhook de saída?
Um webhook de saída é uma notificação automática que o Omnifox envia para uma URL sua (um endpoint) sempre que acontece um evento: chega uma mensagem, um contato é criado, uma conversa é fechada, uma transmissão termina, e assim por diante. Em vez de o seu sistema ficar perguntando "aconteceu algo?" de tempos em tempos, o Omnifox avisa na hora com uma requisição HTTP POST contendo os dados do evento em formato JSON.
É a forma de integrar o Omnifox ao seu CRM, ERP, uma planilha, uma função serverless ou qualquer serviço capaz de receber uma requisição web.
Antes de começar
- Você precisa da permissão Gerenciar webhooks (
webhooks.manage) no seu workspace. - Precisa de um endpoint público acessível via HTTPS que responda com um status
2xx(idealmente200) em poucos segundos. - Tenha a URL de destino em mãos.
Passos para criar uma assinatura
- No menu lateral, abra a seção Webhooks.
- Clique em Novo webhook (canto superior direito).
- Em Configuração, preencha:
- Nome: um rótulo claro, ex.: Sincronizar CRM.
- URL de destino: o endereço HTTPS que receberá os eventos.
- Número de retentativas e Tempo limite (segundos): pode manter os padrões (3 e 30).
- Deixe a chave Ativo ligada.
- Em Segredo de assinatura você verá um segredo gerado automaticamente (
whsec_...). Clique em Copiar e guarde-o: ele será usado para validar o cabeçalhoX-Omnifox-Signatureno seu servidor. - Em Eventos para assinar, marque as caixas desejadas, por exemplo Mensagem recebida (
message.received) ou Conversa criada (conversation.created). Pelo menos um é obrigatório. - Clique em Criar webhook.
Eventos disponíveis
Entre os eventos que você pode assinar estão: Mensagem recebida, Mensagem enviada, Conversa criada, Conversa fechada, Contato criado, Contato atualizado, Transmissão concluída e Saúde do canal alterada. Marque apenas os que sua integração realmente precisa, para não receber tráfego em excesso.
Verificação
Após salvar, volte à lista de Webhooks: seu novo registro aparece com a chave Ativo em verde. Dispare um dos eventos assinados (por exemplo, envie uma mensagem de teste para você) e abra os detalhes do webhook para ver a entrega no Histórico de entregas com status Entregue e código 200.
Se não funcionar
- Não chega nada: confirme que a chave Ativo está ligada e que você marcou o evento certo.
- Seu servidor recebe mas rejeita: responda com um
2xxrápido; se demorar mais que o Tempo limite, conta como falha. - Erros de certificado: a URL precisa ser HTTPS com certificado válido.
Dica: comece assinando um único evento em um endpoint descartável (como o webhook.site) para inspecionar o payload real antes de apontar para o seu sistema em produção.
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.
-
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.