Rastreie eventos
Eventos são o que os seus clientes fazem — “signed_up”, “added_to_cart”, “purchased”. Envie-os em fluxo para o Climails e eles se tornam o combustível para segmentos, gatilhos de automação e atribuição de receita.
O que você vai precisar
- Uma chave de API com permissão para gravar eventos
- Um backend ou frontend que possa fazer POST quando algo acontece
Envie um evento
Faça um POST para /v1/events com o nome do evento, a quem ele pertence e quaisquer propriedades. Identifique o contato por id, external_id ou email.
curl https://api.climails.com/v1/events \
-H "Authorization: Bearer sb_live_<prefix>.<secret>" \
-H "Content-Type: application/json" \
-d '{
"name": "purchased",
"contact": { "email": "[email protected]" },
"occurred_at": "2026-07-01T10:24:00Z",
"properties": { "amount": 49.0, "currency": "USD", "plan": "pro" }
}'Envie eventos em massa
Fazendo um backfill ou agrupando? Faça um POST de até 1000 eventos de uma vez para /v1/events/bulk em vez de uma requisição para cada um.
Coloque os eventos para trabalhar
- Segmentos — monte condições sobre eventos, ex.: fez “purchased” nos últimos 30 dias, ou fez pelo menos 3 vezes.
- Automações — inicie um fluxo no momento em que um evento chega (gatilho de evento).
- Receita — anexe uma propriedade amount e a campanha de origem para atribuir receita no analytics.
Perguntas frequentes
Como identifico o contato em um evento?
Por id, external_id ou email. Se o contato ainda não existir, o evento mesmo assim se associa quando ele for criado com um identificador correspondente.
Qual é o limite em massa?
Até 1000 eventos por chamada para /v1/events/bulk.
Posso segmentar pela quantidade de vezes que um evento aconteceu?
Sim — as condições de evento suportam um operador de contagem e uma janela de tempo (ex.: ≥ 3 vezes nos últimos 30 dias).
Comece a enviar em minutos
Crie uma conta gratuita, conecte seu domínio e alcance seu público em todos os canais — sem cartão de crédito.
Plano gratuito para sempre · Sem cartão de crédito · Pronto em minutos