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, terbaru di atas. Gunakan halaman ini untuk memastikan pesan sudah dikirim, melihat posisinya dalam siklus pengiriman, dan mengetahui template yang menghasilkannya. Untuk tur letak halaman ini di dashboard, lihat tur dashboard.
Daftar pesan
Setiap baris adalah satu pesan. Kolomnya:
| Kolom | Isi kolom |
|---|---|
| Status | Status pesan saat ini (lihat Status), ditampilkan sebagai titik berwarna |
| From | Nomor pengirim WhatsApp yang digunakan untuk mengirim pesan |
| To | Nomor penerima |
| Template | Template yang digunakan untuk mengirim pesan (klik baris untuk membuka pesan) |
| Category | Kategori template |
| Sent | Waktu permintaan pengiriman diterima, dalam waktu relatif (arahkan kursor untuk timestamp persis) |
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 posisinya saat ini dalam siklus. Pesan bergerak dari accepted menuju tanda terima akhir.
| Status | Arti |
|---|---|
| Accepted | Kami menerima pesan dan sedang mempersiapkan penyerahan ke WhatsApp |
| Sent | Diserahkan ke WhatsApp; menunggu tanda terima pengiriman |
| Delivered | WhatsApp mengonfirmasi pengiriman ke penerima |
| Failed | Pengiriman atau penyampaian pesan ke penerima gagal; periksa error yang tercatat |
| Rejected | Bird menolak pesan sebelum mengirimnya. Pesan tidak terkirim dan Anda tidak dikenakan biaya |
| Scheduled | Diantrikan untuk dikirim di waktu mendatang |
| Canceled | Pesan terjadwal dibatalkan sebelum dikirim; tanpa pengiriman berikutnya |
| Received | Pesan masuk |
Pesan berstatus rejected jika penerima ada di daftar supresi workspace Anda, saldo wallet tidak mencukupi untuk pengiriman, atau tujuan tidak memiliki harga yang dikonfigurasi. Tanda terima baca bukan status: ketika penerima membaca pesan yang sudah terkirim, Bird mencatat timestamp 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 dua 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.
Log yang sama melalui API
Semua data di halaman ini dibaca dari GET /v1/whatsapp/messages dan sub-resource per pesannya. Daftar mengambil tiga filter yang sama dari halaman: status, category, dan rentang tanggal (created_after/created_before). Daftar ini menambahkan beberapa filter yang tidak tersedia di halaman: direction, tag, dan to atau from persis. to dan from merujuk ujung pesan yang sama seperti dalam respons, jadi to adalah kontak pada pesan keluar dan nomor bisnis Anda pada pesan masuk; masing-masing menerima nomor telepon E.164 atau user ID bercakupan bisnis. Pencarian penerima di halaman adalah satu-satunya filter tanpa padanan langsung, karena ia mencocokkan kontak di kedua arah dan to atau from saja tidak bisa mengekspresikan 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: stream siklus per pesan di balik timeline
- Metrik WhatsApp: tampilan agregat dari seluruh pesan di sini
- Harga WhatsApp: biaya pesan, berdasarkan tujuan dan kategori
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.
Tonton panduannyaConnecting WhatsApp to Bird: from buying a number to a live channelPahami konsepnyaWhat is the 24-hour customer service window on WhatsApp?Gunakan alatnyaWhatsApp message builderJelajahi kemampuannyaWhatsApp
Coba praktiknya dan dapatkan ringkasan implementasi