Comunicación
Discord en tu producto y en tus agentes de IA, con una API
El toolkit de Discord cubre los servidores, canales, mensajes, hilos y eventos programados a los que llega el bot de un cliente: listar y crear canales, leer, buscar, enviar, editar y eliminar mensajes, y gestionar eventos. Con Connect, tu producto o agente de IA llama a estas operaciones por un solo endpoint, mientras Connect guarda las credenciales del bot y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/discord_create_channel/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"guild_id": "<guild_id>",
"name": "<name>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Discord.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Discord. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Discord.
Avisar a un canal de la comunidad
Cuando algo ocurre en tu producto, publica un mensaje con embeds en el canal que eligió el cliente y edítalo cuando cambie el estado.
Agente que lee y responde
Un agente de IA lista o busca mensajes de un servidor, responde en un hilo que él crea y borra sus propios mensajes desactualizados.
Eventos desde tu calendario
Crea un evento programado para un webinar o lanzamiento en el servidor del cliente, y inícialo, termínalo o cancélalo según cambien los planes.
Tools
12 tools de Discord
- 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.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Discord
¿Necesito implementar la API de Discord?
No. Connect ya trae 12 tools de Discord descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Discord?
Con el modo que acepta el toolkit: Clave de API. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
