Skip to Content
IntegracionesDiscord

Integración con Discord

Agrega tu agent a servidores de Discord mediante slash commands y mensajes directos.

Descripción General

La integración con Discord ofrece:

  • Soporte de slash commands (/ask)
  • Conversaciones por mensaje directo
  • Disponibilidad en todo el servidor
  • Respuestas específicas por canal
  • Formato de embeds enriquecidos
  • DMs de texto opcionales (sin necesidad de prefijo de comando)

Requisitos Previos

  • Una cuenta de Discord
  • Permisos de Manage Server en el servidor objetivo
  • Acceso al Discord Developer Portal

Pasos de Configuración

1. Crear una Aplicación de Discord

  1. Ve al Discord Developer Portal
  2. Haz clic en New Application
  3. Ingresa un nombre (por ejemplo, “My Support Bot”)
  4. Haz clic en Create

2. Obtener tus Credenciales

Desde el Discord Developer Portal, recopila estos valores:

CampoDescripciónDónde Encontrarlo
Application IDEl ID de tu app de DiscordPágina General Information
Public KeyCadena hex de 64 caracteres para verificación de firmasPágina General Information
Bot TokenToken secreto para tu botSección Bot → Reset Token
Guild ID (opcional)ID del servidor para registro instantáneo de comandosClic derecho en el servidor → Copy Server ID

Mantén tu Bot Token seguro — nunca lo compartas públicamente. Cualquiera con tu token puede controlar tu bot.

3. Conectar a Cuneiform Chat

  1. Ve a Agents → Selecciona tu agent
  2. Navega a la pestaña Integrations
  3. Haz clic en Discord
  4. Ingresa tu Application ID, Public Key y Bot Token
  5. Opcionalmente ingresa un Guild ID para el registro instantáneo de slash commands
  6. Haz clic en Connect

4. Configurar la Webhook URL (Obligatorio)

Tras conectarte, verás un diálogo de éxito con tu Webhook URL:

  1. Copia la Webhook URL del diálogo de éxito
  2. En el Discord Developer Portal, ve a General Information
  3. Localiza Interactions Endpoint URL
  4. Pega la webhook URL y haz clic en Save Changes

Este paso es obligatorio. Discord usa esta URL para enviar las interacciones de slash commands a tu bot.

5. Agregar el Bot a tu Servidor

Usa el botón Add to Server en la tarjeta de la integración, o usa la URL de invitación que se muestra tras la conexión. Esto agrega el bot con los permisos necesarios.

Usar el Bot

Slash Commands

Los usuarios interactúan con tu bot usando el slash command /ask:

/ask ¿Cuál es su horario de atención?

El bot procesa la pregunta y responde en el canal.

Mensajes Directos

Envía un mensaje al bot directamente para conversaciones privadas:

  1. Encuentra el bot en la lista de miembros de tu servidor
  2. Haz clic derecho y selecciona Message
  3. Usa el comando /ask o activa Text DMs (ver abajo)

Selector de Text DMs

El switch Text DMs en la tarjeta de la integración controla el comportamiento de los mensajes directos:

  • Off (predeterminado): Los usuarios deben usar el comando /ask en DMs
  • On: Los usuarios pueden enviar mensajes de texto plano en DMs (sin prefijo de comando)

Al activar Text DMs, deberás habilitar Message Content Intent en Discord Developer Portal → sección Bot → Privileged Gateway Intents.

Formato de Respuesta

Las respuestas aparecen como embeds enriquecidos con:

  • Texto de la respuesta
  • Referencias a fuentes (opcional)
  • La imagen de marca de tu bot

Funcionalidades

Acceso en Todo el Servidor

Una vez agregado, el bot está disponible en todos los canales de texto donde tenga permisos.

Soporte de Threads

El bot puede responder en threads, manteniendo las conversaciones organizadas.

Comandos Instantáneos vs Globales

  • Con Guild ID: Los slash commands se registran al instante en ese servidor
  • Sin Guild ID: Los comandos globales tardan hasta 1 hora en propagarse

Proporciona un Guild ID durante la configuración para que los slash commands estén disponibles al instante. Puedes agregar más servidores luego.

Gestionar tu Bot

Cada bot conectado muestra:

  • Nombre de usuario del bot y estado (Active/Error)
  • Application ID
  • Agent asociado
  • Marca temporal de Last activity
  • Webhook URL (como referencia)

Acciones Disponibles

AcciónDescripción
Add to ServerAbre el enlace de invitación para agregar el bot a un servidor
PortalAbre el Discord Developer Portal para esta app
Copy URLCopia la webhook URL
Test ConnectionVerifica la conectividad del bot
DisconnectElimina esta integración

Solución de Problemas

El Bot No Responde

  1. Verifica que la Interactions Endpoint URL esté configurada en el Discord Developer Portal
  2. Confirma que el bot tenga permisos en el canal
  3. Revisa que el token sea correcto en Cuneiform Chat
  4. Comprueba que los slash commands estén registrados (al escribir / aparece tu comando)

No Aparecen los Comandos

Los slash commands pueden tardar hasta una hora en registrarse globalmente. Para pruebas inmediatas:

  • Proporciona un Guild ID durante la configuración para registro instantáneo
  • Espera la propagación global si no se proporcionó un Guild ID

Errores de Permisos

Asegúrate de que el bot tenga estos permisos:

  • Send Messages
  • Use Slash Commands
  • Embed Links
  • Read Message History (para soporte de threads)

Text DMs No Funcionan

  1. Verifica que el switch Text DMs esté activado en la tarjeta de la integración
  2. Habilita Message Content Intent en Discord Developer Portal → sección Bot
  3. Reinicia la conexión del bot si es necesario

Seguridad

  • Los bot tokens están cifrados y almacenados de forma segura
  • Los comandos usan la verificación de firmas integrada de Discord
  • No se accede a datos del servidor más allá de las interacciones directas

Desconectar

Para eliminar la integración con Discord:

  1. Ve a Agents → Selecciona el agent → Integrations
  2. Haz clic en el menú de tres puntos en tu bot de Discord
  3. Selecciona Disconnect

Para eliminar por completo el bot de Discord:

  1. Ve a la configuración de tu servidor de Discord
  2. Navega a Integrations → Elimina el bot
Last updated on
Tienda TelegramSlack