Módulo

Sub-bots: vários bots de afiliado no mesmo painel

O módulo Sub-bots reúne vários bots de afiliado no mesmo painel para quem opera canais ou marcas com as mesmas contas de afiliado. Cada bot tem seu próprio @ no Telegram e reaproveita as rotas, mensagens, comandos e formatos do bot principal.

+ R$ 49/mêsSoma ao plano base (R$ 99/mês). Liga e desliga no painel, sem fidelidade.

O que vem no módulo Sub-bots

  • Um @ do Telegram por sub-bot
  • Rotas, contas e mensagens compartilhadas com o principal
  • Cadastro pelo token do BotFather e webhook automático

O que o módulo Sub-bots faz

Identidade no Telegram

Cada sub-bot usa um token e um @ próprios. Isso permite ter nomes diferentes para os canais ou marcas da mesma operação.

Configuração compartilhada

Os sub-bots usam as mensagens, comandos, cupons, formatos, rotas e contas de afiliado do bot principal. Uma configuração atende os bots ligados a ele.

Token validado no cadastro

Ao adicionar, o sistema consulta o Telegram para validar o token e identificar o @ do bot. Tokens inválidos ou já cadastrados são recusados.

Conexão automática

O webhook, conexão que entrega as mensagens do Telegram ao sistema, é configurado ao cadastrar. O painel oferece Reativar webhook para reaplicar essa conexão.

Gestão no painel

Consulte o último sinal de cada sub-bot, remova cadastros e aplique as permissões de administrador sugeridas. Os tokens são armazenados com criptografia.

Quando usar vários bots de afiliado no mesmo painel?

O módulo atende operações que precisam de nomes diferentes no Telegram e mantêm a mesma configuração de conversão. Uma marca pode ter um bot associado ao canal de tecnologia e outro ao canal de casa, por exemplo. Ambos usam as contas de afiliado, as rotas e os textos definidos no principal.

Esse é um exemplo ilustrativo: o que muda para o seguidor é a identidade do bot que ele abre. Para quem administra, o cadastro de mensagens, comandos e formatos continua compartilhado. A documentação de Sub-bots descreve o vínculo entre essas identidades e o bot principal.

O que muda e o que é compartilhado?

Token, @, conexão de recebimento e último sinal pertencem a cada sub-bot. Já os cupons, as contas de afiliado, os formatos de oferta e os comandos vêm do principal. Uma alteração nessa configuração compartilhada passa a ser usada pelos sub-bots ligados a ela, sem precisar repetir o ajuste para cada identidade.

Essa estrutura serve quando todos devem seguir a mesma operação. Se cada cliente precisa de integrações próprias, mensagens diferentes ou outra conta para receber a atribuição de afiliado, será preciso separar a configuração em outro bot. Os conceitos de bot e organização ajudam a escolher a divisão adequada antes de adicionar tokens.

Como manter a identidade de cada marca?

Cada sub-bot nasce de um bot criado no BotFather e tem seu próprio token. Ao cadastrá-lo, o sistema valida esse token e identifica o @. Depois, as conversas recebidas por aquela identidade usam a configuração do principal. Isso evita repetir o trabalho de conectar lojas apenas para oferecer outro nome de entrada no Telegram.

Nome, foto, descrição e menu de comandos próprios do sub-bot são ajustados no BotFather. A edição de perfil e o botão de aplicar o menu no painel atuam sobre o principal. Já o texto das respostas aos comandos continua compartilhado. Essa diferença importa ao preparar a apresentação de cada marca: aparência no Telegram e conteúdo das respostas têm lugares distintos de configuração.

Como ficam grupos, canais e o Postador?

Para atuar num grupo, o sub-bot precisa ter as permissões exigidas pelas ações que realizará. A opção de aplicar permissões sugeridas prepara o convite como administrador; confira também os direitos concedidos no grupo em uso. Com o módulo Grupos, o Porteiro consulta a participação no canal pelo bot principal, que precisa ser administrador desse canal. O sub-bot atua como administrador do grupo.

O envio direto do Postador utiliza o bot principal. Ter apenas o sub-bot como administrador de um canal não basta para publicar ali por esse caminho. Para planejar a produção de posts e os destinos, a página do módulo Ofertas explica o papel do Postador na operação.

Como acompanhar um sub-bot que parou de responder?

A tabela de gerenciamento mostra o último sinal e oferece a ação Reativar webhook. Webhook é a conexão usada pelo Telegram para entregar mensagens ao sistema; reaplicá-la é uma das verificações possíveis quando um sub-bot deixa de atender. Também é necessário conferir se o token continua válido e se o módulo permanece ativo.

Tokens são credenciais de acesso ao bot e ficam armazenados com criptografia. A documentação de segurança e tokens explica os cuidados com esse acesso. O gerenciamento fica com o dono e administradores da organização. Se a operação também utiliza ofertas, cupons e integração por IA, o Combo Operação Completa inclui Sub-bots entre os módulos reunidos.

Como ativar o módulo Sub-bots

  1. Selecione Sub-bots

    Entre pela Central do Afiliado e adicione Sub-bots em Conta › Assinaturas, junto ao plano base.

  2. Crie outra identidade

    No BotFather do Telegram, crie o bot que será adicionado e obtenha o token próprio dele. Defina um @ adequado ao canal ou à marca.

  3. Cadastre o token

    Abra Configuração › Configurações do bot › Gerenciar sub-bots. Cole o token e clique em Adicionar; o sistema identifica o @ e configura o webhook.

  4. Confira o atendimento

    Abra o sub-bot no Telegram e teste uma conversa. Se ele atuar em grupos, confira as permissões necessárias; a ação Permissões sugeridas ajuda a preparar o convite como administrador.

Para quem é o módulo Sub-bots

Combina com

Perguntas frequentes sobre o módulo Sub-bots

Cada sub-bot pode usar uma conta de afiliado diferente?

Não. As contas e rotas são as do bot principal. Para separar clientes com contas próprias, é necessário outro bot com configuração independente ou outra organização, conforme a operação.

Posso cadastrar o mesmo token duas vezes?

Não. Cada token só pode estar ligado a um bot ou sub-bot por vez. A mensagem Token já cadastrado indica que ele está em uso.

Preciso informar o nome e configurar o webhook à mão?

No cadastro por Gerenciar sub-bots, o @ é identificado pelo token e o webhook é configurado automaticamente. O botão Reativar webhook permite reaplicar a conexão depois.

O Postador publica usando o sub-bot?

O envio direto do Postador sai pelo bot principal. Para publicar num canal por esse caminho, confira as permissões do principal naquele canal.

O painel altera a foto e o menu de comandos de cada sub-bot?

A edição de perfil e a aplicação do menu de comandos pelo painel usam o bot principal. Nome, foto, descrição e menu próprio do sub-bot são ajustados pelo BotFather.

O que acontece ao desativar o módulo?

Os sub-bots param de atender, mas seus cadastros não são apagados pela cobrança. O funcionamento do bot principal continua sujeito ao plano base e aos módulos que permanecerem ativos.

A cobrança é por sub-bot adicionado?

Não. Sub-bots é um módulo cobrado por organização, somado ao plano base, sem cobrança por unidade de sub-bot.

Para se aprofundar

Pronto pra ativar o módulo Sub-bots?

No painel, abra Conta › Assinaturas, marque Sub-bots e conclua o pagamento. O módulo pode ser desligado quando você quiser.