Pular para o conteúdo
Guia 01

Primeiros passos

De “Adicionar à Twitch” até a sua primeira live com o bot no chat. Sete minutos no total, a maior parte lendo.

Neste guia
7 min de leitura

01Conecte seu canal

em um relanceUm único login na Twitch. Sem chaves de API, sem arquivos de configuração, nada para instalar.

Acesse dashboard.itsbagelbot.com e entre com a sua conta da Twitch. A Twitch mostra exatamente o que o bot pode fazer antes de você aprovar qualquer coisa, e essa é toda a instalação. Assim que você entrar, o ItsBagelBot entra no seu chat e fica em silêncio até alguém falar com ele.

No primeiro acesso, um tour rápido recebe você. Clique em Começar a configuração e ele segue esta ordem: Acordos legais (marque a caixa para aceitar os Termos de Serviço e a Política de Privacidade), Tornar ItsBagelBot moderador (digite /mod ItsBagelBot no seu próprio chat), Escolha seu idioma para o painel, e depois Conte mais, onde você escolhe uma configuração: Começar como novo streamer, Integrar à minha configuração, Silêncio completo ou Importar configuração. O caminho de novo streamer adiciona duas paradas rápidas, Comandos são atalhos de chat e Módulos adicionam os extras, e termina em Concluir configuração. Você pode mudar todas as escolhas depois no seu painel.

A etapa de moderador é mais importante do que parece: sem esse status, a Twitch silencia o bot assim que o chat entra no modo só para seguidores, só para inscritos ou modo lento, e ele parece quebrado. Você também pode fazer isso depois.

O que o seu chat vê, cerca de dois segundos depois que você entra.
Bom saber O bot nunca fala sem ser chamado. Até você criar comandos ou ativar módulos, entrar no chat é a única coisa que ele faz: seu chat continua exatamente como estava.

02Conheça o painel

em um relanceSeis paradas no trilho de navegação. Você vai passar a maior parte do tempo em duas delas.

O painel mostra uma página por vez, e toda a navegação fica no trilho de seis itens à esquerda da tela, que vira uma barra flutuante na parte de baixo no celular. Visão geral é a sua página inicial, Comandos guarda os comandos personalizados do chat, e Módulos reúne todos os recursos maiores. Discord tem página própria para conectar um servidor do Discord (beta paga). Cobrança e Configurações fazem o que o nome diz.

  • O trilho é toda a navegação: Visão geral, Comandos, Módulos, Discord, Cobrança, Configurações. No celular, os mesmos seis ficam em uma barra na parte de baixo.
  • Status do bot: se o ItsBagelBot está no seu chat agora, com o botão para corrigir caso não esteja.
  • Ações rápidas: as duas coisas que você mais faz, a um toque de distância.
  • Seus comandos mais usados ficam aqui também, a um clique de editar.
A página Visão geral. A navegação fica no trilho à esquerda e, no celular, em uma barra na parte de baixo.

Tudo o que você faz no painel é salvo assim que você confirma: não há uma etapa de “publicação”, e as mudanças costumam chegar ao seu chat em poucos segundos.

03Crie seu primeiro comando

em um relanceUm nome e uma resposta. Todo o resto é opcional.

Abra Comandos e clique em Novo comando. Um comando precisa de apenas duas coisas: um nome (o que os espectadores digitam depois do !) e uma resposta (o que o bot responde). Vamos fazer o clássico:

  • Novo comando abre o editor, acoplado ao lado da lista no computador (um painel que se abre de baixo para cima no celular).
  • O nome, sem o “!” (o painel adiciona no chat). Minúsculas, sem espaços.
  • A resposta. Texto simples basta; o próximo guia mostra as variáveis que deixam tudo mais inteligente.
  • Criar salva na hora, e o comando entra no chat logo em seguida.
A página Comandos: sua lista à esquerda, o editor acoplado à direita.
Trinta segundos depois, no chat.

O editor também oferece níveis de acesso (de todos até o streamer), tempos de espera comum e por espectador, e uma chave “só ao vivo”. Tudo é opcional e tudo é explicado no guia de comandos.

04Ative seu primeiro módulo

em um relanceMódulos são recursos maiores com um interruptor. Os alertas de chat já estão ativos para você.

Vá até Módulos. Cada linha é um recurso com o próprio interruptor, e clicar na linha abre as configurações dele. Os Alertas de chat (seguidores, inscrições, bits, raids) já funcionam para você. O AutoMod é uma beta Premium: um canal gratuito recebe apenas a proteção básica (contra insultos discriminatórios e links que coletam endereços IP), e as verificações completas exigem o Premium. Dois módulos nunca mostram um interruptor: Contadores e Gerenciamento da transmissão (os comandos por trás de !title, !game e !marker) estão sempre ativos.

  • O trilho de categorias. Clique em um grupo e a lista rola até ele.
  • Uma linha é um módulo: o nome, uma frase sobre ele, os comandos que ele traz e o interruptor. Os alertas de chat começam ativados; a maioria dos outros espera por você.
A página Módulos: um trilho de categorias à esquerda, uma linha por módulo e um interruptor.

Nada aqui é arriscado de explorar: cada módulo pode ser desligado tão rápido quanto foi ligado, e as configurações dele são mantidas para a próxima vez. O tour completo do que cada um faz está no manual de módulos.

05Entre ao vivo com tranquilidade

em um relanceUma lista de conferência de dois minutos, e depois o bot assume o turno da noite.

Antes da sua próxima live, um ensaio rápido:

  1. Digite você mesmo o seu novo comando no chat: o bot responde como responderia a qualquer espectador.
  2. Revise as mensagens dos Alertas de chat e deixe com a sua cara.
  3. Costuma receber raids? Ative a Divulgação automática para que quem chegar por raid seja recebido mesmo quando você estiver jogando.

E pronto, essa é toda a configuração. A partir daqui o bot modera, recebe e responde sozinho, e tudo o que você acabou de fazer pode ser alterado durante a live pelo seu celular.

O próximo passo Deixe seus comandos inteligentes: Comandos e variáveis mostra como uma linha como Bem-vindo, {user}! cumprimenta cada espectador pelo nome.
Sua lista da primeira hora

06Se o bot não estiver no chat

em um relanceO Status do bot, na página Visão geral, diz o que fazer.

Abra Visão geral e olhe o Status do bot. Ele mostra um estado e os botões correspondentes. Quando a conexão está funcionando, o cartão mostra Reiniciar e Desconectar. Ativar religa um bot que você desligou. Reconectar leva você às Configurações, onde você escolhe Reconectar a Twitch para entrar de novo com a sua conta da Twitch depois que a Twitch retirou o acesso do bot. Um banimento precisa de outra solução, no chat da Twitch: digite /unban ItsBagelBot. Você ou um dos seus moderadores pode fazer isso. Também é possível remover o bot da lista de banidos nas configurações de moderação do seu Painel do criador da Twitch.

Se algo der errado
O que você vêO que isso significaO que fazer
Não conectado: “O bot não tem nenhuma autorização da Twitch para o seu canal.”O bot não está conectado ao seu canal.Selecione Conectar.
Desativado por você: “Seu bot está desativado. Ative-o novamente para voltar ao chat.”Você desativou o bot.Selecione Ativar.
Reconexão necessária ou acesso à Twitch perdido: “A Twitch revogou o acesso do bot ao seu canal. Isso acontece após uma troca de senha ou se o aplicativo foi desconectado na Twitch. Reconecte sua conta da Twitch para trazer o bot de volta.”A Twitch não permite mais que o bot atue no seu canal.Selecione Reconectar. Isso leva você às Configurações. Lá, escolha Reconectar a Twitch.
Bot banido do seu chat: “O ItsBagelBot está banido do seu chat. Para desbani-lo, digite /unban ItsBagelBot no seu chat da Twitch (você ou um dos seus moderadores podem fazer isso), ou remova-o da lista de banidos nas configurações de moderação do seu Painel do criador da Twitch. Depois disso, ele volta a entrar no chat sozinho.” ou “O ItsBagelBot está banido do seu chat. Para desbani-lo, digite /unban ItsBagelBot no seu chat da Twitch (você ou um dos seus moderadores podem fazer isso), ou remova-o da lista de banidos nas configurações de moderação do seu Painel do criador da Twitch. Depois, selecione “Já desbani, verificar de novo”.”O seu chat baniu o bot, então ele não consegue entrar.Digite /unban ItsBagelBot no seu chat da Twitch. O bot volta sozinho. Se o botão disser Já desbani, verificar de novo, selecione-o. Se disser Ativar e verificar desbanimento, selecione esse.
“O ItsBagelBot ainda está banido do seu chat. Digite /unban ItsBagelBot no seu chat da Twitch e depois selecione “Ativar e verificar desbanimento”.”A verificação encontrou o banimento ainda em vigor.Desbana o bot e depois selecione Ativar e verificar desbanimento.
Falha na verificação: “Não foi possível confirmar o acesso. Tente novamente depois de corrigir o problema.”O bot não conseguiu confirmar o acesso dele.Corrija o problema e selecione Tentar verificar novamente.
Em espera: “O bot acorda automaticamente quando um recurso ativado é usado. Suas configurações são mantidas.”O bot descansa até que alguém precise dele.Nada. Ele acorda sozinho.
Suspenso temporariamente: “O bot continua pausado até o fim da suspensão e a verificação do acesso.”O bot foi suspenso temporariamente do seu chat.Espere a suspensão terminar. Depois, o bot verifica o acesso de novo.
Conectado · inativo: “O bot está conectado, mas não responde no chat.”O bot está no seu chat, mas não responde.Selecione Ative acima.
“O bot perdeu a conexão com o chat, então os espectadores podem não receber respostas.” ou “O bot perdeu a conexão com o chat. Corrija em Configurações → Reconectar”A conexão do bot com o chat caiu.Selecione Reconectar. Isso leva você às Configurações. Lá, escolha Reconectar a Twitch.
Reconectando…: “Verificando o acesso antes de retomar.”O bot verifica o acesso antes de voltar.Aguarde um instante. O status muda sozinho.
“A autorização da Twitch também precisa ser renovada.”Outra permissão da Twitch precisa ser renovada.Selecione Reconectar ao lado da mensagem e depois escolha Reconectar a Twitch nas Configurações.
Verificando a conexão… ou Conectando…O painel ainda está lendo o status do bot.Aguarde um instante.
Status da conexão indisponívelO painel não conseguiu ler o status do bot.Recarregue a página daqui a pouco.
Nota Verificado em 12 de outubro de 2026.