Memulai untuk Partner Solusi

Panduan ini membahas langkah-langkah yang perlu diambil oleh Partner Solusi untuk menawarkan Cloud API kepada pelanggan mereka. Ada 4 tahapan utama:

1. Mempersiapkan & Merencanakan
2. Menyiapkan Aset
3. Menandatangani Kontrak
4. Integrasi Build

Setelah selesai, ikuti terus pembaruan bulanan.

Mempersiapkan & Merencanakan

Baca Dokumentasi

Sebelum Anda mulai, kami rekomendasikan untuk membaca dokumentasi developer dan koleksi Postman kami. Ini membantu Anda memahami cara kerja Cloud API, termasuk cara memulai dan memigrasi angka.

Merencanakan Onboarding & Migrasi

Anda harus menggunakan Pendaftaran Tersemat untuk memasukkan pelanggan baru ke Cloud API. Jika belum, integrasikan dan luncurkan Pendaftaran Tersemat. Pendaftaran Tersemat adalah cara tercepat dan termudah untuk mendaftarkan pelanggan, memungkinkan mereka untuk mulai mengirim pesan dalam waktu kurang dari lima menit.

Berikutnya, pikirkan klien mana yang ingin Anda migrasikan ke Cloud API terlebih dahulu. Rekomendasi umum kami adalah memigrasikan semua klien Anda dari On-Premises API ke Cloud API, tetapi kebutuhan setiap klien mungkin berbeda. Saat Anda memikirkan klien mana yang akan dimigrasikan, pertimbangkan:

Setelah mengetahui siapa yang akan dimigrasikan, Anda dapat membuat rencana dan garis waktu migrasi.

Saat membuat rencana, ingatlah untuk mendesain sistem Anda untuk dua skenario: orientasi pelanggan baru dan migrasi pelanggan saat ini dari On-Premises API ke Cloud API. Untuk skenario migrasi, sertakan rencana untuk mencakup instance di On-Premises API Anda saat ini dan memindahkan angka-angka tersebut ke Cloud API.

Merencanakan Komunikasi dengan Klien

Pertama, Anda perlu memutuskan apakah akan memberi tahu klien yang ada tentang migrasi. Kemudian, Anda harus menentukan apakah Anda perlu membuat atau memperbarui dokumentasi apa saja untuk mendukung pengaturan Cloud API.

Membuat Keputusan tentang Harga

Karena biaya hosting untuk Cloud API ditanggung oleh Meta, Anda harus memutuskan apakah Anda ingin memperbarui harga untuk menyesuaikan.

Menyiapkan Aset

Untuk menggunakan Cloud API, Partner Solusi perlu memiliki aset berikut:

Menandatangani Kontrak

Menerima Ketentuan Layanan

Untuk mengakses Cloud API Messaging WhatsApp Business, Anda harus terlebih dahulu menerima Ketentuan Layanan Platform WhatsApp Business atas nama bisnis Anda.

Untuk melakukannya, buka Pengelola WhatsApp dan setujui persyaratan layanan di banner informasi.

Jika Anda adalah mitra beta yang sudah ada untuk Cloud API, Anda memiliki masa tenggang 90 hari. Ini berarti Anda harus menyetujui persyaratan sebelum 5 Juli 2022; jika tidak, Anda akan kehilangan akses.

Untuk bisnis Cloud API baru, termasuk bisnis yang bermigrasi dari API di Tempat, Anda harus menyetujui persyaratan layanan sebelum dapat mulai menggunakan Cloud API. Panggilan pendaftaran akan gagal sampai Anda menyetujui persyaratan layanan.

Integrasi Build

Langkah 1: Dapatkan Token Akses Pengguna Sistem

Panggilan Graph API menggunakan token akses untuk autentikasi. Untuk informasi selengkapnya, lihat Token Akses. Kami merekomendasikan penggunaan pengguna sistem Anda untuk membuat token.

Untuk membuat token akses pengguna sistem:

1. Buka Pengelola Bisnis > Pengaturan Bisnis > Pengguna > Pengguna Sistem untuk melihat pengguna sistem yang Anda buat.
2. Klik pengguna itu dan pilih Tambahkan Aset. Tindakan ini akan meluncurkan jendela baru.
3. Di bawah Pilih Jenis Aset di panel sisi kiri, pilih Aplikasi. Di bawah Pilih Aset, pilih aplikasi Meta yang ingin Anda gunakan (aplikasi Anda harus memiliki izin yang benar). Aktifkan Kembangkan Aplikasi untuk aplikasi itu.
4. Pilih Simpan Perubahan untuk menyimpan pengaturan Anda dan kembali ke layar utama pengguna sistem.
5. Sekarang Anda siap untuk membuat token. Di layar utama pengguna sistem, klik Buat Token dan pilih aplikasi Meta Anda. Setelah memilih aplikasi, Anda melihat daftar izin yang tersedia. Pilih whatsapp_business_management dan whatsapp_business_messaging. Klik Buat Token.
6. Jendela baru dibuka dengan pengguna sistem Anda, aplikasi yang ditetapkan, dan token akses. Simpan token Anda.
7. Secara opsional, Anda dapat mengeklik token Anda dan melihat Debugger Token. Di debugger, Anda akan melihat dua izin yang telah Anda pilih. Anda juga bisa langsung menempelkan token ke Debugger Token Akses.

Langkah 2: Siapkan Webhooks

Dengan pengaturan Webhooks, Anda dapat menerima notifikasi HTTP realtime dari Platform WhatsApp Business. Artinya, Anda akan diberi tahu saat ada pesan dari pelanggan atau ada perubahan pada Akun WhatsApp Business (WABA) Anda.

Untuk menyiapkan Webhooks, Anda harus membuat server web yang menghadap internet dengan URL yang memenuhi persyaratan Meta dan WhatsApp. Lihat Membuat Endpoint untuk instruksi cara melakukannya. Jika Anda membutuhkan endpoint untuk tujuan pengujian, Anda dapat membuat endpoint Webhooks tes.

Pengaturan Aplikasi

Setelah endpoint siap, konfigurasikan itu agar digunakan aplikasi Meta Anda:

Anda hanya perlu menyiapkan Webhooks sekali per aplikasi yang Anda miliki. Anda bisa menggunakan Webhooks yang sama untuk menerima beberapa jenis peristiwa dari beberapa Akun WhatsApp Business. Untuk informasi selengkapnya, lihat bagian Webhooks kami.

Langkah 3: Berlangganan ke WABA Anda

Guna memastikan Anda mendapat notifikasi untuk akun yang benar, berlanggananlah ke aplikasi Anda:

curl -X POST \
'https://graph.facebook.com/v19.0/WHATSAPP_BUSINESS_ACCOUNT_ID/subscribed_apps' \
-H 'Authorization: Bearer ACCESS_TOKEN'

Jika Anda mendapatkan tanggapan di bawah, semua aktivitas Webhooks untuk nomor telepon di bawah akun ini akan dikirim ke endpoint Webhooks yang Anda konfigurasikan.

{
  "success": true
}

Langkah 4: Dapatkan ID Nomor Telepon

Untuk mengirim pesan, Anda harus mendaftarkan nomor telepon yang ingin Anda gunakan — ini adalah nomor telepon bisnis yang kami sebutkan di Sebelum Memulai.

Sebelum Anda dapat melanjutkan ke pendaftaran, Anda harus menemukan ID nomor telepon tersebut. Untuk mendapatkan ID nomor telepon Anda, buat panggilan API berikut:

curl -X GET \
'https://graph.facebook.com/v19.0/WHATSAPP_BUSINESS_ACCOUNT_ID/phone_numbers' \
-H 'Authorization: Bearer ACCESS_TOKEN'

Jika permintaan berhasil, tanggapannya mencakup semua nomor telepon yang terhubung ke WABA Anda:

{
  "data": [
    {
      "verified_name": "Jasper's Market",
      "display_phone_number": "+1 631-555-5555",
      "id": "1906385232743451",
      "quality_rating": "GREEN"
    },
    {
      "verified_name": "Jasper's Ice Cream",
      "display_phone_number": "+1 631-555-5556",
      "id": "1913623884432103",
      "quality_rating": "NA"
    }
  ]
}

Simpan ID untuk nomor telepon yang ingin Anda daftarkan. Lihat Membaca Nomor Telepon untuk informasi selengkapnya tentang endpoint ini.

Pengecualian Migrasi

Langkah 5: Daftarkan Nomor Telepon

Dengan ID nomor telepon di tangan, Anda dapat mendaftarkan nomor tersebut. Dalam panggilan pendaftaran API, Anda melakukan dua tindakan bersamaan:

1. Daftarkan telepon.
2. Aktifkan verifikasi dua langkah dengan menetapkan kode pendaftaran 6 digit — kode ini harus diatur di pihak Anda. Simpan dan hafalkan kode ini karena bisa diminta nanti.

Menyiapkan autentikasi dua faktor adalah persyaratan untuk menggunakan Cloud API. Jika Anda tidak menyiapkannya, Anda akan mendapatkan pesan kegagalan onboarding:

Contoh permintaan:

curl -X POST \
'https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER_ID/register' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"messaging_product": "whatsapp","pin": "6_DIGIT_PIN"}'

Contoh tanggapan:

{
  "success": true
}

Pengguna Pendaftaran Tersemat

Langkah 6: Terima Pesan dari Aplikasi Konsumen

Setelah pelanggan yang berpartisipasi mengirimkan pesan ke bisnis Anda, Anda mendapatkan pesan gratis selama 24 jam dengan pelanggan itu —periode waktu itu disebut periode layanan pelanggan. Untuk tujuan pengujian, kami ingin mengaktifkan periode ini, sehingga Anda dapat mengirimkan pesan sebanyak yang Anda inginkan.

Dari aplikasi WhatsApp pribadi iOS/Android, kirim pesan ke nomor telepon yang baru saja Anda daftarkan. Setelah pesan terkirim, Anda seharusnya menerima pesan masuk ke Webhooks Anda dengan notifikasi dalam format berikut.

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "16315551234",
              "phone_number_id": "PHONE_NUMBER_ID"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Kerry Fisher"
                },
                "wa_id": "16315555555"
              }
            ],
            "messages": [
              {
                "from": "16315555555",
                "id": "wamid.ABGGFlA5FpafAgo6tHcNmNjXmuSf",
                "timestamp": "1602139392",
                "text": {
                  "body": "Hello!"
                },
                "type": "text"
                }
            ]
          },
        "field": "messages"
        }
      ]
    }
  ]
}

Langkah 7: Kirimkan Pesan Tes

Setelah Anda mengaktifkan periode layanan pelanggan, Anda dapat mengirim pesan tes ke nomor konsumen yang Anda gunakan di langkah sebelumnya. Untuk melakukannya, lakukan panggilan API berikut:

curl -X  POST \
'https://graph.facebook.com/v19.0/FROM_PHONE_NUMBER_ID/messages' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"messaging_product": "whatsapp", "to": "16315555555","text": {"body" : "hello world!"}}'

Jika panggilan Anda berhasil, tanggapan Anda akan menyertakan ID pesan. Gunakan ID tersebut untuk melacak kemajuan pesan Anda melalui Webhooks. Panjang maksimum ID adalah 128 karakter.

Contoh tanggapan:

{
  "id":"wamid.gBGGFlaCGg0xcvAdgmZ9plHrf2Mh-o"
}

Ikuti Pembaruan Bulanan

Kami akan merilis pembaruan Cloud API pada hari Selasa pertama setiap bulan. Pembaruan akan mencakup fitur dan peningkatan baru. Anda tidak perlu melakukan apa pun untuk menggunakan fitur baru, karena Cloud API diperbarui secara otomatis.

Pertanyaan Umum

Pertanyaan Umum Luas

Pertanyaan Umum Penerapan Teknis

What is the architecture of the Cloud API?

The Cloud API architecture significantly simplifies the Solution Partner's operational and infrastructure requirements to integrate with WhatsApp Business Platform. First, it removes the infrastructure requirements to run Business API docker containers (CAPEX savings). Second, it obviates the need of operational responsibilities to manage the deployment (OPEX savings). For details, refer to the architecture diagram comparing the On-Premises and Cloud API deployments.

Tautan Permanen

Pertanyaan Umum Privasi & Keamanan Data

Pertanyaan Umum Kepatuhan Regulasi