Webhooks de entrada (incoming) no Team

Gere uma URL secreta para que um sistema externo publique mensagens em um espaço do Team com um POST.

Jun 26, 2026

Veja este passo no vídeo · Gerenciar o espaço

O que é um webhook de entrada

Um webhook de entrada (incoming) fornece uma URL secreta para que um sistema externo —GitHub, seu servidor, um monitor de alertas, etc.— publique mensagens em um espaço do Team com uma simples requisição POST. É a forma mais direta de levar notificações de outras ferramentas para a conversa da equipe, sem construir uma integração completa.

É um recurso avançado e somente os administradores do espaço podem gerenciá-lo.

Requisitos

  • Permissão para gerenciar o espaço (a aba Webhooks só aparece para administradores).
  • Um sistema externo capaz de enviar um POST com JSON.

Passos para criar um webhook

  1. Abra o espaço no Team e entre no seu painel de configurações (engrenagem no cabeçalho).
  2. Vá até a aba Webhooks.
  3. Digite um nome (ex. GitHub, Servidor) e clique em Gerar.
  4. O Omnifox mostra a URL uma única vez: "Copie a URL agora — você não poderá vê-la novamente." Clique em Copiar e guarde-a em local seguro.

A URL tem este formato:

POST https://omnifox.io/api/team/hooks/{token}

Como enviar uma mensagem

Envie um POST com corpo JSON. Dois formatos são aceitos:

  • Simples: {"text": "Deploy concluído ✅", "title": "CI/CD"} — o title (opcional) vira a primeira linha em negrito.
  • Estilo Slack: {"text": "...", "attachments": [...]} — lê o text, ou o primeiro fallback/text/pretext do anexo. Assim, muitos emissores que já enviam ao Slack funcionam sem alteração.

Exemplo com curl:

curl -X POST https://omnifox.io/api/team/hooks/SEU_TOKEN \
  -H "Content-Type: application/json" \
  -d '{"text":"Backup noturno OK","title":"Servidor"}'

A mensagem aparece assinada como Integração com o selo Webhook. Uma resposta 201 confirma a publicação.

Gerenciar e revogar

  • Regenerar: cria um novo token e invalida a URL atual imediatamente.
  • Revogar: desabilita a URL permanentemente.
  • O token nunca é guardado em texto puro (apenas um hash) e o endpoint só escreve: uma URL vazada não consegue ler o conteúdo do espaço.

Verificação

  • Envie o exemplo de curl e confira se o cartão aparece no espaço com o selo Webhook.
  • 201 = publicado; 422 = nenhum texto encontrado no corpo.

Se não funcionar

  • 404: token desconhecido ou revogado (ou um POST para a rota errada).
  • 410: o espaço foi arquivado ou excluído.
  • 422: o corpo não trazia text utilizável.
  • 429 / limite: o endpoint é limitado a 60 requisições por minuto por IP e token; espace os envios.
  • O texto é cortado em 4 KB; envie resumos, não logs inteiros.

Dicas

  • Crie um webhook por origem (um para CI, outro para alertas) para revogá-los separadamente.
  • Se suspeitar que a URL vazou, use Regenerar e atualize o sistema emissor.

Artigos relacionados

Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp