Help Center Autorização do operador e links diretos

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