Sende Ereignisse von deinem Server

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

Erfasst im Pixel einer Website die Ereignisse, die nicht über den Browser laufen: ein Verkauf im Laden, eine Verlängerung aus der Verwaltungssoftware, eine telefonisch aufgenommene Bestellung. Ein purchase wird zu einer bestätigten Bestellung, und sein Umsatz geht an die richtige Kampagne oder Automatisierung, wie die Bestellungen der Website.

Die anderen Namen (zum Beispiel preventivo_accettato) werden zu Aktionen des Kontakts und können die Automatisierungen «Führt eine Aktion auf der Website aus» starten.

event_id macht den Aufruf wiederholbar: Dasselbe Ereignis, zweimal gesendet (auch Tage später, bis zu 7), zählt nur einmal und erscheint in duplicates.

Der Kontakt wird an phone oder email erkannt; existiert er nicht, wird er angelegt. Ein Ereignis vom Server übergeht die Einwilligung nicht: Automatisierungen starten nur für Kontakte mit einer erfassten Marketing-Einwilligung.

Du brauchst einen Tarif mit SendApp Pixel, der Server-Events-API und dem API-Zugang. Höchstens 100 Ereignisse pro Aufruf.

Parameter

3 · 3 Pflichtfelder

apikey erforderlich

Ihr API Key (alternativ: der Header X-API-Key).

site erforderlich

Der öffentliche Schlüssel der Website (pk_…), unter Pixel → Websites → Code.

events erforderlich

Liste von Ereignissen. Jedes: name (Kleinbuchstaben, Ziffern und _), event_id (deine, max. 64), occurred_at (ISO 8601), contact ({phone oder email}), value, currency, order_id, properties (bis zu 20 einfache Werte).

Brauchen Sie Hilfe bei der Integration? 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 }], }), });