Webhooks de saída

Seus sistemas ficam sabendo na hora em que acontece

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.

  • 31 eventos
  • Assinados com HMAC-SHA256
  • Novas tentativas com backoff

Última atualização:

Todos os eventos em que você pode se inscrever

Inscreva cada endpoint só nos eventos que importam para ele, em vez de receber tudo e filtrar do seu lado.

Contatos e funil

4
  • contact.created
  • contact.updated
  • contact.deleted
  • pipeline.stage_changed

Mensagens

3
  • message.sent
  • message.received
  • sequence.completed

Campanhas de prospecção

4
  • outreach.step.sent
  • outreach.replied
  • outreach.completed
  • outreach.unsubscribed

Negócios

5
  • deal.created
  • deal.updated
  • deal.stage_changed
  • deal.won
  • deal.lost

Tarefas

2
  • task.created
  • task.completed

Finanças

4
  • invoice.created
  • invoice.paid
  • finance.transaction.created
  • subscription.changed

Central de suporte

4
  • support.ticket.created
  • support.ticket.updated
  • support.ticket.resolved
  • support.ticket.breached

Contas de anúncio

5
  • ads.ad.disapproved
  • ads.budget.exhausted
  • ads.spend.anomaly
  • ads.billing.problem
  • ads.campaign.status_changed

Os detalhes chatos de confiabilidade que decidem se dá para confiar

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.

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.

Novas tentativas com backoff

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.

Um log de entregas legível

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.

Inscrição por evento

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.

Vários endpoints

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.

Teste antes de depender dele

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.

Descumprimentos de SLA incluídos

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.

A empresa inteira, não só os contatos

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.

Junto com a API REST

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.

Para que servem os webhooks de saída

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.

Como confirmar que a entrega veio mesmo de nós

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.

O que acontece quando o seu endpoint está fora do ar

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.

Qual plano é necessário

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.

Perguntas frequentes

Trinta e um, cobrindo contatos e etapas do funil, mensagens, campanhas de prospecção, negócios, tarefas, faturas e transações, assinaturas, chamados da central de suporte (inclusive descumprimentos de SLA) e alertas das contas de anúncio, como um anúncio reprovado ou um orçamento esgotado.
Cada entrega é assinada com HMAC-SHA256 usando o segredo do seu endpoint. Recalcule a assinatura a partir do corpo bruto e compare em tempo constante; rejeite tudo o que não bater.
As entregas que falham são reenviadas com backoff em vez de descartadas, e o log de entregas mostra cada tentativa com a resposta que o seu endpoint deu. Por causa das novas tentativas, o seu handler deve ser idempotente.
Sim, até vinte, cada um com seu próprio segredo e sua própria inscrição em eventos, para que sistemas diferentes recebam fluxos diferentes.
Não. Os webhooks de saída são um recurso do plano Business, junto com as chaves de API e a API REST pública. O servidor MCP está em todos os planos. Os preços atuais estão na página de preços.
Use as integrações com Zapier ou n8n. Elas consomem os mesmos eventos e permitem encaminhá-los para outros apps sem escrever nem hospedar nada.

Hora de começar

Pare de fazer polling atrás de mudanças

Webhooks e a API REST estão incluídos no Business.

Plano grátis para sempre · Preparado para o GDPR · Sem cartão de crédito