Vai al contenuto

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