Solução de problemas
Bot offline, intents, permissões, cargo acima do bot, Pix que não confirma, DM fechada e assinatura vencida: causa e solução.
Nesta página
Comece pelo sintoma. Cada item diz a causa mais provável e como resolver. Muitas respostas aparecem também em Meu bot e no checklist do /setup, que mostram o que está errado com o seu servidor.
O bot está offline
Abra Meu bot e veja a mensagem do passo 3. Ela diz o motivo:
Causa provável
Acabou de conectar ou trocar o token.
Como resolver
O bot leva até 1 minuto para ligar. A página confere sozinha a cada 5 segundos.
Causa provável
"Token inválido ou revogado".
Como resolver
O token foi trocado no Developer Portal ou está errado. Gere um novo em BotReset Token e cole em Meu bot. Veja Copiar o token.
Causa provável
"O bot não liga porque este servidor não tem assinatura ativa".
Como resolver
Assine ou renove em Assinar. O bot liga sozinho em até 1 minuto depois do pagamento confirmado.
Causa provável
"O bot deste servidor foi pausado pela equipe da Kyo".
Como resolver
Fale com o suporte da Kyo por ticket no nosso servidor do Discord.
Causa provável
Falha ao entrar no Discord por instabilidade.
Como resolver
Depois de uma falha, o bot tenta de novo sozinho, com intervalos cada vez maiores (de 5 minutos até 1 hora). Corrigiu o que estava errado? Clique em Conectar de novo em Meu bot para ele tentar na hora.
Erro de intents
Causa provável
"Falta um ajuste no seu bot" ou "Falta ativar a intent Server Members".
Como resolver
- No Developer Portal, abra o seu bot e vá em BotPrivileged Gateway Intents.
- Ligue Server Members Intent (e, de preferência, Message Content Intent).
- Clique em Save Changes.
- Volte em Meu bot e clique em Conectar de novo.
Causa provável
Anti-link não funciona, registro de mensagens sem texto ou transcrição de ticket vazia.
Como resolver
Falta a Message Content Intent. Ligue no Developer Portal. Ela passa a valer quando o bot reconectar; para valer na hora, gere um token novo e cole em Meu bot. Veja Ativar as intents.
Os comandos não aparecem
Causa provável
O Discord ainda não atualizou a lista de comandos, ou o bot foi convidado sem permissão de comandos.
Como resolver
- Feche e abra o Discord (no computador, Ctrl+R recarrega).
- Em Meu bot, clique em Convidar bot de novo e autorize. Isso atualiza as permissões, inclusive a de comandos.
- Lembre que cada comando só aparece para quem tem a permissão dele. O
/kyo, por exemplo, só aparece para quem tem Gerenciar servidor. Veja a Referência de comandos. - Confira se ninguém bloqueou o comando em Configurações do servidorIntegrações.
Falta permissão
Causa provável
O bot responde "O bot não consegue escrever neste canal" ou cita uma permissão que falta.
Como resolver
- O canal tem uma regra que bloqueia o bot. Em Editar canalPermissões, libere para o cargo do bot o que a mensagem pede: normalmente Ver canal, Enviar mensagens e Inserir links.
- Para tópicos privados (pedidos e tickets): Criar tópicos privados e Enviar mensagens em tópicos.
- Para tickets em canal: Gerenciar canais e Gerenciar permissões.
- Se faltar algo no servidor todo, clique em Convidar bot de novo em Meu bot e autorize.
O bot não consegue dar um cargo
Causa provável
O cargo está acima do cargo do bot, tem permissões de equipe ou é um cargo de integração.
Como resolver
- Em Configurações do servidorCargos, arraste o cargo do bot para acima do cargo que ele precisa dar.
- Por segurança, cargos com permissões de equipe (Administrador, banir, expulsar, castigar, gerenciar servidor, cargos, canais ou mensagens, mencionar @everyone, silenciar, ensurdecer ou mover membros, ver o registro de auditoria) nunca são dados automaticamente. Use um cargo sem essas permissões.
- Cargos criados por bots e integrações (como o de Booster) não podem ser dados à mão pelo Discord.
- O bot precisa da permissão Gerenciar cargos.
Na entrega de produto, se o cargo falhar, o comprador é avisado e a equipe também. No cargo automático, o motivo vai para o canal de logs de moderação.
O Pix não confirma
Causa provável
A confirmação ainda não rodou, o gateway está com erro ou o pagamento não bate com a cobrança.
Como resolver
- Espere 1 ou 2 minutos: Pix recentes são conferidos a cada minuto.
- Em Pagamentos, veja a situação e use Testar conexão. Se aparecer erro, conecte de novo com credenciais válidas.
- Credencial de teste (Mercado Pago com TEST-, Efí em homologação) não movimenta dinheiro de verdade. Use as de produção para vender.
- Pix pago com valor menor que o cobrado não é liberado: a equipe precisa verificar.
- Pagou depois de vencer? O pagamento ainda é honrado: o pedido é reaberto e entregue se houver estoque. Veja Pix, QR Code e validade.
- Confira o pedido em Vendas e pedidos. Pago há mais de 15 minutos e ainda não confirmado? Abra um ticket no servidor da Kyo com o número do pedido.
Causa provável
O cliente vê "Os pagamentos desta loja estão indisponíveis no momento".
Como resolver
Nenhum gateway está conectado e testado. Configure em Pagamentos.
O cliente está com a DM fechada
Causa provável
O comprador bloqueou mensagens diretas de membros do servidor.
Como resolver
- Com o tópico privado do pedido ligado, a entrega é postada no tópico e o pedido é marcado como entregue normalmente.
- Sem tópico, o bot tenta de novo a cada 5 minutos por até 24 horas. Depois disso o pedido fica pago esperando a equipe entregar por outro caminho (um ticket, por exemplo).
- Peça ao cliente para liberar as DMs do servidor: clicar no nome do servidor, abrir Configurações de privacidade e ligar Mensagens diretas. Depois ele usa
/meus-pedidospara reenviar a entrega.
Assinatura vencida
Causa provável
O prazo da assinatura ou do teste grátis acabou.
Como resolver
- O bot sai do ar até a renovação. Nada do que você configurou é apagado: produtos, estoque, pedidos e configurações continuam.
- Renove em Assinar (ou no botão Renovar do
/kyo, quando o bot está no ar). O bot volta sozinho em até 1 minuto depois do Pix confirmado. - O teste grátis é um por conta: um segundo servidor precisa de assinatura própria desde o início.
O bot saiu do servidor sozinho
Causa provável
O bot foi convidado para um servidor diferente do que está cadastrado.
Como resolver
Cada bot atende um servidor só. Se ele for convidado para outro, avisa quem convidou por DM e sai. Para usar a Kyo em mais um servidor, crie outro bot no Developer Portal e conecte ele no servidor novo. Veja 1 servidor, 1 bot, 1 assinatura.
Ainda com problema?
Abra um ticket no servidor da Kyo no Discord (o link fica no rodapé do site e no menu do painel). Conte o que aconteceu, o nome do servidor e, se for sobre uma venda, o número do pedido. Nunca mande o token do bot nem credenciais de pagamento.