Discord

Como o Discord funciona aqui

Os membros acessam o bot por meio de um comando de barra, e não conversando normalmente. Digitar /ask quanto custa o frete? gera uma resposta; digitar quanto custa o frete? no canal não.

Isso é intencional. Um bot que lê todas as mensagens de um servidor precisa de um acesso muito mais amplo às conversas da sua comunidade e gastaria créditos com conversas nas quais nunca foi chamado a participar. O comando de barra mantém o restante do servidor privado e dá aos membros o controle sobre quando o bot está escutando.

Adicionar ao servidor (um clique)

Abra Configurações → Canais na barra lateral do painel e, no cartão Discord, escolha Autorizar. A janela abre com Adicione o bot do ProxyAI ao seu servidor e o botão Adicionar ao servidor.

1. Escolha Adicionar ao servidor. A tela de permissões do Discord abre em uma nova aba.
2. Escolha o servidor. Você precisa da permissão Gerenciar servidor nele, regra do Discord para adicionar qualquer app, não nossa.
3. Escolha Autorizar. Você volta ao painel do ProxyAI.

Depois disso, os membros podem usar /ask nesse servidor. Não há nada para criar, nada para configurar e nenhum site de desenvolvedor para visitar.

O bot pede duas permissões: Ver canais e Enviar mensagens. O comando de barra funciona sem nenhuma delas; elas permitem que uma pessoa da sua equipe responda no canal a partir da caixa de entrada do ProxyAI.

Para adicionar um segundo servidor, escolha Adicionar ao servidor novamente e selecione-o. Para remover o bot, retire-o do servidor no próprio Discord.

Uma peculiaridade que vale saber: o item de menu Verificar novamente do cartão só analisa as configurações avançadas abaixo, então depois de uma instalação com um clique ele mostra "Não configurado". A conexão está funcionando; confirme executando /ask no seu servidor.

Avançado: use o seu próprio bot

Escolha esta opção quando quiser que o bot tenha o seu próprio nome e imagem, um comando diferente de ask ou que responda mensagens diretas. Ela exige criar uma aplicação no site de desenvolvedores do Discord, por isso dá mais trabalho.

1. Abra o Portal do Desenvolvedor do Discord e escolha New Application. O nome que você der é o que os membros verão.
2. Abra a aba Bot, escolha Reset Token e copie o Bot Token. O Discord mostra o token apenas uma vez.
3. Abra General Information e copie a Public Key. O ProxyAI a usa para confirmar que as requisições realmente vêm do Discord.
4. Na janela do ProxyAI, abaixo de Avançado, traga o seu próprio bot, cole os dois valores.
5. Opcionalmente, defina um nome de Comando de barra em minúsculas e sem espaços. Deixe em branco para ask.
6. Escolha Salvar.

A janela também mostra uma URL do endpoint de interações, com botão de copiar. Você não precisa dela: ao salvar, o sistema verifica o seu bot, cria o comando de barra e aponta a sua aplicação para o ProxyAI.

Em seguida, convide o seu bot:

1. Portal do Desenvolvedor → Installation.
2. Em Installation Contexts, ative Guild Install para servidores e também User Install se quiser que o bot responda mensagens diretas.
3. Em Default Install Settings, dê os escopos applications.commands e bot e a permissão Enviar mensagens.
4. Copie o Install Link, abra-o e escolha o seu servidor.

Os dois valores são segredos. Se algum deles vazar, redefina o token no site do Discord e salve o novo aqui.

Teste

Num servidor em que o bot está instalado, digite /ask e envie uma pergunta. O Discord mostra o bot pensando, e a resposta chega alguns segundos depois.

• O comando não aparece: um comando recém-criado pode levar até uma hora para chegar a todos os servidores, e o Discord guarda a lista em cache por dispositivo. Aguarde e recarregue com Ctrl+R (Cmd+R no Mac). Confirme que o bot foi convidado com o escopo applications.commands.
• "Este servidor ainda não está conectado a um assistente": o bot está no servidor, mas nenhum bot do ProxyAI o reivindicou. Execute Adicionar ao servidor no seu painel.
• "Este assistente funciona dentro de um servidor": você enviou uma mensagem privada ao bot compartilhado do ProxyAI. O bot compartilhado responde apenas dentro de servidores; mensagens diretas exigem o seu próprio bot com User Install ativado.
• "O aplicativo não respondeu": a resposta demorou demais ou a conexão foi recusada. Na rota avançada, salve as configurações do Discord novamente.
• Falha ao salvar com erro de token inválido: o token foi redefinido depois que você o copiou. Redefina mais uma vez e cole o valor novo.
• Uma resposta humana nunca chega: o bot não tem Enviar mensagens naquele canal específico. Verifique as permissões do próprio canal, não apenas o cargo do servidor.

Conversas e privacidade

Na caixa de entrada do agente, uma conversa pertence a um canal do Discord, não a um membro. Em um canal compartilhado, todos que usam o comando ali compartilham um mesmo histórico, e uma resposta humana fica visível para o canal inteiro. Mensagens diretas, quando você as ativou, permanecem privadas para cada membro.

O bot vê apenas o texto digitado no comando. Todo o restante do que é dito no seu servidor fica fora do ProxyAI.