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.
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
- Abra o espaço no Team e entre no seu painel de configurações (engrenagem no cabeçalho).
- Vá até a aba Webhooks.
- Digite um nome (ex. GitHub, Servidor) e clique em Gerar.
- 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"}— otitle(opcional) vira a primeira linha em negrito. - Estilo Slack:
{"text": "...", "attachments": [...]}— lê otext, ou o primeirofallback/text/pretextdo 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
textutilizá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
Artigos relacionados
-
Comunicacao interna com Team
Crie espacos e mensagens diretas, use mencoes, notas, lembretes e enquetes, transforme uma mensagem em tarefa e receba avisos dos seus workflows.
-
Guia completo do Team
O Team a fundo, em 28 capítulos: espaços, mensagens diretas, tópicos, enquetes, agendadas, status, responsáveis e pendências, quadro, inbox, IA, chamadas, notificações e atalhos.
-
Comece aqui: o Team em 4 minutos
O essencial do Team em um vídeo curto: espaços, criar um espaço, mensagens e menções, tópicos, tarefas e quadro, mensagens diretas, salvos e Discutir no Team.
-
Espaços e mensagens diretas no Team
Organize a comunicação interna por temas com espaços e fale 1 a 1 com mensagens diretas.
-
Transformar uma mensagem em tarefa ou oportunidade (deal)
Transforme qualquer mensagem do Team em uma tarefa de um quadro ou em uma oportunidade do CRM, sem copiar e colar.