Base de conhecimento GetMyBot

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, campo file) com um token pessoal com o scope subscribers:write. O andamento da importação aparece em GET /api/bots/{id}/dialogs/import/{import_id};
  • pelo MCP: a ferramenta import_dialogs aceita o arquivo em base64 com até 48 MB, e get_dialog_import retorna 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 dialogs exporta o histórico de diálogos em um mybot-dialogs.zip separado.
  • 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

  1. Exporte o bot pelo exportador ou pela extensão: você terá mybot-export.zip (e, se precisar, mybot-dialogs.zip).
  2. Importe o arquivo de reações no bot (modo "Adicionar" ou "Substituir").
  3. Se precisar, importe o histórico de diálogos.
  4. Confira as reações e as etiquetas. Se transferiu arquivos, confira também a biblioteca de mídia.

Próximos passos