Help Center Autorizacija operatera i dubinske veze

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