Knowledge base GetMyBot

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, campo file) con un token personale con scope subscribers:write. L'avanzamento dell'importazione si vede con GET /api/bots/{id}/dialogs/import/{import_id};
  • tramite MCP: lo strumento import_dialogs accetta l'archivio in base64 fino a 48 MB, e get_dialog_import restituisce 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 dialogs esporta la cronologia dei dialoghi in un file mybot-dialogs.zip separato.
  • 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

  1. Esporta il bot con l'esportatore o con l'estensione: otterrai mybot-export.zip (e, se serve, mybot-dialogs.zip).
  2. Importa l'archivio delle reazioni nel bot (modalità «Aggiungi» o «Sostituisci»).
  3. Se serve, importa la cronologia dei dialoghi.
  4. Controlla reazioni ed etichette. Se hai trasferito file, controlla anche la libreria media.

Prossimi passi