Trimiteți actualizări de comenzi WhatsApp din WooCommerce
Creați un webhook WooCommerce pentru evenimentele comenzilor, care trimite către un receptor, de exemplu un workflow n8n sau o rută PHP mică. Receptorul verifică semnătura WooCommerce, confirmă că clientul a acceptat mesajele WhatsApp și trimite un template aprobat prin Cloud API, folosind ID-ul numărului de telefon și token-ul numărului conectat.
WooCommerce dezactivează un webhook după mai mult de cinci eșecuri consecutive de livrare.
Header care conține un HMAC-SHA256 al payload-ului codificat base64, calculat cu secretul webhook-ului.
În afara ferestrei de serviciu pentru clienți, pot fi trimise doar mesaje template aprobate în prealabil.
Cum declanșează o comandă WooCommerce un mesaj WhatsApp?
Printr-un webhook WooCommerce și un receptor. În WooCommerce, la Setări, Avansat, Webhook-uri, adăugați un webhook cu un topic de comandă, de exemplu comandă creată sau comandă actualizată, un URL de livrare și un secret. De fiecare dată când are loc evenimentul, WooCommerce trimite comanda ca JSON către acel URL.
Payload-ul este fix, deci nu poate fi îndreptat direct spre Cloud API. Între cele două se află un receptor: un nod Webhook n8n, o rută în PHP-ul magazinului sau orice serviciu mic. Acesta citește comanda, alege numărul de telefon al clientului și detaliile necesare mesajului, apoi face o singură cerere HTTPS către endpoint-ul de mesaje din Cloud API pentru numărul conectat, cu token-ul de acces al numărului ca bearer token.
Topicul order.updated nu este legat de un singur status, așa că receptorul trebuie să citească câmpul status al comenzii și să trimită un mesaj o singură dată pentru fiecare tranziție care contează. Implicit, WooCommerce livrează în fundal prin wp-cron, deci mesajul poate sosi la scurt timp după comandă.
De unde știe receptorul că cererea vine de la magazin?
Din semnătura WooCommerce. Fiecare livrare poartă un header X-WC-Webhook-Signature, un HMAC-SHA256 al payload-ului brut, codificat base64 și calculat cu secretul setat pe webhook. Receptorul calculează același hash peste corpul primit, îl compară și respinge orice nu se potrivește.
Acesta este secretul propriu al magazinului, deci, spre deosebire de semnătura Meta pentru mesajele WhatsApp primite, poate fi validat. Comparați în timp constant și calculați hash-ul pe corpul brut, înainte ca vreun framework să îl proceseze, deoarece un JSON recodificat produce alt hash.
Răspundeți rapid cu un cod 2xx. WooCommerce numără ca eșec orice răspuns care nu este 2xx, 301 sau 302, iar după mai mult de cinci eșecuri la rând dezactivează webhook-ul. Un receptor oprit pentru un deploy sau lent pentru că așteaptă răspunsul Meta poate opri mesajele magazinului fără ca cineva să observe.
Ce poate trimite magazinul și când?
Un template aprobat, de fiecare dată când magazinul scrie primul. Fereastra de serviciu pentru clienți de 24 de ore a Meta se deschide doar când clientul scrie numărului, deci o confirmare de comandă sau o actualizare de livrare este inițiată de firmă, iar textul liber este refuzat. Creați un template de tip utility pentru fiecare actualizare, așteptați aprobarea și trimiteți-l după nume și limbă, cu numărul comenzii și celelalte detalii ca parametri.
Meta cere și opt-in: clientul și-a dat numărul și a acceptat să primească mesaje de la această firmă pe WhatsApp. O casetă bifată la finalizarea comenzii și salvată pe comandă este cea mai simplă dovadă, iar receptorul trebuie să o verifice înainte de trimitere.
După ce clientul răspunde, conversația este Coexistence obișnuit. Răspunsul apare în aplicația WhatsApp Business de pe telefonul magazinului, fereastra este deschisă pentru text liber, iar echipa răspunde din aplicație ca până acum.
Greșeli frecvente
- Apelarea Cloud API înainte de a răspunde WooCommerce. O trimitere lentă sau eșuată se numără împotriva webhook-ului, care este dezactivat după mai mult de cinci eșecuri.
- Calcularea hash-ului pe JSON procesat în loc de corpul brut. Semnătura nu se potrivește niciodată, iar fiecare livrare reală este respinsă.
- Trimiterea la fiecare livrare order.updated. Topicul nu este legat de un singur status, deci fără evidența tranziției deja notificate clienții primesc mesaje duplicate.
Conectați numărul magazinului pe easycoexistence.com și dați receptorului ID-ul numărului de telefon și token-ul din dashboard. De la US$ 9 pe număr pe lună, scăzând la US$ 1 pe măsură ce adăugați numere, cu primele 3 zile gratuite.
Întrebări frecvente
Am nevoie de un plugin WordPress pentru asta?
Nu. Webhook-urile încorporate ale WooCommerce și un receptor sunt suficiente, iar receptorul poate fi o rută în aceeași aplicație PHP.
Cine plătește mesajele despre comenzi?
Meta facturează mesageria direct firmei, pe propriul cont WhatsApp Business, iar EasyCoexistence nu adaugă niciun adaos.
Poate echipa să folosească în continuare telefonul?
Da. Coexistence păstrează aplicația WhatsApp Business funcțională pe numărul magazinului, iar template-ul trimis de magazin apare în conversație.
Ce fac dacă un webhook a fost dezactivat?
Remediați receptorul, apoi setați statusul webhook-ului înapoi pe activ în WooCommerce. Comenzile create cât a fost oprit nu au declanșat niciun mesaj.
Continuați să citiți
Gata să începeți?
Configurați WhatsApp Coexistence în câteva minute, nu luni. Aplicația continuă să funcționeze pe telefon.
Începeți perioada de probă gratuităVerificat la