Magpadala ng mga update sa order ng WooCommerce sa WhatsApp

Paano nagti-trigger ng mensahe sa WhatsApp ang isang order sa WooCommerce?

Sa pamamagitan ng WooCommerce webhook at isang receiver. Sa WooCommerce, pumunta po sa Settings, Advanced, Webhooks, at magdagdag ng webhook na may order topic, gaya ng order created o order updated, isang delivery URL, at isang secret. Pagkatapos nito, ipo-post ng WooCommerce ang order bilang JSON sa URL na iyon tuwing nangyayari ang event.

Nakapirmi ang payload, kaya hindi ito direktang maitutok sa Cloud API. May receiver sa pagitan: isang n8n Webhook node, isang route sa sariling PHP ng tindahan, o anumang maliit na service. Binabasa nito ang order, kinukuha ang numero ng telepono ng customer at ang mga detalyeng kailangan ng mensahe, at gumagawa ng isang HTTPS request sa messages endpoint ng Cloud API para sa naka-connect na numero, gamit ang access token ng numero bilang bearer token.

Hindi nakatali sa iisang status ang order.updated topic, kaya dapat basahin ng receiver ang status field ng order at magpadala nang minsan sa bawat transition na mahalaga rito. Sa default, naghahatid ang WooCommerce sa background sa pamamagitan ng wp-cron, kaya maaaring may maikling pagkaantala bago dumating ang mensahe pagkatapos ng order.

Paano nalalaman ng receiver na galing sa tindahan ang request?

Mula sa signature ng WooCommerce. Bawat delivery ay may X-WC-Webhook-Signature header, isang base64 encoded na HMAC-SHA256 ng raw payload na kinompyut gamit ang secret na itinakda ninyo sa webhook. Kinokompyut ng receiver ang parehong hash sa body na natanggap nito at ikinukumpara, at tinatanggihan ang anumang hindi tumutugma.

Sariling secret ito ng tindahan, kaya hindi gaya ng signature ng Meta sa mga papasok na mensahe sa WhatsApp, maaari itong i-validate. Ihambing sa constant time, at i-hash ang raw body bago ito i-parse ng anumang framework, dahil magbubunga ng ibang hash ang JSON na na-re-encode.

Sumagot agad ng 2xx. Itinuturing ng WooCommerce na pagkabigo ang anumang sagot na hindi 2xx, 301 o 302, at kapag lumampas sa lima ang magkakasunod na pagkabigo, dini-disable nito ang webhook. Ang receiver na down dahil sa deploy, o mabagal dahil naghihintay muna sa Meta bago sumagot, ay maaaring makapag-patay sa mga mensahe ng tindahan nang walang nakakapansin.

Ano ang maipapadala ng tindahan, at kailan?

Isang aprubadong template, tuwing ang tindahan ang unang sumusulat. Nagbubukas lamang ang 24 oras na customer service window ng Meta kapag nag-message ang customer sa numero, kaya ang order confirmation o shipping update ay pinasimulan ng negosyo at tinatanggihan ang free-form text. Gumawa ng utility template para sa bawat update, hintayin ang approval, at ipadala ito ayon sa pangalan at wika, kasama ang numero ng order at iba pang detalye bilang mga parameter.

Hinihingi rin ng Meta ang opt-in: ibinigay ng customer ang kanyang numero at pumayag siyang makatanggap ng mensahe mula sa negosyong ito sa WhatsApp. Ang checkbox sa checkout na nakatala sa order ang pinakasimpleng patunay nito, at dapat itong i-check ng receiver bago magpadala.

Kapag sumagot na ang customer, karaniwang Coexistence na ang usapan. Lumalabas ang sagot sa WhatsApp Business app sa telepono ng tindahan, bukas na ang window para sa free-form text, at sumasagot ang team mula sa app gaya ng dati.

Mga karaniwang pagkakamali

• Ginagawa ang Cloud API call bago sumagot sa WooCommerce. Ang mabagal o pumalyang pagpapadala ay binibilang laban sa webhook, na dini-disable kapag lumampas sa lima ang pagkabigo.
• Pag-hash ng na-parse na JSON sa halip na ng raw body. Hindi kailanman tutugma ang signature at tatanggihan ang bawat tunay na delivery.
• Pagpapadala sa bawat order.updated delivery. Hindi nakatali sa iisang status ang topic, kaya kung hindi sinusubaybayan kung aling transition ang naipadalhan na ng mensahe, makakatanggap ng duplicate ang mga customer.

Mga madalas itanong

Magpatuloy sa pagbabasa