Trimiteți mesaje WhatsApp din orice sistem printr-un webhook

Ca să trimiteți un mesaj pe WhatsApp atunci când se întâmplă ceva în alt sistem, direcționați webhookul acelui sistem către un receptor care găsește clientul după numărul de telefon și trimite un șablon WhatsApp aprobat. Magazinul, CRM-ul sau aplicația de programări trimit deja webhookuri pentru comenzi, plăți și programări; munca înseamnă să alegeți ce evenimente merită un mesaj, să scrieți șabloanele, să securizați URL-ul și să testați cu cereri reale înainte ca vreun client să vadă ceva.

Acest ghid acoperă planul, regulile WhatsApp care îl influențează și modul în care îl construiți în MonoChat, cu un flux care pornește de la propriul URL de webhook.

Ce este un webhook și ce nu este

Un webhook este o cerere HTTP pe care un sistem o trimite către un URL indicat de dvs. atunci când are loc un eveniment. Shopify poate trimite una când se creează o comandă, WooCommerce când se actualizează o comandă, un CRM când o oportunitate trece în altă etapă, o aplicație de programări când se face o programare. Cererea conține detaliile evenimentului, de obicei în format JSON: numărul comenzii, suma, numele clientului și, cel mai important pentru WhatsApp, un număr de telefon.

Un webhook nu trimite singur nimic clientului. Ceva trebuie să primească cererea, să decidă ce face cu ea și să apeleze WhatsApp Business API. Acel „ceva” este fie cod pe care îl scrieți și îl găzduiți, fie o platformă de automatizare care vă oferă un URL de webhook și vă lasă să construiți restul fără cod.

Ce evenimente merită un mesaj pe WhatsApp

Nu orice eveniment merită un mesaj. Un client care primește cinci notificări pentru aceeași comandă începe să le ignore pe toate. Alegeți momentele pe care le așteaptă cu adevărat:

Eveniment	Mesaj	Categoria șablonului
Comandă creată sau plătită	Confirmare cu numărul comenzii și pașii următori	Utilitar
Plată eșuată sau în așteptare	O notă scurtă și o modalitate de a plăti din nou	Utilitar
Comandă expediată	Curierul și linkul de urmărire	Utilitar
Comandă cu plata ramburs creată	O întrebare: confirmați comanda, schimbați adresa sau anulați	Utilitar
Programare făcută, modificată sau pentru mâine	Data, ora, locul și o modalitate de reprogramare	Utilitar
Oportunitate câștigată sau pierdută în CRM	Predarea către managerul de cont sau o întrebare de feedback	Utilitar sau marketing, în funcție de text
Coș abandonat	Un reminder, eventual cu o ofertă	Marketing

Meta stabilește categoria după ce spune șablonul, nu după eticheta pe care o alegeți. Un mesaj despre o anumită comandă, plată sau programare este utilitar; orice promovează, oferă sau încearcă să convingă este marketing și are nevoie de un acord care să acopere marketingul. Exemplele noastre de șabloane WhatsApp au formulări pentru cazurile utilitare de mai sus.

Regulile WhatsApp care se aplică

Majoritatea mesajelor din webhook au nevoie de un șablon

Fereastra pentru serviciul clienți se deschide când un client vă scrie sau vă sună și durează 24 de ore de la ultimul său mesaj. În interiorul ei puteți răspunde liber; în afara ei puteți trimite doar mesaje-șablon aprobate în prealabil. Evenimentele din magazin și din CRM au loc rareori în această fereastră, așa că planificați fiecare mesaj din webhook ca șablon și trimiteți șabloanele la aprobare înainte să activați ceva.

Numărul de telefon trebuie să fie utilizabil

Webhookul trebuie să conțină un număr de telefon la care WhatsApp poate ajunge: în format internațional, cu prefixul țării. Multe magazine lasă clienții să își scrie numărul cum vor, așa că verificați câteva comenzi reale. Un număr fără prefixul țării este cel mai frecvent motiv pentru care testul funcționează, iar în producție nu.

Prețurile s-au schimbat la 1 octombrie 2026

Meta taxează fiecare mesaj livrat din 1 iulie 2025. Din 1 octombrie 2026, șabloanele utilitare trimise într-o fereastră deschisă pentru serviciul clienți se taxează din nou, după o perioadă în care au fost gratuite, iar fiecare număr de telefon de business primește 1.000 de mesaje de serviciu gratuite pe lună. Tarifele depind de categorie și de țara clientului. Concret: o confirmare de comandă costă bani, indiferent dacă clientul v-a scris recent sau nu, așa că trimiteți mesajele care contează și renunțați la cele care nu contează. Ghidul de prețuri WhatsApp API explică lista de tarife.

Securizați URL-ul webhookului

Oricine cunoaște URL-ul unui webhook îl poate apela. Dacă acel URL trimite mesaje pe WhatsApp, un URL scurs înseamnă că altcineva poate scrie clienților dvs. în numele dvs. sau vă poate umfla factura. Trei obiceiuri previn asta:

• Cereți un secret. Sistemul care trimite adaugă secretul într-un header sau semnează corpul cererii cu el (HMAC-SHA256), astfel încât receptorul să poată verifica faptul că cererea nu a fost modificată pe drum. Cererile fără un secret sau o semnătură validă sunt respinse.
• Folosiți câte un URL pentru fiecare scop. Un flux pentru comenzi și unul pentru programări trebuie să aibă URL-uri și secrete diferite, ca să puteți schimba unul fără să îl atingeți pe celălalt.
• Urmăriți erorile din partea sistemului care trimite. WooCommerce dezactivează un webhook după mai mult de cinci livrări eșuate consecutive, iar Shopify șterge abonamentul unui webhook a cărui destinație returnează în mod repetat un răspuns diferit de 200. Un receptor oprit sau configurat greșit vă poate opri notificările fără niciun semnal.

Unde creați webhookul în Shopify și WooCommerce

• Shopify: Settings › Notifications › Webhooks, apoi Create webhook. Alegeți un eveniment (Order creation, Order payment, Fulfillment creation și multe altele), formatul JSON și un URL https://. Evenimentul nu mai poate fi schimbat după crearea webhookului, deci faceți câte un webhook pentru fiecare eveniment. Send test verifică dacă ajunge la URL.
• WooCommerce: WooCommerce › Settings › Advanced › Webhooks, apoi Add webhook. Alegeți un subiect (evenimente pentru comenzi, clienți, cupoane sau produse), introduceți URL-ul de livrare și un secret; WooCommerce adaugă în headerele cererii un hash al payloadului generat cu acel secret.
• Un CRM sau o aplicație de programări: căutați „webhooks”, „automatizări” sau „integrări de ieșire”. Dacă oferă doar un format fix, verificați ce câmp conține telefonul clientului înainte să construiți ceva.

Testați cu cereri reale înainte de lansare

Payloadurile webhookurilor sunt lungi și fiecare platformă își denumește altfel câmpurile: numărul de telefon poate fi phone, billing.phone sau customer.default_address.phone. Nu ghiciți. Trimiteți o cerere de test reală, uitați-vă ce a sosit și mapați câmpurile pe baza ei. Apoi testați cazurile-limită:

• o comandă fără număr de telefon sau cu un număr fără prefixul țării;
• același eveniment livrat de două ori, cum fac platformele când reîncearcă;
• o comandă plasată la 3 dimineața, dacă preferați ca mesajul să aștepte până dimineață;
• un client care răspunde la notificare, ca o persoană sau un asistent AI să fie pregătit să răspundă.

Cum faceți asta în MonoChat

MonoChat este Meta Business Partner oficial. Începând cu versiunea 3.8.37 (octombrie 2026), un flux poate porni de la un webhook, astfel încât magazinul sau CRM-ul dvs. pot declanșa mesaje WhatsApp fără cod din partea dvs.

1. Porniți fluxul cu un nod Webhook primit. Adăugați-l din nodurile de eveniment. Primește propriul URL de webhook și propriul secret. Alegeți canalul, de exemplu numărul dvs. de WhatsApp, și Calea identității, adică locul din cerere unde se află numărul de telefon al clientului (implicit request.body.phone). MonoChat găsește clientul pe acel canal sau îl creează și rulează fluxul pentru el. Nodul răspunde expeditorului cu 202 după ce fluxul este pus în coadă și cu o eroare clară când canalul sau numărul de telefon nu este găsit.

2. Activați Solicită secret. Expeditorul poate pune secretul în headerul de token (implicit Authorization, singur sau ca Bearer <secret>) sau poate trimite o semnătură HMAC-SHA256 a corpului brut în headerul de semnătură (implicit X-Signature). Ambele nume de header pot fi schimbate ca să se potrivească sistemului care trimite.

3. Capturați o cerere reală. Adăugați /test la finalul URL-ului de webhook și direcționați webhookul de test al magazinului către el. Cât timp setările nodului sunt deschise, cererea apare la Cerere primită cu body, query și headere, fără să pornească fluxul. Folosiți-o ca să găsiți căile de care aveți nevoie, apoi salvați-le ca variabile de flux, de exemplu request.body.orderId ca orderId.

4. Trimiteți mesajul. Adăugați un nod Trimiteți mesaj șablon cu șablonul aprobat și completați-i variabilele din variabilele fluxului: numărul comenzii, suma, linkul de urmărire. Folosiți condiții ca să trimiteți șabloane diferite pentru stări diferite.

5. Apelați înapoi, dacă este nevoie. Un nod Cerere HTTP poate căuta mai multe date în propriul sistem sau poate scrie înapoi răspunsul clientului, de exemplu „confirmat” la o comandă ramburs. Continuă pe Ieșire când apelul reușește și pe La eșec când nu reușește, ca să puteți trimite o variantă de rezervă sau să atribuiți conversația unei persoane.

Când clientul răspunde, conversația ajunge în același inbox MonoChat ca restul chaturilor dvs. de pe WhatsApp, Instagram și Messenger, unde echipa sau un asistent AI poate prelua. Pentru construirea fluxurilor, vedeți automatizarea fluxurilor de lucru.

Alte două variante, în funcție de cine face munca:

• Dezvoltatorii dvs. apelează deja un API. Aplicația WhatsApp Template API trimite un șablon aprobat cu un singur apel API, iar răspunsurile ajung în inbox.
• Folosiți Shopify și vreți datele comenzii în chat. Automatizarea chatului pentru Shopify sincronizează produsele și comenzile, ca echipa și asistentul AI să poată răspunde la întrebări despre comenzi.

Ca să începeți, creați un cont gratuit pe app.monochat.ai, conectați numărul dvs. de WhatsApp și comparați planurile pe pagina de prețuri.

Surse

• Meta for Developers: Send messages and the customer service window
• Meta for Developers: Pricing on the WhatsApp Business Platform
• Meta for Developers: Template categorization
• Shopify Help Center: Webhooks
• Documentația WooCommerce: Webhooks
• Centrul de ajutor MonoChat: fluxuri, nodurile Webhook primit și Cerere HTTP