Assinatura HMAC-SHA256
Cada entrega leva uma assinatura calculada a partir do corpo e do segredo do seu endpoint, para que o seu receptor confirme que a requisição veio mesmo de nós antes de agir.
Webhooks de saída
Trinta e um eventos, da criação de um contato a um prazo de suporte descumprido ou um anúncio reprovado, entregues no seu endpoint como requisições HTTP POST assinadas, com novas tentativas automáticas. No plano Business. Sem loop de polling, sem tarefa cron perguntando se algo mudou.
Última atualização:
Inscreva cada endpoint só nos eventos que importam para ele, em vez de receber tudo e filtrar do seu lado.
Qualquer um consegue fazer um POST com um corpo JSON. Assinar, tentar de novo e deixar você ver o que aconteceu é o que torna isso utilizável em produção.
Cada entrega leva uma assinatura calculada a partir do corpo e do segredo do seu endpoint, para que o seu receptor confirme que a requisição veio mesmo de nós antes de agir.
Uma entrega que falha é reenviada com intervalos crescentes em vez de descartada, então uma janela de deploy ou uma queda rápida do seu lado não faz sumir em silêncio o evento que importava.
Veja o que foi enviado, quando, o que o seu endpoint respondeu e quanto tempo levou. Depurar uma integração deixa de ser uma discussão sobre se o evento disparou ou não.
Cada endpoint se inscreve nos eventos que quer. Um serviço de expedição que só se importa com invoice.paid não precisa receber e descartar cada atualização de contato.
Até vinte endpoints, para que o sistema do estoque, um repasse interno para o Slack e um data warehouse recebam cada um seu próprio fluxo, com seu próprio segredo.
Um evento de teste permite conferir o endpoint, a verificação da assinatura e o seu handler antes que um deal.won de verdade dependa dos três funcionando.
O support.ticket.breached dispara quando um prazo de resposta é descumprido, e é o evento que a maioria das equipes quer no canal de plantão, não em um painel que ninguém deixa aberto.
Contatos, etapas do funil, mensagens, passos e respostas de prospecção, negócios, tarefas, faturas, transações, assinaturas, chamados de suporte e alertas das contas de anúncio emitem eventos.
O webhook avisa que algo aconteceu; a API REST pública permite ler ou alterar o registro em que aconteceu. Juntos, eles substituem o polling por completo.
Um webhook é o Pinlyx fazendo um HTTP POST para uma URL que você controla no momento em que algo acontece, em vez de o seu código perguntar a cada poucos minutos se aconteceu alguma coisa. Há trinta e um eventos disponíveis, cada entrega é assinada, as falhas são reenviadas e o log mostra exatamente o que o seu endpoint respondeu.
Na prática, a diferença está na latência e no custo. Um job de polling que roda a cada cinco minutos chega cinco minutos atrasado e desperdiça a maior parte das requisições. Um webhook chega em menos de um segundo, e só quando há algo para dizer.
Cada endpoint tem seu próprio segredo. Calculamos um HMAC-SHA256 do corpo da requisição com esse segredo e o enviamos em um cabeçalho de assinatura; o seu receptor recalcula e compara. Uma requisição sem assinatura correspondente deve ser rejeitada.
Faça a comparação em tempo constante, e não com uma igualdade de strings comum, e trate o segredo como uma senha: ele é a única coisa entre o seu endpoint e qualquer pessoa que adivinhe a URL.
Uma resposta fora da faixa 2xx ou um timeout marca a entrega como falha, e ela é reenviada com backoff. Isso cobre os casos comuns: um deploy, uma reinicialização, um bloqueio momentâneo no banco de dados.
Como existem novas tentativas, o seu handler precisa ser idempotente. Projete-o para que receber o mesmo evento duas vezes dê o mesmo resultado que recebê-lo uma vez, normalmente usando o id do evento como chave. Isso vale para qualquer sistema de webhooks, e é o erro que mais aparece na forma de registros duplicados.
Os webhooks de saída são um recurso do plano Business, com até vinte endpoints, assim como a API REST pública que trabalha com eles. Se você prefere não escrever receptor nenhum, as integrações com Zapier e n8n consomem os mesmos eventos no mesmo plano. Os preços atuais estão na página de preços.
Leia e altere os registros a que os eventos se referem.
Deixe um cliente de IA operar o espaço de trabalho.
Os mesmos eventos, sem receptor.
Automação auto-hospedada sobre os mesmos dados.
De onde vem o evento de descumprimento de SLA.
Limite de endpoints em cada plano.
Hora de começar
Webhooks e a API REST estão incluídos no Business.