Discord es una potente plataforma de comunicación que te permite conectar con amigos, comunidades y equipos. Ofrece una variedad de funciones para la colaboración en equipo, incluyendo canales de texto, canales de voz y videollamadas.
Con una cuenta o bot de Discord, puedes:
- Enviar mensajes: Enviar mensajes a un canal específico
- Obtener mensajes: Obtener mensajes de un canal específico
- Obtener servidor: Obtener información sobre un servidor específico
- Obtener usuario: Obtener información sobre un usuario específico
En Sim, la integración con Discord permite a tus agentes acceder y aprovechar los servidores de Discord de tu organización. Los agentes pueden recuperar información de los canales de Discord, buscar usuarios específicos, obtener información del servidor y enviar mensajes. Esto permite que tus flujos de trabajo se integren con tus comunidades de Discord, automaticen notificaciones y creen experiencias interactivas.
Importante: Para leer el contenido de los mensajes, tu bot de Discord necesita tener habilitado el "Message Content Intent" en el Portal de Desarrolladores de Discord. Sin este permiso, seguirás recibiendo los metadatos del mensaje pero el campo de contenido aparecerá vacío.
Los componentes de Discord en Sim utilizan una carga diferida eficiente, obteniendo datos solo cuando es necesario para minimizar las llamadas a la API y evitar limitaciones de tasa. La actualización de tokens ocurre automáticamente en segundo plano para mantener tu conexión.
- Ve al Portal de Desarrolladores de Discord
- Crea una nueva aplicación y navega a la pestaña "Bot"
- Crea un bot y copia tu token de bot
- En "Privileged Gateway Intents", habilita el Message Content Intent para leer el contenido de los mensajes
- Invita a tu bot a tus servidores con los permisos apropiados
Integración completa con Discord: mensajes, hilos, canales, roles, miembros, invitaciones y webhooks.
Enviar un mensaje a un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord al que enviar el mensaje |
content | string | No | El contenido de texto del mensaje |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
files | file[] | No | Archivos para adjuntar al mensaje |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del mensaje de Discord |
Recuperar mensajes de un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord del que recuperar mensajes |
limit | number | No | Número máximo de mensajes a recuperar (predeterminado: 10, máx: 100) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Contenedor para datos de mensajes |
Recuperar información sobre un servidor de Discord (guild)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Información del servidor de Discord (guild) |
Recuperar información sobre un usuario de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | Token del bot de Discord para autenticación |
userId | string | Sí | El ID del usuario de Discord |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Información del usuario de Discord |
Editar un mensaje existente en un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord que contiene el mensaje |
messageId | string | Sí | El ID del mensaje a editar |
content | string | No | El nuevo contenido de texto para el mensaje |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos actualizados del mensaje de Discord |
Eliminar un mensaje de un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord que contiene el mensaje |
messageId | string | Sí | El ID del mensaje a eliminar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Añadir una reacción con emoji a un mensaje de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord que contiene el mensaje |
messageId | string | Sí | El ID del mensaje al que reaccionar |
emoji | string | Sí | El emoji para reaccionar (emoji unicode o emoji personalizado en formato nombre:id) |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Eliminar una reacción de un mensaje de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord que contiene el mensaje |
messageId | string | Sí | El ID del mensaje con la reacción |
emoji | string | Sí | El emoji a eliminar (emoji unicode o emoji personalizado en formato nombre:id) |
userId | string | No | El ID del usuario cuya reacción se eliminará (omitir para eliminar la propia reacción del bot) |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Fijar un mensaje en un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord que contiene el mensaje |
messageId | string | Sí | El ID del mensaje a fijar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Desfijar un mensaje en un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord que contiene el mensaje |
messageId | string | Sí | El ID del mensaje a desfijar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Crear un hilo en un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord donde crear el hilo |
name | string | Sí | El nombre del hilo (1-100 caracteres) |
messageId | string | No | El ID del mensaje para crear un hilo a partir de él (si se crea desde un mensaje existente) |
autoArchiveDuration | number | No | Duración en minutos para auto-archivar el hilo (60, 1440, 4320, 10080) |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del hilo creado |
Unirse a un hilo en Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
threadId | string | Sí | El ID del hilo al que unirse |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Abandonar un hilo en Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
threadId | string | Sí | El ID del hilo que se va a abandonar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Archivar o desarchivar un hilo en Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
threadId | string | Sí | El ID del hilo que se va a archivar/desarchivar |
archived | boolean | Sí | Si se debe archivar (true) o desarchivar (false) el hilo |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos actualizados del hilo |
Crear un nuevo canal en un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
name | string | Sí | El nombre del canal (1-100 caracteres) |
type | number | No | Tipo de canal (0=texto, 2=voz, 4=categoría, 5=anuncio, 13=escenario) |
topic | string | No | Tema del canal (0-1024 caracteres) |
parentId | string | No | ID de la categoría padre para el canal |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del canal creado |
Actualizar un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord a actualizar |
name | string | No | El nuevo nombre para el canal |
topic | string | No | El nuevo tema para el canal |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del canal actualizado |
Eliminar un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord a eliminar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Obtener información sobre un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord a recuperar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del canal |
Crear un nuevo rol en un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
name | string | Sí | El nombre del rol |
color | number | No | Valor de color RGB como entero (p. ej., 0xFF0000 para rojo) |
hoist | boolean | No | Si se deben mostrar los miembros del rol por separado de los miembros en línea |
mentionable | boolean | No | Si el rol puede ser mencionado |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del rol creado |
Actualizar un rol en un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
roleId | string | Sí | El ID del rol a actualizar |
name | string | No | El nuevo nombre para el rol |
color | number | No | Valor de color RGB como entero |
hoist | boolean | No | Si se deben mostrar los miembros del rol por separado |
mentionable | boolean | No | Si el rol puede ser mencionado |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del rol actualizado |
Eliminar un rol de un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
roleId | string | Sí | El ID del rol a eliminar |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Asignar un rol a un miembro en un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
userId | string | Sí | El ID del usuario al que asignar el rol |
roleId | string | Sí | El ID del rol a asignar |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Eliminar un rol de un miembro en un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
userId | string | Sí | El ID del usuario al que quitar el rol |
roleId | string | Sí | El ID del rol a eliminar |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Expulsar a un miembro de un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
userId | string | Sí | El ID del usuario a expulsar |
reason | string | No | Motivo para expulsar al miembro |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Banear a un miembro de un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
userId | string | Sí | El ID del usuario a banear |
reason | string | No | Motivo para banear al miembro |
deleteMessageDays | number | No | Número de días para eliminar mensajes (0-7) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Desbanear a un miembro de un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
userId | string | Sí | El ID del usuario a desbanear |
reason | string | No | Motivo para desbanear al miembro |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Obtener información sobre un miembro en un servidor de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
userId | string | Sí | El ID del usuario a recuperar |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del miembro |
Actualizar un miembro en un servidor de Discord (p. ej., cambiar apodo)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
userId | string | Sí | El ID del usuario a actualizar |
nick | string | No | Nuevo apodo para el miembro (null para eliminar) |
mute | boolean | No | Si se debe silenciar al miembro en canales de voz |
deaf | boolean | No | Si se debe ensordecer al miembro en canales de voz |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos actualizados del miembro |
Crear un enlace de invitación para un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord para el que crear una invitación |
maxAge | number | No | Duración de la invitación en segundos (0 = nunca expira, predeterminado 86400) |
maxUses | number | No | Número máximo de usos (0 = ilimitado, predeterminado 0) |
temporary | boolean | No | Si la invitación otorga membresía temporal |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos de la invitación creada |
Obtener información sobre una invitación de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
inviteCode | string | Sí | El código de invitación a recuperar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos de la invitación |
Eliminar una invitación de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
inviteCode | string | Sí | El código de invitación a eliminar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
Crear un webhook en un canal de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
channelId | string | Sí | El ID del canal de Discord donde crear el webhook |
name | string | Sí | Nombre del webhook (1-80 caracteres) |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del webhook creado |
Ejecutar un webhook de Discord para enviar un mensaje
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
webhookId | string | Sí | El ID del webhook |
webhookToken | string | Sí | El token del webhook |
content | string | Sí | El contenido del mensaje a enviar |
username | string | No | Sobrescribir el nombre de usuario predeterminado del webhook |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Mensaje enviado a través del webhook |
Obtener información sobre un webhook de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
webhookId | string | Sí | El ID del webhook a recuperar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
data | object | Datos del webhook |
Eliminar un webhook de Discord
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
botToken | string | Sí | El token del bot para autenticación |
webhookId | string | Sí | El ID del webhook a eliminar |
serverId | string | Sí | El ID del servidor de Discord (ID del guild) |
| Parámetro | Tipo | Descripción |
|---|
message | string | Mensaje de éxito o error |
- Categoría:
tools
- Tipo:
discord