sambot からのインポート
sambot からリアクション、ラベル、ファイル、やり取りを移す方法。アーカイブの中身と、追加モードと置き換えモードの違い。
このページの内容
sambot.ru から移行するには、まずボットのデータをアーカイブとしてダウンロードし、それを GetMyBot にアップロードします。移せるのはリアクション、ラベル、画像、ファイルです。やり取りの履歴は別のアーカイブでアップロードします。
コマンドラインを使わない場合は、Chrome 拡張機能を選んでください。自動でエクスポートしたい場合は Python 製のエクスポーターがあります。移行後は、顧客をボットに案内する前に、ボットとのチャットでコマンド、ボタン、ファイルを確認してください。
移行されるもの
- リアクション: ボットの動作のすべて。
- ラベル: 色付きの購読者タグ。
- メディア: リアクションが参照している画像とファイル。
- ダイアログ履歴: ボットとユーザーのやり取り(別のアーカイブ)。
リアクションアーカイブのインポート
リアクションのアーカイブは mybot-export.zip という名前です。リアクションセクションでアーカイブを取り込むを押し、ファイルと読み込みモードを選びます。API では POST /api/bots/{id}/reactions/import を使います。技術文書では、このアーカイブをバンドルと呼ぶこともあります。中身は次のとおりです。
manifest.json: ヘッダー。フォーマットのバージョン、ソース(sambot)、ボット名、エクスポート日時、各種カウンター。reactions.json: リアクションの配列(必須)。labels.json: ラベルの一覧(任意)。media/<sha256>.<ext>: メディアファイル(任意)。
モードは2つあります。
- 追加(
append): アーカイブのリアクションが既存のリアクションに追加されます。 - 置き換え(
replace): ボットの現在のリアクションを削除してから、アーカイブのリアクションを読み込みます。
リアクションアーカイブを展開した後のファイルの合計サイズは 64 MiB までです。
ダイアログ履歴のインポート
やり取りの履歴は別のアーカイブ mybot-dialogs.zip で移します。ユーザーのプロフィールと、添付ファイルを含むメッセージが入っているため、インポート直後から過去のやり取りがユーザーセクションに表示されます。
アーカイブのアップロード方法は3つあります。
- ユーザーセクションの「履歴をインポート」ボタン(ダイアログの権限がある場合)
- API:
POST /api/bots/{id}/dialogs/import(multipart、フィールドfile)。scopesubscribers:writeを持つ個人用トークンが必要です。進行状況はGET /api/bots/{id}/dialogs/import/{import_id}で確認できます。 - MCP: ツール
import_dialogsが 48 MB までのアーカイブを base64 で受け取り、get_dialog_importがステータスを返します。
インポートはバックグラウンドで実行され、誰にも何も送信しません。tg_message_id がすでに読み込まれているメッセージはスキップされるので、アーカイブを再度アップロードしたり、分割してアップロードしたりできます。ダイアログ履歴は無期限に保存されます。
ダイアログアーカイブを展開した後のファイルの合計サイズは 256 MiB までです。
エクスポーター(Python)
パッケージ tools/sambot_export は sambot.ru 上のボットのページを読み取り、ファイルをダウンロードして ZIP アーカイブを作ります。アクセスには、すでに開いているブラウザセッションのデータを含む cookie ファイルが必要です。開発者向けのコマンドで、tools/sambot_export ディレクトリから実行します: python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip。
- デフォルトではリアクション、ラベル、メディアがエクスポートされます。
--mode dialogsモードはダイアログ履歴を別ファイルmybot-dialogs.zipにエクスポートします。- 認証は、すでに開いているブラウザセッションの cookie のみです。ログインフォームが自動リクエストから保護されているため、パスワードは使えません。
Chrome 拡張機能
コマンドを実行したくない場合は、Chrome 拡張機能**「GetMyBot: sambot からのエクスポート」**を使ってください。sambot.ru のページから直接ボットをエクスポートします。アクティブなタブとダウンロードへのアクセスを求め、https://sambot.ru/* で動作し、セッションの cookie がブラウザの外に出ることはありません。拡張機能は GetMyBot にインポートするための同じ ZIP アーカイブを作成します。
移行手順
- エクスポーターまたは拡張機能でボットをエクスポートし、
mybot-export.zip(必要ならmybot-dialogs.zipも)を取得します。 - リアクションアーカイブをボットにインポートします(「追加」または「置き換え」モード)。
- 必要に応じてダイアログ履歴をインポートします。
- リアクションとラベルを確認します。ファイルを移した場合は、メディアライブラリも確認してください。
次のステップ
- リアクションの基本: 個別のリアクションのインポートとエクスポート。
- ユーザー(CRM): インポートしたダイアログ履歴が表示される場所。
- メディアライブラリ: 移したメディアの保存先。
- プロジェクトとチャンネル: インポート前にボットを接続してください。