Envía eventos desde tu servidor

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

Registra en el Pixel de un sitio los eventos que no pasan por el navegador: una venta en la tienda, una renovación desde el software de gestión, un pedido tomado por teléfono. Un purchase se convierte en un pedido confirmado y sus ingresos van a la campaña o a la automatización correcta, como los pedidos del sitio.

Los demás nombres (por ejemplo preventivo_accettato) se convierten en acciones del contacto y pueden iniciar las automatizaciones «Realiza una acción en el sitio».

event_id hace que la llamada se pueda repetir: el mismo evento enviado dos veces (incluso con días de diferencia, hasta 7) cuenta una sola vez y aparece en duplicates.

El contacto se reconoce por phone o email; si no existe, se crea. Un evento desde el servidor no se salta el consentimiento: las automatizaciones solo se inician para contactos con un consentimiento de marketing registrado.

Necesitas un plan con SendApp Pixel, la API de eventos desde el servidor y el acceso API. Como máximo 100 eventos por llamada.

Parámetros

3 · 3 obligatorios

apikey obligatorio

Tu API Key (como alternativa: la cabecera X-API-Key).

site obligatorio

La clave pública del sitio (pk_…), en Pixel → Sitios → Código.

events obligatorio

Lista de eventos. Cada uno: name (letras minúsculas, cifras y _), event_id (tuyo, máx. 64), occurred_at (ISO 8601), contact ({phone o email}), value, currency, order_id, properties (hasta 20 valores simples).

¿Necesitas ayuda con la integración? 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 }], }), });