WhatsApp¶
WhatsApp adalah aplikasi pesan instan dan voice-over-IP yang memungkinkan user mengirim pesan, melakukan panggilan, dan berbagi konten. Bisnis dapat menggunakan WhatsApp Business untuk berkomunikasi dengan pelanggan mereka melalui teks, mengirim dokumen, dan memberikan dukungan. Dokumentasi ini mencakup integrasi WhatsApp Business Account (WABA) dengan Odoo menggunakan WhatsApp Business API.
Catatan
WhatsApp adalah aplikasi Odoo Enterprise-only yang tidak bekerja di edisi Odoo Community. Untuk menggunakan aplikasi WhatsApp Odoo, beralih dari Community ke Enterprise.
Menghubungkan WhatsApp Business Account ke database Odoo memungkinkan hal berikut di aplikasi WhatsApp Odoo:
Mengirim dan menerima pesan WhatsApp langsung dari database Odoo.
Membuat dan mengirim template yang telah disetujui dengan placeholder/variabel dinamis, seperti:
Penawaran dari aplikasi Penjualan.
Tanda terima dan faktur dari aplikasi POS.
Tiket dari aplikasi Acara.
Penting
Integrasi WhatsApp hanya kompatibel dengan WhatsApp Business Platform Account. Akun WhatsApp Pribadi dan akun WhatsApp Business App tidak kompatibel dengan integrasi WhatsApp Odoo. Lihat dokumentasi Meta untuk mempelajari lebih lanjut:
Integrasi WhatsApp mendukung dua alur: dimulai oleh perusahaan dan dimulai oleh pelanggan. Perusahaan dapat memulai diskusi dengan mengirim template kepada satu atau beberapa pelanggan. Jika pelanggan menjawab dalam waktu 15 hari, jendela chat Diskusi muncul untuk memulai percakapan.
Jika pelanggan memulai dengan mengirim pesan ke nomor WhatsApp publik perusahaan, Odoo membuka chat grup dengan semua operator yang bertanggung jawab atas kanal WhatsApp.
Tip
Pertimbangkan untuk menyiapkan akun WhatsApp terpisah untuk setiap departemen, agar dapat mengelola komunikasi dengan lebih baik.
Lihat juga
Konfigurasi WhatsApp di Meta¶
WhatsApp dioperasikan oleh Meta, perusahaan induk Facebook. Integrasi WhatsApp Odoo menggunakan koneksi API standar yang dikonfigurasi di Meta:
Buat akun bisnis Meta.
Buat akun developer Meta.
Siapkan app dan produk WhatsApp di konsol developer Meta.
Uji koneksi API.
Setelah API WhatsApp terhubung, user Odoo dapat mengirim dan menerima pesan melalui aplikasi Diskusi Odoo.
Buat akun bisnis Meta¶
Penting
Untuk membuat akun bisnis Meta, user harus memiliki akun Facebook pribadi yang telah ada minimal satu jam sebelum menyiapkan akun Facebook Business. Mencoba membuat akun bisnis sebelum waktu ini akan menghasilkan error.
Untuk membuat akun bisnis dengan Meta, buka Meta Business Suite. Klik Create account lalu masukkan nama bisnis, nama administrator, dan alamat email kerja. Klik Next, dan konfirmasi alamat email di jendela pop-up yang muncul. Setelah konfirmasi, klik Done untuk menutup jendela.
Selanjutnya, ikuti instruksi dalam email yang dikirim oleh Facebook untuk mengonfirmasi pembuatan akun bisnis dan menyelesaikan proses penyiapan.
Lihat juga
Penting
Jika akun bisnis ditautkan ke akun Facebook pribadi, administrator harus beralih antara akun pribadi mereka dan akun bisnis untuk sisa konfigurasi.
Untuk beralih ke akun bisnis, buka Meta Developer Dashboard dan klik nama akun di pojok kanan atas. Di bawah Business Accounts, pilih bisnis yang akan dikonfigurasi.
Buat app developer Meta untuk Odoo¶
Di dashboard Meta Developer Dashboard, masuk dengan akun developer Meta. Jika belum ada akun yang dikonfigurasi, tautkan akun Facebook untuk membuat akun developer Meta.
Catatan
Akun developer Facebook berbeda dengan akun bisnis Facebook. Sementara akun developer terikat pada akun Facebook pribadi, akun bisnis tidak karena mereka mewakili bisnis dan mengelola semua aset bisnis di Meta, seperti app.
Lihat juga
Setelah masuk ke akun developer Meta, klik My Apps di pojok kanan atas. Ini mengarahkan administrator ke semua app yang telah dikonfigurasi developer di akun developer tertentu. Klik Create App untuk mengonfigurasi aplikasi Meta baru.
Tambahkan detail app¶
Langkah pertama dari proses Buat aplikasi adalah mengisi bagian Detail aplikasi. Masukkan Odoo di kolom Nama aplikasi.
Catatan
Nama aplikasi dapat diubah di pengaturan setelahnya.
Peringatan
Merek dagang dan elemen bermerek tidak boleh digunakan di bagian teks ini. Ini termasuk grup perusahaan Meta. Jangan sertakan kata WhatsApp atau sistem akan menandai ini sebagai kesalahan.
Selanjutnya, masukkan alamat email pengembang di kolom Email kontak aplikasi, lalu klik Berikutnya.
Pilih jenis aplikasi¶
Langkah berikutnya dalam pembuatan aplikasi adalah bagian Kasus penggunaan. Di bawah , pilih Lainnya, pilih Lainnya, lalu klik Berikutnya. Halaman dialihkan ke Pilih jenis aplikasi.
Pilih Bisnis. Pilihan ini memungkinkan pembuatan dan pengelolaan API WhatsApp. Klik Berikutnya untuk mengonfigurasi aplikasi sesuai kebutuhan.
Pilih portofolio bisnis¶
Langkah terakhir dari proses pembuatan aplikasi adalah menghubungkan portofolio bisnis.
Di bawah Portofolio bisnis - Opsional, klik menu tarik-turun dan pilih profil akun bisnis Meta. Tinjau perjanjian Ketentuan Platform Meta dan Kebijakan Pengembang, lalu klik Buat aplikasi untuk menerima dan membuat aplikasi.
Untuk menerima perjanjian dan membuat aplikasi, masukkan kata sandi akun Facebook dan klik Kirim. Browser kemudian dialihkan ke dashboard Meta untuk Pengembang.
Peringatan
Jika akun bisnis Meta dilarang beriklan, aplikasi tidak dapat diklaim. Untuk mengatasi masalah ini, kunjungi Meta Business Suite untuk mendapatkan bantuan.
Untuk informasi lebih lanjut, lihat dokumentasi Meta tentang pembatasan iklan.
Tambahkan produk WhatsApp ke aplikasi¶
Sekarang struktur dasar aplikasi telah dibuat, produk perlu ditambahkan ke aplikasi. Navigasi ke Dashboard Pengembang Meta, dan klik aplikasi yang sedang dikonfigurasi. Halaman dialihkan ke dashboard aplikasi.
Di bawah Tambahkan produk ke aplikasi Anda, buka WhatsApp di dekat bagian bawah halaman dan klik Siapkan.
Lihat juga
Browser kemudian dialihkan ke halaman konfigurasi untuk WhatsApp Business Platform API.
Di bawah opsi Pilih Akun Bisnis Meta, pilih bisnis Meta yang akan dikonfigurasi, lalu klik Lanjutkan untuk mengonfirmasi pilihan dan menyetujui syarat dan ketentuan Meta sebagaimana tertaut di Dashboard Aplikasi Meta.
Setelah produk WhatsApp ditambahkan ke aplikasi, Meta menyediakan nomor Telepon uji WhatsApp. Nomor telepon uji ini dapat mengirim pesan tanpa batas ke maksimal lima penerima.
Di bawah Kirim dan terima pesan, pilih kolom Kepada dan pilih Kelola daftar nomor telepon. Tambahkan hingga lima nomor WhatsApp yang valid sebagai penerima, lalu masukkan kode konfirmasi yang dikirim ke nomor telepon tersebut di WhatsApp untuk memverifikasi.
Lihat juga
Panduan cepat WhatsApp API¶
Setelah akun Meta dan aplikasi telah dikonfigurasi, klik Lanjutkan untuk melanjutkan ke halaman Memulai Cepat WhatsApp. Halaman ini menyediakan titik awal untuk mengonfigurasi API WhatsApp dengan menambahkan nomor telepon dan mengirim pesan pengujian awal.
Catatan
Jika browser tidak secara otomatis mengarahkan ke halaman Quickstart WhatsApp, kunjungi Meta Developer Dashboard dan pilih aplikasi Odoo.
Pada menu di sisi kiri halaman, klik ikon (panah bawah) di sebelah judul bagian WhatsApp. Menu kecil akan terbuka, berisi opsi-opsi berikut:
Quickstart
Pengaturan API
Configuration
Klik opsi Quickstart, lalu klik Start using the API.
Pengaturan API¶
Setelah mengklik Start using the API, halaman mengarah ke Pengaturan API. Sekarang nomor tes telah dibuat, pesan tes dapat dikirim untuk mengonfirmasi bahwa WhatsApp berfungsi dengan baik. Kunjungi bagian Send and receive messages. Di bawah Step 1 Select phone numbers, klik menu drop-down di sebelah To.
Selanjutnya, pilih satu-satunya opsi yang tersedia: Kelola daftar nomor telepon. Ikuti langkah-langkah dan tambahkan hingga lima nomor telepon untuk mengirim pesan pengujian gratis. Masukkan kode negara dan nomor telepon yang sesuai, lalu klik Selanjutnya.
Penting
Menambahkan nomor telepon untuk dikirim pada langkah ini memungkinkan pengiriman pengujian yang berhasil melalui terminal. Hal ini sangat penting untuk memastikan API WhatsApp berfungsi.
Pada halaman berikutnya, masukkan kode verifikasi yang dikirim ke nomor telepon tersebut, dan klik Selanjutnya untuk memverifikasi nomor-nomor tersebut.
Kirim pesan percobaan melalui terminal¶
Setelah nomor telepon diverifikasi, kirim pesan pengujian melalui terminal. Di bawah Langkah 2 Kirim pesan dengan API, klik Kirim Pesan. Ini akan mengirim pesan pengujian ke nomor telepon yang telah ditambahkan.
Setelah berhasil menerima pesan ke nomor-nomor tersebut, lanjutkan ke bagian berikutnya untuk membuat dan mengonfigurasi webhook.
Konfigurasi WhatsApp di Odoo¶
Untuk membuat URL Callback dan Token Verifikasi Webhook, nomor telepon, token, ID aplikasi, dan ID akun perlu dikonfigurasi di Odoo; nilai-nilai ini digunakan untuk menyiapkan webhook, yang memungkinkan penerimaan pesan dalam database. Langkah-langkah konfigurasi di bagian ini semuanya dilakukan di database Odoo.
Di Odoo, navigasikan ke , lalu klik Baru untuk mengonfigurasi akun bisnis WhatsApp di Odoo.
Di tab browser lain, navigasikan ke Dashboard Pengembang Meta. Pilih , lalu salin nilai-nilai berikut dari konsol pengembang Meta ke bidang yang sesuai di Odoo:
Nama |
Meta Console |
Antarmuka Odoo |
|---|---|---|
Telepon |
Phone number ID |
Phone Number ID |
Token |
Temporary access token |
Access Token |
Id App |
App ID |
App ID |
ID Akun |
WhatsApp Business Account ID |
Account ID |
Untuk mengambil Rahasia Aplikasi, navigasikan ke Dashboard Pengembang Meta, dan pilih aplikasi Odoo. Di menu sisi kiri, di bawah Pengaturan aplikasi, pilih Dasar.
Selanjutnya, klik Tampilkan di sebelah Rahasia aplikasi, dan masukkan kata sandi akun. Salin Rahasia aplikasi lalu tempelkan ke bidang Rahasia Aplikasi pada dashboard konfigurasi Akun Bisnis WhatsApp Odoo.
Untuk menyelesaikan penyiapan akun bisnis WhatsApp di Odoo, klik Uji Koneksi. Jika konfigurasi diatur dengan benar, pesan berhasil dalam warna hijau akan muncul di pojok kanan atas dashboard.
Konfigurasikan webhook¶
Untuk mengonfigurasi webhook untuk aplikasi WhatsApp Odoo, kunjungi Meta Developer Dashboard, dan pilih aplikasi Odoo. Di menu sisi kiri, klik . Buka Step 3: Configure webhooks to receive messages dan klik Configure webhooks.
Tip
Pengaturan konfigurasi webhook juga dapat diakses dengan menavigasi ke Dashboard Pengembang Meta, memilih aplikasi Odoo, lalu memilih Webhook di menu sisi kiri.
Pada halaman , klik Edit. Di sinilah nilai URL Callback dan Token Verifikasi Webhook dari Odoo ditambahkan.
Catatan
Nilai URL Callback dan Token Verifikasi Webhook keduanya akan terisi secara otomatis setelah mengklik Uji Koneksi pada langkah sebelumnya.
Di jendela browser terpisah, ambil nilai-nilai yang diperlukan di Odoo dengan menavigasi ke lalu pilih akun yang sedang dikonfigurasi. Nilai-nilai tersebut terletak di bawah Menerima Pesan.
Salin dan tempelkan URL Callback dari Odoo ke bidang URL Callback di Meta, lalu salin dan tempelkan Token Verifikasi Webhook ke bidang Token Verifikasi pada konsol pengembang Meta. Klik Verifikasi dan simpan.
Tambahkan bidang webhook¶
Sekarang setelah database Odoo dan WhatsApp telah dikonfigurasi untuk berkomunikasi satu sama lain, langkah selanjutnya adalah menambahkan bidang webhook untuk menentukan informasi yang harus dikirim antara keduanya. Untuk menambahkan bidang webhook individual di konsol pengembang Meta, buka bagian Webhook fields dan klik Manage. Di jendela pop-up yang muncul, centang kotak di kolom Subscribe untuk nama bidang berikut:
account_update
message_template_quality_update
message_template_status_update
messages
template_category_update
Setelah melakukan pemilihan, klik Done.
Jika konfigurasi Webhooks berhasil, tombol di kolom Subscribe harus berubah dari Subscribe menjadi Unsubscribe:
Penting
Webhook fields hanya muncul setelah langganan dikonfirmasi menggunakan Callback URL dan Webhook Verify Token.
Tambahkan nomor telepon¶
Untuk mengonfigurasi nomor telepon bisnis yang akan digunakan untuk WhatsApp di Odoo, kembali ke Meta Developer Dashboard dan pilih aplikasi Odoo. Di bawah WhatsApp di menu sisi kiri, klik Pengaturan API. Buka Step 5: Add a phone number, dan klik Add phone number.
Masukkan Business name dan Business website or profile page.
Tip
Bidang Business website or profile page dapat berupa tautan ke halaman media sosial.
Pilih negara tempat perusahaan berbisnis dari menu drop-down Country; alamat bisnis bersifat opsional. Setelah menambahkan lokasi bisnis, klik Next.
Pada halaman berikutnya, isi detail WhatsApp Business profile berikut:
WhatsApp Business Profile Display Name
Timezone
Category
Business description (opsional)
Setelah bagian-bagian ini selesai, klik Next. Halaman akan dimuat ulang dan kemudian meminta administrator untuk Add a phone number for WhatsApp di bidang yang tersedia. Masukkan nomor telepon bisnis yang akan digunakan dengan WhatsApp.
Pilih Text message atau Phone call untuk metode verifikasi nomor telepon, kemudian klik Next untuk melanjutkan.
Nomor telepon bisnis akan menerima kode WhatsApp melalui metode verifikasi yang dipilih. Masukkan kode verifikasi ke dalam bidang Verification code dan klik Next untuk memverifikasi nomor telepon bisnis.
Peringatan
Metode pembayaran harus ditambahkan untuk melanjutkan. Ini adalah bagian dari sistem deteksi penipuan Meta. Untuk memastikan bahwa akun/perusahaan adalah nyata, metode pembayaran diperlukan untuk melanjutkan. Lihat dokumentasi Meta tentang cara menambahkan metode pembayaran di Meta Business Suite.
Status nomor telepon terjebak dalam status tertunda¶
Saat menambahkan nomor telepon di Aplikasi Pengembang Meta, nomor tersebut mungkin tetap terjebak dalam status Tertunda alih-alih beralih ke Terhubung.
Hal ini dapat mencegah integrasi WhatsApp berfungsi dengan benar.
Untuk mengatasi masalah ini, buat token akses sementara dan aktifkan akses akun penuh:
Buka https://developers.facebook.com dan buka aplikasi Anda.
Navigasi ke .
Klik Generate access token.
Pilih Edit previous settings.
Pilih opsi: Opt in to all current and future WhatsApp accounts.
Klik Continue, lalu Save, dan terakhir Got it.
Buat token akses sementara.
Setelah menyelesaikan langkah-langkah ini, status nomor telepon akan diperbarui dari Tertunda menjadi Terhubung.
Buat token permanen¶
Setelah konfigurasi dan pengujian selesai, buat token permanen untuk menggantikan Temporary token.
Buka Meta Business Suite kemudian masuk ke . Pilih system user yang sudah ada atau buat system user baru dengan mengklik Add.
Untuk menghasilkan token permanen, aset harus ditambahkan ke system user. Klik Add assets, dan jendela pop-up akan muncul. Pilih Apps di bawah Select asset type, kemudian pilih aplikasi Odoo dan alihkan izin ke On di bawah opsi Full control, lalu klik Save Changes. Klik Done di jendela konfirmasi yang muncul.
Klik Generate new token, dan jendela pop-up akan muncul menanyakan aplikasi mana yang harus dibuatkan token ini. Pilih aplikasi Odoo, kemudian atur tanggal kedaluwarsa ke 60 days atau Never.
Meta menanyakan izin mana yang diperbolehkan user sistem. Tambahkan kedua izin berikut:
business_managementwhatsapp_business_messagingwhatsapp_business_managementwhatsapp_business_manage_events
Ketika izin telah ditetapkan, klik Generate token. Salin nilai token yang muncul di layar berikutnya.
Dengan nilai token tersebut, perbarui kolom Access Token di akun bisnis WhatsApp di Odoo dengan menavigasi ke .
Izin token akses¶
Saat membuat token akses permanen, izin business_management mungkin tidak tersedia.
Untuk mengatasi masalah ini:
Pastikan bahwa aplikasi dibuat dengan kasus penggunaan yang sesuai (misalnya, tipe aplikasi Bisnis).
Verifikasi bahwa akun yang digunakan untuk membuat aplikasi memiliki izin yang memadai:
Hindari menggunakan akun khusus pengembang standar.
Gunakan akun dengan peran Product Manager atau lebih tinggi di akun Bisnis Meta.
Jika izin masih hilang, buat ulang aplikasi dengan konfigurasi dan izin yang benar.
Persyaratan Callback URL¶
Saat mengonfigurasi webhook, Callback URL harus berupa URL publik yang sepenuhnya memenuhi syarat.
URL harus mencakup:
https://Nama domain yang valid
Path lengkap ke endpoint webhook
Penting
Callback URL harus dapat diakses secara publik agar server Meta dapat berhasil mengirim event webhook.
Go live dengan aplikasi Meta¶
Terakhir, untuk meluncurkan aplikasi, aplikasi Meta harus diatur ke Live di Meta Developer Dashboard. Klik aplikasi yang sedang dikonfigurasi, kemudian alihkan field App Mode dari Development ke Live.
Penting
Jika status aplikasi tidak diatur ke live, maka database hanya dapat menghubungi nomor tes yang ditentukan di developer console.
Peringatan
URL kebijakan privasi harus diatur agar aplikasi dapat diatur ke live. Buka Meta Developer Dashboard dan pilih aplikasi Odoo. Kemudian, di menu sisi kiri, masuk ke . Masukkan alamat hyperlink kebijakan privasi di bawah field Privacy Policy URL pada formulir. Klik Save changes untuk menerapkan kebijakan privasi ke aplikasi.
Setelah aplikasi go live di konsol pengembang Meta, email konfirmasi dikirim ke administrator.
Template WhatsApp¶
Template WhatsApp memungkinkan user untuk menyimpan pesan yang sering dikirim. Dengan membuat template yang disesuaikan untuk situasi tertentu, user dapat mengirim pesan yang telah disetujui sebelumnya, tanpa harus mengorbankan kualitas atau menulis teks yang sama berulang kali. Ini memastikan respons yang cepat dan pesan layanan pelanggan yang konsisten, serta meningkatkan tingkat keterlibatan keseluruhan dengan pelanggan.
Template WhatsApp dapat dibuat di konsol Odoo dan Meta.
Penting
WhatsApp memiliki proses persetujuan yang harus diselesaikan sebelum template dapat digunakan. Lihat Persetujuan template Meta.
Untuk mengakses template WhatsApp, buka dashboard .
Setiap template memiliki tiga tab:
Body: menyimpan isi pesan. Isi pesan dapat berisi placeholder untuk konten dinamis yang diisi saat pesan dikirim.
Buttons: menambahkan tombol/hyperlink yang dapat diklik di bagian bawah template WhatsApp. Saat ini, ada tiga jenis tombol: Quick Reply, Visit Website, dan Call Number. Visit Website mendukung URL statis, dinamis, dan terlacak.
Variables: mencantumkan semua placeholder dalam template, serta variabel yang harus diisi. Misalnya, pesan dapat berisi placeholder untuk nama penerima, produk yang dibeli, atau nomor sales order.
Buat template WhatsApp di Odoo¶
Untuk membuat template WhatsApp, buka dashboard dan klik New. Masukkan Name untuk template, dan pilih Language.
Penting
Untuk menyelesaikan tugas berikutnya, diperlukan hak akses administrator untuk mengedit field Berlaku untuk.
Di menu drop-down Account, pilih WhatsApp business account di Odoo yang harus ditautkan ke template ini. Selanjutnya, di bawah field Applies to, pilih model yang harus diterapkan server action ke template ini.
Tip
Model ini juga dapat diakses dalam mode pengembang. Di formulir kontak (atau formulir relevan serupa di Odoo), navigasi ke model yang akan direferensikan, dan arahkan kursor ke nama field. Ini menampilkan informasi backend, termasuk nama Model Odoo spesifik di backend. Cari nama frontend model di template WhatsApp, di bawah menu drop-down Applies to.
Peringatan
Phone Field mungkin menghasilkan error saat mengubah model atau field Applies to. Phone Field harus selalu diatur ke model Phone atau Mobile.
Untuk mencari field yang tersedia, ketik nama frontend di kotak Search.... Ini menampilkan hasil dari semua field yang tersedia untuk model (Applies to) yang template-nya dibuat.
Catatan
Untuk menemukan field tertentu, beberapa level mungkin perlu dinavigasi dalam kotak hasil pencarian. Gunakan ikon (right chevron) dan (left arrow) untuk menavigasi antar level menu.
Ubah Category ke salah satu dari berikut:
Marketing: Promosi atau informasi tentang bisnis, produk, atau layanan. Atau pesan apa pun yang bukan utilitas atau autentikasi.
Utility: Pesan tentang transaksi, akun, pesanan, atau permintaan pelanggan tertentu.
Authentication: Kata sandi sekali pakai yang digunakan pelanggan untuk mengautentikasi transaksi atau login.
Penting
Menentukan kategori yang salah dapat menyebabkan status ditandai/ditolak dari Meta selama proses persetujuan.
Tambahkan Users yang diizinkan menggunakan template ini. Di kolom sebelah kanan, Header type dapat dikonfigurasi bersama dengan Header message juga.
Header types yang tersedia adalah sebagai berikut:
Teks
Gambar
Video
Dokumen
Location (variabel perlu ditetapkan)
Navigasi ke tab Body untuk mengonfigurasi pesan utama template.
Ketika semua perubahan yang diperlukan telah dibuat pada template, klik tombol Submit for approval di sudut kiri atas, dan status template akan berubah menjadi Pending.
Status tetap Pending hingga keputusan dibuat oleh Meta, di mana email konfirmasi dikirim yang menunjukkan bahwa template telah disetujui atau ditolak. Selanjutnya, sinkronkan template dari database Odoo.
Lihat juga
Tip
Template data demo yang telah dikonfigurasi sebelumnya tersedia di Odoo untuk digunakan atau dimodifikasi. Template ini dapat digunakan apa adanya atau dimodifikasi untuk memenuhi kebutuhan bisnis tertentu.
Untuk menggunakan template ini, navigasi ke dan pilih template yang telah dikonfigurasi sebelumnya. Klik Submit for Approval untuk memulai proses persetujuan. Email akan dikirim ke administrator akun Meta ketika template telah disetujui.
Placeholder dan variabel¶
Variabel dinamis merujuk kolom tertentu dalam database Odoo untuk menghasilkan data unik dalam pesan WhatsApp saat menggunakan template. Variabel dinamis dikodekan untuk menampilkan kolom dari dalam database, merujuk kolom dari dalam model.
Example
Banyak perusahaan suka menyesuaikan pesan WhatsApp mereka dengan informasi pelanggan yang dipersonalisasi untuk menarik perhatian. Ini dapat dicapai di Odoo dengan merujuk kolom dalam model dengan menetapkan variabel dinamis. Misalnya, nama pelanggan dapat dirujuk dalam email dari kolom Customer pada model Sales Order.
Variabel dinamis dapat ditambahkan ke Body dengan menambahkan placeholders dalam teks. Untuk menambahkan placeholder dalam body pesan masukkan teks berikut {{1}}. Untuk placeholder kedua masukkan {{2}} dan tingkatkan secara bertahap seiring lebih banyak placeholder ditambahkan ke teks.
Example
Berikut adalah teks dari templat isi tanda terima pembayaran:
Kepada {{1}},
Terima kasih
Lihat juga
Placeholder ini harus dikonfigurasi pada tab Variables dari template sebelum mengirimkan untuk persetujuan dari Meta. Untuk mengedit variabel dinamis pada template, pertama ubah Type menjadi Field of Model. Ini memungkinkan Odoo untuk mereferensikan field dalam model untuk menghasilkan data unik dalam pesan yang dikirim.
Selanjutnya, edit Field dari variabel dinamis. Field Applies to dalam templat harus diedit terlebih dahulu untuk memastikan model dan field yang benar direferensikan.
Untuk mencari field yang tersedia, ketik nama front-end dari field di kotak pencarian. Ini menemukan hasil dari semua field yang tersedia untuk model (Applies to) yang templatenya dibuat. Mungkin ada beberapa level yang perlu dikonfigurasi.
Example
Berikut adalah contoh variabel yang ditetapkan untuk placeholder di atas dalam tanda terima pembayaran yang disebutkan di atas:
Nama |
Sampel Value |
Tipe |
Kolom |
|---|---|---|---|
body - {{1}} |
Azure Interior |
Field dari Model |
|
body - {{2}} |
INV/2022/00001 |
Field dari Model |
|
body - {{3}} |
Perusahaan saya |
Field dari Model |
|
body - {{4}} |
$ |
Field dari Model |
|
body - {{5}} |
4000 |
Field dari Model |
|
body - {{6}} |
https://.. |
Link portal |
Example
Misalnya, di tab Body, jika yang diketik adalah "Hello {{1}},", maka {{1}} harus diatur di tab Variables. Untuk kasus khusus ini, pesan harus menyapa pelanggan dengan nama, sehingga {{1}} harus dikonfigurasi untuk mengisi Field {{1}} dengan nama Customer.
Peringatan
Kustomisasi template WhatsApp berada di luar cakupan Dukungan Odoo.
Persetujuan template Meta¶
Setelah memperbarui variabel dinamis pada template, template perlu dikirimkan ulang ke Meta untuk persetujuan. Klik Submit for Approval untuk memulai proses persetujuan. Email dikirim ke administrator akun Meta ketika template telah disetujui.
Setelah persetujuan dari Meta, sinkronkan template lagi di database Odoo. Lihat dokumentasi ini: Sinkronisasi template.
Tip
Untuk melihat status, buka Meta Business Suite dan pilih .
Sinkronisasi template¶
Template harus disinkronkan pada database Odoo setelah disetujui oleh tim Meta. Untuk melakukannya, mulai dengan menavigasi ke dan pilih konfigurasi yang harus disinkronkan. Di bawah bagian yang ditandai , di bagian bawah, klik Sync Templates. Meta memperbarui template yang disetujui sehingga dapat digunakan dengan berbagai aplikasi dalam database.
Pesan sukses berwarna hijau muncul di sudut kanan atas dengan jumlah template yang diperbarui.
Tip
Template juga dapat disinkronkan secara individual dari template itu sendiri. Navigasi ke dashboard dan pilih template untuk disinkronkan. Kemudian, klik tombol Sync Template yang terletak di menu atas formulir template.
Membuat template WhatsApp di Meta¶
Pertama, navigasi ke Meta Business Suite, kemudian buka .
Untuk membuat template WhatsApp, klik tombol biru Create template, kemudian pilih Category dari salah satu berikut:
Marketing: Promosi atau informasi tentang bisnis, produk, atau layanan. Atau pesan apa pun yang bukan utilitas atau autentikasi.
Utility: Pesan tentang transaksi, akun, pesanan, atau permintaan pelanggan tertentu.
Authentication: Kata sandi sekali pakai yang digunakan pelanggan untuk mengautentikasi transaksi atau login.
Masukkan Name template, lalu pilih Language untuk template tersebut.
Catatan
Beberapa bahasa dapat dipilih dengan mengetik nama bahasa, kemudian memilih bahasa lain sesuai kebutuhan.
Setelah membuat pilihan yang sesuai, klik Continue di sudut kanan atas. Browser mengarahkan ulang ke halaman Edit template di mana Header, Body, Footer, dan Buttons dikonfigurasi. Di sebelah kanan template terdapat pratinjau tentang tampilan template dalam produksi.
Ketika semua perubahan yang diperlukan dibuat pada template, klik tombol Submit di sudut kanan atas, dan jendela muncul untuk mengonfirmasi bahasa. Klik Confirm untuk menyetujui dan kemudian jendela lain menyatakan bahwa template telah dikirimkan ke Meta untuk ditinjau dan disetujui.
Status dari template tetap In review hingga keputusan dibuat oleh Meta. Setelah email konfirmasi yang menyetujui template diterima, template perlu disinkronkan dari dalam database Odoo.
Notifikasi¶
Notifikasi di WhatsApp ditangani mirip dengan percakapan pesan di Odoo. Jendela pop-up muncul dengan percakapan yang diterima dari pelanggan. Secara default, notifikasi diatur dalam konfigurasi akun bisnis WhatsApp di Odoo.
Pengaturan notifikasi dapat disesuaikan dengan menavigasi ke . Dari sana, pilih akun dan gulir ke bawah ke bagian di mana notifikasi ditangani. Di bawah heading Notify users, ketik di field user mana yang harus diberi notifikasi untuk channel WhatsApp tertentu ini.
Catatan
Setelah percakapan dimulai antara user dan pelanggan, notifikasi ke semua user yang ditentukan dalam konfigurasi akun bisnis WhatsApp tidak akan terjadi. Hanya notifikasi ke user dalam percakapan yang terjadi. Jika user tidak merespons dalam 15 hari, balasan pelanggan setelah 15 hari akan muncul lagi ke semua user yang ditentukan dalam konfigurasi WhatsApp.
Menambahkan user ke chat¶
User dapat ditambahkan ke chat WhatsApp dengan memperluas jendela pop-up WhatsApp. Percakapan WhatsApp terletak di aplikasi Diskusi. Pilih percakapan, kemudian klik ikon (Add User) di kanan atas, dan jendela muncul untuk mengundang user ke percakapan.
FAQ API WhatsApp¶
Verifikasi¶
Sejak 1 Februari 2023, jika aplikasi Meta memerlukan akses tingkat lanjut ke izin, verifikasi bisnis lengkap mungkin perlu diselesaikan. Ini termasuk mengirimkan dokumen bisnis kantor ke Meta. Lihat dokumentasi ini.
Tidak dapat menerima pesan¶
Jika akun bisnis tidak dapat menerima pesan, periksa semua konfigurasi webhook. Navigasi ke , atau klik di sini. Login ke akun bisnis jika diperlukan. Di bawah bagian Request Syntax, klik Try it dan isi field berikut:
authorization: masukkan permanent access token.
WABA-ID: masukkan WhatsApp Business Account ID (WABA ID).
override_callback_uri: masukkan callback URL.
verify_token: masukkan verification code.
Untuk mengambil WABA ID, navigasi ke di menu sisi kiri Meta Developer Dashboard. WABA ID terletak di bagian Send and receive messages, di bawah Step 1: Select phone numbers. Setelah semua field diisi, klik Send request.
Error template¶
Mengedit templat dapat menyebabkan traceback dan kesalahan kecuali proses yang tepat diikuti.
Error validasi duplikat¶
Saat menyinkronkan template, mungkin ada kejadian di mana ada beberapa template dengan nama yang sama di business manager Meta dan di Odoo. Ini menyebabkan error validasi duplikat. Odoo menampilkan Validation Error: The operation cannot be completed: Duplicate template is not allowed for one Meta account. Untuk memperbaiki masalah ini, ubah nama template duplikat di Odoo dan sinkronkan template sekali lagi.
Error token¶
Kesalahan user 190¶
Jika token sementara tidak diganti dengan token permanen, Odoo menampilkan User Error 190: Error validating access token: Session has expired. Untuk memperbaiki masalah ini, tambahkan token permanen.
Kesalahan user 100¶
Jika seorang Karyawan mencoba mengatur token permanen, Odoo menampilkan User Error 100: Unsupported get request.
Untuk memperbaiki kesalahan ini, buat user sistem Admin.
Lainnya¶
Template tidak dapat dikirim ke beberapa kontak¶
Pastikan fitur Multi-Template diaktifkan pada templat.
Pesan gagal terkirim¶
Aktifkan kolom Failure Type dan Failure Reason di bawah WhatsApp ---> Messages.
Kode kesalahan lainnya¶
Untuk error lainnya, lihat Developer Suite Meta untuk WhatsApp Error Codes.