Hantar mesej pesanan WhatsApp dari Shopify

Bagaimana Shopify Flow menghantar mesej WhatsApp?

Dengan tindakan Send HTTP request, yang menghantar permintaan POST ke mana-mana URL dengan header dan badan yang boleh menggunakan pemboleh ubah Liquid daripada pencetus.

Bina aliran kerja pada pencetus pesanan dibuat dan tambah Send HTTP request. URL ialah endpoint mesej Cloud API untuk phone number id nombor yang disambungkan. Tambah header Authorization yang nilainya Bearer diikuti token akses nombor itu, disimpan sebagai rahsia Flow dan dirujuk sebagai pemboleh ubah rahsia. Nilai rahsia tidak pernah dipaparkan dalam antara muka Flow dan disorok daripada log larian, iaitu tempat yang sesuai untuk token. Badan permintaan ialah mesej template, dengan nombor telefon pelanggan dalam medan to dan butiran pesanan sebagai parameter template.

Flow menganggap respons 2XX atau 3XX sebagai berjaya. Meta menjawab permintaan yang sah dengan id mesej, jadi larian yang berjaya bermakna Meta telah menerima mesej itu.

{
  "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}}" }]
    }]
  }
}

Mengapa mesej pesanan mesti menggunakan template?

Kerana kedai yang menulis dahulu. Tetingkap khidmat pelanggan 24 jam Meta hanya dibuka apabila pelanggan menulis kepada nombor itu. Pengesahan pesanan, kemas kini penghantaran atau peringatan troli yang ditinggalkan dihantar sebelum itu, jadi teks bebas ditolak dan hanya template yang diluluskan terlebih dahulu akan diterima.

Cipta template sekali sahaja, dalam kategori utility untuk kemas kini pesanan dan penghantaran, dan tunggu kelulusan sebelum menghidupkan aliran kerja. Nama dan bahasa dalam badan permintaan mesti sepadan tepat dengan template yang diluluskan, dan bilangan parameter mesti sepadan dengan ruang letaknya.

Ada juga persetujuan. Meta mewajibkan opt-in sebelum perniagaan menghantar mesej kepada seseorang di WhatsApp: orang itu memberikan nombornya dan bersetuju menerima mesej daripada perniagaan ini. Kotak semak semasa pembayaran yang menyatakannya ialah cara biasa untuk mengumpulnya, dan aliran kerja patut menyemaknya sebelum menghantar.

Bagaimana jika pelan kedai tidak termasuk Send HTTP request?

Gunakan webhook admin Shopify sebaliknya. Di bawah Tetapan, Pemberitahuan, Webhooks, pedagang boleh mencipta webhook untuk peristiwa seperti pesanan dibuat, dalam format JSON, ke sebuah URL. Halakan ke penerima: nod Webhook n8n, atau laluan dalam PHP, Python atau Node. Penerima membaca pesanan, menyemak persetujuan, dan membuat panggilan template yang sama ke Cloud API.

Walau laluan mana yang menghantar, balasan tetap sama. Apabila pelanggan menjawab mesej pesanan, balasan masuk ke app WhatsApp Business pada telefon kedai, kerana nombor itu menggunakan Coexistence, dan tetingkap 24 jam kini terbuka untuk teks bebas. Jika destinasi webhook nombor itu ditetapkan, balasan juga sampai ke sistem anda. Mesej pesanan itu sendiri turut muncul dalam app, supaya orang yang menjawab nampak apa yang dibalas pelanggan.

Kesilapan biasa

• Menghantar teks bebas semasa pesanan dibuat. Pelanggan belum menulis, jadi Meta menolaknya; ia mesti template yang diluluskan.
• Membiarkan pengendalian ralat pada Retry untuk respons 4XX. Flow boleh mencuba semula sehingga 24 jam bagi permintaan yang tidak akan diterima Meta.
• Meletakkan token dalam header sebagai teks biasa. Simpan sebagai rahsia Flow supaya ia tidak muncul dalam antara muka dan log.

Soalan lazim

Teruskan membaca