Trimiteți mesaje despre comenzi de pe WhatsApp din Shopify

Cum trimite Shopify Flow un mesaj pe WhatsApp?

Prin acțiunea Send HTTP request, care trimite un POST către orice URL, cu anteturi și un corp ce pot folosi variabile Liquid din declanșator.

Creați un workflow pe declanșatorul de creare a comenzii și adăugați Send HTTP request. URL-ul este endpoint-ul de mesaje din Cloud API pentru phone number id al numărului conectat. Adăugați un antet Authorization cu valoarea Bearer urmată de token-ul de acces al numărului, stocat ca secret Flow și referit ca variabilă secretă. Valorile secrete nu apar niciodată în interfața Flow și sunt mascate în jurnalele de execuție, adică exact acolo unde trebuie să stea un token. Corpul este un mesaj de tip template, cu numărul de telefon al clientului în câmpul to și detaliile comenzii ca parametri ai template-ului.

Flow consideră succes un răspuns 2XX sau 3XX. Meta răspunde la o cerere validă cu id-ul mesajului, deci o rulare reușită înseamnă că Meta a acceptat mesajul.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

De ce trebuie ca mesajul despre o comandă să fie un template?

Pentru că magazinul scrie primul. Fereastra de 24 de ore pentru serviciul clienți de la Meta se deschide doar când clientul scrie numărului. O confirmare de comandă, o actualizare de livrare sau un memento pentru coșul abandonat se trimit înainte de asta, așa că textul liber este refuzat și trece doar un template aprobat în prealabil.

Creați template-ul o singură dată, în categoria utility, pentru actualizări despre comenzi și livrări, și așteptați aprobarea înainte de a porni workflow-ul. Numele și limba din corpul cererii trebuie să corespundă exact template-ului aprobat, iar numărul de parametri trebuie să corespundă placeholderelor lui.

Există și condiția acordului. Meta cere opt-in înainte ca o firmă să scrie cuiva pe WhatsApp: persoana și-a dat numărul și a fost de acord să primească mesaje de la această firmă. O casetă bifată la finalizarea comenzii este modul obișnuit de a-l obține, iar workflow-ul trebuie să o verifice înainte de trimitere.

Ce fac dacă planul magazinului nu include Send HTTP request?

Folosiți în schimb un webhook din panoul de administrare Shopify. La Settings, Notifications, Webhooks, un comerciant poate crea un webhook pentru un eveniment, de exemplu crearea unei comenzi, în format JSON, către un URL. Îndreptați-l spre un receptor: un nod Webhook din n8n sau o rută în PHP, Python ori Node. Receptorul citește comanda, verifică acordul și face același apel de template către Cloud API.

Indiferent de calea de trimitere, răspunsurile funcționează la fel. Când clientul răspunde la mesajul despre comandă, răspunsul ajunge în aplicația WhatsApp Business de pe telefonul magazinului, pentru că numărul este în Coexistence, iar fereastra de 24 de ore este acum deschisă pentru text liber. Dacă numărul are o destinație de webhook setată, răspunsul ajunge și în sistemul dumneavoastră. Mesajul despre comandă apare și el în aplicație, așa că persoana care răspunde vede la ce răspunde clientul.

Greșeli frecvente

• Trimiterea de text liber la crearea comenzii. Clientul nu a scris, deci Meta refuză mesajul; trebuie să fie un template aprobat.
• Lăsarea gestionării erorilor pe Retry pentru răspunsurile 4XX. Flow poate reîncerca până la 24 de ore o cerere pe care Meta nu o va accepta niciodată.
• Introducerea token-ului în antet ca text simplu. Stocați-l ca secret Flow, ca să rămână în afara interfeței și a jurnalelor.

Întrebări frecvente

Continuați să citiți