Kirim pesan pesanan WhatsApp dari Shopify

Bagaimana Shopify Flow mengirim pesan WhatsApp?

Dengan aksi kirim permintaan HTTP, yang mengirim ke URL mana pun dengan header dan body yang dapat memakai variabel Liquid dari trigger.

Buat workflow pada trigger pembuatan pesanan, lalu tambahkan aksi kirim permintaan HTTP. URL-nya adalah endpoint Cloud API untuk pengiriman pesan bagi ID nomor telepon dari nomor yang terhubung. Tambahkan header Authorization dengan nilai Bearer diikuti token akses nomor tersebut, yang disimpan sebagai secret Flow dan dirujuk sebagai variabel secret. Nilai secret tidak pernah ditampilkan di antarmuka Flow dan disamarkan dari log eksekusi, dan di situlah token seharusnya berada. Body-nya berupa pesan template, dengan nomor telepon pelanggan di field `to` dan detail pesanan sebagai parameter template.

Flow menganggap respons 2XX atau 3XX sebagai berhasil. Meta membalas permintaan yang valid dengan ID pesan, jadi eksekusi yang berhasil berarti Meta menerima pesan tersebut.

{
  "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 pesan pesanan harus berupa template?

Karena toko yang menulis lebih dulu. Jendela layanan pelanggan 24 jam dari Meta hanya terbuka ketika pelanggan menulis ke nomor tersebut. Konfirmasi pesanan, pembaruan pengiriman, atau pengingat checkout yang ditinggalkan dikirim sebelum itu, sehingga teks bebas ditolak dan hanya template yang sudah disetujui yang bisa lolos.

Buat template satu kali, dalam kategori utility untuk pembaruan pesanan dan pengiriman, lalu tunggu persetujuan sebelum workflow diaktifkan. Nama dan bahasa di body permintaan harus sama persis dengan template yang disetujui, dan jumlah parameter harus sesuai dengan placeholder-nya.

Ada juga soal persetujuan. Meta mewajibkan opt-in sebelum bisnis mengirim pesan kepada seseorang di WhatsApp: orang tersebut memberikan nomornya dan setuju menerima pesan dari bisnis ini. Kotak centang di checkout yang menyatakan hal itu adalah cara umum untuk mengumpulkannya, dan workflow sebaiknya memeriksanya sebelum mengirim.

Bagaimana jika plan toko tidak menyertakan aksi kirim permintaan HTTP?

Gunakan webhook admin Shopify sebagai gantinya. Di Pengaturan, Notifikasi, Webhooks, pemilik toko dapat membuat webhook untuk suatu event seperti pembuatan pesanan, dalam format JSON, ke sebuah URL. Arahkan ke penerima: node Webhook n8n, atau route di PHP, Python, atau Node. Penerima membaca pesanan, memeriksa persetujuan, lalu melakukan panggilan template yang sama ke Cloud API.

Jalur mana pun yang mengirim, balasannya sama. Ketika pelanggan menjawab pesan pesanan, balasan masuk ke aplikasi WhatsApp Business di ponsel toko, karena nomor tersebut memakai Coexistence, dan jendela 24 jam kini terbuka untuk teks bebas. Jika tujuan webhook nomor tersebut sudah diatur, balasan juga sampai ke sistem Anda. Pesan pesanan itu sendiri juga muncul di aplikasi, sehingga orang yang membalas melihat apa yang sedang dibalas pelanggan.

Kesalahan umum

• Mengirim teks bebas saat pesanan dibuat. Pelanggan belum menulis, jadi Meta menolaknya; harus berupa template yang sudah disetujui.
• Membiarkan penanganan kesalahan pada coba kembali untuk respons 4XX. Flow bisa mencoba kembali hingga 24 jam untuk permintaan yang tidak akan pernah diterima Meta.
• Menaruh token di header sebagai teks biasa. Simpan sebagai secret Flow agar tidak muncul di antarmuka dan log.

Pertanyaan yang sering diajukan

Lanjut membaca