Nó Notion

O nó de workflow Notion (notion_request) chama a Notion REST API para ler e gravar pages, databases, blocks e executar workspace search. Use-o para registrar leads, atualizar quadros de tarefas ou anexar resumos de conversas ao Notion a partir de automações WhatsApp.

ID do nó no editor: notion_request
Base da API: https://api.notion.com/v1/
Header obrigatório: Notion-Version: 2022-06-28

O que faz

A cada execução, o engine:

1. Resolve URL, headers e body com variáveis do workflow
2. Injeta {{notion_token}} de um serviço conectado ou chave de integração
3. Envia a requisição HTTP ao Notion
4. Retorna status, data e headers

Pré-requisitos

Opção A — Serviço conectado (recomendado)

1. Configurações → Chaves de API → Serviços conectados
2. Adicione Notion e conclua o OAuth
3. No nó, selecione Serviço conectado (company_service_id)

Consulte Como integrar o Notion para o passo a passo completo do OAuth.

Opção B — Token de integração

1. Crie uma internal integration no Notion
2. Copie o Internal Integration Secret
3. Adicione a chave de integração notion_token na WhatsWave
4. Compartilhe cada database/page com a integração no Notion (⋯ → Connections)

Sem compartilhar, o Notion retorna 404 ou 403 mesmo com token válido.

Como configurar

Passo 1 — Adicionar o nó

1. Abra Automações
2. Paleta → Dados → Notion
3. Selecione o serviço conectado (se usar OAuth)
4. Escolha um template de operação ou configure URL/method/body manualmente

Passo 2 — Templates de operação

Passo 3 — Encontrar IDs a partir de URLs do Notion

Copie o ID da URL ou use Database — query / Search para descobrir IDs programaticamente.

Passo 4 — Exemplos de payloads

Criar page em database:

{
  "parent": { "database_id": "{{variables.notion_database_id}}" },
  "properties": {
    "Name": {
      "title": [{ "text": { "content": "{{trigger.body.name}}" } }]
    },
    "Phone": {
      "phone_number": "{{trigger.body.phone}}"
    },
    "Status": {
      "select": { "name": "New lead" }
    }
  }
}

As chaves de propriedade devem corresponder exatamente ao schema do seu database (case-sensitive).

Consultar database com filtro:

{
  "filter": {
    "property": "Phone",
    "phone_number": { "equals": "{{contact.phone}}" }
  },
  "page_size": 10
}

Anexar parágrafo a uma page:

{
  "children": [
    {
      "object": "block",
      "type": "paragraph",
      "paragraph": {
        "rich_text": [
          {
            "type": "text",
            "text": { "content": "Summary: {{variables.conversation_summary}}" }
          }
        ]
      }
    }
  ]
}

Passo 5 — Usar a saída

{{notion_1.data}}
{{notion_1.data.id}}
{{notion_1.status}}

Saídas do nó

Referência de tipos de propriedade

Ao criar ou atualizar pages, envolva os valores no formato de propriedade do Notion:

Use Database — get schema para ver nomes e tipos exatos das propriedades.

Dicas e boas práticas

• Compartilhe todo database com sua integração antes de ir para produção
• Use serviço conectado OAuth para que os tokens sejam renovados automaticamente
• Consulte antes de criar para evitar leads duplicados (filtre por phone ou email)
• Paginar consultas grandes — o Notion retorna no máximo 100 itens por requisição; use start_cursor da resposta para a próxima página
• Arquivar vs excluir — blocks do Notion são arquivados, não excluídos permanentemente
• Armazene page_id em campos customizados do CRM para atualizações posteriores
• Use Search com moderação — varre o workspace e é mais lento que database query

Exemplos de casos de uso

Registrar lead WhatsApp em database CRM do Notion

1. Webhook ou gatilho de mensagem recebida
2. Notion — query — verificar se o phone já existe
3. Condição — encontrado vs novo
4. Notion — create page ou update properties na page existente
5. Enviar WhatsApp — confirmação

Anexar resumo de IA à page do Notion

1. Conversa do Agent termina; resumo em variables.summary
2. Notion — append blocks na page do contato no Notion a partir do ID no CRM

Digest diário do quadro de tarefas

1. Gatilho agendado
2. Notion — query no database onde Status = "Due today"
3. Loop + Enviar mensagem aos responsáveis

FAQ

404 object not found?
ID incorreto ou a integração não tem acesso. Compartilhe a page/database com a integração.

400 validation_error em properties?
Nome ou tipo de propriedade incompatível. Busque o schema com Database — get schema e corresponda exatamente.

Posso fazer upload de arquivos no Notion?
File blocks exigem upload em um host primeiro e depois referenciar a URL no payload do block. Considere Google Drive para armazenamento de arquivos.

OAuth vs internal token?
OAuth (serviço conectado) é mais simples para equipes e gerencia o ciclo de vida do token. Internal tokens funcionam para bots de workspace único.

Rate limits?
O Notion impõe limites de taxa (~3 req/s em média). Adicione Delay entre operações em massa ou limite lotes com Loop.

Referência da API

Relacionados

• Visão geral de Dados
• Como integrar o Notion
• Visão geral das integrações
• Variáveis no workflow