Desenvolvedores
Webhooks
Cada notificação gerada por sua conta pode ser enviada diretamente para seus próprios sistemas como um JSON POST assinado — assim, o que acontece em sua hospedagem pode iniciar um fluxo de trabalho em qualquer outro lugar.
Com o que você pode conectar
Um webhook é uma solicitação HTTPS comum, portanto qualquer elemento que possa recebê-la pode agir com base nela. Você não precisa que nós criemos uma integração para a sua ferramenta.
Plataformas de automação
Aponte um webhook para um fluxo de trabalho no n8n, Make, Zapier, Pipedream, Activepieces e cada evento se tornará um gatilho — publique em um canal, abra um chamado, atualize uma planilha, chame outra API. Plataformas auto-hospedadas funcionam exatamente da mesma maneira, desde que o endpoint esteja acessível via HTTPS.
CRMs e centrais de ajuda
Envie eventos de cobrança e da conta para HubSpot, Pipedrive, Salesforce, ou para qualquer helpdesk ou CRM com um webhook de entrada, para que o registro do cliente reflita o que está acontecendo com a hospedagem dele sem que ninguém precise copiar as informações manualmente.
Qualquer outra coisa que escute
Slack, Discord, Google Sheets, Airtable, Notion, seu próprio monitoramento, um data warehouse ou um pequeno script que você escreveu. Se puder aceitar um HTTPS POST e ler JSON, poderá receber esses dados.
O que é enviado
Você escolhe quais categorias vão para qual destino — e é possível conectar vários, para que o faturamento vá para um lugar e os alertas do site para outro. Tudo fica ativado por padrão.
Faturamento e pagamentos
Faturas emitidas e pagas, pagamentos com falha, cartões prestes a expirar, renovações e cancelamentos.
Sites e segurança
Provisionamento concluído, um site suspenso, malware encontrado, backups e alterações de certificado.
Suporte e domínios
Chamados abertos e escalados, transferências de domínio, renovações e alterações de DNS.
Comprovar que uma solicitação veio de nós
Cada solicitação é assinada com um segredo que somente você e nós temos. Verifique a assinatura antes de agir no corpo — estes cabeçalhos chegam com cada entrega:
X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paidO carimbo de data/hora é assinado junto com o corpo em vez de ser enviado ao lado dele, de modo que uma solicitação interceptada não possa ser reproduzida contra você mais tarde. Rejeite qualquer item com mais de alguns minutos.
Seu segredo de assinatura é exibido apenas uma vez, quando você adiciona o webhook. Não podemos exibi-lo novamente — se você o perder, remova o destino e adicione-o novamente.
Configurando um
- No seu painel, abra Notificações e adicione um destino do tipo Webhook.
- Informe seu endpoint HTTPS e copie o segredo de assinatura que mostramos a você.
- Pressione Test. Enviamos uma solicitação real no mesmo formato de uma em produção, para que você possa desenvolver com base nela antes que algo real aconteça.
- Escolha quais categorias esse destino deve receber. Novos tipos de notificação são ativados automaticamente.
Você pode adicionar quantos destinos desejar, combinar webhooks com e-mail, Slack e Telegram, e definir um conjunto diferente de categorias para cada um.
Prefere nos ligar?
Os webhooks avisam quando algo aconteceu. A API é a forma de fazer algo acontecer: todas as operações realizadas pelo painel estão disponíveis para você.