Integração com Discord

Adicione seu agent a servidores do Discord usando slash commands e mensagens diretas.

Visão Geral

A integração com Discord oferece:

Suporte a slash commands (/ask)
Conversas por mensagem direta
Disponibilidade em todo o servidor
Respostas específicas por canal
Formatação com embeds enriquecidos
DMs em modo texto opcionais (sem prefixo de comando)

Pré-requisitos

Uma conta do Discord
Permissões de Manage Server no servidor de destino
Acesso ao Discord Developer Portal

Passos de Configuração

1. Criar uma Aplicação no Discord

Acesse o Discord Developer Portal
Clique em New Application
Insira um nome (por exemplo, “My Support Bot”)
Clique em Create

2. Obter Suas Credenciais

No Discord Developer Portal, colete estes valores:

Campo	Descrição	Onde Encontrar
Application ID	O ID do seu app do Discord	Página General Information
Public Key	String hex de 64 caracteres para verificação de assinatura	Página General Information
Bot Token	Token secreto do seu bot	Seção Bot → Reset Token
Guild ID (opcional)	ID do servidor para registro instantâneo de comandos	Clique com o botão direito no servidor → Copy Server ID

Mantenha seu Bot Token seguro — nunca o compartilhe publicamente. Qualquer pessoa com o seu token pode controlar o seu bot.

3. Conectar ao Cuneiform Chat

Vá para Agents → Selecione seu agent
Navegue até a aba Integrations
Clique em Discord
Insira seu Application ID, Public Key e Bot Token
Opcionalmente, insira um Guild ID para registro instantâneo dos slash commands
Clique em Connect

4. Configurar a Webhook URL (Obrigatório)

Após conectar, você verá uma janela de sucesso com sua Webhook URL:

Copie a Webhook URL da janela de sucesso
No Discord Developer Portal, vá para General Information
Localize Interactions Endpoint URL
Cole a webhook URL e clique em Save Changes

Este passo é obrigatório. O Discord usa essa URL para enviar as interações de slash commands ao seu bot.

5. Adicionar o Bot ao Seu Servidor

Use o botão Add to Server no card da integração ou use a URL de convite fornecida após a conexão. Isso adiciona o bot com as permissões necessárias.

Usando o Bot

Slash Commands

Os usuários interagem com seu bot usando o slash command /ask:


/ask Qual é o horário de atendimento?

O bot processa a pergunta e responde no canal.

Mensagens Diretas

Envie uma mensagem ao bot diretamente para conversas privadas:

Encontre o bot na lista de membros do seu servidor
Clique com o botão direito e selecione Message
Use o comando /ask ou ative Text DMs (veja abaixo)

Chave Text DMs

A chave Text DMs no card da integração controla o comportamento das mensagens diretas:

Off (padrão): Os usuários precisam usar o comando /ask em DMs
On: Os usuários podem enviar mensagens em texto puro em DMs (sem prefixo de comando)

Ao ativar Text DMs, você precisa habilitar Message Content Intent em Discord Developer Portal → seção Bot → Privileged Gateway Intents.

Formato da Resposta

As respostas aparecem como embeds enriquecidos com:

Texto da resposta
Referências de fonte (opcional)
A identidade visual do seu bot

Recursos

Acesso em Todo o Servidor

Uma vez adicionado, o bot fica disponível em todos os canais de texto onde tiver permissões.

Suporte a Threads

O bot pode responder em threads, mantendo as conversas organizadas.

Comandos Instantâneos vs Globais

Com Guild ID: Os slash commands são registrados instantaneamente naquele servidor
Sem Guild ID: Os comandos globais levam até 1 hora para se propagar

Forneça um Guild ID durante a configuração para ter slash commands disponíveis instantaneamente. Você pode adicionar mais servidores depois.

Gerenciando o Seu Bot

Cada bot conectado exibe:

Nome de usuário do bot e status (Active/Error)
Application ID
Agent associado
Carimbo de Last activity
Webhook URL (para referência)

Ações Disponíveis

Ação	Descrição
Add to Server	Abre o link de convite para adicionar o bot a um servidor
Portal	Abre o Discord Developer Portal para este app
Copy URL	Copia a webhook URL
Test Connection	Verifica a conectividade do bot
Disconnect	Remove esta integração

Solução de Problemas

O Bot Não Está Respondendo

Verifique se a Interactions Endpoint URL está configurada no Discord Developer Portal
Confirme se o bot tem permissões no canal
Verifique se o token está correto no Cuneiform Chat
Confirme se os slash commands estão registrados (ao digitar / o seu comando aparece)

Comandos Não Aparecem

Os slash commands podem levar até uma hora para se registrar globalmente. Para testes imediatos:

Forneça um Guild ID durante a configuração para registro instantâneo
Aguarde a propagação global se nenhum Guild ID foi fornecido

Erros de Permissão

Garanta que o bot tenha estas permissões:

Send Messages
Use Slash Commands
Embed Links
Read Message History (para suporte a threads)

Text DMs Não Funcionam

Verifique se a chave Text DMs está ativada no card da integração
Habilite Message Content Intent em Discord Developer Portal → seção Bot
Reinicie a conexão do bot, se necessário

Segurança

Os bot tokens são criptografados e armazenados de forma segura
Os comandos usam a verificação de assinatura nativa do Discord
Não há acesso a dados do servidor além das interações diretas

Desconectando

Para remover a integração com Discord:

Vá para Agents → Selecione o agent → Integrations
Clique no menu de três pontos no seu bot do Discord
Selecione Disconnect

Para remover totalmente o bot do Discord:

Vá para as configurações do seu servidor do Discord
Navegue até Integrations → Remova o bot