Integración de Messenger API y Webhook para Bots (Tutorial 2026)

Automatizar notificaciones con bots de mensajería hace que los flujos de trabajo de desarrollo sean más rápidos y eficientes. Recibes alertas instantáneas cuando terminan compilaciones, ocurren errores o se completan despliegues. Esta guía te muestra cómo configurar bots que envían mensajes automáticos a través de webhooks en las plataformas de mensajería más populares. ¿Necesitas notificar a tu equipo sobre resultados de CI/CD, alertas de servidor o finalizaciones de procesos? Estas integraciones lo hacen sencillo. Solo cubrimos plataformas con soporte de bots directo y accesible. Algunos mensajeros seguros priorizan la privacidad y no admiten automatización - esos se listan por separado.

Automatización de bots basada en webhooks

Los bots basados en webhooks funcionan con un concepto simple. Tu aplicación envía una solicitud HTTP POST a una URL. La plataforma de mensajería entrega ese contenido a un canal o usuario.

Este enfoque funciona bien para muchas tareas de automatización:

• Notificaciones de compilación - Alertas cuando una compilación tiene éxito o falla, con detalles del error
• Actualizaciones de despliegue - Notifica al equipo cuando el código llega a staging o producción
• Alertas de monitoreo - Envía advertencias sobre el estado del servidor o avisos de tiempo de inactividad
• Informes programados - Entrega métricas diarias o resúmenes de estado

El flujo de trabajo básico tiene tres pasos:

1. Crear un bot o URL de webhook en la plataforma de destino
2. Configurar tu herramienta de automatización (CI/CD, sistema de monitoreo o script personalizado) para enviar solicitudes HTTP
3. Formatear el payload del mensaje según los requisitos de la plataforma

Elegir la plataforma correcta también depende de sus características de seguridad. Para un análisis más detallado de la seguridad de cada plataforma, consulta nuestra Guía definitiva sobre mensajeros en 2026.

Guías de integración de bots de mensajería

A continuación encontrarás guías paso a paso para cada plataforma que admite integración de bots mediante webhooks de forma sencilla.

Bot de Discord con webhook

Discord tiene una de las configuraciones de webhook más sencillas. No necesitas una aplicación de bot ni tokens de autenticación para el envío básico de mensajes.

Configuración paso a paso

1. Abrir la configuración del servidor - Haz clic derecho en el nombre de tu servidor y selecciona "Configuración del servidor"
2. Ir a Integraciones - Haz clic en "Integraciones" en la barra lateral izquierda
3. Crear webhook - Haz clic en "Webhooks" y luego en "Nuevo webhook"
4. Configurar el webhook - Ponle un nombre (por ejemplo, "Build Bot"), elige un canal y opcionalmente añade un avatar
5. Copiar la URL del webhook - Haz clic en "Copiar URL del webhook" y guárdala en un lugar seguro

Envío de mensajes mediante webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"content": "✅ Build completed successfully!\n\nProject: MyApp\nBranch: main\nDuration: 3m 42s"}' \
  https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN

Ejemplo de embed enriquecido para notificaciones de error

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "embeds": [{
      "title": "❌ Build Failed",
      "color": 15158332,
      "fields": [
        {"name": "Project", "value": "MyApp", "inline": true},
        {"name": "Branch", "value": "feature/login", "inline": true},
        {"name": "Error", "value": "```TypeError: Cannot read property of undefined```"}
      ],
      "timestamp": "2026-01-15T10:30:00.000Z"
    }]
  }' \
  YOUR_WEBHOOK_URL

Documentación oficial: Documentación de webhooks de Discord

Bot de Slack con webhook

Slack utiliza Incoming Webhooks como parte de su sistema de Slack Apps. Admite formato de mensajes enriquecido y selección flexible de canales.

Configuración paso a paso

1. Crear una Slack App - Ve a api.slack.com/apps y haz clic en "Create New App"
2. Elegir el método de creación - Selecciona "From scratch" y dale un nombre a tu app (por ejemplo, "CI/CD Notifications")
3. Activar Incoming Webhooks - Ve a "Incoming Webhooks" en la barra lateral y actívalo
4. Añadir webhook al espacio de trabajo - Haz clic en "Add New Webhook to Workspace"
5. Seleccionar canal - Elige el canal para las notificaciones y haz clic en "Allow"
6. Copiar la URL del webhook - Tu URL de webhook única aparecerá en pantalla

Envío de mensajes mediante webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Deployment to production completed successfully!"}' \
  https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXX

Mensaje con Block Kit para notificaciones detalladas

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "blocks": [
      {
        "type": "header",
        "text": {"type": "plain_text", "text": "🚨 Build Failed"}
      },
      {
        "type": "section",
        "fields": [
          {"type": "mrkdwn", "text": "*Project:*\nMyApp"},
          {"type": "mrkdwn", "text": "*Branch:*\nmain"},
          {"type": "mrkdwn", "text": "*Error:*\n`Module not found`"}
        ]
      }
    ]
  }' \
  YOUR_WEBHOOK_URL

Documentación oficial: Guía de Incoming Webhooks de Slack

Bot de Microsoft Teams con webhook

Microsoft Teams admite Incoming Webhooks para notificaciones en canales. Se configuran a través del sistema de conectores.

Configuración paso a paso

1. Abrir la configuración del canal - Ve al canal de destino y haz clic en los tres puntos (•••) junto al nombre del canal
2. Seleccionar Conectores - Haz clic en "Conectores" (o "Administrar canal" y luego "Conectores" en versiones más recientes)
3. Buscar Incoming Webhook - Busca "Incoming Webhook" y haz clic en "Configurar"
4. Nombrar el webhook - Introduce un nombre (por ejemplo, "Build Alerts") y opcionalmente sube una imagen
5. Crear y copiar la URL - Haz clic en "Crear" y copia la URL del webhook

Envío de mensajes mediante webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Build #1234 completed successfully on main branch"}' \
  YOUR_TEAMS_WEBHOOK_URL

Tarjeta adaptable para notificaciones enriquecidas

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "type": "message",
    "attachments": [{
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.2",
        "body": [
          {"type": "TextBlock", "size": "Large", "weight": "Bolder", "text": "❌ Build Failed"},
          {"type": "FactSet", "facts": [
            {"title": "Project:", "value": "MyApp"},
            {"title": "Error:", "value": "Compilation failed"}
          ]}
        ]
      }
    }]
  }' \
  YOUR_TEAMS_WEBHOOK_URL

Documentación oficial: Incoming Webhooks de Microsoft Teams

Bot de Telegram

Telegram cuenta con una potente Bot API para enviar mensajes de forma programática. En lugar de una URL de webhook, envías solicitudes directamente a la API de Telegram.

Configuración paso a paso

1. Crear el bot con BotFather - Abre Telegram y busca @BotFather
2. Iniciar un nuevo bot - Envía el comando /newbot
3. Nombrar tu bot - Sigue las instrucciones para establecer un nombre visible y un nombre de usuario (debe terminar en "bot")
4. Guardar el token de la API - BotFather te entregará un token como 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
5. Obtener el ID del chat - Añade el bot a tu grupo o canal, envía un mensaje y visita https://api.telegram.org/bot<TOKEN>/getUpdates para encontrar el ID del chat

Envío de mensajes mediante la Bot API

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -d "chat_id=" \
  -d "text=✅ Build completed successfully!%0A%0AProject: MyApp%0ABranch: main" \
  -d "parse_mode=HTML"

Mensaje formateado con HTML

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "",
    "text": "❌ Build Failed\n\nProject: MyApp\nBranch: main\nError: Module not found",
    "parse_mode": "HTML"
  }'

Documentación oficial: Telegram Bot API

Bot de Mattermost con webhook

Mattermost es una alternativa de código abierto a Slack. Tiene un sólido soporte de webhooks y funciona muy bien para la comunicación de equipos en entornos autoalojados.

Configuración paso a paso

1. Acceder a Integraciones - Haz clic en el menú de hamburguesa y luego en "Integraciones"
2. Crear Incoming Webhook - Selecciona "Incoming Webhooks" y luego "Añadir Incoming Webhook"
3. Configurar el webhook - Establece un título, descripción y canal predeterminado
4. Guardar y copiar la URL - Haz clic en "Guardar" y copia la URL del webhook

Envío de mensajes mediante webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Build completed successfully!"}' \
  https://your-mattermost-server.com/hooks/YOUR_WEBHOOK_ID

Mensaje con adjunto enriquecido

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "attachments": [{
      "fallback": "Build Failed",
      "color": "#FF0000",
      "title": "❌ Build Failed",
      "fields": [
        {"short": true, "title": "Project", "value": "MyApp"},
        {"short": true, "title": "Branch", "value": "main"},
        {"short": false, "title": "Error", "value": "```Module not found```"}
      ]
    }]
  }' \
  YOUR_WEBHOOK_URL

Documentación oficial: Incoming Webhooks de Mattermost

Bot de Matrix/Element

Matrix es un protocolo abierto para comunicación descentralizada. Element es su cliente más popular. Para integrar un bot, se utiliza la Matrix Client-Server API.

Configuración paso a paso

1. Crear una cuenta de bot - Registra una nueva cuenta de Matrix para tu bot en tu servidor propio o en matrix.org
2. Obtener el token de acceso - Inicia sesión y busca el token de acceso en Element: Configuración - Ayuda y acerca de - Avanzado - Token de acceso
3. Obtener el ID de la sala - Une al bot a la sala de destino y luego encuentra el ID en Configuración de la sala - Avanzado
4. Invitar al bot a la sala - Asegúrate de que la cuenta del bot haya entrado en la sala donde enviará mensajes

Envío de mensajes mediante la Matrix API

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"msgtype": "m.text", "body": "✅ Build completed successfully!"}' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

Mensaje formateado con HTML

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "msgtype": "m.text",
    "body": "Build Failed\nProject: MyApp\nError: Module not found",
    "format": "org.matrix.custom.html",
    "formatted_body": "
❌ Build Failed
Project: MyApp
Error: Module not found
"
  }' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

Documentación oficial: Especificación de la Matrix Client-Server API

Bot de WhatsApp Business

WhatsApp ofrece una Business API para mensajería automatizada. Requiere verificación empresarial y su configuración es más compleja que la de otras plataformas.

Configuración paso a paso

1. Crear una cuenta de Meta Business - Visita business.facebook.com y crea una cuenta empresarial
2. Configurar WhatsApp Business - Ve a developers.facebook.com, crea una app y añade el producto de WhatsApp
3. Configurar el número de teléfono - Añade un número de teléfono para tu bot (hay números de prueba disponibles para desarrollo)
4. Obtener el token de acceso - Genera un token de acceso permanente desde el panel de la app
5. Verificar el negocio - Completa la verificación empresarial antes de pasar a producción

Envío de mensajes mediante la Cloud API

curl -X POST \
  "https://graph.facebook.com/v17.0/YOUR_PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "RECIPIENT_PHONE_NUMBER",
    "type": "text",
    "text": {"body": "✅ Build completed successfully!"}
  }'

Documentación oficial: Documentación de la WhatsApp Cloud API

Bot de Facebook Messenger

Los bots de Facebook Messenger requieren una app de Facebook y una página. Los mensajes se envían a través de la Send API.

Configuración paso a paso

1. Crear una app de Facebook - Ve a developers.facebook.com y crea una nueva app (elige el tipo "Business")
2. Añadir el producto Messenger - En el panel de tu app, haz clic en "Añadir producto" y selecciona Messenger
3. Conectar una página de Facebook - Vincula una página de Facebook a tu app (crea una si es necesario)
4. Generar el token de acceso de la página - En la configuración de Messenger, genera un token para tu página
5. Obtener el PSID - Los usuarios deben enviar un mensaje a tu página primero. Captura su identificador de página (PSID) desde los eventos del webhook

Envío de mensajes mediante la Send API

curl -X POST \
  "https://graph.facebook.com/v17.0/me/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {"id": "USER_PSID"},
    "message": {"text": "✅ Build completed successfully!"},
    "access_token": "YOUR_PAGE_ACCESS_TOKEN"
  }'

Documentación oficial: Documentación de la plataforma Facebook Messenger

Mensajeros sin soporte fácil de bots

Los siguientes mensajeros priorizan la privacidad y la seguridad. Esto significa que la integración de bots mediante webhooks no es posible o no resulta práctica:

• Signal - Sin API oficial de bots. Signal se centra en el cifrado de extremo a extremo y evita funciones de automatización que puedan reducir la seguridad.
• Session - Un mensajero descentralizado sin infraestructura de bots. Su diseño con enrutamiento cebolla hace que la mensajería automatizada no sea práctica.
• Briar - Un mensajero peer-to-peer diseñado para activistas y periodistas. Sin infraestructura de servidor, no hay soporte de webhooks.
• Wire - Tiene algunas funciones de API empresarial, pero no cuenta con un sistema de webhooks sencillo para notificaciones automatizadas.
• Wickr - Orientado a empresas y sin API pública de bots. La automatización requiere Wickr Enterprise con integración personalizada.
• SimpleX - Diseñado sin identificadores de usuario, lo que hace que la integración de bots sea incompatible con su arquitectura.
• Threema - Ofrece Threema Gateway para empresas, pero es un servicio de pago que requiere contratos, no una configuración simple de webhook.
• Viber - Tiene una API de bots, pero requiere aprobación de cuenta empresarial y está orientada al servicio al cliente, no a notificaciones para desarrolladores.
• LINE - Ofrece una Messaging API, pero requiere verificación de cuenta empresarial y resulta compleja para casos de uso simples de notificaciones.
• WeChat - Tiene una API de cuenta oficial, pero requiere registro empresarial en China y aprobación gubernamental.

Si prefieres estas plataformas para comunicaciones seguras, considera combinarlas con una plataforma compatible para la automatización. También puedes leer nuestra guía sobre cómo mantener tus mensajes privados verdaderamente seguros.

Ejemplo práctico de implementación

Aquí tienes un ejemplo completo en Node.js que envía notificaciones de compilación a múltiples plataformas al mismo tiempo:

const axios = require('axios');

const notifiers = {
  discord: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { content: message });
  },

  slack: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { text: message });
  },

  telegram: async (message, token, chatId) => {
    await axios.post(`https://api.telegram.org/bot${token}/sendMessage`, {
      chat_id: chatId,
      text: message,
      parse_mode: 'HTML'
    });
  },

  teams: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { text: message });
  }
};

async function notifyBuildResult(success, project, branch, error = null) {
  const emoji = success ? '✅' : '❌';
  const status = success ? 'succeeded' : 'failed';
  let message = `${emoji} Build ${status}\n\nProject: ${project}\nBranch: ${branch}`;
  if (error) message += `\nError: ${error}`;

  const notifications = [
    notifiers.discord(message, process.env.DISCORD_WEBHOOK),
    notifiers.slack(message, process.env.SLACK_WEBHOOK),
    notifiers.telegram(message, process.env.TELEGRAM_TOKEN, process.env.TELEGRAM_CHAT_ID),
    notifiers.teams(message, process.env.TEAMS_WEBHOOK)
  ];

  await Promise.allSettled(notifications);
}

// Uso en tu pipeline de CI/CD
notifyBuildResult(false, 'MyApp', 'main', 'Module not found: @utils/helper');

Conclusión

Configurar notificaciones de bots basadas en webhooks en distintas plataformas de mensajería añade una potente automatización a tu flujo de trabajo de desarrollo. Discord y Slack son las opciones más fáciles para empezar - basta con usar una URL de webhook simple. Telegram es fiable y sencillo de configurar. Para equipos empresariales, Microsoft Teams y Mattermost encajan bien con las herramientas existentes. Matrix te ofrece una opción autoalojada y respetuosa con la privacidad con acceso completo a la API.

Empieza con una sola plataforma. Prueba tu flujo de notificaciones. Luego añade más canales según sea necesario. Los ejemplos de código anteriores funcionan de inmediato. Tu próximo paso es crear un webhook en la plataforma que hayas elegido y enviar tu primer mensaje automatizado - te llevará menos de 10 minutos.

Preguntas frecuentes