All Products
Search
Document Center

Chat App Message Service:ChatAppAudit

Last Updated:Dec 25, 2025

Tentukan URL HTTP untuk menerima notifikasi tinjauan templat pesan.

Spesifikasi protokol

Item

Deskripsi

Protocol

HTTP + JSON

Encoding method

UTF-8

Prasyarat

Request

Beberapa laporan tinjauan dapat didorong sekaligus.

Contoh request

[
 {    
 "WabaId": "9099999990****",        
 "TemplateCode": "744c4b5c79c9432497a075bdfca3****",    
 "Language": "en_US",    
 "AuditStatus": "unaudit",    
 "Reason": ""
 },
 {    
 "WabaId": "9099999990****",        
 "TemplateCode": "744c4b5c79c9432497a075bdfca*****",    
 "Language": "en_US",    
 "AuditStatus": "unaudit",    
 "Reason": ""
 }
]

Parameter request

V1

Parameter

Type

Required

Deskripsi

WabaId

String

Yes

WhatsApp Business Account (WABA) ID.

Catatan

Setelah Anda membuat WABA, peroleh WABA ID di platform Business Manager.

TemplateCode

String

Yes

Kode templat.

Catatan

Peroleh kode templat di halaman Template Design pada konsol Chat App Message Service atau dengan memanggil operasi ListChatappTemplate.

Language

String

Yes

Bahasa templat.

AuditStatus

String

Yes

Status tinjauan templat pesan. Nilai yang valid:

  • pass: Templat pesan disetujui.

  • fail: Templat pesan ditolak.

  • auditing: Templat pesan sedang dalam proses peninjauan.

  • unaudit: Templat pesan akan ditinjau.

  • disabled

  • paused

Reason

String

No

Alasan kegagalan peninjauan.

Catatan

Nilai dikembalikan ketika nilai kembali dari AuditStatus adalah fail.

V2

Catatan

V2 digunakan ketika independent software vendor (ISV) perlu mengelola WhatsApp Business accounts (WABAs) dan nomor telepon pelanggannya.

Parameter

Type

Required

Deskripsi

WabaId

String

Yes

WABA ID.

Catatan

Setelah Anda membuat WABA, peroleh WABA ID di platform Business Manager.

TemplateCode

String

Yes

Kode templat.

Catatan

Peroleh kode templat di halaman Template Design pada konsol Chat App Message Service atau dengan memanggil operasi ListChatappTemplate.

Language

String

Yes

Bahasa templat.

AuditStatus

String

Yes

Status tinjauan templat pesan. Nilai yang valid:

  • pass: Templat pesan disetujui.

  • fail: Templat pesan ditolak.

  • auditing: Templat pesan sedang dalam proses peninjauan.

  • unaudit: Templat pesan akan ditinjau.

  • disabled

  • paused

Reason

String

No

Alasan penolakan tinjauan.

Catatan

Nilai dikembalikan ketika nilai kembali dari AuditStatus adalah fail.

Type

String

Yes

Jenis notifikasi. Nilai yang valid:

  • template: Status templat pesan berubah.

  • phoneNameUpdate: Status nama nomor telepon berubah.

  • phoneQualityUpdate: Peringkat kualitas nomor telepon berubah.

    • GREEN: Kualitas tinggi

    • YELLOW: Kualitas sedang

    • RED: Kualitas rendah

    • UNKNOWN: Tidak diketahui

  • wabaReviewUpdate: Status tinjauan WABA berubah.

  • wabaAccountUpdate: WABA berubah.

  • templateCategoryUpdate: Jenis templat pesan berubah.

  • templateQualityUpdate: Peringkat kualitas templat pesan berubah.

Catatan

Jika nilai kembali Type adalah template, parameter dalam laporan tinjauan V2 sama dengan parameter dalam laporan tinjauan V1.

PhoneNumber

String

No

Nomor telepon.

Catatan
  • Jika nilai kembali Type adalah phoneNameUpdate, phoneQualityUpdate, atau wabaAccountUpdate, nilai PhoneNumber dikembalikan.

  • Jika nilai kembali Type adalah wabaReviewUpdate atau template, tidak ada nilai yang dikembalikan untuk PhoneNumber.

Status

String

No

Status.

Catatan
  • Nilai yang valid ketika nilai kembali Type adalah phoneNameUpdate:

    • APPROVED: Nama nomor telepon disetujui.

    • REJECTED: Nama nomor telepon ditolak.

    • DEFERRED: Peninjauan nama nomor telepon ditunda.

  • Nilai yang valid ketika nilai kembali Type adalah phoneQualityUpdate. Nilai-nilai ini menunjukkan alasan perubahan peringkat kualitas nomor telepon.

    • ONBOARDING: Nomor telepon sedang digunakan untuk pendaftaran.

    • UPGRADE: Jumlah pesan yang dapat dikirim oleh nomor telepon ditingkatkan.

    • DOWNGRADE: Jumlah pesan yang dapat dikirim oleh nomor telepon diturunkan.

    • FLAGGED: Tag ditambahkan ke nomor telepon.

    • UNFLAGGED: Tag dihapus dari nomor telepon.

  • Nilai yang valid ketika nilai kembali Type adalah wabaAccountUpdate:

    • DISABLED_UPDATE:

      • SCHEDULE_FOR_DISABLE: WABA diblokir.

      • DISABLE: WABA dinonaktifkan.

      • REINSTATE: Pemblokiran WABA dicabut.

    • VERIFIED_ACCOUNT: WABA diverifikasi.

    • ACCOUNT_RESTRICTION: Jika WABA melanggar kebijakan WhatsApp Business Platform, WABA dibatasi. Nilai yang valid:

      • RESTRICTED_BIZ_INITIATED_MESSAGING: WABA tidak diizinkan mengirim pesan yang diinisiasi bisnis.

      • RESTRICTION_ON_ADD_PHONE_NUMBER_ACTION: WABA tidak diizinkan menambahkan nomor telepon baru.

      • RESTRICTED_CUSTOMER_INITIATED_MESSAGING: WABA tidak diizinkan mengirim pesan yang diinisiasi pelanggan.

    • ACCOUNT_VIOLATION: WABA telah melanggar kebijakan.

    • PHONE_NUMBER_ADDED: Nomor telepon ditambahkan ke WABA.

    • PHONE_NUMBER_REMOVED: Nomor telepon dihapus dari WABA.

    • BUSINESS_VERIFICATION_STATUS_UPDATE: Status verifikasi perusahaan di platform Business Manager Meta diperbarui.

      • BUSINESS_VERIFIED: Perusahaan disetujui.

      • BUSINESS_REJECTED: Perusahaan ditolak.

      • MORE_INFORMATION_REQUESTED: Perusahaan perlu memberikan informasi tambahan.

      • BUSINESS_REVOKED: Perusahaan mencabut permohonan tinjauan.

    • ACCOUNT_DELETED: WABA dihapus.

  • Nilai yang valid ketika nilai kembali Type adalah wabaReviewUpdate:

    • APPROVED: WABA disetujui.

    • REJECTED: WABA ditolak.

  • Tidak ada nilai yang dikembalikan untuk parameter ini ketika nilai kembali Type adalah template.

CurrentLimit

String

No

Jumlah maksimum pesan yang dapat dikirim oleh nomor telepon dalam sehari.

Catatan
  • Nilai yang valid ketika nilai kembali Type adalah phoneQualityUpdate:

    • TIER_50

    • TIER_250

    • TIER_1K

    • TIER_10K

    • TIER_100K

    • TIER_UNLIMITED

    • TIER_UN_SET

  • Tidak ada nilai yang dikembalikan untuk parameter ini ketika nilai kembali Type adalah template, phoneNameUpdate, wabaReviewUpdate, wabaAccountUpdate, templateCategoryUpdate, atau templateQualityUpdate.

Response

Untuk mengonfirmasi penerimaan callback, titik akhir Anda harus mengembalikan kode status HTTP 200 dalam waktu 3 detik. Badan respons harus berupa objek JSON dalam format berikut. Jika tidak, sistem akan menganggap bahwa laporan tinjauan gagal didorong dan akan mencoba mendorongnya kembali.

Contoh response

{
  "code" : 0,
  "msg" : "Successful"
}

Parameter response

Parameter

Type

Required

Deskripsi

code

Number

Yes

Kode respons.

msg

String

No

Deskripsi kode respons.

Retries

Jika upaya dorong awal gagal, layanan akan mencoba kembali setelah 1 menit dan sekali lagi setelah 5 menit. Upaya dianggap gagal jika titik akhir Anda mengembalikan kode status HTTP selain 200 atau jika permintaan melebihi batas waktu. Setelah tiga kali upaya gagal, layanan akan berhenti mencoba ulang.