Enviar eventos do seu backend

Envie eventos dos seus servidores para tudo o que não pode depender do navegador do visitante, como pedidos, pagamentos, mudanças de assinatura ou eventos de um back office. Esta página mostra como enviar um evento, como enviar vários e como tratar erros.

Antes de começar

• O envio de eventos está incluído nos planos Pro, Business e Custom. Um workspace Pro pode usar 100 tipos de evento, e um workspace Business, 1.000. Consulte Limites.
• Crie uma chave de API com o escopo Events Only em Email API›API Keys. Ela pode enviar eventos e nada mais: não pode ler os seus dados, gerenciar definições de eventos nem enviar e-mails. Uma chave Full Access também funciona. Consulte Chaves de API.
• Para enviar eventos do workspace, defina-os antes. Os eventos personalizados não precisam de configuração.

Enviar um evento

Chame Enviar um evento com o type do evento, as properties dele e a pessoa a que ele se refere:

curl -X POST https://api.emailit.com/v2/events \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "c:order.completed",
    "email": "jane@example.com",
    "properties": { "order_id": "1001", "total": 59.9, "currency": "EUR" },
    "occurred_at": "2026-10-19T09:30:00Z"
  }'

• email vincula o evento ao contato com esse endereço. Se você já souber o ID do contato, envie contact_id no lugar.
• occurred_at indica quando o evento aconteceu, por exemplo, quando você envia eventos a partir de uma fila. Omita-o para usar o horário atual.
• A resposta é 201 com o evento armazenado e o ID evt_ dele. Uma chave Events Only recebe o evento de volta sem data.

Enviar vários eventos de uma vez

Enviar eventos em lote aceita até 100 eventos em uma requisição, o que é adequado para importações e sincronizações agendadas:

curl -X POST https://api.emailit.com/v2/events/batch \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      { "type": "c:order.completed", "email": "jane@example.com", "properties": { "order_id": "1001", "total": 59.9 } },
      { "type": "c:order.completed", "email": "omar@example.com", "properties": { "order_id": "1002", "total": 18 } }
    ]
  }'

Um lote é tudo ou nada: se um evento for inválido, nenhum é armazenado. A resposta 422 lista cada problema em events.<index>, para que você corrija ou remova esses eventos e envie o lote de novo.

Tratar erros

Os eventos não têm chave de idempotência, então tentar de novo uma requisição que já foi processada armazena o evento duas vezes. Coloque o seu próprio ID nas propriedades, como order_id, para que quem lê os eventos possa reconhecer duplicados.

Verificar se os eventos chegam

Abra Email API›Events. A aba Log lista os eventos novos no topo; defina Scope como Custom ou Workspace para ocultar os eventos do sistema. Selecione um evento para ver as propriedades dele, o contato a que pertence e de onde veio. Os eventos vinculados a um contato também aparecem no Activity log do contato.

Veja também