Help Center Autorizzazione dell'operatore e collegamenti diretti

Autorizzazione dell'operatore e collegamenti diretti

Questa guida spiega come ottenere un token di autorizzazione valido per gli operatori del sistema tramite API e come utilizzare i deep link per navigare nel pannello della chat.

URL di base dell’API: “https://chatapi.smsbat.com/”. Spavalderia: https://chatapi.smsbat.com/index.html

Nota: puoi utilizzare l’intestazione “X-Authorization-Key” con il tuo token (disponibile nel tuo profilo nella dashboard) invece dell’autorizzazione “Bearer” per le richieste a livello aziendale.

1. Ottieni il token aziendale

Per ottenere il token aziendale, invia una richiesta HTTP POST a “/api/company/get-token” contenente le credenziali di accesso dell’azienda.

Richiesta

  • Metodo: POST
  • URL: https://chatapi.smsbat.com/api/company/get-token
  • Intestazioni: Content-Type: application/json

Corpo:

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

Risposta

  • Codice di stato: 200 (OK)
  • Corpo: Token di stringa (“your_token_string”`)

Nota: Salva il token ricevuto per le richieste successive.

2. Recupera l’elenco delle organizzazioni

Invia una richiesta GET a “/api/company/organization” utilizzando il token aziendale per elencare le tue organizzazioni.

Richiesta

  • Metodo: OTTIENI
  • URL: https://chatapi.smsbat.com/api/company/organization
  • Intestazioni:
    • Autorizzazione: Portatore {token}
    • “Accetta: testo/semplice”.

Risposta

  • Codice di stato: 200 (OK)
  • Corpo:
[
  {
    "id": 6,
    "name": "string"
  }
]

3. Recupera gli operatori per organizzazione

Invia una richiesta GET a “/api/operator” utilizzando il parametro “organizationId”.

Richiesta

  • Metodo: OTTIENI
  • URL: https://chatapi.smsbat.com/api/operator?organizationId={id}
  • Intestazioni:
    • Autorizzazione: Portatore {token}
    • “Accetta: testo/semplice”.

Risposta

  • Codice di stato: 200 (OK)
  • Corpo: CODICE_BLOCCO_2

4. Aggiungi operatori al sistema

Utilizza il token aziendale per accedere a questo endpoint e sincronizzare gli operatori con il sistema.

Richiesta

  • Metodo: POST
  • URL: https://chatapi.smsbat.com/api/operator/synchronize
  • Intestazioni:
    • Autorizzazione: Portatore {token}
    • “Tipo di contenuto: application/json”.

Corpo:

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

Risposta

  • Codice di stato: 200 (OK)
  • Corpo:
[
  {
    "id": 21,
    "status": 0,
    "name": "string"
  }
]

Possibili stati dell’operatore:

  • Attivo: “0”.
  • Inattivo: “1”.
  • Cancellato: “2”.

5. Ottieni il token operatore

Autorizzare con il token aziendale ad ottenere un token per un operatore specifico.

Richiesta

  • Metodo: POST
  • URL: https://chatapi.smsbat.com/api/operator/get-token
  • Intestazioni:
    • Autorizzazione: Portatore {token}
    • “Tipo di contenuto: application/json”.

Corpo: CODICE_BLOCCO_5 expiresAt è obbligatorio e determina la durata della sessione dell’operatore (max +24 ore).

Risposta

  • Codice di stato: 200 (OK)
  • Corpo: Token di stringa

6. Convalida token operatore

Verificare la validità del token di un operatore.

Richiesta

  • Metodo: POST
  • URL: https://chatapi.smsbat.com/api/operator/validate-token
  • Intestazioni:
    • Autorizzazione: Portatore {token}
    • “Tipo di contenuto: application/json”.

Corpo: "operator_token_string"

Risposta valida (200 OK): CODICE_BLOCCO_6

7. Collegamento diretto al pannello chat dell’operatore

I sistemi esterni (CRM, ERP, siti web interni) possono aprire direttamente il pannello Chat sfruttando i deep link passando come parametro il token JWT Operator. Se il token non è valido o è scaduto, l’utente verrà reindirizzato all’interfaccia di accesso.

Formato 1: tramite ID chat

CODICE_BLOCCO_7

Formato 2: per numero di telefono

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

Il numero di telefono deve essere nel formato internazionale E.164.

Formato 3: per nome e telefono alfanumerici

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

Formato 4: completare i dettagli del bersaglio

Specifica esattamente da quale fonte intercettare i messaggi:

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

Fonti chat:

  • “0” - Viber
  • “1” - ViberBot
  • “2” - TelegramBot
  • “3” - Whatsapp
  • “4” - Dispositivo
  • “5” - Rozetka
  • “6” - Facebook
  • “7” - Instagram