Ir para o conteúdo

Autorização do operador e links diretos

Este guia explica como obter um token de autorização válido para operadores no sistema via API e como usar links diretos para navegar até o painel de chat.

URL base da API: https://chatapi.smsbat.com/ Arrogância: https://chatapi.smsbat.com/index.html

Observação: Você pode usar o cabeçalho X-Authorization-Key com seu token (disponível em seu perfil no painel) em vez da autorização Bearer para solicitações de nível de empresa.

1. Obtenha o token da empresa

Para obter o token da empresa, envie uma solicitação HTTP POST para /api/company/get-token contendo as credenciais de login da empresa.

Solicitação - Método: POSTAR - URL: https://chatapi.smsbat.com/api/company/get-token - Cabeçalhos: Tipo de conteúdo: aplicativo/json

Corpo: 

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

Resposta - Código de status: 200 (OK) - Corpo: Token de string ("seu_token_string")

Observação: Salve o token recebido para solicitações subsequentes.

2. Recuperar lista de organizações

Envie uma solicitação GET para /api/company/organization usando o token da empresa para listar suas organizações.

Solicitação - Método: OBTER - URL: https://chatapi.smsbat.com/api/company/organization - Cabeçalhos: - Autorização: Portador {token} - Aceitar: texto/simples

Resposta - Código de status: 200 (OK) - Corpo: 

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

3. Recuperar operadores por organização

Envie uma solicitação GET para /api/operator usando o parâmetro organizationId.

Solicitação - Método: OBTER - URL: https://chatapi.smsbat.com/api/operator?organizationId={id} - Cabeçalhos: - Autorização: Portador {token} - Aceitar: texto/simples

Resposta - Código de status: 200 (OK) - Corpo: 

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

4. Adicionar operadores ao sistema

Use o token da empresa para acessar esse endpoint e sincronizar os operadores com o sistema.

Solicitação - Método: POSTAR - URL: https://chatapi.smsbat.com/api/operator/synchronize - Cabeçalhos: - Autorização: Portador {token} - Tipo de conteúdo: aplicativo/json

Corpo: CODE_BLOCO_3

Resposta - Código de status: 200 (OK) - Corpo: 

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

Possíveis status do operador: - Ativo: 0 - Inativo: 1 - Excluído: 2

5. Obtenha o token do operador

Autorize com o token da empresa a obtenção de um token para uma operadora específica.

Solicitação - Método: POSTAR - URL: https://chatapi.smsbat.com/api/operator/get-token - Cabeçalhos: - Autorização: Portador {token} - Tipo de conteúdo: aplicativo/json

Corpo: CODE_BLOCO_5 expiresAt é obrigatório e determina a duração da sessão do operador (máx. +24 horas).

Resposta - Código de status: 200 (OK) - Corpo: Token de string

6. Validar token do operador

Verifique a validade do token de um operador.

Solicitação - Método: POSTAR - URL: https://chatapi.smsbat.com/api/operator/validate-token - Cabeçalhos: - Autorização: Portador {token} - Tipo de conteúdo: aplicativo/json

Corpo: "operator_token_string"

Resposta válida (200 OK): 

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

Sistemas externos (CRM, ERP, sites internos) podem abrir diretamente o painel de Chat aproveitando os links diretos, passando o token do Operador JWT como parâmetro. Se o token for inválido ou expirado, o usuário será redirecionado para a interface de login.

Formato 1: por ID de bate-papo

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

Formato 2: por número de telefone

https://chat.smsbat.com/?phone=<phone_number>&token=<jwt_token>
O número de telefone deve estar no formato internacional E.164.

Formato 3: Por nome alfa e telefone

CODE_BLOCO_9

Formato 4: detalhes completos do destino

Especifique exatamente de qual fonte interceptar mensagens: 

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