Suivre les événements
Les événements, c'est ce que font vos clients — « signed_up », « added_to_cart », « purchased ». Diffusez-les vers Climails et ils deviennent le carburant des segments, des déclencheurs d'automatisation et de l'attribution du chiffre d'affaires.
Ce dont vous aurez besoin
- Une clé API autorisée à écrire des événements
- Un backend ou un frontend capable de faire un POST quand quelque chose se produit
Envoyer un événement
Faites un POST vers /v1/events avec le nom de l'événement, à qui il appartient et d'éventuelles propriétés. Identifiez le contact par 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" }
}'Envoyer des événements en masse
Vous faites un rattrapage ou du batch ? Faites un POST de jusqu'à 1000 événements à la fois vers /v1/events/bulk au lieu d'une requête par événement.
Mettre les événements au travail
- Segments — construisez des conditions sur les événements, par exemple a fait « purchased » au cours des 30 derniers jours, ou l'a fait au moins 3 fois.
- Automatisations — démarrez un scénario à l'instant où un événement arrive (déclencheur d'événement).
- Chiffre d'affaires — attachez une propriété amount et la campagne d'origine pour attribuer le chiffre d'affaires dans les analytics.
Questions fréquentes
Comment identifier le contact sur un événement ?
Par id, external_id ou email. Si le contact n'existe pas encore, l'événement s'y associe dès qu'il est créé avec un identifiant correspondant.
Quelle est la limite en masse ?
Jusqu'à 1000 événements par appel à /v1/events/bulk.
Puis-je segmenter sur le nombre de fois qu'un événement s'est produit ?
Oui — les conditions d'événement prennent en charge un opérateur de comptage et une fenêtre temporelle (par exemple ≥ 3 fois au cours des 30 derniers jours).
Commencez à envoyer en quelques minutes
Créez un compte gratuit, connectez votre domaine et touchez votre audience sur tous les canaux — sans carte bancaire.
Offre gratuite à vie · Sans carte bancaire · Prêt en quelques minutes