Cihazlar | WA2Notify Docs

Mesaj gönderdiğiniz her API çağrısı bir device_id ister. Bu değer, WhatsApp numaranızı temsil eden bağlı cihazın kimliğidir.

Cihaz uçları API key ile çağrılamaz

GET /v1/devices ve GET /v1/devices/{device_id} yalnızca panel (dashboard) JWT oturumu ile erişilir. Bu uçlara X-API-Key ile yapılan istekler 403 döner. Public entegrasyonlarda device_id değerini önce dashboard’dan alın, sonra API key ile mesaj gönderim uçlarını çağırın.

device_id'yi bulmanın önerilen yolu Dashboardtır: Cihazlar sayfasındaki Cihaz ID sütunundan tek tıkla kopyalayabilirsiniz. Aşağıdaki uçlar aynı bilgiyi programatik olarak, yalnızca panel oturumu (JWT) ile döndürür.

Cihaz operasyonları

Listele

Hesabınıza bağlı tüm cihazları ve her birinin id (device_id) değerini döndürür.

Detay

Tek bir cihazın bağlantı durumu, telefon numarası ve son senkronizasyon bilgisini verir.

Kullan

Aldığınız device_id'yi Mesajlar uçlarında gönderim için kullanın.

GET/v1/devices

Panel oturumu (JWT)200 OK

Cihazları listele

Hesabınıza bağlı tüm WhatsApp cihazlarını döndürür. Her cihazın `id` alanı, gönderim uçlarında kullanacağınız `device_id`'dir. Bu uç yalnızca panel (JWT) oturumu ile çağrılır; API key ile 403 döner.

device_id nerede?Yanıttaki her cihazın id alanı, gönderim çağrılarındaki device_id ile aynıdır.

Kimlik doğrulamaYalnızca panel (dashboard) JWT oturumu ile erişilir. X-API-Key desteklenmez ve 403 döner.

`status` alanı `connected`, `connecting`, `disconnected`, `error` veya `suspended` olabilir. Yalnızca `connected` cihazlarla mesaj gönderilebilir.

İstek

curl --request GET \
--url {{BASE_URL}}/v1/devices \
--header "Authorization: Bearer {{JWT_TOKEN}}"

Yanıt

JSON

{
"data": {
  "devices": [
    {
      "id": "3baedacf-53bf-4061-a0f5-5235cab38875",
      "name": "Satış Hattı",
      "phone_number": "+905551112233",
      "status": "connected",
      "last_seen": "2026-04-01T09:18:35Z",
      "push_name": "Ayşe",
      "business_name": "WA2Notify",
      "created_at": "2026-03-20T11:02:10Z",
      "updated_at": "2026-04-01T09:18:35Z"
    }
  ]
}
}

GET/v1/devices/{device_id}

Panel oturumu (JWT)200 OK

Cihaz detayını al

Tek bir cihazın güncel durumunu ve bağlantı bilgisini döndürür. Bu uç yalnızca panel (JWT) oturumu ile çağrılır; API key ile 403 döner.

device_id bir UUID'dir; dashboard Cihaz ID sütunundan veya listeleme ucundan alınır.
Cihaz bağlı değilse önce dashboard üzerinden QR ile yeniden bağlayın.

Geçersiz bir `device_id` biçimi `400 INVALID_DEVICE_ID`, size ait olmayan veya bulunamayan cihaz `404 DEVICE_NOT_FOUND` döndürür.

İstek

curl --request GET \
--url {{BASE_URL}}/v1/devices/{{DEVICE_ID}} \
--header "Authorization: Bearer {{JWT_TOKEN}}"

Yanıt

JSON

{
"data": {
  "id": "3baedacf-53bf-4061-a0f5-5235cab38875",
  "name": "Satış Hattı",
  "phone_number": "+905551112233",
  "status": "connected",
  "last_seen": "2026-04-01T09:18:35Z",
  "push_name": "Ayşe",
  "business_name": "WA2Notify",
  "created_at": "2026-03-20T11:02:10Z",
  "updated_at": "2026-04-01T09:18:35Z"
}
}

Sonraki adım

device_id'yi aldıktan sonra Mesajlar sayfasındaki POST /v1/messages/send ucuyla ilk mesajınızı gönderin.