Monday.com - Agregar update

↩ Parte de la integración Monday.com.

Descripción

Este módulo publica un update —así llama Monday a los comentarios del hilo de actividad de un ítem— con la mutation GraphQL create_update:

mutation($item_id: ID!, $body: String!) {
  create_update(item_id: $item_id, body: $body) { id }
}

Los updates son el lugar natural para dejar rastro de lo automatizado: qué hizo el flujo, cuándo y con qué resultado, sin tocar ninguna columna.

Configuración

Campo	Tipo	Obligatorio	Descripción
`credentials_id`	credentials	Sí	Credencial de Monday
`item_id`	text	Sí	ID numérico del ítem
`body`	textarea	Sí	Texto del update o comentario

Credenciales

Este módulo requiere una credencial de tipo Monday.

Campo	Descripción
`token`	Token personal de la API (Avatar → Developers → My access tokens)
`timeout`	Opcional. Tiempo máximo de la petición en milisegundos (por defecto 20000)

Salida

{
  "nextModule": null,
  "data": { "id": "445566778" },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "445566778",
    "totalMs": 214
  }
}

Ojo: acá _meta.id es el id del update nuevo, no el del ítem.

Ejemplo de uso

Registrar el resultado de un paso automatizado

{
  "credentials_id": 8,
  "item_id": "{{data.id}}",
  "body": "Factura {{data.factura}} emitida por {{data.importe}} EUR el {{data.fecha}}."
}

Avisar de un fallo

{
  "credentials_id": 8,
  "item_id": "987654321",
  "body": "Falló la sincronización: {{data.error.message}}. El flujo lo reintentará automáticamente."
}

Notas

El update lo publica la persona dueña del token, así que aparece con su nombre en el hilo del ítem. Si no querés que quede atribuido a una persona concreta, conviene usar un usuario dedicado para la integración.
body acepta HTML básico, que es como Monday renderiza los updates. El texto plano también funciona sin problema.
item_id y body son obligatorios. Si alguno se resuelve como valor vacío, el nodo falla antes de llamar a Monday.
Las notificaciones y las menciones siguen las reglas propias de Monday: quienes estén suscritos al ítem reciben el aviso del update nuevo.

Nodos relacionados

Monday.com - Actualizar ítem — cambiá columnas en lugar de escribir en el hilo.
Monday.com - Crear ítem — creá el ítem al que pertenece el update.
Monday.com - Leer ítem — obtené el id del ítem que necesitás acá.