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.
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
- Abre el espacio en el Team y entra a su panel de ajustes (engranaje en la cabecera).
- Ve a la pestaña Webhooks.
- Escribe un nombre (ej. GitHub, Servidor) y pulsa Generar.
- 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"}— eltitle(opcional) se muestra como primera línea en negrita. - Estilo Slack:
{"text": "...", "attachments": [...]}— se tomatext, o el primerfallback/text/pretextdel 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
textutilizable. - 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
Artículos relacionados
-
Comunicacion interna con Team
Crea espacios y mensajes directos, usa menciones, notas, recordatorios y encuestas, convierte un mensaje en tarea y recibe avisos de tus workflows.
-
Guía completa de Team
Team a fondo, en 28 capítulos: espacios, mensajes directos, hilos, encuestas, programados, estados, responsables y pendientes, tablero, inbox, IA, llamadas, notificaciones y atajos.
-
Empieza aquí: Team en 4 minutos
Lo esencial de Team en un video corto: espacios, crear un espacio, mensajes y menciones, hilos, tareas y tablero, mensajes directos, guardados y Discutir en Team.
-
Espacios y mensajes directos en el Team
Organiza la comunicación interna por temas con espacios y habla 1 a 1 con mensajes directos.
-
Convertir un mensaje en tarea o en oportunidad (deal)
Transforma cualquier mensaje del Team en una tarea de un tablero o en una oportunidad del CRM, sin copiar y pegar.