Ana içeriğe geç

Operatör Yetkilendirmesi ve Derin Bağlantılar

Bu kılavuz, sistemdeki operatörler için API aracılığıyla geçerli bir yetkilendirme jetonunun nasıl alınacağını ve sohbet paneline gitmek için derin bağlantıların nasıl kullanılacağını açıklamaktadır.

API Temel URL'si: https://chatapi.smsbat.com/ Havalı: https://chatapi.smsbat.com/index.html

Not: Şirket düzeyindeki istekler için "Hamile" yetkilendirmesi yerine jetonunuzla birlikte "X-Authorization-Key" başlığını (kontrol panelindeki Profilinizde mevcuttur) kullanabilirsiniz.

1. Şirket Jetonu Alın

Şirket belirtecini almak için, şirketin oturum açma kimlik bilgilerini içeren /api/company/get-token adresine bir HTTP POST isteği gönderin.

Talep - Yöntem: POST - URL: https://chatapi.smsbat.com/api/company/get-token - Başlıklar: İçerik Türü: application/json

Gövde: 

{
  "login": "string",
  "password": "string"
}

Yanıt - Durum Kodu: 200 (Tamam) - Gövde: Dize jetonu ("your_token_string")

Not: Alınan jetonu sonraki istekler için kaydedin.

2. Organizasyon Listesini Alın

Kuruluşlarınızı listelemek için şirket belirtecini kullanarak /api/company/organization adresine bir GET isteği gönderin.

Talep - Yöntem: AL - URL: https://chatapi.smsbat.com/api/company/organization - Başlıklar: - Yetkilendirme: Taşıyıcı {token} - `Kabul et: metin/düz'

Yanıt - Durum Kodu: 200 (Tamam) - Gövde: 

[
  {
    "id": 6,
    "name": "string"
  }
]

3. Operatörleri Organizasyona Göre Alın

'organizationId' parametresini kullanarak '/api/operator'a bir GET isteği gönderin.

Talep - Yöntem: AL - URL: https://chatapi.smsbat.com/api/operator?organizationId={id} - Başlıklar: - Yetkilendirme: Taşıyıcı {token} - `Kabul et: metin/düz'

Yanıt - Durum Kodu: 200 (Tamam) - Gövde: 

[
  {
    "id": 21,
    "name": "string",
    "status": 1,
    "organization": {
      "id": 24,
      "name": "test_costs"
    }
  }
]

4. Sisteme Operatör Ekleme

Bu uç noktaya erişmek ve operatörleri sistemle senkronize etmek için şirket belirtecini kullanın.

Talep - Yöntem: POST - URL: https://chatapi.smsbat.com/api/operator/synchronize - Başlıklar: - Yetkilendirme: Taşıyıcı {token} - 'İçerik Türü: uygulama/json'

Gövde: 

[
  {
    "organizationId": 24,
    "name": "string"
  }
]

Yanıt - Durum Kodu: 200 (Tamam) - Gövde: 

[
  {
    "id": 21,
    "status": 0,
    "name": "string"
  }
]

Olası Operatör Durumları: - Aktif: 0 - Aktif Değil: 1 - Silindi: 2

5. Operatör Jetonu Alın

Belirli bir operatör için jeton almak üzere şirket jetonuyla yetkilendirin.

Talep - Yöntem: POST - URL: https://chatapi.smsbat.com/api/operator/get-token - Başlıklar: - Yetkilendirme: Taşıyıcı {token} - 'İçerik Türü: uygulama/json'

Gövde: 

{
  "id": 0,
  "expiresAt": "2025-01-20T14:33:34.147Z"
}
expiresAt gereklidir ve operatörün oturum süresini belirler (maks. +24 saat).

Yanıt - Durum Kodu: 200 (Tamam) - Gövde: Dize belirteci

6. Operatör Jetonunu Doğrulayın

Operatörün jetonunun geçerliliğini doğrulayın.

Talep - Yöntem: POST - URL: https://chatapi.smsbat.com/api/operator/validate-token - Başlıklar: - Yetkilendirme: Taşıyıcı {token} - 'İçerik Türü: uygulama/json'

Gövde: "operator_token_string"

Geçerli Yanıt (200 OK): 

{
  "isValid": true,
  "operatorId": 0,
  "clientId": 0,
  "expiresAt": "2024-12-28T14:04:15.861Z",
  "error": null
}

7. Operatör Sohbet Paneline Derin Bağlantı

Harici sistemler (CRM, ERP, dahili web siteleri), JWT Operatör belirtecini parametre olarak ileterek derin bağlantılardan yararlanarak Sohbet panelini doğrudan açabilir. Belirteç geçersizse veya süresi dolmuşsa kullanıcı, oturum açma arayüzüne yönlendirilecektir.

Format 1: Sohbet Kimliğine göre

https://chat.smsbat.com/?chat_raw_id=<chat_id>&token=<jwt_token>

Format 2: Telefon Numarasına Göre

https://chat.smsbat.com/?phone=<phone_number>&token=<jwt_token>
Telefon numarası E.164 uluslararası formatında olmalıdır.

Format 3: Alfa Adına ve Telefona Göre

https://chat.smsbat.com/?from=<bm_id>&phone=<phone_number>&token=<jwt_token>

Format 4: Hedef Ayrıntılarını Tamamlayın

Mesajlara tam olarak hangi kaynaktan müdahale edileceğini belirtin: 

https://chat.smsbat.com/?source=<sourceId>&from=<bm_id>&phone=<phone_number>&token=<jwt_token>
Sohbet Kaynakları: - 0 - Viber - 1 - ViberBot - 2 - TelegramBot - 3 - Whatsapp - 4 - Widget - 5 - Rozetka - 6 - Facebook - 7 - Instagram