Cara Mengirim Pesan WhatsApp dari Google Spreadsheet menggunakan API WhatsApp

Diterbitkan: 2022-06-16

WhatsApp with Google Sheets

Tutorial ini menjelaskan bagaimana Anda dapat menggunakan API WhatsApp baru dengan Skrip Google Apps untuk mengirim pesan WhatsApp dari Google Spreadsheet. Pendekatan yang sama juga akan berfungsi untuk mengirim pesan WhatsApp dari Google Forms ketika pengiriman formulir baru diterima.

Langkah 1: Buat Aplikasi WhatsApp

Buka developers.facebook.com dan klik tombol Create App untuk membuat aplikasi baru yang akan kita gunakan untuk mengirim pesan WhatsApp.

Facebook WhatsApp App

Pilih Business sebagai jenis aplikasi.

Beri nama deskriptif pada aplikasi Anda (jangan gunakan merek dagang Facebook seperti WhatsApp atau Facebook dalam nama aplikasi) dan klik tombol Create App untuk membuat aplikasi.

WhatsApp App Name

Setelah aplikasi dibuat, klik tombol WhatsApp di layar berikutnya untuk menambahkan kemampuan pengiriman WhatsApp ke aplikasi Anda.

Pada layar berikutnya, Anda akan diminta untuk menautkan aplikasi WhatsApp Anda ke akun bisnis Facebook Anda. Anda juga akan memiliki opsi untuk membuat akun bisnis baru jika Anda belum memilikinya.

Add WhatsApp App

Langkah 2: Tambahkan nomor telepon Penerima

Facebook akan memberi Anda nomor telepon WhatsApp percobaan yang akan menjadi alamat pengiriman default aplikasi Anda. Untuk penerima, Anda akan memiliki opsi untuk menambahkan maksimal 5 nomor telepon selama tahap pengembangan tanpa harus melakukan pembayaran apa pun.

Aplikasi WhatsApp Anda akan memberi Anda token akses sementara yang akan berlaku selama 23 jam. Catat token ini karena kami akan membutuhkannya di langkah selanjutnya.

WhatsApp Phone Number

Selanjutnya, klik tarik-turun Recipient Phone Number untuk menambahkan hingga 5 nomor telepon WhatsApp yang berbeda ke aplikasi Anda. Anda akan menerima kode verifikasi pada nomor yang ditambahkan dan Anda hanya dapat mengirim pesan WhatsApp ke nomor yang telah diverifikasi dengan kode tersebut.

Verify Phone Number

Langkah 3: Buat Template Pesan WhatsApp

Beralih ke pengelola template dan buat template pesan WhatsApp baru.

Untuk contoh ini, kami akan memilih kategori sebagai Account Update dan memberikan nama unik untuk templat pesan Anda. Untuk bahasa, kami akan memilih bahasa Inggris dengan bahasa kode en . Jika Anda menggunakan bahasa lain, catat bahasa kode yang diperlukan untuk mengirim pesan.

WhatsApp Message Template

Tulis Pesan yang Dipersonalisasi

Kami menggunakan parameter variabel dalam pesan dan ini akan diganti dengan nilai aktual dari Google Sheet. Ini sangat mirip dengan penanda yang mungkin telah Anda gunakan di dalam Mail Merge dan Document Studio dengan sedikit perbedaan bahwa ini adalah penanda posisi dan bukan penanda bernama.

Berikut template pesan kami di mana variabel {{1}} dan {{2}} masing-masing adalah untuk nama pelanggan dan nama item.

WhatsApp Message Template

Mungkin perlu waktu hingga satu menit bagi WhatsApp untuk menyetujui template pesan baru Anda.

Langkah 4: Kirim Pesan WhatsApp

Sekarang setelah semua konfigurasi kita di sisi Facebook / WhatsApp selesai, mari kita bekerja di Google Sheet yang benar-benar akan mengirim pesan WhatsApp yang dipersonalisasi ini secara otomatis.

Klik di sini untuk menyalin Lembar WhatsApp di akun Google Anda sendiri.

Google sheets WhatsApp

Selanjutnya, tambahkan nomor telepon (dengan kode negara) di kolom Nomor telepon di Google Sheet. Anda hanya boleh menambahkan nomor yang telah Anda verifikasi dengan akun WhatsApp pengujian Anda di langkah sebelumnya.

Lalu buka menu Extension dan pilih Apps Script untuk membuka skrip yang mendasarinya. Ganti WHATSAPP_ACCESS_TOKEN dan WHATSAPP_TEMPLATE_NAME dengan nilai yang telah Anda salin pada langkah sebelumnya.

Klik tombol Run di dalam editor Skrip Aplikasi dan itu akan langsung mengirim pesan WhatsApp ke nomor telepon Anda yang terdaftar.

Dan apa yang Anda miliki di bawah ini adalah pesan WhatsApp aktual yang dikirim oleh API WhatsApp menggantikan penanda variabel dalam template dengan nilai aktual dari Google Spreadsheet.

WhatsApp Message Text

Detail Teknis

Bagaimana WhatsApp API bekerja dengan Google Apps Script

Skrip Google Apps terhubung ke Google Spreadsheet dan mengambil detail pelanggan, termasuk nomor telepon, yang akan dikirimi pesan melalui WhatsApp.

 // Get data from Google Sheets // for sending messages through WhatsApp const getSheetData_ = ( ) => { const sheet = SpreadsheetApp . getActiveSheet ( ) ; const [ header , ... rows ] = sheet . getDataRange ( ) . getDisplayValues ( ) ; const data = [ ] ; rows . forEach ( ( row ) => { const recipient = { } ; header . forEach ( ( title , column ) => { recipient [ title ] = row [ column ] ; } ) ; data . push ( recipient ) ; } ) ; return data ; } ;

Selanjutnya, skrip beralih melalui setiap baris lembar dan mengirim pesan WhatsApp dengan memanggil WhatsApp Cloud API dengan layanan UrlFetch.

 // Send Message with WhatsApp Cloud API const sendMessage_ = ( e ) => { const apiUrl = 'https://graph.facebook.com/v13.0/114746974570888/messages' ; const request = UrlFetchApp . fetch ( apiUrl , { muteHttpExceptions : true , method : 'POST' , headers : { Authorization : ` Bearer ${ WHATSAPP_ACCESS_TOKEN } ` , 'Content-Type' : 'application/json' , } , payload : JSON . stringify ( { type : 'template' , messaging_product : 'whatsapp' , to : e . recipient_number , template : { name : WHATSAPP_TEMPLATE_NAME , language : { code : LANGUAGE_CODE } , components : [ { type : 'body' , parameters : [ { type : 'text' , text : e . customer_name } , { type : 'text' , text : e . item_name } , { type : 'text' , text : e . delivery_date } , ] , } , ] , } , } ) , } ) ; const { error } = JSON . parse ( request ) ; if ( error ) { Logger . log ( ` ${ error } ` ) ; } else { Logger . log ( ` Message sent to ${ recipient_number } ` ) ; } } ; const main = ( ) => { getSheetData_ ( ) . forEach ( ( row ) => { const status = sendMessage_ ( { recipient_number : row [ 'Phone Number' ] . replace ( / [^\d] / g , '' ) , customer_name : row [ 'Customer Name' ] , item_name : row [ 'Item Name' ] , delivery_date : row [ 'Delivery Date' ] , } ) ; } ) ; } ;

Lihat juga: Mengotomatiskan Alur Kerja dengan Google Spreadsheet