Preskoči na sadržaj

Autorizacija operatera i dubinske veze

Ovaj vodič objašnjava kako dobiti valjani autorizacijski token za operatere u sustavu putem API-ja i kako koristiti dubinske veze za navigaciju do panela za chat.

API osnovni URL: https://chatapi.smsbat.com/ Razmetanje: https://chatapi.smsbat.com/index.html

Napomena: možete koristiti zaglavlje X-Authorization-Key sa svojim tokenom (dostupno u vašem profilu na nadzornoj ploči) umjesto autorizacije Bearer za zahtjeve na razini tvrtke.

1. Nabavite token tvrtke

Da biste dobili token tvrtke, pošaljite HTTP POST zahtjev na /api/company/get-token koji sadrži vjerodajnice za prijavu tvrtke.

Zahtjev - Metoda: POST - URL: https://chatapi.smsbat.com/api/company/get-token - Zaglavlja: Content-Type: application/json

Tijelo: 

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

Odgovor - Statusni kod: 200 (OK) - Tijelo: Token niza ("vaš_token_string")

Napomena: Spremite primljeni token za sljedeće zahtjeve.

2. Dohvati popis organizacija

Pošaljite GET zahtjev na /api/company/organization koristeći token tvrtke za popis vaših organizacija.

Zahtjev - Metoda: GET - URL: https://chatapi.smsbat.com/api/company/organization - Zaglavlja: - Autorizacija: Nositelj {token} - Prihvati: tekst/običan

Odgovor - Statusni kod: 200 (OK) - Tijelo: 

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

3. Dohvati operatore po organizaciji

Pošaljite GET zahtjev na /api/operator pomoću parametra organizationId.

Zahtjev - Metoda: GET - URL: https://chatapi.smsbat.com/api/operator?organizationId={id} - Zaglavlja: - Autorizacija: Nositelj {token} - Prihvati: tekst/običan

Odgovor - Statusni kod: 200 (OK) - Tijelo: 

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

4. Dodajte operatore u sustav

Koristite token tvrtke za pristup ovoj krajnjoj točki i sinkronizaciju operatera sa sustavom.

Zahtjev - Metoda: POST - URL: https://chatapi.smsbat.com/api/operator/synchronize - Zaglavlja: - Autorizacija: Nositelj {token} - Content-Type: application/json

Tijelo: 

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

Odgovor - Statusni kod: 200 (OK) - Tijelo: 

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

Mogući statusi operatera: - Aktivan: 0 - Neaktivno: 1 - Izbrisano: 2

5. Nabavite operatorski token

Autorizirajte tokenom tvrtke za dobivanje tokena za određenog operatera.

Zahtjev - Metoda: POST - URL: https://chatapi.smsbat.com/api/operator/get-token - Zaglavlja: - Autorizacija: Nositelj {token} - Content-Type: application/json

Tijelo: 

{
  "id": 0,
  "expiresAt": "2025-01-20T14:33:34.147Z"
}
expiresAt je obavezan i određuje trajanje sesije operatera (maks. +24 sata).

Odgovor - Statusni kod: 200 (OK) - Tijelo: Token niza

6. Provjerite token operatera

Provjerite valjanost tokena operatera.

Zahtjev - Metoda: POST - URL: https://chatapi.smsbat.com/api/operator/validate-token - Zaglavlja: - Autorizacija: Nositelj {token} - Content-Type: application/json

Tijelo: "operator_token_string"

Valjani odgovor (200 OK): 

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

7. Dubinsko povezivanje s panelom za chat operatera

Vanjski sustavi (CRM, ERP, interna web-mjesta) mogu izravno otvoriti panel Chat koristeći dubinske veze prosljeđivanjem tokena JWT Operator kao parametra. Ako je token nevažeći ili je istekao, korisnik će biti preusmjeren na sučelje za prijavu.

Format 1: Po ID-u chata

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

Format 2: putem telefonskog broja

https://chat.smsbat.com/?phone=<phone_number>&token=<jwt_token>
Telefonski broj mora biti u E.164 međunarodnom formatu.

Format 3: Alfa ime i telefon

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

Format 4: Dovršite pojedinosti cilja

Navedite točno iz kojeg izvora želite presresti poruke: 

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