Início
Xtream UIPro

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

Algo não reproduz? A maioria dos problemas se resolve com o checklist de Solução de problemas. Comece por lá. Abrir solução de problemas

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ê

GEN
GEN-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-01
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-02
GEN-03 Quem é quem no sistema?
FunçãoQuem éOnde entra
Admino operador do paineldashboard
Revendedorvende lines; recebe créditos do admindashboard, API do revendedor
Sub-revendedorum revendedor criado abaixo de outro revendedordashboard, API do revendedor
Lineum assinante — o espectador finalapp IPTV, set-top box, web player.Nuncao dashboard
#GEN-03
GEN-04 Quais etapas levam um canal ao espectador?
  1. O admin monta o catálogo (canais, filmes, séries, rádio) e o agrupa embouquets.
  2. O admin cria umpacote: bouquets + duração + número de conexões + preço em créditos.
  3. Um revendedor gasta créditos para vender o pacote → o sistema cria umaline.
  4. 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-04
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-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-06
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.

#GEN-07

Contas do painel e login

ACC
ACC-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-01
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-02
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-03
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-04
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-05
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-06
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-07
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.

#ACC-08

Créditos

CRD
CRD-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-01
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-02
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-03
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-04
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-05
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-06
CRD-07 Recebo créditos de volta ao excluir uma line?

Não. Excluir uma line não reembolsa nada, mesmo que ainda tenha tempo restante. A única exceção: excluir umcódigo de ativação não utilizadocriado pelo revendedor é reembolsado (CODE-08).

#CRD-07
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-08
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.

#CRD-09

Pacotes, bouquets e preços

PKG
PKG-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-01
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-02
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-03
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-04
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-05
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-06
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.

#PKG-07

Lines: criar, editar, renovar, excluir

LINE
LINE-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-01
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-02
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-03
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-04
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-05
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-06
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-07
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-08
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-09
LINE-10 O que significam os status de uma line?
StatusSignificadoQuem pode removê-lo
Activeutilizável—
Disableddesligada pelo revendedor / proprietáriorevendedor
Bannedbloqueada pelo adminsomente admin
Expiredpassou da data de expiraçãouma renovação
Trialuma line de teste, utilizável até o fim do período de testetorna-se oficial na renovação
#LINE-10
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-11
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-12
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-13
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-14
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-15
LINE-16 Por que a lista Lines não mostra as lines de códigos de ativação?

Uma line que pertence a um código de ativação fica oculta da lista por padrão até você filtrar por ela (CODE-02).

#LINE-16
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.

#LINE-17

Testes

TRI
TRI-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-01
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-02
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-03
TRI-04 Por que a caixa de teste está bloqueada?

Uma das condições deTRI-01não foi atendida; o formulário informa o motivo ao lado da caixa.

#TRI-04
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.

#TRI-05
TRI-06 Posso dar outro período de teste a uma line existente?

Não. Um teste é concedidouma vez, quando a line é criada; uma line existente só pode ser renovada com um período oficial (TRI-05). Para deixar um cliente testar de novo, crie uma nova line de teste (ela conta na cota de testes).

#TRI-06

Links de reprodução, apps e formatos

PLAY
PLAY-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-01
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-02
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-03
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-04
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-05
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-06
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-07
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-08
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.

#PLAY-09
PLAY-10 Posso dar um link a várias pessoas?

Tecnicamente elas dividem uma só line, então dividem seunúmero de conexões(SEC-01) e podem esbarrar na regra do segundo IP (SEC-03). Cada cliente deve ter uma line própria.

#PLAY-10

Set-top boxes MAG / Enigma2

DEV
DEV-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-01
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-02
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-03
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-04
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-05
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-06
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.

#DEV-07

Códigos de ativação

CODE
CODE-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-01
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-02
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-03
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-04
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-05
CODE-06 O cliente recebe um erro ao digitar o código. O que significa? Espectador
MensagemSignificadoO que fazer
INVALID_CODEcódigo errado / o código não existeconfira cada caractere; não digite os hifens
DEVICE_MISMATCHo código está vinculado a outro dispositivoo revendedor redefine o dispositivo (CODE-05)
DISABLEDo código está desligadoo revendedor o ativa novamente
EXPIREDo período acaboucomprar 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-06
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-07
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-08
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-09
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.

#CODE-10

Limites de conexão e os bloqueios que protegem uma line

SEC
SEC-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-01
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-02
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-03
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-04
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-05
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-06
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-07
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-08
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-09
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-10
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-11
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.
#SEC-12

Sub-revendedores

SUB
SUB-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-01
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-02
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-03
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-04
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-05
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.

#SUB-06

Modelos de categoria

CAT
CAT-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-01
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-02
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-03
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-04
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.

#CAT-05

API do revendedor, chaves de API, webhooks

API
API-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-01
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-02
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-03
API-04 O que a API pode fazer?
NecessidadeAção
Saldo, preços, quantos você pode pagar, regras de usuário / testeuser_info,pricing,packages
Linesget_lines,get_line,create_line,renew_line,change_package,edit_line,enable_line,disable_line,delete_line
Sub-revendedoresget_users,get_user,create_user,edit_user,adjust_credits,enable_user,disable_user,delete_user
Códigos de ativaçãocriar, listar, ativar / desativar, redefinir dispositivo, excluir
Webhooks, endereço de reprodução próprio, log de chamadas da APIcreate_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-04
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-05
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-06
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-07
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-08
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-09
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-10
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-11
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).

#API-12

Conectores para sistemas de loja / cobrança

CON
CON-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-01
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-02
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-03
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-04
CON-05 Um conector é seguro e o que ele faz com o painel?

Um conector só chama a API do revendedor com asuachave de API — pode fazer exatamente o que você pode, nada mais. O código-fonte é aberto para você ler e conferir. Dê a cada conector uma chave própria com limite de IP (API-03).

#CON-05
CON-06 O que um conector pode vender?

Lines (criar, renovar, trocar de pacote, suspender, excluir) e contas de sub-revendedor com créditos.

#CON-06
CON-07 Ainda não há conector para a minha plataforma?

Integre você mesmo com a API do revendedor (API-01) e webhooks, ou envie um pedido pelo canal de suporte.

#CON-07

Dados, exclusão e privacidade

DATA
DATA-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-01
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-02
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-03
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-04
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-05
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-06
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.

#DATA-07

Solução de problemas

FIX

Verifique 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
#VerificarSinalO que fazer
1Usuário / senhao app informa dados erradoscompare com o formulário da line (diferencia maiúsculas, sem espaços); envie novamente o link deGenerate play link
2Expiraçãoo app informaExpiredrenove (LINE-06)
3StatusDisabled/Bannedative novamente; paraBannedfale com o admin
4Endereço do servidornão consegue conectaruse o endereço e a porta exatos do link de reprodução, e ohttp/httpscorreto
5Número de conexõesderrubado quando outra pessoa começa a assistirSEC-01,SEC-02
6IP bloqueadonenhuma line entra a partir dessa redeSEC-08: espere o bloqueio acabar ou peça ao admin que o remova
7Bloqueio de ISP / país / Allowed IPsfalha só depois de trocar de rede, em dados móveis, com VPN ou em viagemSEC-04,SEC-05,SEC-07
8Formatoo link HLS / TS é recusadouse um formato que o pacote permita (PLAY-03)
9App bloqueadofalha em apenas um apptente outro app;SEC-09
#FIX-01
FIX-02 O login funciona e a lista aparece, mas um canal não reproduz Espectador

Geralmente um dos bloqueios de reprodução (linhas 5–9 deFIX-01): o login e a lista de canais não verificam o IP / app, só a reprodução. Se sóumcanal falha em todas as lines → o canal de origem tem um problema; informe ao admin o nome do canal e o horário.

#FIX-02
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-03
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-04
FIX-05 Sem guia de programação (EPG) Espectador

Um app M3U precisa que o link XMLTV seja adicionado (PLAY-05). Um canal sem EPG na origem não mostra programação.

#FIX-05
FIX-06 Não consigo criar uma line

Em ordem: nenhum pacote escolhido · o pacote não é para o seu grupo (PKG-02) · créditos insuficientes (CRD-05) · o usuário já existe ou é menor que o mínimo (LINE-02) · a cota de testes acabou (TRI-01).

#FIX-06
FIX-07 Baixar uma playlist retorna erro 429 ou uma página 404

429: a line está baixando playlists / arquivos EPG demais ao mesmo tempo — espere e tente novamente. Página 404: o sistema responde 404 paratodarecusa (dados errados, expirada, bloqueada, acima de um limite) para não revelar o motivo a estranhos; verifique comFIX-01.

#FIX-07
FIX-08 Não consigo abrir uma página do dashboard

Seu grupo não tem permissão para essa página (ACC-02).Live Connectionsexige ainda que o admin ative, para o grupo, a opção de ver as conexões dos clientes (LINE-15).

#FIX-08
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.

#FIX-09

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

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.