Notion - Agregar contenido

↩ Parte de la integración Notion.

Descripción

Este módulo agrega contenido al cuerpo de una página —o a cualquier bloque que admita hijos— con PATCH /blocks/{id}/children.

Tiene dos modos. Si cargás children con un array JSON de bloques, ese array se envía tal cual, así que podés sumar encabezados, listas, callouts, bloques de código y todo lo que Notion soporte. Si dejás children vacío y completás text, el nodo envuelve tu texto en un bloque de párrafo por vos.

Configuración

Campo	Tipo	Obligatorio	Descripción
`credentials_id`	credentials	Sí	Credencial de Notion
`block_id`	text	Sí	ID de la página o bloque padre
`text`	textarea	Condicional	Texto plano. Crea un párrafo. Se ignora si cargás `children`
`children`	json	Condicional	Bloques de contenido (array JSON, formato Notion)

Tenés que completar children o text. Si children es un array válido, siempre gana sobre text.

Credenciales

Este módulo requiere una credencial de tipo Notion.

Campo	Descripción
`token`	Internal Integration Secret de notion.so/my-integrations
`notion_version`	Opcional. Valor de la cabecera `Notion-Version` (por defecto `2022-06-28`)

Salida

{
  "nextModule": null,
  "data": {
    "object": "list",
    "results": [
      {
        "object": "block",
        "id": "0d1e2f3a-4b5c-6d7e-8f9a-0b1c2d3e4f5a",
        "type": "paragraph",
        "paragraph": { "rich_text": [ { "plain_text": "El pedido 4471 se despachó" } ] }
      }
    ]
  },
  "_meta": {
    "moduleVersion": "1.0.0",
    "success": true,
    "id": "8b9c0d1e-2f3a-4b5c-6d7e-8f9a0b1c2d3e",
    "added": 1,
    "totalMs": 253
  }
}

Ejemplo de uso

Dejar una línea de registro en una página

{
  "credentials_id": 12,
  "block_id": "8b9c0d1e-2f3a-4b5c-6d7e-8f9a0b1c2d3e",
  "text": "El pedido {{data.pedido_id}} se despachó el {{data.fecha_envio}}."
}

Encabezado más lista de viñetas

{
  "credentials_id": 12,
  "block_id": "8b9c0d1e-2f3a-4b5c-6d7e-8f9a0b1c2d3e",
  "children": [
    {
      "object": "block",
      "type": "heading_3",
      "heading_3": { "rich_text": [ { "type": "text", "text": { "content": "Incidencias de hoy" } } ] }
    },
    {
      "object": "block",
      "type": "bulleted_list_item",
      "bulleted_list_item": { "rich_text": [ { "type": "text", "text": { "content": "{{data.incidencia_1}}" } } ] }
    },
    {
      "object": "block",
      "type": "bulleted_list_item",
      "bulleted_list_item": { "rich_text": [ { "type": "text", "text": { "content": "{{data.incidencia_2}}" } } ] }
    }
  ]
}

Notas

Los bloques nuevos se agregan siempre al final del padre. No hay opción de insertar en una posición concreta.
block_id puede ser el id de una página (el caso más habitual) o el de un bloque que admita hijos, como un desplegable o una columna.
_meta.added te dice cuántos bloques creó Notion realmente, una forma barata de comprobar el resultado en el nodo siguiente.
Notion limita cada llamada a 100 bloques. Repartí los cuerpos más largos en varias llamadas.
Este nodo escribe el cuerpo de la página. Para cambiar las columnas de la base usá Actualizar página.

Nodos relacionados

Notion - Crear página — crea la página y puede enviar sus primeros bloques en children.
Notion - Actualizar página — actualizá las propiedades en lugar del cuerpo.
Notion - Comentar página — dejá una nota sin tocar el contenido.