Webhooks de entrada (incoming) en el Team

Genera una URL secreta para que un sistema externo publique mensajes en un espacio del Team con un POST.

Jun 26, 2026

Mira este paso en el video · Administrar el espacio

Qué es un webhook de entrada

Un webhook de entrada (incoming) te da una URL secreta para que un sistema externo —GitHub, tu servidor, un monitor de alertas, etc.— publique mensajes en un espacio del Team con una simple petición POST. Es la forma más directa de llevar notificaciones de otras herramientas a la conversación del equipo, sin construir una integración completa.

Es una función avanzada y solo los administradores del espacio pueden gestionarla.

Requisitos

  • Permiso para gestionar el espacio (la pestaña Webhooks solo aparece para administradores).
  • Un sistema externo capaz de enviar un POST con JSON.

Pasos para crear un webhook

  1. Abre el espacio en el Team y entra a su panel de ajustes (engranaje en la cabecera).
  2. Ve a la pestaña Webhooks.
  3. Escribe un nombre (ej. GitHub, Servidor) y pulsa Generar.
  4. Omnifox muestra la URL una sola vez: "Copia la URL ahora — no podrás verla de nuevo." Pulsa Copiar y guárdala en un lugar seguro.

La URL tiene esta forma:

POST https://omnifox.io/api/team/hooks/{token}

Cómo enviar un mensaje

Envía un POST con cuerpo JSON. Se aceptan dos formatos:

  • Simple: {"text": "Despliegue completado ✅", "title": "CI/CD"} — el title (opcional) se muestra como primera línea en negrita.
  • Estilo Slack: {"text": "...", "attachments": [...]} — se toma text, o el primer fallback/text/pretext del adjunto. Así, muchos emisores que ya envían a Slack funcionan sin cambios.

Ejemplo con curl:

curl -X POST https://omnifox.io/api/team/hooks/TU_TOKEN \
  -H "Content-Type: application/json" \
  -d '{"text":"Backup nocturno OK","title":"Servidor"}'

El mensaje aparece firmado como Integración con la insignia Webhook. Una respuesta 201 confirma la publicación.

Gestionar y revocar

  • Regenerar: crea un token nuevo e invalida la URL anterior de inmediato.
  • Revocar: deshabilita la URL de forma permanente.
  • El token nunca se guarda en claro (solo un hash), y el endpoint solo escribe: una URL filtrada no puede leer el contenido del espacio.

Verificación

  • Manda el ejemplo de curl y comprueba que la tarjeta aparece en el espacio con la insignia Webhook.
  • Una respuesta 201 = publicado; 422 = no se encontró texto en el cuerpo.

Si no funciona

  • 404: token desconocido o revocado (o un POST a otra ruta).
  • 410: el espacio fue archivado o eliminado.
  • 422: el cuerpo no traía text utilizable.
  • 429 / límite: el endpoint está limitado a 60 peticiones por minuto por IP y token; espacia los envíos.
  • El texto se recorta a 4 KB; manda resúmenes, no logs enteros.

Tips

  • Crea un webhook por origen (uno para CI, otro para alertas) para revocarlos por separado.
  • Si sospechas que la URL se filtró, usa Regenerar y actualiza el sistema emisor.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp