Management

Devices

Copy page

Devices

Device merepresentasikan satu nomor WhatsApp Business yang terhubung ke kirim.dev.

Setup Device Baru

1. Buka Devices di sidebar
2. Klik Add Device
3. Pilih metode setup:
   • Coexistence - Gunakan nomor WhatsApp Business App yang sudah ada
   • Manual Setup - Input credentials dari Meta Developer Portal

Coexistence Setup

Coexistence memungkinkan menggunakan WhatsApp Business App dan Cloud API secara bersamaan:

1. Pilih Coexistence
2. Login dengan akun Meta/Facebook
3. Pilih nomor WhatsApp Business
4. Selesaikan verifikasi

Keuntungan Coexistence:

• Tidak perlu nomor baru
• Chat history tetap
• Bisa chat manual via App dan otomatis via API

Manual Setup

Untuk setup manual, Anda perlu credentials dari Meta Developer Portal:

Field	Deskripsi	Lokasi
Phone Number ID	ID nomor di WhatsApp Cloud API	Meta Developer Portal → WhatsApp → API Setup
WhatsApp Business Account ID	ID business account	Meta Business Suite → Settings
Access Token	Token untuk API calls	Meta Developer Portal → App → Access Token
Webhook Verify Token	Token verifikasi webhook	Anda tentukan sendiri

Konfigurasi Webhook di Meta

Setelah membuat device dengan manual setup:

1. Buka Meta Developer Portal
2. Pilih App → WhatsApp → Configuration
3. Set Callback URL: https://api.kirim.dev/webhooks/whatsapp/:device_id
4. Set Verify Token: Token yang Anda tentukan saat setup
5. Subscribe ke fields: messages, message_status

Status Device

Status	Deskripsi	Action
connected	Device aktif dan siap	Tidak perlu action
disconnected	Token expired atau invalid	Refresh access token
pending	Menunggu verifikasi webhook	Selesaikan setup webhook

Default Device

Anda bisa menetapkan satu device sebagai default:

• API key tanpa device restriction akan menggunakan default device
• Request tanpa device_id akan menggunakan default device

Set default:

1. Buka Devices
2. Klik device → Set as Default

Edit Device

1. Klik device di list
2. Update informasi yang diperlukan:
   • Name
   • Access Token (jika expired)
3. Klik Save

Refresh Token

Jika Access Token expired:

1. Buka Meta Developer Portal
2. Generate access token baru (pilih yang tidak expire)
3. Update di kirim.dev → Devices → Edit

Tip: Gunakan System User Token yang tidak expire untuk produksi.

Delete Device

1. Klik icon Delete pada device
2. Konfirmasi penghapusan

Warning: Menghapus device akan:

• Menghentikan semua automations untuk device tersebut
• Webhooks tidak akan diterima lagi
• Conversations tetap tersimpan

Multi-Device

Anda bisa menghubungkan multiple devices:

• Setiap device = 1 nomor WhatsApp
• Bisa untuk departemen berbeda (Sales, Support)
• Atau untuk brand berbeda

Troubleshooting

Webhook tidak terverifikasi

1. Pastikan Callback URL benar: https://api.kirim.dev/webhooks/whatsapp/:device_id
2. Pastikan Verify Token sama dengan yang diinput saat setup
3. Cek URL accessible dari internet

Access Token expired

1. Buka Meta Developer Portal
2. Generate access token baru
3. Update di kirim.dev Dashboard

Pesan tidak terkirim

1. Cek status device - harus connected
2. Pastikan phone number sudah verified di Meta
3. Cek rate limit tier di Meta Business Suite
4. Lihat Logs untuk error detail

Device menunjukkan disconnected

1. Cek apakah token masih valid
2. Cek apakah app masih aktif di Meta
3. Cek apakah ada perubahan permissions