Saltar al contenido principal

Crear un bot

Publica en un canal con un webhook, dale comandos con barra a tu comunidad y pon botones en las tarjetas.

Tres piezas permiten que tu propio servicio hable en tu comunidad. Funcionan juntas: una sola integración puede publicar una tarjeta, responder a un /comando, reaccionar a un botón y actualizar su propio mensaje.

Las piezas

  • Webhooks: una URL que publica en un canal. Tu servicio le envía JSON y el mensaje aparece con el nombre que le diste al webhook. Pensados para alertas: resultados de CI, monitorización, tickets.
  • Triggers: los comandos con barra propios de tu comunidad. Un miembro escribe /weather, mssgs envía el mensaje a tu servicio web, y lo que responda aparece en el canal como una tarjeta.
  • Botones: bajo una tarjeta, abren un enlace, cambian la tarjeta para todos o ejecutan uno de tus triggers (consulta Tarjetas y botones de bots).

Publica tu primer mensaje

1
En la app de escritorio, abre Manage Server → Webhooks en tu comunidad y haz clic en Add Webhook.
2
Ponle un nombre, elige en Channels los canales en los que puede publicar, copia el Webhook Secret y haz clic en Create Webhook.
3
Haz clic en el icono de enlace junto al webhook (View webhook URL), elige un canal en Channel y copia la URL.
4
Envía JSON por POST a esa URL, firmado con el secreto. El mensaje aparece en el canal al instante.
BODY='{"content": "Build #1847 passed on main"}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$MSSGS_WEBHOOK_SECRET" | sed 's/^.* //')
curl -X POST "$MSSGS_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -H "X-Mssgs-Signature: sha256=$SIG" \
  -d "$BODY"
Mantén en privado la URL y el secreto. Juntos permiten a cualquiera publicar en ese canal, así que no los pongas en repositorios públicos ni en código del lado del cliente. Una petición sin una firma válida se rechaza.

¿Publicas desde GitHub? No hace falta código: apunta un webhook de GitHub a la URL y pega el secreto en su campo Secret. Consulta las integraciones.

Añade un comando con barra

1
Abre Manage Server → Triggers y haz clic en Create Trigger.
2
Rellena Word to Match, por ejemplo /weather, y el URL Endpoint de tu servicio web. En Allowed User Groups puedes reservar el comando para ciertos roles.
3
Cuando un miembro envía un mensaje que empieza por /weather, mssgs lo envía por POST a tu URL. Responde en menos de 5 segundos con JSON y la respuesta aparece en el canal como una tarjeta.

¿Necesitas más tiempo? Responde enseguida con una tarjeta de carga y complétala a través del callback_url de la petición, que funciona durante 30 minutos. La tarjeta muestra el nombre de tu comunidad, y su pie indica quién usó qué comando.

Un bot con cuenta propia

¿Quieres que el bot sea un miembro por sí mismo, con nombre, avatar y la etiqueta BOT? Crea una cuenta de bot vinculada a tu propia cuenta y gestiónala desde el panel de bots. Con la app de escritorio conectada como el bot, un asistente de IA puede publicar tarjetas con botones a través de su servidor MCP.

Cada campo, respuesta y código de error está en la documentación para desarrolladores: webhooks, comandos con barra, tarjetas de mensaje, botones y actualizaciones en directo. Y si quieres un comportamiento impulsado por IA sin construir nada, puede que la vía del MCP sea todo lo que necesitas.

¿Te ha resultado útil este artículo?

¿No has encontrado lo que buscabas? Te ayudamos encantados.

Haz tu pregunta

¿Todavía necesitas ayuda?

Nuestro equipo de soporte suele responder en menos de 24 horas.

Contactar con soporte