Événements

Un événement est quelque chose qu’une personne a fait, signalé par votre boutique ou votre application. Il est gardé sur son profil, peut démarrer une automatisation, alimente les segments — et, nommé order avec une value, compte comme du revenu.

Enregistrer un événement

curl -X POST https://api.lekalao.com/v1/events \
  -H "Authorization: Bearer $LEKALAO_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "email": "ada@example.com",
    "name": "cart.abandoned",
    "reference": "cart-88213",
    "properties": {
      "url": "https://boutique.example.com/panier/88213",
      "total": "27 500 FCFA",
      "items": [
        { "name": "Darjeeling première récolte", "price": "15 000 FCFA", "quantity": 1 },
        { "name": "Théière", "price": "12 500 FCFA", "quantity": 1 }
      ]
    }
  }'

Champ
`email`	Qui l’a fait. Obligatoire. La personne n’a pas besoin d’être déjà abonnée : l’événement l’attend sur son profil.
`name`	Obligatoire, à vous de le choisir : lettres, chiffres, espaces et `_ . : -`, 100 caractères au plus.
`properties`	Ce qui le décrit. Les e-mails de l’automatisation qu’il démarre les lisent directement : `{{ event.total }}`, `{% for item in event.items %}`.
`value`, `currency`	Un entier dans la plus petite unité (`1250` vaut 12,50 €) et trois lettres. L’un exige l’autre.
`reference`	Votre propre identifiant. La même référence deux fois n’est enregistrée qu’une fois : le second appel répond `200` avec `"status": "duplicate"`.
`occurred_at`	Maintenant, si absent. Au plus un jour dans le futur.

La réponse est 201 avec {"data": {"index": 0, "status": "recorded", "id": "…"}}.

Un lot

Jusqu’à 1 000 événements sous events. Chaque ligne reçoit sa propre réponse, dans l’ordre d’arrivée — une ligne fausse ne coûte rien aux autres :

{
  "data": [
    { "index": 0, "status": "recorded", "id": "01a0…" },
    { "index": 1, "status": "invalid", "errors": { "email": ["Le champ email doit être une adresse e-mail valide."] } }
  ],
  "failed": 1
}

L’appel répond 200, ou 422 quand toutes les lignes sont invalides.

Une commande est du revenu

Un événement nommé order porteur d’une value est crédité au dernier e-mail que la personne a ouvert ou cliqué dans la fenêtre d’attribution, exactement comme le fait POST /v1/conversions. Envoyez l’un ou l’autre pour une vente, pas les deux.

Ce qu’une personne a fait

curl "https://api.lekalao.com/v1/events?email=ada@example.com&name=order" \
  -H "Authorization: Bearer $LEKALAO_TOKEN" -H "Accept: application/json"

Du plus récent au plus ancien, 50 par défaut, 200 au plus (per_page). Une adresse inconnue de l’équipe répond une liste vide.

Champs de contact

Les champs donnent un type à ce que vous envoyez sous attributes sur un abonné. GET /v1/fields les liste ; POST /v1/fields en crée un (key, label, type : text, number, date ou boolean) ; PATCH change son libellé ou son type ; DELETE le retire. Une clé jamais déclarée crée d’elle-même un champ text. Voir Champs de contact.

L'API

Recettes

Intégrations

Enregistrer un événement

Un lot

Une commande est du revenu

Ce qu’une personne a fait

Champs de contact

​Enregistrer un événement

​Un lot

​Une commande est du revenu

​Ce qu’une personne a fait

​Champs de contact

Enregistrer un événement

Un lot

Une commande est du revenu

Ce qu’une personne a fait

Champs de contact