Trigger push via API
Invio push basato su eventi del tuo sistema. Carrello abbandonato, ordine spedito, prodotto tornato — il tuo server chiama e Willy invia.
Endpoint
POST /api-push/api/trigger_event.php
Autenticazione: X-API-TOKEN. Il token in Area Cliente → Impostazioni.
Parametri (JSON body)
| Campo | Obbligatorio | Descrizione |
|---|---|---|
domain | Sì | Il tuo dominio |
title | Sì* | Titolo notifica |
body | Sì* | Corpo messaggio |
event_type | No | cart_abandoned, order_shipped, ecc. |
url | No | Link al click |
target | No | {"role":"wooCart"} – segmento |
external_event_id | No | ID univoco per deduplica |
* Almeno uno tra title e body
Esempio: carrello abbandonato
curl -X POST "https://willypush.it/api-push/api/trigger_event.php" \
-H "Content-Type: application/json" \
-H "X-API-TOKEN: IL_TUO_TOKEN" \
-d '{
"domain": "tuosito.it",
"event_type": "cart_abandoned",
"title": "Hai lasciato articoli nel carrello",
"body": "Completa l'\''ordine con -10% se ordini entro stasera!",
"url": "https://tuosito.it/carrello",
"target": { "role": "wooCart" },
"external_event_id": "cart_123"
}'
Deduplica
Se invii lo stesso external_event_id due volte, la seconda richiesta risponde OK senza inviare di nuovo (evita push duplicate da webhook/retry).
Integrazione
- WooCommerce – Hook su carrello abbandonato o cron 1h dopo → chiama trigger con
target: {role: "wooCart"} - Shopify – Webhook orders/fulfillments → trigger con segmento cliente
- CRM – Lead caldo → trigger con
target: {role: "lead_caldo"}