Platform WhatsApp Business

Mengelola Akun WhatsApp Business

Setelah menyematkan alur pendaftaran di situs web Anda, langkah selanjutnya adalah mengintegrasikan dengan endpoint API yang diperlukan untuk menyelesaikan proses.

Panduan membahas tindakan yang mungkin perlu dilakukan Partner Solusi untuk mengelola Akun WhatsApp Business (WABA).

Mendapatkan ID WABA yang Dibagikan dengan Token Akses

Setelah bisnis menyelesaikan alur pendaftaran tersemat, Anda dapat mengambil ID WABA yang dibagikan menggunakan accessToken yang diberikan dengan endpoint Token Debug. Sertakan token akses Pengguna Sistem dalam header permintaan yang diawali dengan Authorization: Bearer untuk panggilan API ini.

Sintaksis Permintaan

GET https://graph.facebook.com/<API_VERSION>/debug_token
  ?input_token=<TOKEN_RETURNED_FROM_SIGNUP_FLOW>

Contoh Permintaan

curl \
'https://graph.facebook.com/v21.0/debug_token?input_token=EAAFl...' \
-H 'Authorization: Bearer EAAJi...'

Contoh Tanggapan

{
  "data" : {
    "app_id" : "670843887433847",
    "application" : "JaspersMarket",
    "data_access_expires_at" : 1672092840,
    "expires_at" : 1665090000,
    "granular_scopes" : [
      {
        "scope" : "whatsapp_business_management",
        "target_ids" : [
          "102289599326934", // ID of newest WABA to grant app whatsapp_business_management
          "101569239400667"
        ]
      },
      {
        "scope" : "whatsapp_business_messaging",
        "target_ids" : [
          "102289599326934",
          "101569239400667"
        ]
      }
    ],
    "is_valid" : true,
    "scopes" : [
       "whatsapp_business_management",
       "whatsapp_business_messaging",
       "public_profile"
    ],
    "type" : "USER",
    "user_id" : "10222270944537964"
  }
}

Setiap objek dalam array granular_scopes mengidentifikasi ID setiap WABA yang telah memberi aplikasi Anda izin (scope). ID untuk WABA yang terbaru onboarding akan muncul terlebih dahulu, jadi catat ID pertama dalam array target_ids untuk lingkup whatsapp_business_management.

Mendapatkan Daftar WABA yang Dibagikan

Endpoint client_whatsapp_business_accounts mengambil daftar semua WABA yang ditetapkan/dibagikan ke akun Pengelola Bisnis Anda setelah alur pendaftaran tersemat selesai.

Anda dapat menggunakan endpoint ini secara berkala untuk melacak WABA yang dibagikan kepada Anda. Dengan cara ini, Anda dapat melihat perbedaannya dan menemukan WABA yang baru dibagikan kepada Anda, sebagai alternatif pendekatan endpoint Token-Debug yang dijelaskan dalam panduan Pengelolaan Akun WhatsApp Business.

Daftar kolom WABA yang dapat diminta dari endpoint ini terdapat di referensi Akun WhatsApp Business.

Sintaksis Permintaan

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/client_whatsapp_business_accounts

Contoh Permintaan

curl \
'https://graph.facebook.com/v21.0/805021500648488/client_whatsapp_business_accounts/' \
-H 'Authorization: Bearer EAAJi...'

Contoh Tanggapan

{
  "data": [
    {
      "id": 1906385232743451, 
      "name": "My WhatsApp Business Account", 
      "currency": "USD", 
      "timezone_id": "1", 
      "message_template_namespace": "abcdefghijk_12lmnop" 
    },
    {
      "id": 1972385232742141, 
      "name": "My Regional Account", 
      "currency": "INR", 
      "timezone_id": "5", 
      "message_template_namespace": "12abcdefghijk_34lmnop" 
    },
  ],
  "paging": {
    "cursors": {
      "before": "abcdefghij",
      "after": "klmnopqr"
    }
  }
}

Memahami WABA bersama

Izin

Partner Solusi memiliki izin berikut di WABA bersama:

Di sisi mereka, orientasi bisnis melalui pendaftaran tersemat dapat melihat dan/atau melakukan:

KategoriApa yang dapat dilihat bisnis?

Insight

Berkirim pesan, biaya, dan perubahan status kualitas.

Kualitas

Perubahan kualitas dan penilaian.

KategoriApa yang dapat dilakukan bisnis?

Aset

Menambahkan dan mengelola nomor telepon dan template.


Bisnis tidak dapat mengunduh sertifikat untuk mendaftarkan nomor telepon, hanya Partner Solusi yang dapat melakukannya.

Pengelolaan WABA

Batal membagikan WABA dengan Partner Solusi, menghapus WABA, dan mengubah pengaturan.

Integrasi dengan produk Meta lainnya

Integrasi dengan Iklan Klik ke WhatsApp.

Partner Solusi tidak dapat menonaktifkan bisnis apa yang dapat melihat atau melakukan atau menyesuaikan tampilan mereka.

Bisnis dapat melihat Mengelola Izin Partner Solusi WhatsApp Anda untuk informasi selengkapnya.

Notifikasi

Partner Solusi menerima notifikasi yang relevan melalui Webhooks dan melalui Pengelola Bisnis. Notifikasi dikirim ketika:

  • Bisnis membagikan WABA.
  • Batasan berkirim pesan atau perubahan penilaian kualitas untuk WABA klien.
  • Ketika nama tampilan nomor telepon atau template disetujui.

Jika bisnis meninggalkan alur pendaftaran tersemat sebelum berhasil selesai, bisnis mungkin telah membagikan WABA tetapi sertifikatnya belum siap untuk diunduh. Jika ini terjadi, harap hubungi bisnis tersebut untuk membantu mereka menyelesaikan alur pendaftaran tersemat.

Mendapatkan Daftar Akun WhatsApp Business yang Dimiliki

Gunakan endpoint owned_whatsapp_business_accounts untuk mendapatkan daftar WABA yang dimiliki bisnis Anda. Untuk permintaan tersebut, gunakan token akses pengguna sistem Anda.

Sintaksis Permintaan

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/owned_whatsapp_business_accounts

Contoh Permintaan

curl \
'https://graph.facebook.com/v21.0/805021500648488/owned_whatsapp_business_accounts/' \
-H 'Authorization: Bearer EAAJi...'

Contoh Tanggapan

{
  "data": [
    {
      "id": 1906385232743451, 
      "name": "My WhatsApp Business Account", 
      "currency": "USD", 
      "timezone_id": "1", 
      "message_template_namespace": "abcdefghijk_12lmnop" 
    },
    {
      "id": 1972385232742141, 
      "name": "My Regional Account", 
      "currency": "INR", 
      "timezone_id": "5", 
      "message_template_namespace": "12abcdefghijk_34lmnop" 
    },
  ],
  "paging": {
    "cursors": {
      "before": "abcdefghij",
      "after": "klmnopqr"
    }
  }
}

Filter WABA berdasarkan Waktu Pembuatan

Anda dapat memfilter klien dan akun WhatsApp Business yang dimiliki berdasarkan waktu pembuatannya. Untuk permintaan tersebut, Anda dapat menggunakan parameter yang terdaftar di bawah ini.

Sintaksis Permintaan

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/owned_whatsapp_business_accounts
  ?filtering=<FILTERING>

Nilai filtering dapat berupa array yang berisi satu objek yang terdiri dari properti berikut:

Memfilter Properti Objek

NamaDeskripsi

field

Berisi kolom yang digunakan untuk pemfilteran. Atur ke creation_time.

operator

Berisi cara Anda ingin memfilter akun. Nilai yang didukung:


  • LESS_THAN
  • GREATER_THAN

value

Cap waktu UNIX yang akan digunakan dalam pemfilteran.

Contoh Objek

[
  {
    "field" : "creation_time",
    "operator" : "GREATER_THAN",
    "value" : "1604962813"
  }
]

Contoh Permintaan

curl \
'https://graph.facebook.com/v21.0/805021500648488/owned_whatsapp_business_accounts' \
-H 'Authorization: Bearer EAAJi...' \
-H 'Content-Type: application/json' \
-d '[{"field":"creation_time","operator":"GREATER_THAN","value":"1604962813"}]'

Contoh Tanggapan

{
  "data": [
    {
      "id": “12312321312”,
      "name": "test",
      "currency": "USD",
      "timezone_id": "1",
      "message_template_namespace": "46fe_814"
    }
  ],
  "paging": {
    "cursors": {
      "before": "QVFIUm9",
      "after": "QVFIUklX"
    },
    "next": "https://graph.facebook.com/v21.0/“
  }
}

Urutkan WABA berdasarkan Waktu Pembuatan

Anda dapat mengurutkan Akun WhatsApp Business bersama dan akun yang dimiliki berdasarkan waktu pembuatannya.

Sintaksis Permintaan

GET https://graph.facebook.com/<API_VERSION>/<BUSINESS_MANAGER_ACCOUNT_ID>/owned_whatsapp_business_accounts
  ?sort=<SORT>

Nilai sort dapat berupa creation_time_ascending atau creation_time_descending.

Contoh Permintaan

curl \
'https://graph.facebook.com/v21.0/805021500648488/owned_whatsapp_business_accounts?sort=creation_time_ascending' \
-H 'Authorization: Bearer EAAJi...'

Contoh Tanggapan

{
  "data": [
    {
      "id": 1906385232743451,
      "name": "My WhatsApp Business Account",
      "currency": "USD",
      "timezone_id": "1",
      "message_template_namespace": "abcdefghijk_12lmnop"
    },
    {
      "id": 1972385232742141,
      "name": "My Regional Account",
      "currency": "INR",
      "timezone_id": "5",
      "message_template_namespace": "12abcdefghijk_34lmnop"
    },
  ],
  "paging": {
    "cursors": {
      "before": "abcdefghij"
      "after": "klmnopqr"
    }
  }
}

Mengambil Status Tinjauan WABA

Anda dapat mengambil status tinjauan Akun WhatsApp Business dengan meminta kolom account_review_status.

Sintaksis Permintaan

GET https://graph.facebook.com/<API_VERSION>/<WABA_ID>
  ?fields=account_review_status

Contoh Permintaan

curl \
'https://graph.facebook.com/v21.0/106526625562206?fields=account_review_status' \
-H 'Authorization: Bearer EAAJi...' \

Contoh Tanggapan

{
  "account_review_status": "APPROVED",
  "id": "1111111111111"
}

Properti account_review_status dapat memiliki salah satu nilai berikut: PENDING, APPROVED, dan REJECTED.

Lihat Juga