Skip to content

Autorizacija operatera i duboke veze

Ovaj vodič objašnjava kako da dobijete važeći token autorizacije za operatere u sistemu putem API-ja i kako da koristite duboke veze za navigaciju do panela za ćaskanje.

Osnovni URL API-ja: https://chatapi.smsbat.com/ Swagger: https://chatapi.smsbat.com/index.html

Napomena: Možete koristiti zaglavlje X-Authorization-Key sa svojim tokenom (dostupno u vašem profilu na kontrolnoj tabli) umjesto autorizacije Nosioca za zahtjeve na nivou kompanije.

1. Nabavite token kompanije

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

Zahtjev - Metoda: POST - URL: https://chatapi.smsbat.com/api/company/get-token - Zaglavlja: Tip sadržaja: aplikacija/json

Tijelo: 

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

Odgovor - Kôd statusa: 200 (OK) - Tijelo: token niza ("your_token_string")

Napomena: Sačuvajte primljeni token za naknadne zahtjeve.

2. Dohvatite listu organizacija

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

Zahtjev - Metoda: GET - URL: https://chatapi.smsbat.com/api/company/organization - Zaglavlja: - Ovlašćenje: nosilac {token} - Prihvati: tekst/obično

Odgovor - Kôd statusa: 200 (OK) - Tijelo: 

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

3. Dohvatite operatere po organizaciji

Pošaljite GET zahtjev na /api/operator koristeći parametar organizationId.

Zahtjev - Metoda: GET - URL: https://chatapi.smsbat.com/api/operator?organizationId={id} - Zaglavlja: - Ovlašćenje: nosilac {token} - Prihvati: tekst/obično

Odgovor - Kôd statusa: 200 (OK) - Tijelo: 

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

4. Dodajte operatore sistemu

Koristite token kompanije za pristup ovoj krajnjoj tački i sinhronizaciju operatera sa sistemom.

Zahtjev - Metoda: POST - URL: https://chatapi.smsbat.com/api/operator/synchronize - Zaglavlja: - Ovlašćenje: nosilac {token} - Tip sadržaja: aplikacija/json

Tijelo: 

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

Odgovor - Kôd statusa: 200 (OK) - Tijelo: 

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

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

5. Nabavite token operatera

Ovlastite tokenom kompanije da dobijete token za određenog operatera.

Zahtjev - Metoda: POST - URL: https://chatapi.smsbat.com/api/operator/get-token - Zaglavlja: - Ovlašćenje: nosilac {token} - Tip sadržaja: aplikacija/json

Tijelo: 

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

Odgovor - Kôd statusa: 200 (OK) - Telo: Token niza

6. Potvrdite token operatera

Provjerite valjanost tokena operatora.

Zahtjev - Metoda: POST - URL: https://chatapi.smsbat.com/api/operator/validate-token - Zaglavlja: - Ovlašćenje: nosilac {token} - Tip sadržaja: aplikacija/json

Tijelo: "operator_token_string"

Valjan odgovor (200 OK): 

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

7. Duboko povezivanje sa čet panelom operatera

Eksterni sistemi (CRM, ERP, interne web stranice) mogu direktno otvoriti Chat panel koristeći duboke veze prosljeđivanjem tokena JWT Operatora kao parametra. Ako je token nevažeći ili istekao, korisnik će biti preusmjeren na sučelje za prijavu.

Format 1: Po ID-u ćaskanja

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

Format 2: Po broju telefona

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

Format 3: Alfa imenom i telefonom

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

Format 4: Potpuni detalji o meti

Navedite tač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