Panduan: Indikator Mengetik & Merekam (Chat Presence)
Endpoint ini memungkinkan Anda mengirimkan indikator status real-time ke ruang obrolan WhatsApp lawan bicara, seperti "sedang mengetik..." (composing), "sedang merekam audio..." (recording), atau menghentikan indikator (paused).
Fitur ini sangat ideal digunakan pada integrasi Customer Service (Shared Inbox) atau Bot AI agar interaksi terasa lebih responsif dan alami.
Parameter Request
| Field | Tipe | Wajib? | Contoh | Keterangan |
|---|---|---|---|---|
phone | string | Wajib | 628123456789 | Nomor WhatsApp penerima (format internasional tanpa tanda +). |
state | string | Wajib | composing | Status presence yang ingin ditampilkan. Pilihan: composing, typing, recording, paused, stop. |
duration | integer | Opsional | 5 | Durasi indikator dalam detik (maks. 30 detik). Server akan otomatis mengirim status paused setelah durasi habis. |
Pilihan Nilai state
Nilai state | Efek Tampilan di WhatsApp Lawan Bicara |
|---|---|
composing atau typing | Menampilkan teks header "sedang mengetik..." (typing...). Cocok dipicu saat agen mulai mengetik balasan atau AI sedang memproses respons. |
recording | Menampilkan teks header "sedang merekam audio..." (recording audio...). Cocok dipicu saat voice note sedang direkam atau disintesis. |
paused atau stop | Menghilangkan status mengetik/merekam secara instan. |
Gunakan parameter duration (misalnya "duration": 5) saat menyetel status composing. Server Wagy akan mengelola background timer otomatis untuk menghentikan status mengetik jika tidak ada pesan lanjutan, sehingga status WhatsApp tidak macet atau terus-menerus mengetik.
Untuk menjaga reputasi nomor WhatsApp dan mematuhi kebijakan lalu lintas jaringan, endpoint ini dibatasi maksimal 5 request per 10 detik per perangkat.
Set chat presence / typing indicator
POST/:device_id/presence
Set chat presence state (typing, recording audio, or paused) for a specific WhatsApp chat.
Coba Sekarang
Responses
- 200
- 400
- 401
- 429
- 500
- 503
Chat presence status sent successfully
Format JSON salah atau parameter wajib kosong
API Key tidak valid atau tidak sesuai
Rate limit exceeded (Max 5 requests per 10 seconds)
Gagal mengirim chat presence
Device tidak terhubung (offline)