Webhooks

Os webhooks permitem que você receba notificações HTTP em tempo real quando eventos acontecem na sua conta Emailit, como quando um email é entregue, rejeitado ou quando um contato é criado.

Em vez de consultar a API constantemente para verificar mudanças, os webhooks enviam dados para o seu servidor conforme os eventos ocorrem, permitindo que você construa integrações e fluxos de trabalho reativos.

Como funciona

1. Você cria um endpoint de webhook na sua aplicação que aceita requisições POST
2. Você registra a URL no painel do Emailit ou através da API
3. Quando um evento inscrito ocorre, o Emailit envia uma requisição POST para sua URL com os dados do evento
4. Seu endpoint responde com um código de status 2xx para confirmar o recebimento

Estrutura do evento

Todo evento de webhook segue uma estrutura consistente:

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

Eventos disponíveis

O Emailit envia notificações de webhook para os seguintes tipos de recursos:

• Emails — eventos do ciclo de vida de entrega (aceito, entregue, rejeitado, etc.)
• Domínios — criação, atualizações e exclusão de domínios
• Audiências — eventos de gerenciamento de audiências
• Assinantes — eventos do ciclo de vida de assinantes
• Contatos — eventos de gerenciamento de contatos
• Templates — criação, atualizações e exclusão de templates
• Supressões — alterações na lista de supressão
• Verificações de Email — resultados de verificação
• Listas de Verificação de Email — eventos de listas de verificação em lote

Consulte Tipos de Eventos para a lista completa.

Próximos passos

• Tipos de Eventos — Lista completa de todos os tipos de eventos disponíveis
• Requisições de Webhook — Como as requisições HTTP de webhook são estruturadas
• Assinatura da Requisição — Verifique a autenticidade do webhook usando assinaturas