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.

Jun 26, 2026

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 (idealmente 200) em poucos segundos.
  • Tenha a URL de destino em mãos.

Passos para criar uma assinatura

  1. No menu lateral, abra a seção Webhooks.
  2. Clique em Novo webhook (canto superior direito).
  3. 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).
  4. Deixe a chave Ativo ligada.
  5. Em Segredo de assinatura você verá um segredo gerado automaticamente (whsec_...). Clique em Copiar e guarde-o: ele será usado para validar o cabeçalho X-Omnifox-Signature no seu servidor.
  6. Em Eventos para assinar, marque as caixas desejadas, por exemplo Mensagem recebida (message.received) ou Conversa criada (conversation.created). Pelo menos um é obrigatório.
  7. 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 2xx rá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

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp