Invia eventi dal tuo server

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

Registra nel Pixel di un sito gli eventi che non passano dal browser: una vendita in negozio, un rinnovo dal gestionale, un ordine preso al telefono. Un purchase diventa un ordine confermato e il suo incasso va alla campagna o all'automazione giusta, come gli ordini del sito.

Gli altri nomi (per esempio preventivo_accettato) diventano azioni del contatto e possono far partire le automazioni «Fa un'azione sul sito».

event_id rende la chiamata ripetibile: lo stesso evento inviato due volte (anche a distanza di giorni, fino a 7) conta una volta sola e compare in duplicates.

Il contatto si riconosce da phone o email; se non esiste viene creato. Un evento dal server non scavalca il consenso: le automazioni partono solo per contatti con un consenso marketing registrato.

Serve un piano con SendApp Pixel, l'API eventi dal server e l'accesso API. Al massimo 100 eventi per chiamata.

Parametri

3 · 3 obbligatori

apikey obbligatorio

La tua API Key (in alternativa: header X-API-Key).

site obbligatorio

La chiave pubblica del sito (pk_…), da Pixel → Siti → Codice.

events obbligatorio

Lista di eventi. Ognuno: name (lettere minuscole, cifre e _), event_id (tuo, max 64), occurred_at (ISO 8601), contact ({phone o email}), value, currency, order_id, properties (fino a 20 valori semplici).

Serve aiuto con l'integrazione? 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 }], }), });