Importazione da sambot
Come trasferire reazioni, etichette, file e conversazioni da sambot. Cosa contengono gli archivi e in cosa differiscono le modalità Aggiungi e Sostituisci.
In questa pagina
Per trasferire un bot da sambot.ru, prima scarica i suoi dati in un archivio, poi caricalo in GetMyBot. Puoi trasferire reazioni, etichette, immagini e file. La cronologia delle conversazioni si carica con un archivio separato.
Se non usi la riga di comando, scegli l'estensione per Chrome. Per l'esportazione automatica c'è l'esportatore Python. Dopo il trasferimento, prova comandi, pulsanti e file nella chat con il bot prima di indirizzarvi i clienti.
Cosa viene trasferito
- Reazioni: il comportamento completo del bot.
- Etichette: i tag degli iscritti con i loro colori.
- Media: immagini e file a cui fanno riferimento le reazioni.
- Cronologia dei dialoghi: le conversazioni del bot con gli utenti (in un archivio separato).
Importazione dell'archivio delle reazioni
L'archivio delle reazioni si chiama mybot-export.zip. Nella sezione Reazioni clicca Importa archivio, scegli il file e la modalità di caricamento. Tramite API si usa POST /api/bots/{id}/reactions/import. Nella documentazione tecnica questo archivio si chiama anche bundle. Contiene:
manifest.json: intestazione con versione del formato, sorgente (sambot), nome del bot, data di esportazione e contatori.reactions.json: array delle reazioni (obbligatorio).labels.json: elenco delle etichette (facoltativo).media/<sha256>.<ext>: file media (facoltativi).
Sono disponibili due modalità:
- Aggiungi (
append): le reazioni dell'archivio si aggiungono a quelle attuali. - Sostituisci (
replace): le reazioni attuali del bot vengono eliminate, poi vengono caricate quelle dell'archivio.
La dimensione totale dei file dopo la decompressione dell'archivio delle reazioni è limitata a 64 MiB.
Importazione della cronologia dei dialoghi
La cronologia delle conversazioni si trasferisce con un archivio separato, mybot-dialogs.zip. Contiene i profili degli utenti e i loro messaggi con gli allegati, quindi dopo l'importazione le conversazioni passate compaiono subito nella sezione Persone.
L'archivio si può caricare in tre modi:
- con il pulsante «Importa cronologia» nella sezione Persone, se hai il permesso sui dialoghi;
- tramite API:
POST /api/bots/{id}/dialogs/import(multipart, campofile) con un token personale con scopesubscribers:write. L'avanzamento dell'importazione si vede conGET /api/bots/{id}/dialogs/import/{import_id}; - tramite MCP: lo strumento
import_dialogsaccetta l'archivio in base64 fino a 48 MB, eget_dialog_importrestituisce lo stato.
L'importazione avviene in background e non invia nulla a nessuno. I messaggi con un tg_message_id già caricato vengono saltati, quindi puoi caricare l'archivio di nuovo o a parti. La cronologia dei dialoghi viene conservata senza limiti di tempo.
La dimensione totale dei file dopo la decompressione dell'archivio dei dialoghi è limitata a 256 MiB.
Esportatore (Python)
Il pacchetto tools/sambot_export legge le pagine del tuo bot su sambot.ru, scarica i file e crea un archivio ZIP. Per l'accesso serve un file cookie con i dati di una sessione del browser già aperta. Il comando per sviluppatori, da eseguire nella directory tools/sambot_export, è python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip.
- Per impostazione predefinita vengono esportati reazioni, etichette e media.
- La modalità
--mode dialogsesporta la cronologia dei dialoghi in un filemybot-dialogs.zipseparato. - Autenticazione: solo tramite il cookie di una sessione del browser già aperta. La password non funziona, perché il modulo di accesso è protetto dalle richieste automatiche.
Estensione per Chrome
Se non vuoi eseguire un comando, usa l'estensione Chrome «GetMyBot: esportazione da sambot». Esporta il bot direttamente dalla pagina di sambot.ru: chiede l'accesso alla scheda attiva e ai download, funziona su https://sambot.ru/* e il cookie della sessione non lascia il browser. L'estensione crea lo stesso archivio ZIP da importare in GetMyBot.
Procedura di migrazione
- Esporta il bot con l'esportatore o con l'estensione: otterrai
mybot-export.zip(e, se serve,mybot-dialogs.zip). - Importa l'archivio delle reazioni nel bot (modalità «Aggiungi» o «Sostituisci»).
- Se serve, importa la cronologia dei dialoghi.
- Controlla reazioni ed etichette. Se hai trasferito file, controlla anche la libreria media.
Prossimi passi
- Reazioni: le basi: importazione ed esportazione di singole reazioni.
- Persone (CRM): dove compare la cronologia dei dialoghi importata.
- Libreria media: dove finiscono i media trasferiti.
- Progetti e canali: collega il bot prima dell'importazione.