Saltar a contenido

Autorización del operador y enlaces profundos

Esta guía explica cómo obtener un token de autorización válido para los operadores del sistema a través de API y cómo utilizar enlaces profundos para navegar al panel de chat.

URL base de API: https://chatapi.smsbat.com/ Arrogancia: https://chatapi.smsbat.com/index.html

Nota: Puede utilizar el encabezado X-Authorization-Key con su token (disponible en su perfil en el panel de control) en lugar de la autorización Bearer para solicitudes a nivel de empresa.

1. Obtener el token de la empresa

Para obtener el token de la empresa, envíe una solicitud HTTP POST a /api/company/get-token que contenga las credenciales de inicio de sesión de la empresa.

Solicitar - Método: PUBLICAR - URL: https://chatapi.smsbat.com/api/company/get-token - Encabezados: Tipo de contenido: aplicación/json

Cuerpo: 

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

Respuesta - Código de estado: 200 (OK) - Cuerpo: Token de cadena ("your_token_string"`)

Nota: Guarde el token recibido para solicitudes posteriores.

2. Recuperar la lista de organizaciones

Envíe una solicitud GET a /api/company/organization utilizando el token de la empresa para enumerar sus organizaciones.

Solicitar - Método: OBTENER - URL: https://chatapi.smsbat.com/api/company/organization - Encabezados: - Autorización: Portador {token} - Aceptar: texto/normal

Respuesta - Código de estado: 200 (OK) - Cuerpo: 

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

3. Recuperar operadores por organización

Envíe una solicitud GET a /api/operator usando el parámetro organizationId.

Solicitar - Método: OBTENER - URL: https://chatapi.smsbat.com/api/operator?organizationId={id} - Encabezados: - Autorización: Portador {token} - Aceptar: texto/normal

Respuesta - Código de estado: 200 (OK) - Cuerpo: 

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

4. Agregar operadores al sistema

Utilice el token de la empresa para acceder a este punto final y sincronizar los operadores con el sistema.

Solicitar - Método: PUBLICAR - URL: https://chatapi.smsbat.com/api/operator/synchronize - Encabezados: - Autorización: Portador {token} - Tipo de contenido: aplicación/json

Cuerpo: 

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

Respuesta - Código de estado: 200 (OK) - Cuerpo: 

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

Posibles estados del operador: - Activo: 0 - Inactivo: 1 - Eliminado: 2

5. Obtener token de operador

Autorizar con el token de la empresa a obtener un token para un operador específico.

Solicitar - Método: PUBLICAR - URL: https://chatapi.smsbat.com/api/operator/get-token - Encabezados: - Autorización: Portador {token} - Tipo de contenido: aplicación/json

Cuerpo: 

{
  "id": 0,
  "expiresAt": "2025-01-20T14:33:34.147Z"
}
expiresAt es obligatorio y determina la duración de la sesión del operador (máx. +24 horas).

Respuesta - Código de estado: 200 (OK) - Cuerpo: Token de cadena

6. Validar token de operador

Verificar la validez del token de un operador.

Solicitar - Método: PUBLICAR - URL: https://chatapi.smsbat.com/api/operator/validate-token - Encabezados: - Autorización: Portador {token} - Tipo de contenido: aplicación/json

Cuerpo: "operator_token_string"

Respuesta válida (200 OK): 

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

7. Enlace profundo al panel de chat del operador

Los sistemas externos (CRM, ERP, sitios web internos) pueden abrir directamente el panel de Chat aprovechando los enlaces profundos pasando el token del Operador JWT como parámetro. Si el token no es válido o ha caducado, el usuario será redirigido a la interfaz de inicio de sesión.

Formato 1: Por ID de chat

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

Formato 2: Por número de teléfono

https://chat.smsbat.com/?phone=<phone_number>&token=<jwt_token>
El número de teléfono debe estar en formato internacional E.164.

Formato 3: Por nombre alfa y teléfono

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

Formato 4: Detalles completos del objetivo

Especifique exactamente de qué fuente interceptar mensajes: 

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