O que é o Boteco Imperial e como ele funciona na prática
O Boteco Imperial é um framework de automação para WhatsApp que permite criar robôs de atendimento, disparo em massa e respostas automáticas. Ele roda como um serviço local na sua máquina, se conecta à API do WhatsApp Web e fica escutando mensagens o tempo todo. O diferencial dele em relação a muitas ferramentas similares é a interface de configuração via painel web, que facilita a criação de fluxos sem precisar escrever código do zero. Eu comecei a usar ele há uns dois anos quando precisei montar um sistema de resposta automática para uma loja de peças automotivas. O cliente queria que o WhatsApp respondesse horas fora do expediente com informações de catálogo e preços. A maioria das ferramentas disponíveis na época exigia configuração manual de tokens e endpoints que davam dor de cabeça. O Boteco Imperial simplifica isso, mas não é mágica — tem seus jeitos.
Instalação e primeiros passos com o Boteco Imperial
Você baixa o pacote diretamente do repositório oficial, descompacta na pasta que quiser e roda o arquivo de inicialização. Ele vai subir um servidor local que fica escutando numa porta específica, normalmente a 8080 ou 8081. Depois disso, você acessa o painel pelo navegador, faz o login escaneando o QR code com seu WhatsApp e pronto — a conexão está ativa. O painel permite criar comandos personalizados. Cada comando é basicamente uma palavra-chave que, quando detectada na conversa, dispara uma ação. Pode ser uma mensagem de texto, um arquivo de áudio, um link, ou até um fluxo encadeado de várias etapas. A sintaxe dos comandos é simples: você define o gatilho, a resposta e opcionalmente um delay entre as mensagens.
Aqui vai algo que ninguém conta nos tutoriais básicos: o Boteco Imperial tem um limite de velocidade de envio que varia conforme a versão e a infraestrutura do WhatsApp. Se você tentar enviar vinte mensagens em sequência rápida, a conta é flagreada em questão de minutos. A regra prática que eu descobri depois de perder dois números é esperar entre trinta segundos e dois minutos entre cada mensagem em massa. Para atendimento conversacional individual, esse limite não pesa tanto assim, desde que você não use o bot como ferramenta de spam.
Pegadinhas e limitações que você precisa saber antes de investir
O primeiro problema real que eu enfrentei foi com a atualização da API do WhatsApp Web. O Boteco Imperial depende de uma versão específica do protocolo, e quando a Meta atualiza sem aviso, o bot para de funcionar do dia pra noite. Eu passei três dias tentando resolver quando isso aconteceu num projeto de cliente. A solução foi verificar o repositório oficial se havia uma nova versão do pacote, e se não houvesse, aguardar o ajuste dos desenvolvedores. Esse é um risco permanente — nenhuma ferramenta baseada em WhatsApp Web está livre disso. Outro ponto: o Boteco Imperial exige que a máquina que roda o serviço fique ligada e conectada à internet 24 horas por dia. Ele não roda em nuvem nativamente. Se o computador desliga, a internet cai, ou o Windows atualiza sozinho no meio da noite, o bot para. Eu cheguei arar um computador antigo só pra isso, com um plano de internet dedicado, mas mesmo assim teve dias em que o serviço ficou no ar por falta de reinício automático depois de uma queda de energia. Um script de monitoramento simples que verifica se o processo está rodando e reinicia caso contrário resolveu grande parte do problema.
👉 Clique no botão abaixo para saber mais sobre o assunto!
A versão gratuita tem limitações sérias. O número de comandos ativos é restrito, o disco de armazenamento de arquivos de mídia é pequeno, e o suporte é basicamente comunidade. Se você precisa de algo profissional, acaba migrendo para as versões pagas, que cobram mensalidade baseada no volume de uso. Eu testei as três e a relação custo-benefício só faz sentido para quem já tem tráfego consolidado. Para quem está começando, recomendo começar com a versão gratuita, validar o fluxo de atendimento, e só depois pensar em upgrade.
Configurando fluxos avançados no Boteco Imperial
Depois de dominar o básico, o próximo nível envolve criar fluxos condicionais. Você pode fazer com que o bot responda de formas diferentes dependendo do que o usuário digita. Por exemplo, se a pessoa mandar "preço", o bot responde com uma tabela. Se mandar "atendimento", encaminha para um operador humano. Se mandar qualquer outra coisa, manda um menu de opções. A sintaxe usa variáveis e condições que lembram programação básica. Não precisa ser expert em código, mas precisa ter lógica. Um fluxo que eu montei recentemente para uma clínica odontológica funcionava assim: o paciente enviava o nome, o bot pesquisava no banco de dados local, e se encontrasse o registro, pedia o motivo da visita. Se não encontrasse, encaminhava para o cadastro. O detalhe importante aqui era o timeout — se o paciente demorasse mais de cinco minutos para responder, o bot encerrava a sessão automaticamente e pedia para reiniciar. Sem esse timeout, as conversas ficavam abertas indefinidamente e o banco de dados encheria de registros órfãos.
Também dá para integrar com planilhas Google Sheets. Cada interação pode salvar dados automaticamente numa aba, o que é útil para quem precisa de relatórios de atendimento. Eu configuro isso em todos os projetos agora. Basta inserir as credenciais da API do Google e mapear as colunas. Leva cerca de vinte minutos para colocar no ar e funciona de forma estável. O download do Boteco Imperial é feito pelo site oficial ou pelo repositório GitHub do desenvolvedor. Sempre verifique a versão mais recente antes de instalar, porque as atualizações costumam corrigir bugs de conexão e adicionar novos comandos. A instalação em si leva entre cinco e dez minutos, dependendo da velocidade do seu download e da configuração do ambiente Node.js no seu computador.
A parte chata é a manutenção contínua. O WhatsApp mudou a API novamente no mês passado e eu precisei ajustar três fluxos que quebraram. Se você vai usar o Boteco Imperial a longo prazo, reserve um tempo semanal para verificar se há atualizações e testar se os comandos estão respondendo corretamente. Caso contrário, você descobre que o bot parou de funcionar só quando o cliente liga reclamando que ninguém respondeu.
