WPP Marketing
Limbă și monedă
Conectează‑te
Studii de caz Planuri
Caută pe site
Limbă și monedă
Events API

Trimite evenimente din magazinul sau ERP-ul tău pentru a declanșa automatizări pe WhatsApp.

Folosește Events API când sistemul tău trebuie să raporteze către WPP Marketing coș, comandă, plată, livrare, anulare sau crearea unui client.

Events API primește evenimentul comercial și folosește automatizările configurate. Pentru a trimite un mesaj direct, folosește Messaging API. Pentru a urmări livrarea, confirmările de citire și erorile, folosiți webhook-uri de stare.

Flux

Sistemul tău raportează evenimentul. WPP Marketing decide automatizarea.

Events API este ideal pentru magazine personalizate, ERP-uri, backoffices și integrări care nu au un conector plug-and-play.

01 Evenimentul are loc

Comanda, coșul, plata, livrarea, anularea sau înregistrarea au loc în sistemul sursă.

02 Sistemul trimite payload

Backend‑ul tău trimite evenimentul cu token, identificator, client, valori și linkuri disponibile.

03 Regula este evaluată

WPP Marketing verifică dacă există o automatizare activă pentru acel eveniment și client.

04 Mesajul a fost trimis

Clientul primește mesaje WhatsApp pentru recuperare, plată, comandă, expediere, campanie sau post-vânzare.

Evenimente comerciale acceptate.

Nomenclatura finală și câmpurile obligatorii trebuie să urmeze documentația Events API.

POST cart.created

Înregistrează intenția de cumpărare și permite automatizări pentru urmărirea inițială.

Carrinho
POST cart.abandoned

Activează recuperarea coșului cu un memento și un link de revenire când sunt disponibile.

Recuperação
POST order.created

Informează comandă creată sau în așteptarea plății pentru mesaje tranzacționale.

Pedido
POST order.paid

Confirmă plata și permite un mesaj de confirmare, instrucțiuni și pașii următori.

Pagamento
POST order.shipped

Trimite actualizări de expediere, urmărire sau status logistic pentru a reduce tichetelor manuale.

Envio
POST order.cancelled

Înregistrează anularea comenzii pentru a declanșa comunicarea configurată pentru acest eveniment.

Cancelamento
POST customer.created

Alimentează baza de contacte pentru mesaje de bun venit, gestionarea relațiilor, etichete și campanii.

Cliente
Date recomandate

Cu cât evenimentul este mai bun, cu atât mai bună este automatizarea.

Events API trebuie să primească suficiente date pentru a identifica clientul, achiziția, suma, starea și linkuri utile pentru mesaj.

Client

Numărul de telefon, numele, e‑mailul, țara și identificatorul extern ajută la deduplicare și segmentare.

Pedido

Număr, ID extern, total, monedă, stare, metodă de plată și articole fac mesajul mai util.

Linkuri

Pagina de checkout, plată, urmărire sau pagina comenzii poate fi folosită în mesaje automate.

Idempotentă

Furnizați external_id sau order.id și mențineți sursa stabilă. Deduplificarea ia în considerare contul, sursa normalizată, tipul evenimentului și identificatorul extern. Evenimentele repetate returnează HTTP 200 cu indicația Duplicate event ignored. Acest endpoint nu folosește antetul Idempotency-Key al Messaging API.

Răspuns

HTTP 200 confirmă procesarea evenimentului, nu livrarea unui mesaj. Trimiterea necesită o automatizare activă pentru eveniment, date de client valide și o conexiune configurată. Urmăriți mesajul prin rapoarte și webhooks de status.

Securitate

Creează o credential cu events:write și trimite evenimente de pe server. Păstrează tokenul în afara frontend-ului și al repository-urilor publice. Folosește customer.phone pentru numărul de telefon și obiectele customer și order conform exemplului și contractului OpenAPI.

Vrei să conectezi un magazin personalizat sau un ERP?

Deschide documentația Events API pentru a valida payload-urile, autentificarea și exemplele înainte de a trimite evenimente în producție.

Deschide Swagger