Enviar eventos a partir do seu servidor

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

Regista no Pixel de um site os eventos que não passam pelo navegador: uma venda na loja, uma renovação a partir do software de gestão, uma encomenda feita por telefone. Um purchase torna-se uma encomenda confirmada e a sua receita vai para a campanha ou automação certa, como as encomendas do site.

Os outros nomes (por exemplo preventivo_accettato) tornam-se ações do contacto e podem iniciar as automações «Realiza uma ação no site».

event_id torna a chamada repetível: o mesmo evento enviado duas vezes (mesmo com dias de intervalo, até 7) conta só uma vez e aparece em duplicates.

O contacto é reconhecido pelo phone ou pelo email; se não existir, é criado. Um evento do servidor não se sobrepõe ao consentimento: as automações só arrancam para contactos com um consentimento de marketing registado.

É necessário um plano com SendApp Pixel, a API de eventos do servidor e o acesso API. No máximo 100 eventos por chamada.

Parâmetros

3 · 3 obrigatórios

apikey obrigatório

A sua API Key (em alternativa: o cabeçalho X-API-Key).

site obrigatório

A chave pública do site (pk_…), em Pixel → Sites → Código.

events obrigatório

Lista de eventos. Cada um: name (letras minúsculas, algarismos e _), event_id (próprio, máx. 64), occurred_at (ISO 8601), contact ({phone ou email}), value, currency, order_id, properties (até 20 valores simples).

Precisa de ajuda com a integração? 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 }], }), });