Tools de Discord
Las 12 operaciones de Discord que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Listar servidoresGETLista los servidores en los que está el bot. El id de un servidor es el guild_id de las otras tools. with_counts agrega approximate_member_count y approximate_presence_count a cada servidor.
- Listar canalesGETLista los canales y categorías de un servidor, sin hilos. type indica el tipo: 0 texto, 2 voz, 4 categoría, 5 anuncios, 13 escenario, 15 foro y 16 medios. Un canal de foro o medios lista sus etiquetas en available_tags.
- Crear canalPOSTCrea un canal o una categoría en un servidor y lo devuelve con su id. El bot necesita el permiso Manage Channels.
- Listar mensajesGETLista los mensajes de un canal o hilo, del más nuevo al más antiguo, hasta 100 por llamada. Para la página siguiente, envía before con el id del mensaje más antiguo devuelto. Sin Message Content Intent en el bot, content, embeds y attachments vuelven vacíos, salvo en mensajes que mencionan al bot. El bot necesita View Channel y Read Message History.
- Buscar mensajesGETBusca los mensajes de un servidor, hasta 25 por página, del más nuevo al más antiguo por defecto; pagina con offset. La respuesta tiene total_results y messages, una lista de listas de un mensaje. Si el servidor aún no está indexado, Discord responde 202 con retry_after: vuelve a llamar tras esos segundos. Requiere Message Content Intent en el bot.
- Enviar mensajePOSTPublica un mensaje del bot en un canal o hilo y lo devuelve con su id. Envía al menos content, embeds o poll. El bot necesita Send Messages en el canal, o Send Messages in Threads en un hilo.
- Editar mensajePATCHEdita un mensaje que envió el bot y lo devuelve. Los campos omitidos conservan su valor, y embeds reemplaza todas las tarjetas del mensaje.
- Eliminar mensajeDELETEElimina un mensaje y responde 204 sin cuerpo. Eliminar el mensaje de otra persona requiere el permiso Manage Messages.
- Crear hiloPOSTCrea un hilo en un canal de texto o de anuncios, o una publicación en un canal de foro o medios, y lo devuelve con su id, que las tools de mensajes usan como channel_id. En foro o medios envía message, la primera publicación; en los demás envía type, porque por defecto es un hilo privado. El bot necesita Create Public Threads, o Send Messages en un foro.
- Listar eventos programadosGETLista los eventos de un servidor con id, estado (1 programado, 2 activo, 3 completado, 4 cancelado) y horarios.
- Crear evento programadoPOSTCrea un evento en un servidor y lo devuelve con su id. Un evento fuera de Discord usa entity_type 3 con entity_metadata.location y scheduled_end_time; un evento en un canal de voz o escenario usa entity_type 2 o 1 con channel_id. El bot necesita Create Events, y un servidor admite hasta 100 eventos programados o activos.
- Actualizar evento programadoPATCHActualiza un evento y lo devuelve. Los campos omitidos conservan su valor. status 2 inicia el evento, 3 termina uno activo y 4 cancela uno programado; después de 3 o 4 el evento ya no puede cambiar.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
