Mengirim Pesan Teks

Anda dapat menggunakan node messages untuk mengirimkan pesan teks kepada pelanggan Anda.

Sebelum Memulai

Anda harus memenuhi semua prasyarat yang terdaftar dalam bagian Sebelum Memulai dari dokumentasi Pesan.

Batasan:

  • Pesan teks dapat sepanjang maksimal 4.096 karakter.

Langkah 1: Buat Permintaan POST ke /messages

Setelah Anda memiliki ID WhatsApp untuk pengguna yang ingin Anda kirimi pesan, gunakanlah untuk mengirimkan pesan teks. Tentukan text di kolom type.

POST /v1/messages
{
    "preview_url": false | true,
    "recipient_type": "individual",
    "to": "whatsapp-id",
    "type": "text",
    "text": {
        "body": "your-text-message-content"
    }
}

Untuk informasi selengkapnya tentang parameter, lihat:

Jika Anda ingin memformat pesan Anda, lihat Pemformatan dalam Pesan Teks.

Mengirim URL dalam Pesan Teks

Secara default, aplikasi WhatsApp seluler dapat mengenali URL dan membuatnya dapat diklik. Untuk menyertakan cuplikan URL, sertakan "preview_url": true di dalam badan pesan dan pastikan URL dimulai dengan http:// atau https://. Nama host juga diperlukan, alamat IP tidak cocok.

Perhatikan bahwa penggunaan preview_url di sini berbeda dari Cloud API. Lihat dokumentasi Pesan Cloud API.

Contoh

{
    "preview_url": true,
    "to": "whatsapp-id",
    "text": {
        "body": "You have to check out this amazing messaging service https://www.whatsapp.com/"
     }

Biasanya saat Anda mengirim URL, baik dengan cuplikan maupun tidak, penerima pesan akan melihat URL yang dapat dia klik.

Cuplikan URL hanya akan di-render setelah salah satu hal berikut terjadi:

  1. Bisnis tersebut telah mengirimkan template pesan kepada pengguna.
  2. Pengguna memulai percakapan dengan tautan "klik untuk mengobrol".
  3. Pengguna menambahkan nomor telepon bisnis ke buku alamat mereka dan memulai percakapan.

Langkah 2: Periksa Tanggapan Anda

Tanggapan yang berhasil mengandung objek messages dengan pengidentifikasi untuk pesan yang baru dibuat.

{
  "messages": [{
    "id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
  }]
}  

Tanggapan yang gagal akan berisi pesan kesalahan. Lihat Kode Kesalahan dan Status untuk informasi selengkapnya.