Envoyez des événements depuis votre serveur

POST https://app.sendapp.ai/api/pixel/events

Enregistre dans le Pixel d'un site les événements qui ne passent pas par le navigateur : une vente en boutique, un renouvellement depuis le logiciel de gestion, une commande prise par téléphone. Un purchase devient une commande confirmée et ses revenus vont à la bonne campagne ou automatisation, comme les commandes du site.

Les autres noms (par exemple preventivo_accettato) deviennent des actions du contact et peuvent déclencher les automatisations «Effectue une action sur le site».

event_id rend l'appel répétable : le même événement envoyé deux fois (même à plusieurs jours d'écart, jusqu'à 7) ne compte qu'une fois et apparaît dans duplicates.

Le contact est reconnu par phone ou email ; s'il n'existe pas, il est créé. Un événement envoyé par le serveur ne contourne pas le consentement : les automatisations ne démarrent que pour les contacts ayant un consentement marketing enregistré.

Il faut un forfait avec SendApp Pixel, l'API d'événements serveur et l'accès API. 100 événements maximum par appel.

Paramètres

3 · 3 obligatoires

apikey obligatoire

Votre API Key (ou bien l'en-tête X-API-Key).

site obligatoire

La clé publique du site (pk_…), dans Pixel → Sites → Code.

events obligatoire

Liste d'événements. Chacun : name (lettres minuscules, chiffres et _), event_id (le vôtre, 64 max.), occurred_at (ISO 8601), contact ({phone ou email}), value, currency, order_id, properties (jusqu'à 20 valeurs simples).

Besoin d'aide pour l'intégration ? info@sendapp.live

curl -X POST 'https://app.sendapp.ai/api/pixel/events' \ -H 'X-API-Key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "site": "pk_7Fq2XbN9Lm4c0000", "events": [{ "name": "purchase", "event_id": "negozio-firenze-55120", "occurred_at": "2026-09-24T16:42:10+02:00", "contact": { "phone": "+393475550192" }, "value": 420.00, "currency": "EUR", "order_id": "55120", "properties": { "canale": "negozio", "articoli": 2 } }] }'

<?php $ch = curl_init('https://app.sendapp.ai/api/pixel/events'); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY', 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode([ 'site' => 'pk_7Fq2XbN9Lm4c0000', 'events' => [[ 'name' => 'purchase', 'event_id' => 'negozio-firenze-55120', 'contact' => ['phone' => '+393475550192'], 'value' => 420.00, 'currency' => 'EUR', 'order_id' => '55120', ]], ]), ]); $res = json_decode(curl_exec($ch), true); curl_close($ch);

await fetch('https://app.sendapp.ai/api/pixel/events', { method: 'POST', headers: { 'X-API-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ site: 'pk_7Fq2XbN9Lm4c0000', events: [{ name: 'preventivo_accettato', event_id: 'crm-8812', contact: { email: 'giulia@example.com' }, value: 1200 }], }), });