Central de ajuda
Perguntas e respostas
Como funcionam créditos, pacotes, lines, links de reprodução e dispositivos — e o que verificar quando algo não reproduz.
139 de 139 perguntas
Como usar esta página
Toda pergunta tem um código fixo (por exemploLINE-07). Cite-o ao falar com o suporte ou copie o link da pergunta.
Nomes de menus, botões e campos aparecem como o painel os mostra. Umuser(usuário) é uma conta que entra no painel (admin, revendedor); umalineé a assinatura IPTV de um espectador. Os dois nunca se misturam.
- Espectador O revendedor pode encaminhar esta resposta ao espectador como está
- Admin Para o operador do painel
Visão geral do serviço e quem é responsável por quê
GENGEN-01 O que este serviço oferece?
Um sistema OTT / IPTV completo: o painel de administração (dashboard), o servidor de API para os apps dos espectadores, a entrega de canais ao vivo, filmes, séries e rádio, e um web player. Nós fornecemos e mantemos o sistema; os revendedores o usam para dar aos clientes o direito de assistir (lines).
GEN-02 O que o serviço não faz?
- Não cobra por você e não tem gateway de pagamento. O preço para seus clientes, como você recebe e a emissão de notas são assunto do revendedor (vejaCON-01).
- Não entra em contato com os espectadores de um revendedor. O painel só envia e-mail para contas do painel, nunca para uma line.
- Não guarda dados pessoais de um cliente excluído e não tem função de restauração (vejaDATA-01).
GEN-03 Quem é quem no sistema?
| Função | Quem é | Onde entra |
|---|---|---|
| Admin | o operador do painel | dashboard |
| Revendedor | vende lines; recebe créditos do admin | dashboard, API do revendedor |
| Sub-revendedor | um revendedor criado abaixo de outro revendedor | dashboard, API do revendedor |
| Line | um assinante — o espectador final | app IPTV, set-top box, web player.Nuncao dashboard |
GEN-04 Quais etapas levam um canal ao espectador?
- O admin monta o catálogo (canais, filmes, séries, rádio) e o agrupa embouquets.
- O admin cria umpacote: bouquets + duração + número de conexões + preço em créditos.
- Um revendedor gasta créditos para vender o pacote → o sistema cria umaline.
- O cliente insere os dados da line em um app; o sistema verifica a line (não expirada, ativada, dentro dos limites) e reproduz a partir de um servidor adequado.
GEN-05 O que um revendedor pode e não pode fazer com o conteúdo?
Um revendedor podeveras listas de canais, filmes, séries, rádio, bouquets e pacotes (quando o grupo tem a permissão), mas não pode adicionar, editar nem excluir conteúdo. Conteúdo e pacotes são gerenciados pelo admin. O revendedor decide o que cada cliente pode assistir escolhendo o pacote (e os bouquets, quando o grupo permite —PKG-05).
GEN-06 Onde consigo suporte?
A entradaSupportda barra lateral abre o site de suporte separado. O painel não tem sistema de tickets próprio. Ao enviar um pedido, inclua: o nome de usuário da line (nunca a senha), quando aconteceu, o app / dispositivo e o código da pergunta desta página, se já tentou alguma.
GEN-07 Quais idiomas a interface tem?
O painel, o web player e esta página de ajuda têm um seletor de idioma com 27 idiomas. Inglês e vietnamita são as traduções de referência; nos outros idiomas, uma tela recém-adicionada pode ficar em inglês por um tempo. Os e-mails enviados pelo painel estão atualmente apenas em inglês.
Contas do painel e login
ACCACC-01 Por que meu cliente não consegue entrar no dashboard?
É proposital: uma line não é uma conta do painel. O cliente só usa os dados da line em um app IPTV, um set-top box ou o web player. Da mesma forma, uma conta de revendedor não serve para assistir canais.
ACC-02 Vejo menos menus do que esta página descreve. Por quê?
Menus e ações dependem dogrupoque o admin deu à sua conta. Uma página para a qual seu grupo não tem permissão não aparece na barra lateral e não pode ser aberta. Peça mais permissões ao admin.
ACC-03 Onde altero a senha do meu painel?
Na área da conta (perfil → alterar senha). As senhas do painel são armazenadas com hash; ninguém consegue lê-las — nem o admin. Se você a esquecer, peça à conta acima de você (seu revendedor superior ou o admin) para definir uma nova.
ACC-04 Por que sou desconectado quando troco de rede?
O painel pode ser configurado para encerrar a sessão quando o endereço IP muda, para que uma sessão roubada não seja reutilizada. Entre novamente. É uma configuração do admin.
ACC-05 O que acontece após várias tentativas de login erradas?
O painel limita os logins com falha (configurado pelo admin). Passado o limite, você precisa esperar antes de tentar de novo.
ACC-06 Como uma conta demo difere de uma conta real?
Uma conta demo só mostra a interface: não pode alterar a senha, editar o perfil, criar códigos de ativação nem fazer nada que não possa ser desfeito.
ACC-07 Minha conta está "desativada". O que isso significa?
A conta acima de você a desligou: você não consegue entrar no painel e suas chaves de API são recusadas. As lines já vendidas não são excluídas. Fale com a conta acima de você.
ACC-08 Onde reviso o que eu e meus sub-revendedores fizemos?
Logs → Reseller Logs(quando o grupo pode ver logs): cada line ou dispositivo criado, editado, renovado, ativado / desativado ou excluído, cada sub-revendedor criado e cada transferência de créditos — com os créditos cobrados. Você só vê seus próprios registros e os das contas abaixo de você; o log não pode ser excluído (somente o admin). O livro de créditos (CRD) continua sendo o lugar para conciliar um saldo.
Créditos
CRDCRD-01 O que é um crédito?
A unidade pré-paga do painel. Toda venda (criar uma line, renovar, criar códigos de ativação, criar um sub-revendedor) consome créditos conforme o preço do pacote ou a taxa do grupo. Um crédito não é dinheiro e o painel não o converte: quanto vale um crédito é combinado entre você e a conta acima de você.
CRD-02 Como recarrego créditos?
Os créditos fluem de cima para baixo: o admin dá créditos a um revendedor, um revendedor os transfere a um sub-revendedor. O pagamento à conta acima de você acontece fora do painel.
CRD-03 Os créditos de quem são cobrados?
Sempre os daconta que executa a ação, mesmo quando a line é atribuída a um sub-revendedor abaixo.
CRD-04 Onde vejo meu histórico de créditos?
A páginaCredits: uma linha por movimentação, com data, valor, saldo posterior, motivo e quem fez. É o livro-razão — a fonte oficial do seu saldo.
CRD-05 E se eu não tiver créditos suficientes?
A ação inteira é recusada: nenhuma line é criada e nada é cobrado. Um saldo nunca fica negativo.
CRD-06 Se eu salvar duas vezes ou a rede cair, sou cobrado duas vezes?
Não. Cada pedido de venda leva um id de requisição (request_id); enviar o mesmo id novamente retorna o resultado anterior. Criar a line e cobrar os créditos sempre acontecem juntos ou são cancelados juntos.
CRD-07 Recebo créditos de volta ao excluir uma line?
CRD-08 Posso pegar de volta créditos que transferi a um sub-revendedor?
Sim: no formulário de edição do sub-revendedor, informe um número negativo no campo de transferência de créditos. Nenhum saldo pode ficar abaixo de 0.
CRD-09 Como sei de antemão quantas lines posso comprar?
O seletor de pacote do formulário de line mostra o seu preço. Pela API, a açãopricingretorna seu saldo, o preço de cada pacote e quantos você pode pagar.
Pacotes, bouquets e preços
PKGPKG-01 Qual a diferença entre um bouquet e um pacote?
Umbouqueté uma lista de conteúdo (canais, filmes, séries). Umpacoteé o produto que você vende: um ou mais bouquets, uma duração, um número de conexões, formatos de saída, bloqueios e um preço em créditos (preço oficial e preço de teste).
PKG-02 Por que não vejo determinado pacote?
Um pacote só pode ser vendido pelos grupos que o admin selecionou para ele. Um pacote que não é destinado ao seu grupo não aparece no seletor e é recusado quando enviado pela API.
PKG-03 Meu preço difere do preço do pacote. Por quê?
O admin pode definir umpreço própriopor revendedor para cada pacote (0 = grátis). O preço próprio vale para criar uma line oficial, renovar e códigos de ativação oficiais;nãovale para testes.
PKG-04 Quando o admin altera os bouquets de um pacote, as lines já vendidas mudam também?
Não. Os bouquets sãocopiados para a lineno momento da venda; editar o pacote depois não afeta as lines já vendidas. Uma line recebe os novos bouquets do pacote na próxima renovação / troca de pacote. (Quando o conteúdodentrode um bouquet muda, toda line que tem esse bouquet vê a mudança na hora. Excluir um bouquet remove seu id de todas as lines e pacotes. Alterar a ordem global dos bouquets só muda a ordem guardada nas lines vendidas quando você marca a caixa "aplicar a lines e pacotes vendidos"; o conjunto de bouquets de uma line não muda.)
PKG-05 Posso vender só uma parte de um pacote?
Somente quando seu grupo temAllow Bouquet Selectionativado: você marca uma parte dos bouquets do pacote; nada marcado = o pacote inteiro; bouquets fora do pacote são descartados. O preço não muda.
PKG-06 Quais propriedades de uma line são definidas pelo pacote?
A data de expiração (hoje + a duração do pacote), o número de conexões, formatos de saída, restreamer, bloqueio de dispositivo, país forçado, servidor forçado, bloqueio de ISP, bouquets. Valores que um revendedor informa nesses campos são ignorados, exceto os bouquets (PKG-05) e o bloqueio de ISP quando o grupo temAllow Line Restrictionsativado.
PKG-07 O que é um pacote "somente MAG" / "somente Enigma"?
Um pacote que só pode ser vendido para aquele tipo de set-top box; não pode ser vendido para uma line comum nem para o outro tipo de dispositivo. Por outro lado, um pacote precisa permitir o tipo de dispositivo para poder ser usado no formulário Add MAG / Add Enigma.
Lines: criar, editar, renovar, excluir
LINELINE-01 O que preciso para criar uma line?
Você precisa escolher um pacote que seu grupo possa vender e ter créditos suficientes. Usuário / senha: digite os seus (quando o grupo permite) ou deixe vazios para serem gerados. Um admin também pode deixar um deles (ou ambos) vazio ao criar uma line: o sistema gera 10 caracteres e os mostra logo após salvar; o formulário deediçãoainda exige um nome de usuário.
LINE-02 Por que não posso escolher o usuário / senha eu mesmo?
Seu grupo temAllow Username Change/Allow Password Changedesativado: uma nova line recebe valores gerados. Quando você pode digitar os seus, o tamanho mínimo é definido pelo grupo (8 caracteres por padrão).
LINE-03 Onde posso ver a senha de uma line novamente?
No formulário de edição da line e na janelaGenerate play linkda lista Lines. As senhas das lines são mantidas legíveis porque apps IPTV e links de playlist precisam delas. Uma senha gerada é mostrada logo após salvar.
LINE-04 Uma line antiga não mostra senha e o cliente não consegue entrar?
Algumas lines criadas por uma versão anterior do painel guardam apenas uma senha com hash. Uma line assimnão consegue entrare o painel não mostra senha para ela. Defina uma nova senha no formulário de edição da line e envie ao cliente.
LINE-05 O que um revendedor pode editar em uma line após a venda?
Ativar / desativar, notas do revendedor, contato, modelo de categoria, proprietário (dentro da sua própria árvore); usuário e senha quando o grupo permite; restrições (IPs, user agents, bloqueio de ISP) quando o grupo temAllow Line Restrictionsativado; uma nova seleção de bouquets dentro do pacote quando o grupo permite. O pacote, a data de expiração, o número de conexões, o indicador de teste, os formatos de saída, o bloqueio de dispositivo e o paísnãopodem ser editados diretamente — só mudam por meio de uma renovação / troca de pacote.
LINE-06 Como renovo uma line?
Duas formas, uma regra:
- o botãoRenew (charged)da lista: usa o pacote atual da line;
- o campoExtend with packagedo formulário de edição: escolha qualquer pacote que você possa vender (é também assim que vocêtroca de pacote).
Quando você edita uma line e escolhe uma renovação no mesmo salvamento, ambos sãouma só transação: se a renovação for recusada (créditos insuficientes, pacote não vendável), a ediçãotambém nãoé salva e nenhum crédito é cobrado. Corrija e salve novamente.
LINE-07 O tempo restante é mantido quando renovo?
- A linenão expiroue o novo pacote écompatívelcom o antigo → o tempo é somado à data de expiração atual.
- A lineexpirou, ou os dois pacotes não são compatíveis → conta a partir de hoje; o tempo restante não é mantido.
"Compatível" só é verificado quando o novo pacote tem a opção de verificação de compatibilidade ativada: os dois pacotes devem ter os mesmos bouquets, formatos de saída, número de conexões, indicador de restreamer e bloqueio de dispositivo. Com a opção desativada, sempre contam como compatíveis. Novos pacotes têm a opção ativada por padrão (o admin pode desativá-la); pacotes existentes mantêm sua configuração. Uma line MAG / Enigma só pode ser renovada com, ou trocada para, um pacote que permita esse tipo de box.
LINE-08 Como é cobrada uma troca de pacote (upgrade / downgrade)?
Uma troca de pacote = comprar um período oficial do novo pacote: é cobrado o preço integral do novo pacote (seu preço próprio, se houver), sem crédito pela parte não utilizada. A line assume todas as propriedades do novo pacote.
LINE-09 Qual a diferença entre desativar e excluir uma line?
Desativar: o cliente não consegue entrar nem assistir, as sessões em andamento são encerradas em cerca de um minuto; o período da assinatura continua correndo; você pode reativá-la a qualquer momento.Excluir: permanente, sem restauração, sem reembolso (DATA-01). Para um cliente que pausa, desative — não exclua.
LINE-10 O que significam os status de uma line?
| Status | Significado | Quem pode removê-lo |
|---|---|---|
| Active | utilizável | — |
| Disabled | desligada pelo revendedor / proprietário | revendedor |
| Banned | bloqueada pelo admin | somente admin |
| Expired | passou da data de expiração | uma renovação |
| Trial | uma line de teste, utilizável até o fim do período de teste | torna-se oficial na renovação |
LINE-11 O que acontece quando uma line expira?
O cliente é recusado até a line ser renovada (uma line que está expirada e banida vê o vídeo de "expirada", porque a expiração é verificada primeiro); as sessões em andamento são encerradas em cerca de um minuto. A linenãoé excluída automaticamente: renove-a e ela volta a funcionar com o mesmo usuário / senha.
LINE-12 Posso passar uma line a um sub-revendedor?
Sim: escolha uma conta abaixo de você como proprietária. O proprietário vê a line em sua própria lista. Os créditos continuam sendo cobrados de quem aperta salvar.
LINE-13 As lines de quem eu vejo?
As suas e as de todas as contas abaixo de você. Uma line fora da sua árvore não existe para você (a resposta é "não encontrado").
LINE-14 Para que servem os campos "Contact" e "Reseller notes"?
Para você lembrar quem é o cliente (e-mail, telefone, número do pedido). O assinante nunca os vê. Eles são apagados definitivamente quando a line é excluída.
LINE-15 Posso ver o que uma line está assistindo e de onde?
Quando o grupo tem a permissão:Logs → Line Activitymostra o histórico de visualização de cada line, eLogs → Live Connectionsmostra todas as conexões abertas das lines da sua árvore (qual line, qual canal, de qual endereço) com um botão para encerrá-la. Live Connections só abre quando o admin ativou, para o seu grupo, a opção de ver o histórico de conexões dos clientes (a caixaclient connection logsdo formulário do grupo); você nunca vê conexões de uma line fora da sua árvore.
LINE-16 Por que a lista Lines não mostra as lines de códigos de ativação?
LINE-17 A data de expiração do formulário da line inclui um horário? Admin
Sim. O campoExpires ondo formulário da line é uma datae horano fuso horário do painel, então uma line pode expirar em uma hora específica. Abrir o formulário e salvar sem tocar neste campo mantém a expiração ao segundo — editar uma nota ou os bouquets não dá tempo extra a uma line de teste por hora. Um valor que não pode ser lido é reportado no próprio campo e nunca vira "nunca expira". A página de edição em massa ainda aceita uma data, lida como o fim desse dia.
Testes
TRITRI-01 Quando posso criar uma line de teste?
Quandotodasestas condições valem: o admin não desativou testes para revendedores; o pacote tem um período de teste; seu grupo temAllowed Trials> 0; seus créditos são ≥ oMinimum Trial Creditsdo grupo; e o número de lines de teste que você criou dentro da janela de contagem não atingiu a cota.
TRI-02 Em que janela a cota de testes é contada?
Conforme definido no grupo:dia= as últimas 24 horas,mês= os últimos 30 dias. Exemplo, cota de 5 / dia: no máximo 5 lines de teste em quaisquer 24 horas. Um teste mais antigo libera sua vaga ao sair da janela.
TRI-03 Um teste custa créditos?
Exatamente o preço de teste do pacote (geralmente 0). O preço próprio de um revendedor não vale para testes.
TRI-04 Por que a caixa de teste está bloqueada?
TRI-05 Como transformo um teste em uma line oficial?
Renove a line com um pacote: a line recebe um período oficial e deixa de ser teste. Usuário e senha continuam os mesmos, o cliente não precisa configurar nada de novo.
Links de reprodução, apps e formatos
PLAYPLAY-01 Onde pego o link para meu cliente?
Lines → Generate play link: escolha o formato; o link é montado com o usuário e a senha da line. Pela API,get_lineretorna os links prontos:m3u,m3u_hls,xmltv,player_api,web_player.
PLAY-02 Quais apps um cliente pode usar? Espectador
Qualquer app que suporte aXtream Codes API(IPTV Smarters, TiviMate, XCIPTV, GSE…): informe o endereço do servidor + usuário + senha. Para um app que só aceita playlist, use o linkM3U. BoxesMAGusam o portal, boxesEnigma2usam uma playlist / plugin. Sem nenhum dispositivo, use oweb playerem um navegador.
PLAY-03 MPEG-TS ou HLS?
MPEG-TS: troca de canal rápida, adequado para apps IPTV e set-top boxes.HLS: funciona bem em navegadores, em dispositivos Apple e em redes instáveis. Uma line só pode usar os formatos que seu pacote permite; um link em formato não permitido é recusado.
PLAY-04 Quais tipos de playlist existem?
m3u_plus(com logotipos, grupos, ids de EPG — o padrão recomendado),m3usimples, os tipos para Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive e tipos de lista simples. Escolha um na janela Generate play link.
PLAY-05 De onde vem o guia de programação (EPG)? Espectador
Os apps Xtream o buscam sozinhos. Para um app M3U, use o linkXMLTVda line (uma playlistm3u_plusjá traz o endereço do EPG).
PLAY-06 Existe catch-up? Espectador
Sim, nos canais para os quais o admin ativou o arquivamento; os apps mostram um ícone de catch-up nesses canais.
PLAY-07 Onde fica o web player e como entro? Espectador
Em/player/no servidor de API (o linkweb_player). Entre com o usuário / senha da line ou com um código de ativação.
PLAY-08 Um link antigo ainda funciona depois que altero a senha da line?
Não. A senha faz parte do link e fica guardada no app; após uma troca de senha o cliente precisa digitá-la novamente / receber um novo link. É também assim que você corta quem usa uma line sem permissão.
PLAY-09 Posso usar meu próprio domínio nos links de reprodução?
Sim: definaYour own play addressna página da chave de API (ou com a ação de APIset_play_base). Você aponta o DNS do domínio para o servidor de API do painel,eo operador precisa configurar o lado dele; avise o admin antes de usar. O endereço vale para os links que a API retorna ao seu sistema.
Set-top boxes MAG / Enigma2
DEVDEV-01 Como adiciono um box MAG / Enigma?
Devices → Add MAG / Add Enigma: informe o MAC, escolha um pacote. O sistema vende uma nova line e vincula o dispositivo em um só passo; o dispositivo entra pelo MAC, ninguém precisa digitar usuário / senha. Os créditos são cobrados exatamente como em uma line comum.
DEV-02 O cliente já tem uma line e quer adicionar um box?
No formulário do dispositivo, escolha aline existentedo cliente em vez de um pacote: o dispositivo épareadocom essa line, sem custo. O cliente continua usando a line no app; o box segue o pacote, a expiração, os bouquets e o status da line.
DEV-03 Como as conexões são contadas para um app e um box pareados?
Elescompartilhamo limite de conexões: o app e o box são um só assinante.
DEV-04 Como renovo um box?
Renove a line dele (o link está no formulário do dispositivo). Para um dispositivo pareado, renove a line do cliente — o box acompanha sozinho.
DEV-05 O cliente troca o box por um novo?
Edite o MAC no dispositivo. Se a line tem o bloqueio de dispositivo ativado, apague o número de série / id do dispositivo registrado para que o novo box possa se registrar.
DEV-06 Excluir um dispositivo exclui a line?
Sim. Excluir um dispositivo exclui também sua line (com o histórico de conexões e eventos pendentes), como no painel antigo. Para manter uma line que foi paga, use o botãoConvert to line: o dispositivo é removido e a line vira uma line comum. Quando você exclui a line de um cliente, um dispositivo pareado continua existindo de forma independente, com uma line própria.
DEV-07 Um revendedor pode controlar um box remotamente?
Seus próprios boxesMAG, sim: enviar uma mensagem à TV, reproduzir um canal, recarregar o portal, reiniciar, encerrar as conexões da line (o grupo precisa da permissão para ver os logs de conexão dos clientes), redefinir o ISP registrado e redefinir o bloqueio de STB. Comandos X-Plugin e capturas de tela de boxesEnigma, banir um dispositivo e mover um dispositivo para outra line são somente do admin. Ativar / desativar o dispositivo de um revendedor ativa / desativa sua line; um revendedor não pode remover oBannedde um dispositivo.
Códigos de ativação
CODECODE-01 Para que serve um código de ativação?
Vender acesso como um código (um cartão raspadinha, um código enviado por mensagem): o cliente digita o código em um app ou no web player e pode assistir, sem usuário / senha. O períodosó começa quando o cliente ativa o código pela primeira vez.
CODE-02 Como crio códigos e quanto custam?
Active Codes → New: escolha o pacote, a quantidade (1–500 por lote), o tamanho do código (6–24), a opção somente dígitos (fácil de digitar com o controle remoto da TV), a opção de teste. Os créditos são cobradosna criação= preço do pacote × número de códigos. Cada código vem com uma line própria, bloqueada até a ativação.
CODE-03 Quais caracteres um código contém?
Letras maiúsculas e dígitos sem os facilmente confundíveis (0, O, 1, I); ou somente dígitos. Um cliente que digita em minúsculas ainda é aceito.
CODE-04 Em quantos dispositivos um código pode ser usado? Espectador
Um. O código fica vinculado ao primeiro dispositivo que o ativa; outro dispositivo que digite o mesmo código é recusado. Esse dispositivo pode digitar o código quantas vezes quiser, os dados de login da line não mudam.
CODE-05 E se o cliente trocar de dispositivo?
Reset devicenesse código; o novo dispositivo poderá então ativá-lo. Nenhum tempo é adicionado ao período.
CODE-06 O cliente recebe um erro ao digitar o código. O que significa? Espectador
| Mensagem | Significado | O que fazer |
|---|---|---|
INVALID_CODE | código errado / o código não existe | confira cada caractere; não digite os hifens |
DEVICE_MISMATCH | o código está vinculado a outro dispositivo | o revendedor redefine o dispositivo (CODE-05) |
DISABLED | o código está desligado | o revendedor o ativa novamente |
EXPIRED | o período acabou | comprar um código / estender |
Digitar vários códigos errados diferentes em sequência faz o endereço IP ser bloqueado por um tempo (SEC-08).
CODE-07 Como estendo um código que foi ativado?
Na páginaActive Codes, marque o código, escolha a açãoExtend (days)e informe o número de dias. Só um códigoativadorecebe dias (um código não usado ainda não iniciou seu período); um código ainda válido é estendido a partir da data de expiração atual, um expirado a partir de agora. Esta ação não cobra créditos. Pela API:extend_active_code.
CODE-08 Recebo créditos de volta ao excluir um código?
Um códigonão utilizadocriado pelo revendedor: reembolsado integralmente, com uma linha no livro de créditos. Um códigoativado: sem reembolso.
CODE-09 Como gerencio muitos códigos de uma vez?
A páginaBatchesmostra total / prontos / ativados / desativados de cada lote e exporta um arquivo TXT (um código por linha). Ações em massa: ativar, desativar, redefinir dispositivo, excluir.
CODE-10 A line de um código de ativação segue os limites do pacote?
Sim, como toda line vendida com esse pacote: número de conexões, formatos de saída, bouquets, bloqueio de dispositivo, restreamer e também opaís forçadodo pacote (SEC-07). Um cliente que ativa um código a partir de um país fora da lista permitida consegue ativá-lo, mas é recusado ao reproduzir.
Limites de conexão e os bloqueios que protegem uma line
SECSEC-01 Como "Max connections" é contado?
É o número de dispositivos assistindoao mesmo tempocom uma line. 0 = ilimitado. Abrir de novo o canal que você já está assistindo, a partir do mesmo dispositivo, não conta como outra conexão.
SEC-02 Quem é desconectado quando o limite é excedido? Espectador
Por padrão: anovaconexão entra e amais antigaé encerrada (dando preferência a uma conexão do mesmo dispositivo, depois do mesmo IP). O player encerrado para em cerca de 30 segundos. O admin pode mudar pararecusar a nova conexãoem vez de encerrar uma antiga.
SEC-03 O que é a regra do "segundo IP"?
Quando o admin a ativa: enquanto uma line está sendo assistida de um IP, uma conexão ao vivo de outro IP é recusada. A regra pode ser limitada a lines com poucas conexões (por exemplo lines com 1 conexão; uma line com conexões ilimitadas só é vinculada quando o limiar é 0). ComMatch The Address By Networkativado, endereços da mesma rede /24 (IPv6: /64) contam como um só espectador. É uma ferramenta contra o compartilhamento de contas.
SEC-04 Posso restringir uma line a certos IPs ou apps?
Quando o grupo temAllow Line Restrictionsativado: o campoAllowed IPs(um IP, uma faixa CIDR ou um nome de domínio, um por linha; um domínio é consultado no momento da conexão, então um IP dinâmico continua funcionando) eAllowed User-Agents. Vazio = tudo permitido. Observe: essas restrições bloqueiam nareprodução; o app ainda faz login e mostra a lista de canais.
SEC-05 O que é o bloqueio de ISP?
A line memoriza o provedor de internet da primeira conexão e recusa o uso a partir de outro provedor. Quando o cliente troca de provedor, desative e ative novamente o bloqueio de ISP para registrar o novo. Não se aplica a boxes MAG.
SEC-06 O que é o bloqueio de dispositivo?
Vincula a line ao primeiro set-top box que entra (número de série, id do dispositivo); outro box é recusado. Definido pelo pacote.
SEC-07 Como funciona a restrição de país?
Uma line só pode se conectar a partir de seu país forçado (ALL= qualquer lugar). Quando está vazio, vale a lista geral de países permitidos do painel. Um cliente que viaja ao exterior ou usa uma VPN pode ser recusado por esse motivo.
SEC-08 Por que um endereço IP está bloqueado? Espectador
- Automaticamente: logins com falha de um IP com muitos usuários / códigos de ativação diferentes em pouco tempo, ou uma enxurrada de requisições. Um bloqueio automático se desfaz sozinho após o tempo configurado pelo admin (60 minutos por padrão).
- Manualmente: o admin bloqueou o IP / faixa de IP; este não expira.
Enquanto um IP está bloqueado,nenhumaline consegue se conectar a partir dele. Errar repetidamente o mesmo usuário não causa bloqueio.
SEC-09 Por quais outros motivos uma conexão pode ser bloqueada?
O admin pode bloquear porUser-Agent(app), porprovedor de internet (ISP)e porASN(por exemplo faixas de hospedagem / VPN). Uma line para a qual o admin ativou "bypass UA" ignora a lista de bloqueio de apps.
SEC-10 O que é um restreamer?
Uma line para um parceiro que puxa os streams para redistribuí-los. Ela é isenta do limite de conexões, da regra do segundo IP, do encerramento automático de sessões longas e do bloqueio por ASN. Definido pelo pacote / pelo admin; não se destina a espectadores comuns.
SEC-11 Uma sessão contínua muito longa é cortada? Espectador
O admin pode definir uma duração máxima para uma sessão contínua; passado esse tempo a sessão é encerrada e o cliente aperta play para continuar. Uma sessão que perde o sinal por cerca de 90 segundos também conta como encerrada.
SEC-12 Como detecto uma line compartilhada ou roubada?
- A páginaTheft Detection(quando o grupo tem a permissão): classifica as lines pelo número de filmes / episódiosdiferentesassistidos em 1 hora / 24 horas / 7 dias, com o número de IPs diferentes — uma line com valor incomumente alto é suspeita.
- A página de atividade da line: mostra os IPs e dispositivos em uso.
- O que fazer: altere a senha da line (PLAY-08), ative a restrição de IP / bloqueio de ISP ou desative a line.
Sub-revendedores
SUBSUB-01 Posso criar sub-revendedores?
Quando seu grupo temCan Create Sub-Resellersativado e pelo menos um grupo emGroups for sub-resellers. Cada criação cobra a taxa de criação (créditos) definida no grupo. Uma árvore de revendedores tem no máximo 5 níveis de profundidade.
SUB-02 A que grupo um sub-revendedor pertence e o que ele pode fazer?
Você escolhe um grupo da lista que o admin permite; esse grupo define as permissões, os pacotes vendáveis e a cota de testes do sub-revendedor.
SUB-03 O que posso gerenciar em um sub-revendedor?
E-mail, nome, senha, status, grupo (da lista), notas, transferência / retomada de créditos e todas as lines abaixo dele. Você não pode alterar a função nem o proprietário dele.
SUB-04 O que um sub-revendedor vê do que é meu?
Nada: cada conta só vê o que está abaixo dela, nunca os níveis acima nem outros ramos.
SUB-05 Para onde vão as lines e os créditos de um sub-revendedor quando o excluo?
O grupo precisa terCan Delete Usersativado. Os créditos restantes, as lines e as contas filhas passam paraa conta que exclui. As lines dos clientes continuam funcionando. Os dados pessoais da conta excluída (usuário, e-mail, nome, senha, chaves de API, notas) são apagados; esse usuário e e-mail podem ser usados novamente.
SUB-06 Um novo sub-revendedor recebe um e-mail?
Quando o admin ativou o e-mail de boas-vindas: a nova conta recebe seu nome de login e um link de acesso. O e-mailnuncacontém a senha — você mesmo envia a senha.
Modelos de categoria
CATCAT-01 Para que serve um modelo de categoria?
Para reordenar, renomear ou ocultar as categorias (ao vivo, filmes, séries, rádio) que um cliente vê no app — por line, sem mexer nas categorias do próprio painel.
CAT-02 O que acontece quando oculto uma categoria?
Todo o conteúdo dessa categoria também fica oculto no app e na playlist das lines que usam o modelo.
CAT-03 Quando edito um modelo, as lines que o usam mudam?
Sim, na hora para toda line à qual o modelo está atribuído. Quando um modelo é excluído, suas lines voltam ao layout padrão.
CAT-04 Quais modelos posso ver e editar?
Ver: os seus e os das contas abaixo de você, modelos do sistema e modelos compartilhados pelos níveis acima. Editar: só os seus e os de quem está abaixo. Para ajustar um modelo do sistema,duplique-oe edite a cópia.
CAT-05 Limites que vale conhecer?
A ordem personalizada de categorias não vale para a parte de filmes / séries de uma playlist M3U (nomes e ocultação continuam valendo). Apps que usam a API Xtream recebem tudo.
API do revendedor, chaves de API, webhooks
APIAPI-01 Para que serve a API do revendedor?
Para o seu próprio sistema (loja web, cobrança, bot) vender e gerenciar lines / sub-revendedores sem abrir o dashboard. Endereço:{API}/reseller/v1, autenticado com o cabeçalhoX-API-Key. A documentação completa está em/docs/no servidor de API.
API-02 Onde consigo uma chave de API?
A páginaAPI Key. Uma chave é mostradauma vez, quando é criada — copie-a imediatamente. Se a perder, crie uma nova chave (a antiga para de funcionar).
API-03 Devo usar uma chave para todos os sistemas?
Melhor não. Crie umachave adicionalpor sistema: dê um nome, limite os IPs / CIDRs que podem usá-la, opcionalmente torne-asomente leitura(apenas listar e ver) e revogue-a separadamente sem afetar as outras chaves.
API-04 O que a API pode fazer?
| Necessidade | Ação |
|---|---|
| Saldo, preços, quantos você pode pagar, regras de usuário / teste | user_info,pricing,packages |
| Lines | get_lines,get_line,create_line,renew_line,change_package,edit_line,enable_line,disable_line,delete_line |
| Sub-revendedores | get_users,get_user,create_user,edit_user,adjust_credits,enable_user,disable_user,delete_user |
| Códigos de ativação | criar, listar, ativar / desativar, redefinir dispositivo, excluir |
| Webhooks, endereço de reprodução próprio, log de chamadas da API | create_webhook…,set_play_base,api_logs |
Toda regra do dashboard (grupo, preço próprio, cota de testes, escopo da árvore) vale pela API exatamente da mesma forma.
API-05 Se eu tentar de novo após um erro de rede, sou cobrado duas vezes?
Não, desde que você envie o mesmorequest_idpara a mesma transação: o sistema retorna o resultado anterior. Orequest_idde uma renovação évinculado a essa line: reutilizá-lo para outra line retorna um erro de conflito (HTTP 409) e a outra line não muda — gere um novorequest_idpara cada transação.
API-06 Minha integração não funciona. Como verifico sozinho?
A página API Key tem uma tabela dechamadas recentes da API(30 dias): ação, resultado, código de erro, endereço de origem, nome do conector. Os parâmetros nunca são registrados.
API-07 O que é um webhook e quais eventos existem?
O painel avisa seu sistema quando algo acontece, para que você não precise ficar perguntando. Eventos:line.created,line.renewed,line.enabled,line.disabled,line.deleted,line.expiring(3 dias antes),line.expired,credits.low(abaixo do limiar que você definiu). O endereço receptor deve ser https e acessível pela internet.
API-08 Como sei que um webhook é genuíno?
Toda notificação traz a assinaturaX-Xtream-Signature: sha256=HMAC(secret, timestamp.body); o segredo é mostrado uma vez, quando o endpoint é criado. Um webhook nunca contém uma senha.
API-09 O webhook parou de enviar?
Cada notificação é tentada 3 vezes; um endpoint que falha em 20 entregas seguidas é desligado. Corrija o seu lado, useSend teste então crie o endpoint novamente se ele foi desligado.
API-10 A API retorna as senhas das lines?
Sim, mas apenas ao proprietário da line (você e os níveis acima de você na árvore). Não guarde senhas de lines em logs nem as envie por um canal inseguro.
API-11 `edit_line` pode renovar uma line?
Sim, quando você enviapackage_idjunto (o nome antigopackagetambém é aceito): além da edição, a ação vende um período oficial desse pacote exatamente comochange_package— mesmo preço, mesmorequest_id, e a resposta trazcredits_charged. Edição e renovação são uma só transação: quando é recusada (créditos insuficientes, pacote inválido,trialenviado junto) nada muda.edit_linesempacote só edita usuário, senha, contato e notas e não toca no pacote nem na expiração.
API-12 Um script escrito para o painel antigo (PHP) funciona com esta API?
Não como está. A API mantém os nomes de ação familiares mas é uma nova interface: o endereço/reseller/v1, uma chave de API criada neste painel, ações de escrita enviadas com POST, erros retornados como status HTTP com um campoerror, e o resultado da criação de uma line emdata.line. Use a documentação em/docs/ou um conector pronto (CON-02).
Conectores para sistemas de loja / cobrança
CONCON-01 Como recebo o dinheiro dos meus clientes?
Com oseu própriosistema e gateway de pagamento. O painel não processa pagamentos. Um conector liga o sistema da sua loja ao painel: o cliente paga do seu lado → o conector chama a API do revendedor para criar / renovar a line.
CON-02 Para quais plataformas existe um conector?
WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress (WooCommerce / Easy Digital Downloads), Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext e uma "webhook bridge" para Shopify, Upmind e Invoice Ninja.
CON-03 Onde baixo e instalo um?
Barra lateralResources → All Connectors: cada conector tem uma descrição, os dados de conexão, os passos de instalação, um botãoDownloade o SHA-256 do arquivo para verificá-lo.
CON-04 Até que ponto os conectores foram testados?
Varia por conector, e a página de cada conector informa: alguns rodaram dentro da plataforma real (por exemplo WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), outros só tiveram seu núcleo testado. Leia a linha "how it was tested" e experimente em um ambiente de teste antes de vender de verdade.
CON-05 Um conector é seguro e o que ele faz com o painel?
CON-06 O que um conector pode vender?
Lines (criar, renovar, trocar de pacote, suspender, excluir) e contas de sub-revendedor com créditos.
Dados, exclusão e privacidade
DATADATA-01 Uma line excluída pode ser restaurada?
Não. Excluído é perdido: os dados da line (usuário, senha, contato, notas), seu histórico de conexões (IPs, dispositivos, o que foi assistido), os set-top boxes vinculados à line e seu código de ativação. Não há lixeira nem função ou API de restauração. Quando o cliente voltar, crie uma nova line.
DATA-02 O que o sistema guarda após uma exclusão?
Apenas um registro estatísticoanônimopara o operador (cliente novo ou recorrente, quais pacotes são populares). Ele não contém nada legível sobre o cliente e nenhum revendedor, conector ou API consegue acessá-lo.
DATA-03 Um backup pode trazer de volta uma line excluída?
Não. Os backups do banco de dados existem apenas para reconstruir o sistema após um incidente e ficam com o operador; não são usados para desfazer uma exclusão. Backups antigos são rotacionados, então os dados excluídos também desaparecem deles.
DATA-04 Por que a senha de uma line é legível e a de uma conta do painel não?
A senha de uma line precisa ser digitada nos apps e faz parte do link da playlist, então o painel a mantém legível para o proprietário da line. As senhas das contas do painel são armazenadas apenas com hash.
DATA-05 Quem pode ver minhas lines e clientes?
Você, as contas acima de você na sua árvore e o admin. Outros revendedores e os níveis abaixo de você não podem.
DATA-06 O painel envia e-mails / mensagens aos meus clientes?
Nunca. Os clientes de uma line pertencem ao revendedor; você os contata pelo seu próprio sistema.
DATA-07 Sou avisado antes de uma line expirar?
De duas formas: um e-mail diário com o resumo das lines prestes a expirar (quando o admin o ativou; 3 dias antes por padrão) e os webhooksline.expiring/line.expiredpara o seu sistema.
Solução de problemas
FIXVerifique de cima para baixo. A maioria dos problemas de "não consigo assistir" está nas 5 primeiras linhas.
FIX-01 O cliente não consegue entrar / não consegue assistir Espectador
| # | Verificar | Sinal | O que fazer |
|---|---|---|---|
| 1 | Usuário / senha | o app informa dados errados | compare com o formulário da line (diferencia maiúsculas, sem espaços); envie novamente o link deGenerate play link |
| 2 | Expiração | o app informaExpired | renove (LINE-06) |
| 3 | Status | Disabled/Banned | ative novamente; paraBannedfale com o admin |
| 4 | Endereço do servidor | não consegue conectar | use o endereço e a porta exatos do link de reprodução, e ohttp/httpscorreto |
| 5 | Número de conexões | derrubado quando outra pessoa começa a assistir | SEC-01,SEC-02 |
| 6 | IP bloqueado | nenhuma line entra a partir dessa rede | SEC-08: espere o bloqueio acabar ou peça ao admin que o remova |
| 7 | Bloqueio de ISP / país / Allowed IPs | falha só depois de trocar de rede, em dados móveis, com VPN ou em viagem | SEC-04,SEC-05,SEC-07 |
| 8 | Formato | o link HLS / TS é recusado | use um formato que o pacote permita (PLAY-03) |
| 9 | App bloqueado | falha em apenas um app | tente outro app;SEC-09 |
FIX-02 O login funciona e a lista aparece, mas um canal não reproduz Espectador
FIX-03 Canais ou grupos de canais estão faltando Espectador
Verifique os bouquets da line (PKG-04,PKG-05) e o modelo de categoria atribuído a ela (CAT-02). Após uma alteração, peça ao cliente que recarregue a lista no app. Um canal que o admin acabou de adicionar aparece após cerca de meio minuto; se um canal está no bouquet e nenhuma line o vê, o admin pode ter tirado esse canal do ar.
FIX-04 Travamentos, congelamentos Espectador
Tente em ordem: outro canal (um canal ou todos?) → outra rede → outro formato (HLS em vez de MPEG-TS) → outro app. Todo canal falha em toda rede → informe ao suporte o usuário, o horário e o canal.
FIX-05 Sem guia de programação (EPG) Espectador
FIX-06 Não consigo criar uma line
FIX-07 Baixar uma playlist retorna erro 429 ou uma página 404
FIX-08 Não consigo abrir uma página do dashboard
FIX-09 Não recebo e-mails do painel
O e-mail só é enviado quando o admin configurou um servidor de e-mail e ativou aquele tipo de mensagem; a conta precisa ter um endereço de e-mail real. Verifique a pasta de spam.
Glossário
- Line
- a assinatura IPTV de um espectador: usuário, senha, expiração, bouquets, limites
- User (usuário)
- uma conta que entra no painel: admin, revendedor, sub-revendedor
- Grupo
- o grupo de permissões de uma conta do painel; define menus, pacotes vendáveis, regras de line, testes
- Bouquet
- uma lista de conteúdo (canais, filmes, séries)
- Pacote
- o produto a vender: bouquets + duração + limites + preço em créditos
- Crédito
- a unidade pré-paga usada para comprar pacotes
- Teste (trial)
- o período de teste de um pacote
- Código de ativação
- um código com o qual o cliente ativa sozinho uma line paga
- MAG / Enigma2
- duas famílias de set-top boxes; entram pelo endereço MAC
- Xtream Codes API
- o protocolo que a maioria dos apps IPTV usa (servidor + usuário + senha)
- M3U / XMLTV
- formatos de arquivo de uma playlist / de um guia de programação
- MPEG-TS / HLS
- dois formatos de stream
- EPG
- o guia de programação
- Catch-up
- assistir a um programa depois de ele ter sido transmitido
- Restreamer
- uma line para um parceiro que puxa streams para redistribuí-los
- Conector
- software que liga o sistema de loja de um revendedor ao painel
- Webhook
- uma notificação que o painel envia ao sistema de um revendedor quando algo acontece
Nenhuma pergunta corresponde
Tente outra palavra-chave ou um código de pergunta, ou limpe o filtro.
Ainda travado?
Envie o nome de usuário da line (nunca a senha), quando aconteceu, o app ou dispositivo e o código da pergunta que você já tentou.