Log WhatsApp

Halaman Messages di dashboard Bird adalah catatan workspace Anda untuk setiap pesan WhatsApp yang telah dikirim: setiap pengiriman melalui POST /v1/whatsapp/messages masuk ke sini, yang terbaru di urutan pertama. Gunakan halaman ini untuk memastikan pesan terkirim, memeriksa status pengirimannya, dan melihat template mana yang menghasilkannya. Untuk tur letak halaman ini di dashboard, lihat tur dashboard.

Daftar pesan

Setiap baris adalah satu pesan. Kolomnya:

Daftar ini dipaginasi, 25 pesan per halaman; gunakan Prev dan Next untuk berpindah halaman.

Pencarian dan filter

Log pesan cepat penuh, jadi halaman ini mengutamakan pencarian penerima dan dua filter. Keduanya dapat digabungkan: filter status ditambah rentang tanggal mempersempit hasil ke pesan yang cocok dengan keduanya.

Cari berdasarkan penerima. Kotak pencarian mencocokkan nomor penerima persis dalam format E.164. Ketik nomor lengkap tujuan pengiriman, misalnya +14155550100, untuk menemukan setiap pesan yang ditujukan ke nomor tersebut. Pencarian mencocokkan seluruh nilai, bukan sebagian.

Status. Filter ke satu atau beberapa status. Status bersifat multi-select, sehingga Anda bisa, misalnya, menampilkan semua pesan yang masih dalam proses dengan memilih Accepted dan Sent bersamaan. Pilihannya adalah Accepted, Sent, Delivered, Failed, Rejected, dan Received.

Date. Filter berdasarkan waktu pesan dikirim: pilih preset (3, 7, atau 30 hari terakhir) atau pilih rentang kustom dari kalender.

Jika kombinasi filter tidak menemukan hasil, halaman menampilkan status tanpa hasil dengan aksi Clear filters untuk kembali ke daftar lengkap.

Status

Status pesan menunjukkan kondisi pengiriman atau penerimaan saat ini. Pesan keluar bergerak maju dari accepted menuju tanda terima akhir.

Pesan berstatus rejected jika penerima ada di daftar supresi workspace Anda, saldo wallet tidak cukup untuk mengirim, atau tujuan tidak memiliki harga yang dikonfigurasi. Tanda baca bukan status: ketika penerima membaca pesan yang sudah terkirim, Bird mencatat stempel waktu read_at dan event whatsapp.read pada pesan tersebut, dan status pengiriman tetap delivered.

Memeriksa pesan

Klik baris mana pun untuk membuka pesan. Header-nya menampilkan template yang menghasilkan pesan, status saat ini, penerima, dan badge kategori, di atas tiga tab:

• Events: timeline semua yang terjadi pada pesan, berurutan, masing-masing dengan timestamp-nya. Urutannya Accepted, Sent, Delivered, lalu tanda terima baca jika penerima membacanya, atau kegagalan atau penolakan beserta deskripsi error-nya. Ini adalah stream yang sama yang dapat Anda baca dengan GET /v1/whatsapp/messages/{message_id}/events.
• Details: metadata pesan. Berisi ID (dengan tombol salin), nomor pengirim dan penerima, slug template, bahasa, dan kategori, serta timestamp terkirim, diterima, dan dibaca. Juga berisi deskripsi error pada pesan yang tidak sampai, ditambah tag dan metadata yang disertakan saat pengiriman.
• Preview: tampilan pesan seperti yang dirender di WhatsApp. Untuk pesan template, tab ini menampilkan konten template saat ini, bukan nilai yang dikirimkan saat pengiriman, sehingga variabel muncul sebagai placeholder dan perubahan pada template akan mengubah tampilan yang Anda lihat; gunakan tab ini sebagai alat bantu rendering, bukan catatan isi pesan yang dikirimkan. Pesan masuk menampilkan pratinjau kontennya sendiri.

Log yang sama melalui API

Semua data di halaman ini dibaca dari GET /v1/whatsapp/messages dan sub-resource per pesannya. Daftar ini menerima tiga filter yang sama dengan halaman: status, category, dan rentang tanggal (created_after/created_before). API menambahkan beberapa filter yang tidak tersedia di halaman: direction, tag, dan to atau from yang tepat. to dan from merujuk ujung pesan yang sama seperti pada respons, sehingga to adalah kontak pada pesan keluar dan nomor bisnis Anda pada pesan masuk; keduanya menerima nomor telepon E.164 atau user ID berskop bisnis. Pencarian penerima di halaman adalah satu-satunya filter tanpa padanan langsung, karena filter tersebut mencocokkan kontak di kedua arah dan to atau from saja tidak bisa mengekspresikan hal itu. Timeline di balik tab Events adalah GET /v1/whatsapp/messages/{message_id}/events; event WhatsApp membahas cara membacanya secara programatis.

Langkah berikutnya

• Mengirim pesan WhatsApp: payload pengiriman di balik setiap baris
• Event WhatsApp: event status pesan di balik linimasa
• Metrik WhatsApp: tampilan agregat dari seluruh pesan di sini
• Harga WhatsApp: biaya pesan, berdasarkan tujuan dan kategori