Importar un bot de sambot
Cómo trasladar reacciones, etiquetas, archivos y conversaciones desde sambot, y cuándo añadir o sustituir las reacciones existentes.
En esta página
Para trasladar tu bot desde sambot.ru, descarga primero sus datos en un archivo comprimido y después impórtalo en GetMyBot. Puedes trasladar reacciones, etiquetas, imágenes y otros archivos. El historial de conversaciones se importa por separado.
Si no usas la línea de comandos, puedes exportar los datos con una extensión de Chrome. También hay un exportador de Python para automatizar la descarga. Antes de dirigir a tus clientes al bot importado, prueba sus comandos, botones y archivos en una conversación.
Qué se puede trasladar
- Reacciones: el comportamiento del bot.
- Etiquetas: etiquetas de los suscriptores, con sus colores.
- Imágenes y archivos: los que utilizan las reacciones.
- Historial de conversaciones: los mensajes entre el bot y los usuarios, en otro archivo comprimido.
Importar las reacciones
El archivo se llama mybot-export.zip. En Reacciones, pulsa Importar archivo, selecciona el archivo y el modo de importación. Si utilizas la API, la solicitud es POST /api/bots/{id}/reactions/import. La documentación técnica también llama paquete a este archivo. Contiene:
manifest.json: versión del formato, origen (sambot), nombre del bot, fecha de exportación y cantidades.reactions.json: lista de reacciones, obligatoria.labels.json: lista de etiquetas, opcional.media/<sha256>.<ext>: imágenes y archivos, opcionales.
Puedes elegir entre dos modos:
- Añadir (
append): añade las reacciones importadas a las que ya tiene el bot. - Sustituir (
replace): elimina las reacciones actuales del bot y carga las del archivo.
Los archivos descomprimidos de este paquete no pueden superar 64 MiB en total.
Importar las conversaciones
El historial de conversaciones llega en un archivo aparte, mybot-dialogs.zip. Contiene los perfiles de los usuarios y sus mensajes con archivos adjuntos, así que después de importarlo verás las conversaciones anteriores en Personas.
Puedes subir el archivo de tres formas:
- con el botón Importar historial en Personas, si tienes permiso sobre los diálogos;
- por API:
POST /api/bots/{id}/dialogs/import(multipart, campofile) con un token de acceso personal con el scopesubscribers:write.GET /api/bots/{id}/dialogs/import/{import_id}muestra el progreso; - por MCP: la herramienta
import_dialogsacepta el archivo en base64 de hasta 48 MB yget_dialog_importdevuelve el estado.
La importación se ejecuta en segundo plano y no envía nada a nadie. Los mensajes cuyo tg_message_id ya está guardado se omiten, por eso puedes volver a subir un archivo o subirlo por partes. El historial de diálogos se conserva sin límite de tiempo.
Los archivos descomprimidos de las conversaciones no pueden superar 256 MiB en total.
Exportador de Python
El paquete tools/sambot_export lee las páginas de tu bot en sambot.ru, descarga sus archivos y crea el ZIP. Necesita un archivo de cookies de una sesión que ya hayas abierto en el navegador. Un desarrollador puede ejecutar este comando desde tools/sambot_export: python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip.
- De forma predeterminada exporta reacciones, etiquetas e imágenes y archivos.
--mode dialogsexporta el historial de conversaciones enmybot-dialogs.zip.- La autenticación utiliza únicamente la cookie de la sesión abierta. La contraseña no sirve para este exportador porque el formulario de acceso impide las solicitudes automáticas.
Extensión de Chrome
Si prefieres no ejecutar un comando, usa la extensión «GetMyBot: exportar desde sambot». Descarga los datos desde la página de sambot.ru en Chrome. Solicita acceso a la pestaña activa y a las descargas, funciona en https://sambot.ru/* y la cookie de sesión no sale del navegador. Produce el mismo ZIP que puedes importar en GetMyBot.
Orden recomendado
- Exporta el bot con la extensión o el exportador. Obtendrás
mybot-export.zipy, si quieres trasladar las conversaciones,mybot-dialogs.zip. - Importa las reacciones y elige Añadir o Sustituir.
- Si lo necesitas, importa el historial de conversaciones.
- Comprueba las reacciones y etiquetas. Si trasladaste archivos, revisa también la biblioteca de archivos.
Siguientes pasos
- Reacciones: primeros pasos: importar y exportar reacciones individuales.
- Personas: consultar las conversaciones importadas.
- Biblioteca de archivos: encontrar las imágenes y otros archivos importados.
- Proyectos y canales: conectar el bot antes de importar.