Tutorial

Como obter os dados do painel (SIGMA) para integrar a empresa

Este guia mostra exatamente quais dados usar onde encontrar cada um.

Regra curta: para integrar uma voce vai precisar no minimo de Base URL, Bearer token, Parent user id e pelo menos um ID de servidor.
Abrir configuracao de revendas Ir para o checklist

O que pedir para cada empresa

Campo no Nexus Obrigatorio? O que e Exemplo
Base URL Sim Endereco base do painel. https://painel-exemplo.com
Bearer token Sim Token da API usado para autenticar as chamadas do Nexus. 12345|token-exemplo
Parent user id Sim Identificador do usuario pai no painel. Define em qual conta as revendas serao criadas. parent_user_id_exemplo
Role padrao Nao Tipo de revenda padrao. Normalmente reseller ou master-reseller. reseller
Creditos padrao Nao Quantidade inicial de creditos sugerida na ativacao. 5
IDs dos servidores padrao Sim IDs dos servidores que a revenda vai operar. ["server_id_iptv_exemplo","server_id_p2p_exemplo"]

1. Como obter a Base URL

  1. Peça para a empresa abrir o painel no navegador.
  2. Copie apenas a parte principal do dominio.
  3. Nao use rotas como /api/resellers ou /api/chatbot.
Correto:  https://painel-exemplo.com
Errado:   https://painel-exemplo.com/api/resellers
Errado:   https://painel-exemplo.com/api/chatbot/abc/xyz

2. Como obter o Bearer token

  1. Entrar no painel com o usuario dono do painel.
  2. Abrir DevTools > Network.
  3. Abrir uma tela que faca request autenticado, como Revendas ou Servidores.
  4. Clicar em uma chamada tipo /api/servers ou /api/resellers.
  5. Em Request Headers, localizar authorization.
  6. Copiar apenas o valor depois de Bearer .
Importante: esse token e sensivel. Nao precisa mandar cookie, cf_clearance nem outros headers. So o valor do Bearer token.

3. Como obter o Parent user id

  1. Abrir DevTools > Network.
  2. Ir para a tela de adicionar revenda no painel.
  3. Clicar em salvar com campos incompletos, so para gerar o request sem criar nada.
  4. Abrir a chamada POST /api/resellers.
  5. Em Payload, procurar o campo parent_user_id.
{
  "parent_user_id": "parent_user_id_exemplo"
}

Esse valor identifica qual conta dona do painel vai receber as revendas criadas pelo Nexus.

4. Como obter os roles de revenda

  1. Na mesma tela de revendas, localizar a chamada GET /api/resellers/roles.
  2. Ver o retorno em Preview ou Response.
[
  { "name": "master-reseller", "label": null, "count": 79 },
  { "name": "reseller", "label": null, "count": 247 }
]

Normalmente usamos:

  • reseller = revenda normal
  • master-reseller = revenda master

5. Como obter os IDs dos servidores

  1. Abrir a chamada GET /api/servers no DevTools.
  2. Em Preview ou Response, olhar o array data.
  3. Copiar o id dos servidores que a empresa quer liberar.
{
  "data": [
    { "id": "server_id_streaming_exemplo", "name": "Streaming" },
    { "id": "server_id_p2p_exemplo", "name": "P2P" }
  ]
}

No Nexus, voce pode informar esses IDs separados por virgula ou em JSON.

6. O que o Nexus escolhe internamente

  • Role padrao: pode ficar como reseller se a empresa nao vender master.
  • Creditos padrao: use 5 como minimo inicial, se o painel exigir isso.
  • Preparar sincronizacao: e decisao sua no Nexus, nao algo que a empresa precise te passar.
  • Somente clientes com telefone: e uma regra de importacao do Nexus.
  • Importar base existente: deixe desligado se voce nao quiser puxar a carteira antiga da empresa.

Checklist final para pedir ao cliente

Base URL Bearer token Parent user id Role padrao Creditos padrao IDs dos servidores
Se a empresa nao souber pegar isso sozinha, o caminho mais seguro e fazer uma chamada com compartilhamento de tela e coletar voce mesmo no navegador. 
Checklist pronto para enviar:

1. URL principal do painel
2. Bearer token da API
3. Parent user id
4. Tipo padrao de revenda (reseller ou master-reseller)
5. Quantidade padrao de creditos
6. IDs dos servidores que a revenda deve operar

Exemplo de preenchimento no Nexus

Base URL: https://painel-exemplo.com
Bearer token: 12345|token-exemplo
Parent user id: parent_user_id_exemplo
Role padrao: reseller
Creditos padrao: 5
IDs dos servidores padrao: ["server_id_iptv_exemplo","server_id_p2p_exemplo"]
Preparar sincronizacao: desligado
Somente clientes com telefone: ligado
Importar base existente: desligado