Guía Paso a Paso para Configurar Webhooks de Quire

Última actualización: 24 de julio de 2026

¿Alguna vez has deseado que tus apps pudieran hablar entre sí automáticamente? ¡Eso es exactamente lo que hacen los webhooks! Piensa en ellos como mensajeros que avisan a tu servidor en el momento en que ocurre algo en tus proyectos de Quire, ya sea que se cree una tarea nueva, alguien actualice una asignación o se marque una tarea como completada.

En esta guía te mostraremos cómo configurar webhooks para que tus aplicaciones se mantengan sincronizadas con Quire, sin que tengas que mover un dedo.

¿Cómo Empiezas con los Webhooks de Quire?

Paso 1: Crea Tu App de Quire

Antes que nada, necesitarás una app de Quire. Si aún no has configurado una, consulta nuestra guía Crear tu app de Quire con la API de Quire, donde te guiamos paso a paso.

Paso 2: Dile a Quire Adónde Enviar las Actualizaciones

Ahora es momento de configurar tu endpoint de webhook en el portal de Apps para desarrolladores de Quire. Esto es simplemente la dirección web a la que quieres que Quire envíe las notificaciones, algo como http://myserver/hookhandler.

Piénsalo como darle a Quire tu dirección postal para que sepa dónde entregar las novedades.

Paso 3: Suscríbete a las Actualizaciones

El último paso de la configuración es decirle a Quire qué proyectos o tareas quieres seguir. Lo haces añadiendo tu app como "seguidora" mediante la API de Quire:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app"]}' \
  https://quire.io/api/project/projectAOid

Nota importante: asegúrate de haber configurado ya la URL de tu webhook antes de este paso. Sin ella, añadir tu app como seguidora no funcionará.

Cuando ya no necesites actualizaciones, simplemente elimina tu app de la lista de seguidores. ¡Así de fácil!

Para más detalles, consulta Actualizar un proyecto por OID en nuestra referencia de la API.

¿Cómo Funcionan los Webhooks Detrás de Escena?

Lo Que Recibirás

Una vez configurado todo, Quire empieza a enviarte notificaciones cada vez que ocurre algo en tus proyectos seguidos. Estas llegan como solicitudes POST con todos los detalles jugosos en un paquete JSON ordenado:

{
  "type": "notification",
  "secret": "your-app-secret",
  "data": {
    "type": 0, 
    "when": "2019-09-30T08:20:12.000Z",
    "what": {
      "oid": "YxjapXXRCOYxoaiCT4tT3OQm", 
      "id": 101,
      "name": "Brand new start"
    },
    "user": {
      "oid": "1AbDEFed2A5031BEDDweqmde",
      "id": "john.doer",
      "name": "John Doer"
    },
    "message": "<a href=\"https://quire.io/u/john.doer\">John Doer</a> added <a href=\"https://quire.io/w/MyProjects/101\">Brand new start</a>",
    "text": "John Doer added Brand new start",
    "url": "https://quire.io/w/MyProjects/101"
  } 
}

Seguridad Primero: Verifica el Origen

Cada webhook incluye la clave secreta de tu app. Esta es tu forma de confirmar que el mensaje realmente vino de Quire y no de alguien haciéndose pasar por nosotros. ¡Verifica siempre esto antes de procesar cualquier dato!

Respondiendo a Diferentes Eventos

En tus proyectos ocurren cosas distintas, y querrás manejarlas de forma diferente. Aquí tienes un ejemplo sencillo de cómo responder según lo que haya sucedido:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    log("New task: " + json["data"]["what"]["name"]);
    break;
  case 1:
    // task removed
    log(json["data"]["user"]["name"] + " deleted " + json["data"]["what"]["name"]);
    break;
}

¿Qué Tipos de Eventos Envía Quire?

Quire puede notificarte sobre todo tipo de actividades. Estas son algunas de las más comunes:

¿Quieres la lista completa? Visita nuestra documentación de tipos de actividad para ver todo lo que Quire puede contarte.

Hazle Saber a Quire Que Recibiste el Mensaje

Cuando tu webhook recibe una notificación, simplemente devuelve un código de estado de éxito (cualquiera entre 200 y 299). Esto le dice a Quire: "¡Recibido, gracias!".

Si algo sale mal y envías un código de estado diferente, no te preocupes: Quire intentará enviar la notificación de nuevo después de 15 minutos, luego después de 1 hora y finalmente después de 1 día.

Para más detalles, consulta "Responding and Retries" en nuestra documentación de la API.

¿Cómo Gestionas Webhooks en Varios Proyectos?

¿Trabajas con varios proyectos de Quire en el mismo servidor? Tenemos dos enfoques flexibles para ti:

Opción 1: Usa Etiquetas Personalizadas

Puedes añadir una etiqueta personalizada al suscribirte a las actualizaciones de un proyecto:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|handleProjectA"]}' \
  https://quire.io/api/project/projectAOid

Quire incluirá esta etiqueta en cada notificación de webhook, facilitando identificar qué proyecto la envió:

{
  "type": "notification",
  "team": "handleProjectA",
  "data": {
    // event details...
  }
}

Luego, en tu código, puedes enrutar las notificaciones en consecuencia:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    if (json["team"] == "handleProjectA") {
      log("ProjectA has a new task: " + json["data"]["what"]["name"]);
    }
    break;
}

Opción 2: Usa Rutas Diferentes

¿Prefieres mantener las cosas separadas? Configura rutas únicas para cada proyecto:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|/projectAUpdate"]}' \
  https://quire.io/api/project/projectAOid

De esta forma, Quire envía notificaciones a diferentes subrutas de tu endpoint principal (como http://myserver/hookhandler/projectAUpdate), y puedes manejar cada proyecto con su propio manejador dedicado.

¿Cuál Es el Camino Más Rápido Hacia Tu Primer Webhook?

¡Eso es todo! Ahora ya sabes cómo configurar webhooks y mantener tus aplicaciones perfectamente sincronizadas con Quire. Para la documentación técnica completa, consulta la sección de Webhook en nuestra referencia de la API.

¿Estás desarrollando para un asistente de IA en lugar de un servidor personalizado? Consulta Configuración de Quire MCP en 5 minutos para conectar Claude, ChatGPT o cualquier cliente de IA directamente.

¡Feliz desarrollo!

Preguntas Frecuentes

¿Qué es un webhook de Quire?

Una notificación HTTP automatizada que Quire envía a una URL que tú controlas en el momento en que ocurre algo en un proyecto seguido, para que tu app se mantenga sincronizada sin necesidad de polling.

¿Cómo configuro un webhook en Quire?

Crea una app de Quire, registra la URL de tu endpoint en el portal de Apps para desarrolladores y luego añade tu app como seguidora del proyecto mediante la API. Configura la URL antes de suscribirte, o la llamada fallará.

¿Cómo verifico que una solicitud de webhook realmente provino de Quire?

Cada payload incluye el campo secret de tu app: compáralo con tu secreto almacenado y rechaza cualquier solicitud que no coincida.

¿Qué pasa si mi servidor está caído cuando se dispara un webhook?

Quire reintenta tres veces: después de 15 minutos, 1 hora y 1 día. Devuelve un estado 2xx tan pronto como recibas el payload para detener más reintentos.

¿Cómo manejo webhooks para varios proyectos de Quire en un solo servidor?

Puedes adjuntar una etiqueta personalizada al suscribirte (por ejemplo, app|handleProjectA) y enrutar según el campo team, o darle a cada proyecto su propia subruta en tu URL de webhook.