Importação do sambot
Como transferir reações, etiquetas, arquivos e conversas do sambot. O que os arquivos de exportação contêm e qual a diferença entre os modos Adicionar e Substituir.
Nesta página
Para migrar do sambot.ru, primeiro baixe os dados do bot em um arquivo compactado e depois envie esse arquivo ao GetMyBot. Dá para transferir reações, etiquetas, imagens e arquivos. O histórico de conversas é enviado em um arquivo compactado separado.
Se você não usa a linha de comando, escolha a extensão para Chrome. Para exportação automática existe o exportador em Python. Depois da migração, teste comandos, botões e arquivos no chat com o bot antes de direcionar clientes para ele.
O que é transferido
- Reações: o comportamento completo do bot.
- Etiquetas: tags dos assinantes com suas cores.
- Mídia: imagens e arquivos referenciados pelas reações.
- Histórico de diálogos: as conversas do bot com os usuários (em um arquivo compactado separado).
Importação do arquivo de reações
O arquivo de reações se chama mybot-export.zip. Na seção Reações, clique em Importar arquivo, escolha o arquivo e o modo de envio. Pela API, use POST /api/bots/{id}/reactions/import. Na documentação técnica esse arquivo também é chamado de bundle. Ele contém:
manifest.json: cabeçalho com versão do formato, origem (sambot), nome do bot, data da exportação e contadores.reactions.json: array de reações (obrigatório).labels.json: lista de etiquetas (opcional).media/<sha256>.<ext>: arquivos de mídia (opcional).
Há dois modos:
- Adicionar (
append): as reações do arquivo são somadas às atuais. - Substituir (
replace): as reações atuais do bot são excluídas e depois as do arquivo são carregadas.
O tamanho total dos arquivos após descompactar o arquivo de reações é limitado a 64 MiB.
Importação do histórico de diálogos
O histórico de conversas é transferido em um arquivo separado, mybot-dialogs.zip. Ele traz os perfis dos usuários e suas mensagens com anexos, por isso, após a importação, as conversas anteriores aparecem na hora na seção Pessoas.
Há três formas de enviar o arquivo:
- pelo botão "Importar histórico" na seção Pessoas, se você tiver permissão nos diálogos;
- pela API:
POST /api/bots/{id}/dialogs/import(multipart, campofile) com um token pessoal com o scopesubscribers:write. O andamento da importação aparece emGET /api/bots/{id}/dialogs/import/{import_id}; - pelo MCP: a ferramenta
import_dialogsaceita o arquivo em base64 com até 48 MB, eget_dialog_importretorna o status.
A importação roda em segundo plano e não envia nada a ninguém. Mensagens com um tg_message_id já carregado são ignoradas, então você pode enviar o arquivo de novo ou em partes. O histórico de diálogos é guardado sem prazo.
O tamanho total dos arquivos após descompactar o arquivo de diálogos é limitado a 256 MiB.
Exportador (Python)
O pacote tools/sambot_export lê as páginas do seu bot no sambot.ru, baixa os arquivos e monta um arquivo ZIP. Para o acesso, é preciso um arquivo de cookie com os dados de uma sessão do navegador já aberta. O comando para desenvolvedores, executado no diretório tools/sambot_export, é python -m exporter --cookie-file cookie.txt --bot 42785 --out mybot-export.zip.
- Por padrão, são exportados reações, etiquetas e mídia.
- O modo
--mode dialogsexporta o histórico de diálogos em ummybot-dialogs.zipseparado. - Autenticação: apenas pelo cookie de uma sessão do navegador já aberta. A senha não funciona, porque o formulário de login é protegido contra requisições automáticas.
Extensão para Chrome
Se não quiser executar um comando, use a extensão do Chrome "GetMyBot: exportar do sambot". Ela exporta o bot direto da página do sambot.ru: pede acesso à aba ativa e aos downloads, funciona em https://sambot.ru/*, e o cookie da sessão não sai do navegador. A extensão gera o mesmo arquivo ZIP para importar no GetMyBot.
Ordem da migração
- Exporte o bot pelo exportador ou pela extensão: você terá
mybot-export.zip(e, se precisar,mybot-dialogs.zip). - Importe o arquivo de reações no bot (modo "Adicionar" ou "Substituir").
- Se precisar, importe o histórico de diálogos.
- Confira as reações e as etiquetas. Se transferiu arquivos, confira também a biblioteca de mídia.
Próximos passos
- Reações: primeiros passos: importação e exportação de reações individuais.
- Pessoas (CRM): onde o histórico de diálogos importado vai aparecer.
- Biblioteca de mídia: para onde vai a mídia transferida.
- Projetos e canais: conecte o bot antes de importar.