Webhooks (integrações de saída)
Avise os SEUS sistemas quando algo acontece aqui: fatura paga, proposta aceita, negócio ganho, demanda criada e lead criado — entregues por HTTP com assinatura.
O que você encontra nesta tela
Um retrato da tela, lido dela mesma — muda quando a tela muda.
Ações disponíveis
Enviar evento de teste
A lista mostra
EventoStatusTent.Quando
Campos do cadastro
DescriçãoPara você reconhecer a integração (ex.: ERP do cliente).
URL de destino*Endpoint HTTPS que receberá o POST com o corpo em JSON.
Ativo
Comece aqui
Para que serve
Integração em tempo real sem polling: cadastre uma URL sua e escolha os eventos. Quando o evento acontece, enviamos um POST com o JSON do ocorrido.
Webhooks em lista, as entregas no topo
A lista traz cada webhook com a descrição, a URL, os eventos, o segredo mascarado e se está ativo. No topo ficam as últimas entregas — evento, status, código HTTP, tentativa e quando — e o botão Enviar teste, que enfileira um ping para todas as assinaturas ativas.
Regras
Segurança (assinatura HMAC)
Cada assinatura tem um segredo (whsec_...). Todo envio vai com o header X-Tenka-Signature (HMAC-SHA256 do corpo) — valide no seu servidor antes de confiar no conteúdo.
Entrega e reenvio
Falhou (timeout/5xx)? A fila reenvia com recuo progressivo. As últimas entregas aparecem na tela com status — use o botão Testar para validar sua URL.
Eventos disponíveis
fatura.paga, proposta.aceita, negocio.ganho, demanda.criada e lead.criado. O catálogo mostra só o que realmente dispara — sem promessa vazia.
Segredo e eventos na ficha
Na ficha, o segredo assina o corpo de cada entrega (cabeçalho X-Tenka-Signature, HMAC): valide-o do seu lado para garantir a origem. Em branco, o Tenka gera um; o botão ao lado gera outro. Em Eventos, deixe "Todos" ou escolha quais eventos disparam — ao menos um.
Excluir remove a assinatura
Webhook não vai para a lixeira: excluir remove a assinatura, e o seu sistema deixa de receber eventos na hora. Para pausar sem perder a configuração, desmarque Ativo.
Perguntas frequentes
Boas práticas
Responda 2xx rápido (processe async no seu lado); trate duplicidade pelo id do evento (entregas podem repetir em retry).
Este artigo foi útil?
No mesmo módulo: Plataforma e segurança38
Acessos da pessoaMostra o acesso EFETIVO de um usuário: grupos, CNPJs e telas — com o grupo que concedeu cada tela.Acessos da plataformaO registro de quando a equipe de suporte da plataforma acessou a sua conta, o que fez e com qual autorização.Ambiente sandboxUm espelho de testes para experimentar sem tocar em produção. O que se faz no sandbox NÃO reflete em produção…Aplicativos conectadosAprove os aplicativos de IA que podem conversar com a sua conta pelo MCP e revogue o que já foi autorizado. U…Assistente fiscalQuatro passos para a nota sair do Tenka: estado, regime, código de segurança (CSC) e certificado A1 — com a r…AutomaçõesMonta regras "quando isso, faça aquilo" sem programar. O risco real é a cascata: uma automação que dispara ou…Autorizar aplicativoA tela em que você decide se um aplicativo externo pode agir na sua conta com as suas permissões. Você chega …Blog — conexão WordPressOnde você conecta o WordPress da sua empresa e ensina a IA a escrever como você: pauta (sobre o que falar), t…
Academia Tenka
Conhecer a AcademiaTrilhas de aprendizado do seu ramo, passo a passo, dentro da plataforma.