Importer depuis sambot
Transférer réactions, étiquettes, fichiers et conversations depuis sambot : contenu des archives et différence entre ajout et remplacement.
Sur cette page
Pour migrer depuis sambot.ru, téléchargez d’abord les données du bot sous forme d’archive, puis importez celle-ci dans GetMyBot. Les réactions, étiquettes, images et fichiers peuvent être transférés. L’historique des conversations utilise une archive séparée.
Si vous ne souhaitez pas utiliser la ligne de commande, choisissez l’extension Chrome. Un exporteur Python existe pour automatiser l’opération. Après l’import, testez commandes, boutons et fichiers dans une conversation avec le bot avant de diriger des clients vers lui.
Ce qui est transféré
- Réactions : comportement complet du bot.
- Étiquettes : tags des abonnés et leurs couleurs.
- Médias : images et fichiers utilisés dans les réactions.
- Historique des conversations : échanges du bot avec les utilisateurs, dans une archive distincte.
Importer l’archive des réactions
L’archive s’appelle mybot-export.zip. Dans Réactions, cliquez sur Importer une archive, choisissez le fichier et le mode. La route API est POST /api/bots/{id}/reactions/import. La documentation technique appelle aussi cette archive un bundle. Elle contient :
manifest.json: version du format, sourcesambot, nom du bot, date d’export et compteurs ;reactions.json: tableau des réactions, obligatoire ;labels.json: liste des étiquettes, facultative ;media/<sha256>.<ext>: fichiers média, facultatifs.
Deux modes sont proposés :
- Ajouter (
append) : les réactions de l’archive s’ajoutent aux réactions actuelles. - Remplacer (
replace) : les réactions actuelles sont supprimées, puis celles de l’archive sont chargées.
La taille totale des fichiers après décompression de l’archive des réactions est limitée à 64 Mio.
Importer l’historique des conversations
L’historique des conversations arrive dans une archive à part, mybot-dialogs.zip. Elle contient les profils des utilisateurs et leurs messages avec les pièces jointes : après l’import, les anciennes conversations apparaissent tout de suite dans Personnes.
L’archive peut être envoyée de trois façons :
- avec le bouton Importer l'historique dans Personnes, si vous avez le droit sur les dialogues ;
- par l’API :
POST /api/bots/{id}/dialogs/import(multipart, champfile) avec un jeton d’accès personnel doté du scopesubscribers:write.GET /api/bots/{id}/dialogs/import/{import_id}indique la progression ; - par MCP : l’outil
import_dialogsaccepte l’archive en base64 jusqu’à 48 Mo, etget_dialog_importrenvoie l’état.
L’import tourne en arrière-plan et n’envoie rien à personne. Les messages dont le tg_message_id est déjà enregistré sont ignorés, vous pouvez donc renvoyer une archive ou l’envoyer en plusieurs parties. L’historique des dialogues est conservé sans limite de durée.
La taille totale des fichiers après décompression de l’archive des conversations est limitée à 256 Mio.
Exporteur Python
Le paquet tools/sambot_export parcourt les pages de votre bot sur sambot.ru, télécharge les fichiers et crée le ZIP. Il lui faut un fichier de cookies provenant d’une session déjà ouverte dans le navigateur. Depuis le dossier tools/sambot_export, le développeur peut lancer python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip.
- Par défaut, il exporte réactions, étiquettes et médias.
--mode dialogsexporte l’historique dans unmybot-dialogs.zipdistinct.- L’authentification passe uniquement par les cookies de la session ouverte ; le mot de passe seul ne fonctionne pas, car la page de connexion protège contre les requêtes automatiques.
Extension Chrome
Si vous préférez éviter la commande, utilisez l’extension Chrome GetMyBot : export depuis sambot. Elle exporte depuis la page sambot.ru, demande accès à l’onglet actif et aux téléchargements, fonctionne sur https://sambot.ru/* et ne fait pas sortir les cookies de session du navigateur. Elle produit le même ZIP pour GetMyBot.
Étapes de migration
- Exportez le bot avec l’exporteur ou l’extension. Vous obtenez
mybot-export.zipet éventuellementmybot-dialogs.zip. - Importez les réactions en mode Ajouter ou Remplacer.
- Importez l’historique si nécessaire.
- Vérifiez réactions et étiquettes, puis les fichiers dans la médiathèque si vous les avez transférés.
Pour aller plus loin
- Réactions : principes : import et export d’une réaction.
- Personnes (CRM) : conversations importées.
- Médiathèque : médias transférés.
- Projets et canaux : connecter le bot avant l’import.