Centro assistenza
Domande e risposte
Come funzionano crediti, pacchetti, linee, link di riproduzione e dispositivi, e cosa controllare quando qualcosa non va in riproduzione.
139 di 139 domande
Come usare questa pagina
Ogni domanda ha un codice fisso (ad esempioLINE-07). Citalo quando contatti l'assistenza, oppure copia il link alla domanda.
I nomi di menu, pulsanti e campi sono scritti come li mostra il pannello. Unutenteè un account che accede al pannello (admin, reseller); unalineaè l'abbonamento IPTV di uno spettatore. I due concetti non vanno mai confusi.
- Spettatore Un reseller può inoltrare questa risposta così com'è a uno spettatore
- Admin Per l'operatore del pannello
Panoramica del servizio e chi è responsabile di cosa
GENGEN-01 Che cosa offre questo servizio?
Un sistema OTT / IPTV completo: il pannello di amministrazione (dashboard), il server API per le app degli spettatori, la distribuzione di canali live, film, serie e radio, e un web player. Noi forniamo e manteniamo il sistema; i reseller lo usano per dare ai propri clienti il diritto di guardare (le linee).
GEN-02 Che cosa non fa il servizio?
- Non incassa denaro al posto tuo e non ha un gateway di pagamento. Il prezzo per i tuoi clienti, come vieni pagato e la fatturazione sono affari del reseller (vediCON-01).
- Non contatta gli spettatori di un reseller. Il pannello invia email solo agli account del pannello, mai a una linea.
- Non conserva i dati personali di un cliente eliminato e non ha una funzione di ripristino (vediDATA-01).
GEN-03 Chi è chi nel sistema?
| Ruolo | Chi è | Dove accede |
|---|---|---|
| Admin | l'operatore del pannello | dashboard |
| Reseller | vende linee; riceve crediti dall'admin | dashboard, Reseller API |
| Sub-reseller | un reseller creato sotto un altro reseller | dashboard, Reseller API |
| Linea | un abbonato — lo spettatore finale | app IPTV, set-top box, web player.Maila dashboard |
GEN-04 Quali passaggi portano un canale allo spettatore?
- L'admin costruisce il catalogo (canali, film, serie, radio) e lo raggruppa inbouquet.
- L'admin crea unpacchetto: bouquet + durata + numero di connessioni + prezzo in crediti.
- Un reseller spende crediti per vendere il pacchetto → il sistema crea unalinea.
- Il cliente inserisce i dati della linea in un'app; il sistema verifica la linea (non scaduta, abilitata, entro i suoi limiti) e riproduce da un server adatto.
GEN-05 Che cosa può fare un reseller con i contenuti e che cosa no?
Un reseller puòvederegli elenchi di canali, film, serie, radio, bouquet e pacchetti (quando il suo gruppo ha il permesso), ma non può aggiungere, modificare o eliminare contenuti. Contenuti e pacchetti sono gestiti dall'admin. Il reseller decide cosa può guardare ogni cliente scegliendo il pacchetto (e i bouquet, quando il gruppo lo consente —PKG-05).
GEN-06 Dove trovo assistenza?
La voceSupportdella barra laterale apre il sito di assistenza separato. Il pannello non ha un sistema di ticket proprio. Quando invii una richiesta, includi: lo username della linea (mai la password), quando è successo, l'app / dispositivo e il codice della domanda di questa pagina se l'hai già provata.
GEN-07 Quali lingue ha l'interfaccia?
Il pannello, il web player e questa pagina di aiuto hanno un selettore di lingua con 27 lingue. Inglese e vietnamita sono le traduzioni di riferimento; nelle altre lingue una schermata appena aggiunta può restare in inglese per un po'. Le email inviate dal pannello sono attualmente solo in inglese.
Account del pannello e accesso
ACCACC-01 Perché il mio cliente non può accedere alla dashboard?
È voluto: una linea non è un account del pannello. Un cliente usa i dati della linea solo in un'app IPTV, in un set-top box o nel web player. Allo stesso modo, un account reseller non può essere usato per guardare i canali.
ACC-02 Vedo meno menu di quelli descritti in questa pagina. Perché?
Menu e azioni dipendono dalgruppoche l'admin ha assegnato al tuo account. Una pagina per cui il tuo gruppo non ha il permesso non compare nella barra laterale e non si può aprire. Chiedi all'admin più permessi.
ACC-03 Dove cambio la password del mio pannello?
Nell'area dell'account (profilo → cambia password). Le password del pannello sono salvate con hash; nessuno può rileggerle, nemmeno l'admin. Se la dimentichi, chiedi all'account sopra di te (il tuo reseller superiore o l'admin) di impostarne una nuova.
ACC-04 Perché vengo disconnesso quando cambio rete?
Il pannello può essere configurato per terminare una sessione quando cambia il suo indirizzo IP, così una sessione rubata non può essere riutilizzata. Accedi di nuovo. È un'impostazione dell'admin.
ACC-05 Che cosa succede dopo diversi tentativi di accesso errati?
Il pannello limita gli accessi falliti (configurato dall'admin). Oltre il limite devi attendere prima di riprovare.
ACC-06 In cosa un account demo è diverso da uno reale?
Un account demo mostra solo l'interfaccia: non può cambiare la password, modificare il profilo, creare codici di attivazione né fare nulla che non si possa annullare.
ACC-07 Il mio account è "disabled". Che cosa significa?
L'account sopra di te lo ha disattivato: non puoi accedere al pannello e le tue chiavi API vengono rifiutate. Le linee già vendute non vengono eliminate. Contatta l'account sopra di te.
ACC-08 Dove controllo cosa hanno fatto io e i miei sub-reseller?
Logs → Reseller Logs(quando il gruppo può vedere i log): ogni linea o dispositivo creato, modificato, rinnovato, abilitato / disabilitato o eliminato, ogni sub-reseller creato e ogni trasferimento di crediti — con i crediti addebitati. Vedi solo le tue voci e quelle degli account sotto di te; il log non può essere eliminato (solo admin). Il registro dei crediti (CRD) resta il posto dove riconciliare un saldo.
Crediti
CRDCRD-01 Che cos'è un credito?
L'unità prepagata del pannello. Ogni vendita (creare una linea, rinnovare, creare codici di attivazione, creare un sub-reseller) preleva crediti in base al prezzo del pacchetto o alla tariffa del gruppo. Un credito non è denaro e il pannello non lo converte: quanto vale un credito si concorda tra te e l'account sopra di te.
CRD-02 Come ricarico i crediti?
I crediti scendono dall'alto verso il basso: l'admin dà crediti a un reseller, un reseller li trasferisce a un sub-reseller. Il pagamento all'account sopra di te avviene fuori dal pannello.
CRD-03 I crediti di chi vengono addebitati?
Sempre quellidell'account che esegue l'azione, anche quando la linea è assegnata a un sub-reseller sottostante.
CRD-04 Dove vedo la cronologia dei miei crediti?
La paginaCredits: una riga per movimento, con data, importo, saldo successivo, motivo e chi l'ha eseguito. È il registro — la fonte autorevole per il tuo saldo.
CRD-05 E se non ho abbastanza crediti?
L'intera azione viene rifiutata: nessuna linea viene creata e non viene addebitato nulla. Un saldo non va mai in negativo.
CRD-06 Se premo salva due volte o la rete cade, vengo addebitato due volte?
No. Ogni richiesta di vendita porta un request id (request_id); inviando di nuovo lo stesso id si ottiene il risultato precedente. La creazione della linea e l'addebito dei crediti riescono sempre insieme o vengono annullati insieme.
CRD-07 Ricevo indietro i crediti quando elimino una linea?
CRD-08 Posso riprendermi i crediti trasferiti a un sub-reseller?
Sì: nel modulo di modifica del sub-reseller, inserisci un numero negativo nel campo del trasferimento di crediti. Nessun saldo può scendere sotto 0.
CRD-09 Come so in anticipo quante linee posso acquistare?
Il selettore del pacchetto nel modulo della linea mostra il tuo prezzo. Tramite l'API, l'azionepricingrestituisce il tuo saldo, il prezzo di ogni pacchetto e quanti te ne puoi permettere.
Pacchetti, bouquet e prezzi
PKGPKG-01 Qual è la differenza tra un bouquet e un pacchetto?
Unbouquetè un elenco di contenuti (canali, film, serie). Unpacchettoè il prodotto che vendi: uno o più bouquet, una durata, un numero di connessioni, formati di output, blocchi e un prezzo in crediti (prezzo ufficiale e prezzo della prova).
PKG-02 Perché non vedo un certo pacchetto?
Un pacchetto può essere venduto solo dai gruppi che l'admin ha selezionato. Un pacchetto non destinato al tuo gruppo non compare nel selettore e viene rifiutato se inviato tramite l'API.
PKG-03 Il mio prezzo è diverso dal prezzo del pacchetto. Perché?
L'admin può impostare unprezzo proprioper reseller per ogni pacchetto (0 = gratis). Il prezzo proprio vale per la creazione di una linea ufficiale, il rinnovo e i codici di attivazione ufficiali;nonvale per le prove.
PKG-04 Se l'admin cambia i bouquet di un pacchetto, cambiano anche le linee già vendute?
No. I bouquet vengonocopiati nella lineaal momento della vendita; modificare il pacchetto in seguito non influisce sulle linee già vendute. Una linea riceve i nuovi bouquet del pacchetto al successivo rinnovo / cambio di pacchetto. (Quando cambia il contenutoall'internodi un bouquet, ogni linea che possiede quel bouquet lo vede subito. Eliminare un bouquet rimuove il suo id da ogni linea e pacchetto. Cambiare l'ordine globale dei bouquet modifica l'ordine salvato sulle linee vendute solo se spunti la casella "applica a linee e pacchetti venduti"; l'insieme dei bouquet di una linea non cambia.)
PKG-05 Posso vendere solo una parte di un pacchetto?
Solo quando il tuo gruppo haAllow Bouquet Selectionattivo: spunti una parte dei bouquet del pacchetto; nessuna spunta = l'intero pacchetto; i bouquet fuori dal pacchetto vengono scartati. Il prezzo non cambia.
PKG-06 Quali proprietà di una linea sono decise dal pacchetto?
La data di scadenza (oggi + la durata del pacchetto), il numero di connessioni, i formati di output, il restreamer, il blocco del dispositivo, il paese forzato, il server forzato, il blocco ISP, i bouquet. I valori che un reseller inserisce per questi campi vengono ignorati, tranne i bouquet (PKG-05) e il blocco ISP quando il gruppo haAllow Line Restrictionsattivo.
PKG-07 Che cos'è un pacchetto "MAG only" / "Enigma only"?
Un pacchetto che può essere venduto solo per quel tipo di set-top box; non può essere venduto per una linea ordinaria né per l'altro tipo di dispositivo. Viceversa, un pacchetto deve consentire il tipo di dispositivo prima di poter essere usato nel modulo Add MAG / Add Enigma.
Linee: creare, modificare, rinnovare, eliminare
LINELINE-01 Di che cosa ho bisogno per creare una linea?
Devi scegliere un pacchetto che il tuo gruppo può vendere e avere crediti sufficienti. Username / password: digita i tuoi (quando il gruppo lo consente) o lasciali vuoti per farli generare. Un admin può anche lasciare vuoto uno dei due (o entrambi) durante la creazione di una linea: il sistema genera 10 caratteri e li mostra subito dopo il salvataggio; il modulo dimodificarichiede comunque uno username.
LINE-02 Perché non posso scegliere io username / password?
Il tuo gruppo haAllow Username Change/Allow Password Changedisattivati: una nuova linea riceve valori generati. Quando puoi digitare i tuoi, la lunghezza minima è stabilita dal gruppo (8 caratteri per impostazione predefinita).
LINE-03 Dove posso rivedere la password di una linea?
Nel modulo di modifica della linea e nella finestraGenerate play linkdell'elenco Lines. Le password delle linee sono conservate in chiaro perché le app IPTV e i link delle playlist ne hanno bisogno. Una password generata viene mostrata subito dopo il salvataggio.
LINE-04 Una vecchia linea non mostra la password e il cliente non riesce ad accedere?
Alcune linee create da una versione precedente del pannello contengono solo una password con hash. Una linea cosìnon può accederee il pannello non mostra alcuna password. Imposta una nuova password nel modulo di modifica della linea e inviala al cliente.
LINE-05 Che cosa può modificare un reseller su una linea dopo la vendita?
Abilitare / disabilitare, note del reseller, contatto, modello di categoria, proprietario (all'interno del tuo albero); username e password quando il gruppo lo consente; restrizioni (IP, user agent, blocco ISP) quando il gruppo haAllow Line Restrictionsattivo; una nuova selezione di bouquet all'interno del pacchetto quando il gruppo lo consente. Pacchetto, data di scadenza, numero di connessioni, flag di prova, formati di output, blocco dispositivo e paesenonsono modificabili direttamente — cambiano solo tramite un rinnovo / cambio di pacchetto.
LINE-06 Come rinnovo una linea?
Due modi, una sola regola:
- il pulsanteRenew (charged)dell'elenco: usa il pacchetto attuale della linea;
- il campoExtend with packagedel modulo di modifica: scegli qualsiasi pacchetto che puoi vendere (è anche il modo percambiare pacchetto).
Quando modifichi una linea e scegli un rinnovo nello stesso salvataggio, i due sonoun'unica transazione: se il rinnovo viene rifiutato (crediti insufficienti, pacchetto non vendibile), nemmeno la modifica viene salvata e non viene addebitato alcun credito. Correggi e salva di nuovo.
LINE-07 Il tempo residuo viene mantenuto quando rinnovo?
- La lineanon è scadutae il nuovo pacchetto ècompatibilecon il vecchio → il tempo viene aggiunto all'attuale data di scadenza.
- La lineaè scaduta, oppure i due pacchetti non sono compatibili → si conta da oggi; l'eventuale tempo residuo non viene mantenuto.
La "compatibilità" viene verificata solo quando il nuovo pacchetto ha attiva l'opzione di controllo della compatibilità: entrambi i pacchetti devono avere gli stessi bouquet, formati di output, numero di connessioni, flag restreamer e blocco dispositivo. Con l'opzione disattivata sono sempre considerati compatibili. I nuovi pacchetti hanno l'opzione attiva per impostazione predefinita (l'admin può disattivarla); i pacchetti esistenti mantengono la loro impostazione. Una linea MAG / Enigma può essere rinnovata o cambiata solo con un pacchetto che consente quel tipo di box.
LINE-08 Come viene addebitato un cambio di pacchetto (upgrade / downgrade)?
Un cambio di pacchetto = l'acquisto di un periodo ufficiale del nuovo pacchetto: viene addebitato il prezzo pieno del nuovo pacchetto (il tuo prezzo proprio se ne hai uno), senza credito per la parte non utilizzata. La linea assume ogni proprietà del nuovo pacchetto.
LINE-09 Qual è la differenza tra disabilitare ed eliminare una linea?
Disable: il cliente non può accedere né guardare, le sessioni in corso vengono chiuse entro circa un minuto; il periodo di abbonamento continua a scorrere; puoi riabilitarla in qualsiasi momento.Delete: permanente, nessun ripristino, nessun rimborso (DATA-01). Per un cliente che mette in pausa, disabilita — non eliminare.
LINE-10 Che cosa significano gli stati di una linea?
| Stato | Significato | Chi può rimuoverlo |
|---|---|---|
| Active | utilizzabile | — |
| Disabled | disattivata dal reseller / proprietario | reseller |
| Banned | bloccata dall'admin | solo admin |
| Expired | oltre la data di scadenza | un rinnovo |
| Trial | una linea di prova, utilizzabile fino alla fine del periodo di prova | diventa ufficiale con il rinnovo |
LINE-11 Che cosa succede quando una linea scade?
Il cliente viene rifiutato finché la linea non viene rinnovata (una linea sia scaduta sia bannata vede la clip "scaduta", perché la scadenza viene controllata per prima); le sessioni in corso vengono chiuse entro circa un minuto. La lineanonviene eliminata automaticamente: rinnovala e funziona di nuovo con lo stesso username / password.
LINE-12 Posso passare una linea a un sub-reseller?
Sì: scegli un account sotto di te come proprietario. Il proprietario vede la linea nel proprio elenco. I crediti vengono comunque addebitati a chi preme salva.
LINE-13 Le linee di chi vedo?
Le tue e quelle di ogni account sotto di te. Una linea fuori dal tuo albero per te non esiste (la risposta è "non trovata").
LINE-14 A cosa servono i campi "Contact" e "Reseller notes"?
Per ricordarti chi è il cliente (email, numero di telefono, numero d'ordine). L'abbonato non li vede mai. Vengono cancellati definitivamente quando la linea viene eliminata.
LINE-15 Posso vedere cosa sta guardando una linea e da dove?
Quando il gruppo ha il permesso:Logs → Line Activitymostra la cronologia di visione di ogni linea, eLogs → Live Connectionsmostra ogni connessione aperta delle linee nel tuo albero (quale linea, quale canale, da quale indirizzo) con un pulsante per chiuderla. Live Connections si apre solo quando l'admin ha attivato, per il tuo gruppo, l'opzione per vedere la cronologia delle connessioni dei clienti (la casellaclient connection logsdel modulo del gruppo); non vedi mai le connessioni di una linea fuori dal tuo albero.
LINE-16 Perché l'elenco Lines non mostra le linee dei codici di attivazione?
LINE-17 La data di scadenza del modulo della linea include un'ora? Admin
Sì. Il campoExpires ondel modulo della linea è una datae oranel fuso orario del pannello, quindi una linea può scadere a un'ora precisa. Aprire il modulo e salvare senza toccare questo campo mantiene la scadenza al secondo — modificare una nota o i bouquet non dà tempo extra a una linea di prova a ore. Un valore non leggibile viene segnalato sul campo stesso e non diventa mai "non scade mai". La pagina di modifica di massa accetta ancora una data, letta come fine di quel giorno.
Prove
TRITRI-01 Quando posso creare una linea di prova?
Quandotuttequeste condizioni sono vere: l'admin non ha disattivato le prove per i reseller; il pacchetto ha un periodo di prova; il tuo gruppo haAllowed Trials> 0; i tuoi crediti sono ≥ alMinimum Trial Creditsdel gruppo; e il numero di linee di prova create nella finestra di conteggio non ha raggiunto la quota.
TRI-02 Su quale finestra viene conteggiata la quota delle prove?
Come impostato sul gruppo:giorno= le ultime 24 ore,mese= gli ultimi 30 giorni. Esempio, una quota di 5 / giorno: al massimo 5 linee di prova in qualsiasi arco di 24 ore. Una prova più vecchia libera il suo posto quando esce dalla finestra.
TRI-03 Una prova costa crediti?
Esattamente il prezzo di prova del pacchetto (di solito 0). Il prezzo proprio di un reseller non vale per le prove.
TRI-04 Perché la casella della prova è bloccata?
TRI-05 Come trasformo una prova in una linea ufficiale?
Rinnova la linea con un pacchetto: la linea riceve un periodo ufficiale e non è più una prova. Username e password restano gli stessi, il cliente non deve configurare nulla di nuovo.
TRI-06 Posso dare a una linea esistente un altro periodo di prova?
Link di riproduzione, app e formati
PLAYPLAY-01 Dove prendo il link per il mio cliente?
Lines → Generate play link: scegli il formato; il link viene costruito con username e password della linea. Tramite l'API,get_linerestituisce i link già pronti:m3u,m3u_hls,xmltv,player_api,web_player.
PLAY-02 Quali app può usare un cliente? Spettatore
Qualsiasi app che supporti laXtream Codes API(IPTV Smarters, TiviMate, XCIPTV, GSE…): inserisci indirizzo del server + username + password. Per un'app che accetta solo una playlist, usa il linkM3U. I boxMAGusano il portale, i boxEnigma2usano una playlist / plugin. Senza alcun dispositivo, usa ilweb playerin un browser.
PLAY-03 MPEG-TS o HLS?
MPEG-TS: cambio canale veloce, adatto ad app IPTV e set-top box.HLS: funziona bene nei browser, sui dispositivi Apple e su reti instabili. Una linea può usare solo i formati consentiti dal suo pacchetto; un link in un formato non consentito viene rifiutato.
PLAY-04 Quali tipi di playlist esistono?
m3u_plus(con loghi, gruppi, id EPG — l'impostazione predefinita consigliata),m3usemplice, i tipi per Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive e tipi di elenco semplici. Scegline uno nella finestra Generate play link.
PLAY-05 Da dove arriva la guida ai programmi (EPG)? Spettatore
Le app Xtream la scaricano da sole. Per un'app M3U, usa il linkXMLTVdella linea (una playlistm3u_pluscontiene già l'indirizzo dell'EPG).
PLAY-06 C'è il catch-up? Spettatore
Sì, sui canali per cui l'admin ha attivato l'archiviazione; le app mostrano un'icona di catch-up su quei canali.
PLAY-07 Dov'è il web player e come accedo? Spettatore
In/player/sul server API (il linkweb_player). Accedi con username / password della linea, oppure con un codice di attivazione.
PLAY-08 Un vecchio link funziona ancora dopo che cambio la password della linea?
No. La password fa parte del link ed è memorizzata nell'app; dopo un cambio di password il cliente deve reinserirla / ottenere un nuovo link. È anche il modo per tagliare fuori chi usa una linea senza permesso.
PLAY-09 Posso usare un mio dominio per i link di riproduzione?
Sì: impostaYour own play addressnella pagina della chiave API (o con l'azione APIset_play_base). Fai puntare il DNS del dominio al server API del pannello,el'operatore deve configurare la sua parte; avvisa l'admin prima di usarlo. L'indirizzo si applica ai link che l'API restituisce al tuo sistema.
Set-top box MAG / Enigma2
DEVDEV-01 Come aggiungo un box MAG / Enigma?
Devices → Add MAG / Add Enigma: inserisci il MAC, scegli un pacchetto. Il sistema vende una nuova linea e collega il dispositivo in un solo passaggio; il dispositivo accede tramite il suo MAC, nessuno deve digitare username / password. I crediti vengono addebitati esattamente come per una linea ordinaria.
DEV-02 Il cliente ha già una linea e vuole aggiungere un box?
Nel modulo del dispositivo, scegli lalinea esistentedel cliente invece di un pacchetto: il dispositivo vieneabbinatoa quella linea, gratuitamente. Il cliente continua a usare la linea nell'app; il box segue pacchetto, scadenza, bouquet e stato della linea.
DEV-03 Come vengono conteggiate le connessioni per un'app e un box abbinati?
Condividonoil limite di connessioni: l'app e il box sono un solo abbonato.
DEV-04 Come rinnovo un box?
Rinnova la sua linea (il link è nel modulo del dispositivo). Per un dispositivo abbinato, rinnova la linea del cliente — il box la segue da solo.
DEV-05 Il cliente sostituisce il box con uno nuovo?
Modifica il MAC sul dispositivo. Se la linea ha il blocco dispositivo attivo, cancella il numero di serie / id del dispositivo registrato così il nuovo box può registrarsi.
DEV-06 Eliminare un dispositivo elimina la linea?
Sì. Eliminare un dispositivo elimina anche la sua linea (con la cronologia delle connessioni e gli eventi in sospeso), come nel vecchio pannello. Per conservare una linea pagata, usa il pulsanteConvert to line: il dispositivo viene rimosso e la linea diventa una linea ordinaria. Quando elimini la linea di un cliente, un dispositivo abbinato continua a vivere in modo indipendente con una linea propria.
DEV-07 Un reseller può controllare un box da remoto?
I propri boxMAG, sì: inviare un messaggio alla TV, riprodurre un canale, ricaricare il portale, riavviare, chiudere le connessioni della linea (il gruppo ha bisogno del permesso di vedere i log di connessione dei clienti), azzerare l'ISP registrato e azzerare il blocco STB. Comandi X-Plugin e screenshot dei boxEnigma, il ban di un dispositivo e lo spostamento di un dispositivo su un'altra linea sono solo per l'admin. Abilitare / disabilitare il dispositivo di un reseller abilita / disabilita la sua linea; un reseller non può rimuovereBannedda un dispositivo.
Codici di attivazione
CODECODE-01 A cosa serve un codice di attivazione?
Vendere l'accesso come codice (un gratta e vinci, un codice inviato per messaggio): il cliente inserisce il codice in un'app o nel web player e può guardare, senza username / password. Il periodoinizia solo quando il cliente attiva il codice per la prima volta.
CODE-02 Come creo i codici e quanto costano?
Active Codes → New: scegli il pacchetto, la quantità (1–500 per lotto), la lunghezza del codice (6–24), l'opzione solo cifre (facile da digitare con il telecomando della TV), l'opzione di prova. I crediti vengono addebitatialla creazione= prezzo del pacchetto × numero di codici. Ogni codice ha una propria linea, bloccata fino all'attivazione.
CODE-03 Quali caratteri contiene un codice?
Lettere maiuscole e cifre senza quelle facilmente confondibili (0, O, 1, I); oppure solo cifre. Un cliente che digita in minuscolo viene comunque accettato.
CODE-04 Su quanti dispositivi si può usare un codice? Spettatore
Uno. Il codice è legato al primo dispositivo che lo attiva; un altro dispositivo che inserisce lo stesso codice viene rifiutato. Quel dispositivo può inserire il codice quante volte vuole, i dati di accesso della linea non cambiano.
CODE-05 E se il cliente cambia dispositivo?
Reset devicesu quel codice; il nuovo dispositivo potrà poi attivarlo. Non viene aggiunto tempo al periodo.
CODE-06 Il cliente riceve un errore inserendo il codice. Che cosa significa? Spettatore
| Messaggio | Significato | Cosa fare |
|---|---|---|
INVALID_CODE | codice errato / il codice non esiste | controlla ogni carattere; non digitare i trattini |
DEVICE_MISMATCH | il codice è legato a un altro dispositivo | il reseller azzera il dispositivo (CODE-05) |
DISABLED | il codice è disattivato | il reseller lo riabilita |
EXPIRED | il periodo è finito | acquista un codice / estendi |
Inserire di seguito diversi codici errati porta al blocco dell'indirizzo IP per un po' (SEC-08).
CODE-07 Come estendo un codice che è stato attivato?
Nella paginaActive Codes, spunta il codice, scegli l'azioneExtend (days)e inserisci il numero di giorni. Solo un codiceattivatoriceve giorni (un codice non utilizzato non ha ancora iniziato il suo periodo); un codice ancora valido viene esteso dalla sua attuale data di scadenza, uno scaduto da adesso. Questa azione non addebita crediti. Tramite l'API:extend_active_code.
CODE-08 Ricevo indietro crediti quando elimino un codice?
Un codicenon utilizzatocreato dal reseller: rimborsato per intero, con una riga nel registro dei crediti. Un codiceattivato: nessun rimborso.
CODE-09 Come gestisco molti codici insieme?
La paginaBatchesmostra totale / pronti / attivati / disabilitati per ogni lotto ed esporta un file TXT (un codice per riga). Azioni di massa: abilita, disabilita, azzera dispositivo, elimina.
CODE-10 La linea di un codice di attivazione segue i limiti del pacchetto?
Sì, come ogni linea venduta con quel pacchetto: numero di connessioni, formati di output, bouquet, blocco dispositivo, restreamer e anche ilpaese forzatodel pacchetto (SEC-07). Un cliente che attiva un codice da un paese fuori dall'elenco consentito può attivarlo ma viene rifiutato in riproduzione.
Limiti di connessione e blocchi che proteggono una linea
SECSEC-01 Come vengono conteggiate le "Max connections"?
È il numero di dispositivi che guardanocontemporaneamentecon una linea. 0 = illimitato. Riaprire dallo stesso dispositivo il canale che stai già guardando non conta come un'altra connessione.
SEC-02 Chi viene disconnesso quando il limite è superato? Spettatore
Per impostazione predefinita: lanuovaconnessione entra e lapiù vecchiaviene chiusa (preferendo una connessione dallo stesso dispositivo, poi dallo stesso IP). Il player chiuso si ferma entro circa 30 secondi. L'admin può passare arifiutare la nuova connessioneinvece di chiudere una vecchia.
SEC-03 Che cos'è la regola del "secondo IP"?
Quando l'admin la attiva: mentre una linea viene guardata da un IP, una connessione live da un altro IP viene rifiutata. La regola può essere limitata alle linee con poche connessioni (ad esempio linee con 1 connessione; una linea con connessioni illimitate è vincolata solo quando la soglia è 0). ConMatch The Address By Networkattivo, gli indirizzi della stessa rete /24 (IPv6: /64) contano come un solo spettatore. È uno strumento contro la condivisione degli account.
SEC-04 Posso limitare una linea a certi IP o app?
Quando il gruppo haAllow Line Restrictionsattivo: il campoAllowed IPs(un IP, un intervallo CIDR o un nome di dominio, uno per riga; un dominio viene risolto al momento della connessione, quindi un IP dinamico funziona comunque) eAllowed User-Agents. Vuoto = tutto consentito. Nota: queste restrizioni bloccano allariproduzione; l'app accede comunque e mostra l'elenco dei canali.
SEC-05 Che cos'è il blocco ISP?
La linea ricorda il provider internet della sua prima connessione e rifiuta l'uso da un altro provider. Quando il cliente cambia provider, disattiva e riattiva il blocco ISP per registrare quello nuovo. Non si applica ai box MAG.
SEC-06 Che cos'è il blocco del dispositivo?
Lega la linea al primo set-top box che accede (numero di serie, id del dispositivo); un altro box viene rifiutato. Deciso dal pacchetto.
SEC-07 Come funziona la restrizione per paese?
Una linea può connettersi solo dal suo paese forzato (ALL= ovunque). Quando è vuoto, si applica l'elenco generale dei paesi consentiti del pannello. Un cliente che viaggia all'estero o usa una VPN può essere rifiutato per questo motivo.
SEC-08 Perché un indirizzo IP è bloccato? Spettatore
- Automaticamente: accessi falliti da un IP con molti username / codici di attivazione diversi in poco tempo, oppure un flusso massiccio di richieste. Un blocco automatico si toglie da solo dopo il tempo configurato dall'admin (60 minuti per impostazione predefinita).
- Manualmente: l'admin ha bloccato l'IP / l'intervallo di IP; questo non scade.
Finché un IP è bloccato,nessunalinea può connettersi da lì. Sbagliare ripetutamente lo stesso username non provoca un blocco.
SEC-09 Per quali altri motivi una connessione può essere bloccata?
L'admin può bloccare perUser-Agent(app), perprovider internet (ISP)e perASN(ad esempio intervalli di hosting / VPN). Una linea per cui l'admin ha attivato "bypass UA" salta l'elenco di blocco delle app.
SEC-10 Che cos'è un restreamer?
Una linea per un partner che preleva gli stream per ridistribuirli. È esente dal limite di connessioni, dalla regola del secondo IP, dalla chiusura automatica delle sessioni lunghe e dal blocco ASN. Deciso dal pacchetto / dall'admin; non destinato agli spettatori ordinari.
SEC-11 Una sessione continua molto lunga viene interrotta? Spettatore
L'admin può impostare una durata massima per una sessione continua; superata, la sessione viene chiusa e il cliente preme play per continuare. Anche una sessione che perde il segnale per circa 90 secondi conta come chiusa.
SEC-12 Come individuo una linea condivisa o rubata?
- La paginaTheft Detection(quando il gruppo ha il permesso): classifica le linee per numero di film / episodidiversiguardati in 1 ora / 24 ore / 7 giorni, con il numero di IP diversi — una linea insolitamente alta è sospetta.
- La pagina di attività della linea: mostra gli IP e i dispositivi in uso.
- Cosa fare: cambia la password della linea (PLAY-08), attiva la restrizione IP / il blocco ISP, oppure disabilita la linea.
Sub-reseller
SUBSUB-01 Posso creare sub-reseller?
Quando il tuo gruppo haCan Create Sub-Resellersattivo e almeno un gruppo inGroups for sub-resellers. Ogni creazione addebita la tariffa di creazione (crediti) impostata sul gruppo. Un albero di reseller è profondo al massimo 5 livelli.
SUB-02 A quale gruppo appartiene un sub-reseller e che cosa può fare?
Scegli un gruppo dall'elenco consentito dall'admin; quel gruppo decide i permessi del sub-reseller, i pacchetti vendibili e la quota delle prove.
SUB-03 Che cosa posso gestire su un sub-reseller?
Email, nome, password, stato, gruppo (dall'elenco), note, trasferire / riprendere crediti e ogni linea sotto di lui. Non puoi cambiare il suo ruolo o proprietario.
SUB-04 Che cosa vede un sub-reseller delle mie cose?
Niente: ogni account vede solo ciò che sta sotto di sé, mai i livelli superiori o altri rami.
SUB-05 Dove vanno le linee e i crediti di un sub-reseller quando lo elimino?
Il gruppo deve avereCan Delete Usersattivo. I crediti rimanenti, le linee e gli account figli passanoall'account che elimina. Le linee dei clienti continuano a funzionare. I dati personali dell'account eliminato (username, email, nome, password, chiavi API, note) vengono cancellati; quello username e quell'email possono essere riutilizzati.
SUB-06 Un nuovo sub-reseller riceve un'email?
Quando l'admin ha attivato l'email di benvenuto: il nuovo account riceve il nome di accesso e un link di accesso. L'emailnoncontiene mai la password — gliela invii tu stesso.
Modelli di categoria
CATCAT-01 A cosa serve un modello di categoria?
A riordinare, rinominare o nascondere le categorie (live, film, serie, radio) che un cliente vede nell'app — per linea, senza toccare le categorie del pannello.
CAT-02 Che cosa succede quando nascondo una categoria?
Anche tutti i contenuti di quella categoria vengono nascosti dall'app e dalla playlist delle linee che usano il modello.
CAT-03 Quando modifico un modello, cambiano le linee che lo usano?
Sì, subito per ogni linea a cui il modello è assegnato. Quando un modello viene eliminato, le sue linee tornano al layout predefinito.
CAT-04 Quali modelli posso vedere e modificare?
Vedere: i tuoi e quelli degli account sotto di te, i modelli di sistema e i modelli condivisi dai livelli superiori. Modificare: solo i tuoi e quelli sotto di te. Per adattare un modello di sistema,duplicaloe modifica la copia.
CAT-05 Limiti da conoscere?
L'ordine personalizzato delle categorie non si applica alla parte film / serie di una playlist M3U (nomi e nascondimento si applicano comunque). Le app che usano la Xtream API ricevono tutto.
Reseller API, chiavi API, webhook
APIAPI-01 A cosa serve la Reseller API?
Per il tuo sistema (web shop, fatturazione, bot) per vendere e gestire linee / sub-reseller senza aprire la dashboard. Indirizzo:{API}/reseller/v1, autenticato con l'headerX-API-Key. La documentazione completa è in/docs/sul server API.
API-02 Dove ottengo una chiave API?
La paginaAPI Key. Una chiave viene mostratauna sola volta, quando viene creata — copiala subito. Se la perdi, crea una nuova chiave (la vecchia smette di funzionare).
API-03 Devo usare una sola chiave per ogni sistema?
Meglio di no. Crea unachiave aggiuntivaper sistema: dagli un nome, limita gli IP / CIDR che possono usarla, rendila eventualmentedi sola lettura(solo elenco e visualizzazione) e revocala da sola senza influire sulle altre chiavi.
API-04 Che cosa può fare l'API?
| Esigenza | Azione |
|---|---|
| Saldo, prezzi, quanti te ne puoi permettere, regole username / prova | user_info,pricing,packages |
| Linee | get_lines,get_line,create_line,renew_line,change_package,edit_line,enable_line,disable_line,delete_line |
| Sub-reseller | get_users,get_user,create_user,edit_user,adjust_credits,enable_user,disable_user,delete_user |
| Codici di attivazione | create, list, enable / disable, reset device, delete |
| Webhook, indirizzo di riproduzione proprio, log delle chiamate API | create_webhook…,set_play_base,api_logs |
Ogni regola della dashboard (gruppo, prezzo proprio, quota prove, ambito dell'albero) si applica tramite l'API esattamente allo stesso modo.
API-05 Se riprovo dopo un errore di rete, vengo addebitato due volte?
No, purché invii lo stessorequest_idper la stessa transazione: il sistema restituisce il risultato precedente. Ilrequest_iddi un rinnovo èlegato a quella linea: riusarlo per un'altra linea restituisce un errore di conflitto (HTTP 409) e l'altra linea non cambia — genera un nuovorequest_idper ogni transazione.
API-06 La mia integrazione non funziona. Come la verifico da solo?
La pagina API Key ha una tabella dellechiamate API recenti(30 giorni): azione, risultato, codice di errore, indirizzo chiamante, nome del connettore. I parametri non vengono mai registrati.
API-07 Che cos'è un webhook e quali eventi esistono?
Il pannello avvisa il tuo sistema quando succede qualcosa, così non devi continuare a chiedere. Eventi:line.created,line.renewed,line.enabled,line.disabled,line.deleted,line.expiring(3 giorni prima),line.expired,credits.low(sotto la soglia che imposti). L'indirizzo ricevente deve essere https e raggiungibile da internet.
API-08 Come so che un webhook è autentico?
Ogni notifica porta la firmaX-Xtream-Signature: sha256=HMAC(secret, timestamp.body); il secret viene mostrato una sola volta, alla creazione dell'endpoint. Un webhook non contiene mai una password.
API-09 Il webhook ha smesso di inviare?
Ogni notifica viene tentata 3 volte; un endpoint che fallisce 20 consegne di fila viene disattivato. Sistema la tua parte, usaSend test, poi ricrea l'endpoint se è stato disattivato.
API-10 L'API restituisce le password delle linee?
Sì, ma solo al proprietario della linea (tu e i livelli sopra di te nell'albero). Non conservare le password delle linee nei log né inviarle su un canale non sicuro.
API-11 `edit_line` può rinnovare una linea?
Sì, quando invii con essapackage_id(è accettato anche il vecchio nomepackage): oltre alla modifica, l'azione vende un periodo ufficiale di quel pacchetto esattamente comechange_package— stesso prezzo, stessorequest_id, e la risposta portacredits_charged. Modifica e rinnovo sono un'unica transazione: se viene rifiutata (crediti insufficienti, pacchetto non valido,trialinviato insieme) non cambia nulla.edit_linesenzaun pacchetto modifica solo username, password, contatto e note e non tocca il pacchetto né la scadenza.
API-12 Uno script scritto per il vecchio pannello (PHP) funziona con questa API?
Non così com'è. L'API mantiene i nomi di azione familiari ma è una nuova interfaccia: l'indirizzo/reseller/v1, una chiave API creata in questo pannello, azioni di scrittura inviate con POST, errori restituiti come stato HTTP con un campoerrore il risultato della creazione di una linea indata.line. Usa la documentazione in/docs/o un connettore già pronto (CON-02).
Connettori per sistemi di shop / fatturazione
CONCON-01 Come incasso il denaro dai miei clienti?
Conil tuosistema e gateway di pagamento. Il pannello non elabora pagamenti. Un connettore collega il tuo sistema di shop al pannello: il cliente paga dalla tua parte → il connettore chiama la Reseller API per creare / rinnovare la linea.
CON-02 Per quali piattaforme esiste un connettore?
WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress (WooCommerce / Easy Digital Downloads), Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext e un "webhook bridge" per Shopify, Upmind e Invoice Ninja.
CON-03 Dove lo scarico e lo installo?
Barra lateraleResources → All Connectors: ogni connettore ha una descrizione, i dati di connessione, i passaggi di installazione, un pulsanteDownloade lo SHA-256 del file per verificarlo.
CON-04 Fino a che punto sono stati testati i connettori?
Dipende dal connettore, e la pagina di ciascuno lo dice: alcuni sono stati eseguiti nella piattaforma reale (ad esempio WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), altri hanno avuto verificato solo il nucleo. Leggi la riga "how it was tested" e prova in un ambiente di test prima di vendere sul serio.
CON-05 Un connettore è sicuro e che cosa fa al pannello?
CON-06 Che cosa può vendere un connettore?
Linee (creare, rinnovare, cambiare pacchetto, sospendere, eliminare) e account sub-reseller con crediti.
Dati, eliminazione e privacy
DATADATA-01 Una linea eliminata può essere ripristinata?
No. Eliminato è perso: i dati della linea (username, password, contatto, note), la cronologia delle connessioni (IP, dispositivi, cosa è stato guardato), i set-top box collegati alla linea e il suo codice di attivazione. Non c'è cestino né funzione o API di ripristino. Quando il cliente torna, crea una nuova linea.
DATA-02 Che cosa conserva il sistema dopo un'eliminazione?
Solo un record statisticoanonimoper l'operatore (cliente nuovo o di ritorno, quali pacchetti sono popolari). Non contiene nulla di leggibile sul cliente e nessun reseller, connettore o API può accedervi.
DATA-03 Un backup può riportare indietro una linea eliminata?
No. I backup del database esistono solo per ricostruire il sistema dopo un incidente e sono custoditi dall'operatore; non si usano per annullare un'eliminazione. I vecchi backup vengono ruotati, quindi anche i dati eliminati scompaiono da essi.
DATA-04 Perché la password di una linea è leggibile mentre quella del pannello no?
La password di una linea va digitata nelle app ed è parte del link della playlist, quindi il pannello la mantiene leggibile per il proprietario della linea. Le password degli account del pannello sono salvate solo con hash.
DATA-05 Chi può vedere le mie linee e i miei clienti?
Tu, gli account sopra di te nel tuo albero e l'admin. Altri reseller e i livelli sotto di te no.
DATA-06 Il pannello invia email / messaggi ai miei clienti?
Mai. I clienti di una linea appartengono al reseller; li contatti tramite il tuo sistema.
DATA-07 Vengo avvisato prima che una linea scada?
In due modi: un'email di riepilogo giornaliera delle linee in scadenza (quando l'admin l'ha attivata; 3 giorni prima per impostazione predefinita) e i webhookline.expiring/line.expiredper il tuo sistema.
Risoluzione dei problemi
FIXControlla dall'alto verso il basso. La maggior parte dei problemi di "non riesco a guardare" si trova nelle prime 5 righe.
FIX-01 Il cliente non riesce ad accedere / non riesce a guardare Spettatore
| # | Controllo | Segno | Cosa fare |
|---|---|---|---|
| 1 | Username / password | l'app segnala dati errati | confronta con il modulo della linea (maiuscole/minuscole, niente spazi); invia di nuovo il link daGenerate play link |
| 2 | Scadenza | l'app segnalaExpired | rinnova (LINE-06) |
| 3 | Stato | Disabled/Banned | riabilitala; perBannedcontatta l'admin |
| 4 | Indirizzo del server | impossibile connettersi | usa l'indirizzo e la porta esatti del link di riproduzione e il giustohttp/https |
| 5 | Numero di connessioni | espulso quando qualcun altro inizia a guardare | SEC-01,SEC-02 |
| 6 | IP bloccato | nessuna linea può entrare da quella rete | SEC-08: attendi la fine del blocco o chiedi all'admin di toglierlo |
| 7 | Blocco ISP / paese / Allowed IPs | fallisce solo dopo aver cambiato rete, con dati mobili, con una VPN o in viaggio | SEC-04,SEC-05,SEC-07 |
| 8 | Formato | il link HLS / TS viene rifiutato | usa un formato consentito dal pacchetto (PLAY-03) |
| 9 | App bloccata | fallisce in una sola app | prova un'altra app;SEC-09 |
FIX-02 L'accesso funziona e l'elenco compare, ma un canale non si riproduce Spettatore
FIX-03 Mancano canali o gruppi di canali Spettatore
Controlla i bouquet della linea (PKG-04,PKG-05) e il modello di categoria assegnato (CAT-02). Dopo una modifica, chiedi al cliente di ricaricare l'elenco nell'app. Un canale appena aggiunto dall'admin compare dopo circa mezzo minuto; se un canale è nel bouquet e nessuna linea lo vede, l'admin potrebbe aver tolto quel canale dalla trasmissione.
FIX-04 Scatti, blocchi Spettatore
Prova in ordine: un altro canale (un solo canale o tutti?) → un'altra rete → un altro formato (HLS invece di MPEG-TS) → un'altra app. Ogni canale fallisce su ogni rete → comunica all'assistenza username, orario e canale.
FIX-05 Nessuna guida ai programmi (EPG) Spettatore
FIX-06 Non riesco a creare una linea
FIX-07 Il download di una playlist restituisce errore 429 o una pagina 404
FIX-08 Non riesco ad aprire una pagina della dashboard
FIX-09 Non ricevo email dal pannello
L'email viene inviata solo quando l'admin ha configurato un server di posta e abilitato quel tipo di messaggio; l'account deve avere un indirizzo email reale. Controlla la cartella spam.
Glossario
- Linea
- l'abbonamento IPTV di uno spettatore: username, password, scadenza, bouquet, limiti
- Utente
- un account che accede al pannello: admin, reseller, sub-reseller
- Gruppo
- il gruppo di permessi di un account del pannello; decide menu, pacchetti vendibili, regole delle linee, prove
- Bouquet
- un elenco di contenuti (canali, film, serie)
- Pacchetto
- il prodotto da vendere: bouquet + durata + limiti + prezzo in crediti
- Credito
- l'unità prepagata usata per acquistare pacchetti
- Prova
- il periodo di prova di un pacchetto
- Codice di attivazione
- un codice con cui un cliente attiva da solo una linea a pagamento
- MAG / Enigma2
- due famiglie di set-top box; accedono tramite indirizzo MAC
- Xtream Codes API
- il protocollo usato dalla maggior parte delle app IPTV (server + username + password)
- M3U / XMLTV
- formati di file di una playlist / di una guida ai programmi
- MPEG-TS / HLS
- due formati di stream
- EPG
- la guida ai programmi
- Catch-up
- guardare un programma dopo la sua messa in onda
- Restreamer
- una linea per un partner che preleva stream per ridistribuirli
- Connettore
- software che collega il sistema di shop di un reseller al pannello
- Webhook
- una notifica che il pannello invia al sistema di un reseller quando succede qualcosa
Nessuna domanda corrisponde
Prova un'altra parola chiave o un codice di domanda, oppure cancella il filtro.
Ancora bloccato?
Invia lo username della linea (mai la password), quando è successo, l'app o il dispositivo e il codice della domanda che hai già provato.