Šaljite obavijesti o narudžbama iz WooCommercea na WhatsApp

Kako narudžba u WooCommerceu pokreće WhatsApp poruku?

Preko WooCommerce webhooka i prijemnika. U WooCommerceu otvorite Postavke, Napredno, Webhookovi i dodajte webhook s temom narudžbe, primjerice „narudžba izrađena” ili „narudžba ažurirana”, uz URL isporuke i tajnu. WooCommerce zatim šalje narudžbu kao JSON na taj URL svaki put kad se događaj dogodi.

Payload je fiksan pa se ne može usmjeriti izravno na Cloud API. Između stoji prijemnik: n8n Webhook čvor, ruta u PHP-u same trgovine ili bilo koja mala usluga. On čita narudžbu, uzima kupčev telefonski broj i podatke potrebne za poruku te šalje jedan HTTPS zahtjev na endpoint poruka Cloud API-ja za povezani broj, s pristupnim tokenom broja kao bearer tokenom.

Tema order.updated nije vezana uz jedan status, pa prijemnik treba pročitati polje status narudžbe i poslati poruku jednom za svaku promjenu koja ga zanima. WooCommerce prema zadanim postavkama isporučuje u pozadini preko wp-crona, pa poruka može stići uz kratko kašnjenje nakon narudžbe.

Kako prijemnik zna da zahtjev dolazi iz trgovine?

Iz WooCommerceova potpisa. Svaka isporuka nosi zaglavlje X-WC-Webhook-Signature, base64 kodirani HMAC-SHA256 neobrađenog payloada izračunat tajnom koju ste postavili na webhooku. Prijemnik izračuna isti hash nad tijelom koje je primio, usporedi ga i odbije sve što se ne podudara.

Ovo je tajna same trgovine, pa se, za razliku od Metina potpisa na dolaznim WhatsApp porukama, može provjeriti. Usporedbu radite u konstantnom vremenu, a hash računajte nad neobrađenim tijelom prije nego ga bilo koji okvir obradi, jer ponovno kodiran JSON daje drukčiji hash.

Odgovorite brzo statusom 2xx. WooCommerce svaki odgovor koji nije 2xx, 301 ili 302 računa kao neuspjeh, a nakon više od pet uzastopnih neuspjeha isključuje webhook. Prijemnik koji ne radi zbog postavljanja nove verzije ili je spor jer čeka Metu prije odgovora može ugasiti poruke trgovine, a da nitko ne primijeti.

Što trgovina može slati i kada?

Odobreni predložak, svaki put kad trgovina piše prva. Metin 24-satni prozor korisničke podrške otvara se tek kad kupac pošalje poruku na broj, pa su potvrda narudžbe ili obavijest o dostavi poruke koje pokreće tvrtka i slobodan tekst se odbija. Izradite predložak kategorije utility za svaku obavijest, pričekajte odobrenje i šaljite ga po nazivu i jeziku, s brojem narudžbe i ostalim podacima kao parametrima.

Meta traži i privolu (opt-in): kupac je dao svoj broj i pristao da mu se ova tvrtka javlja na WhatsAppu. Kvačica pri naplati spremljena uz narudžbu najjednostavniji je dokaz, a prijemnik je treba provjeriti prije slanja.

Kad kupac odgovori, razgovor je običan Coexistence. Odgovor se pojavljuje u aplikaciji WhatsApp Business na telefonu trgovine, prozor je otvoren za slobodan tekst, a tim odgovara iz aplikacije kao i dosad.

Uobičajene pogreške

• Poziv Cloud API-ju prije odgovora WooCommerceu. Spor ili neuspjeli pokušaj slanja računa se protiv webhooka, koji se isključuje nakon više od pet neuspjeha.
• Hashiranje obrađenog JSON-a umjesto neobrađenog tijela. Potpis se nikad ne podudara i svaka prava isporuka biva odbijena.
• Slanje pri svakoj isporuci order.updated. Tema nije vezana uz jedan status, pa bez praćenja za koju je promjenu poruka već poslana kupci dobivaju duplikate.

Često postavljana pitanja

Nastavite čitati