Conecta-seEntrar na plataforma

Notion

Consultar e administrar páginas e blocos do Notion.

Integrações e ferramentasArquivos e documentosConexão: OAuth

O que faz

Integre o Notion ao fluxo. Permite ler páginas, ler bancos de dados, criar páginas, criar bancos de dados, acrescentar conteúdo, consultar bancos de dados e buscar no espaço de trabalho.

Quando usar: Use quando o seu fluxo precisar consultar e administrar páginas e blocos do Notion.

Exemplo de situação: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Notion ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Ler páginaLê página com o bloco Notion.
Ler banco de dadosLê banco de dados com o bloco Notion.
Criar páginaCria página com o bloco Notion.
Atualizar propriedades da páginaAtualiza propriedades da página com o bloco Notion.
Criar banco de dadosCria banco de dados com o bloco Notion.
Adicionar linha ao banco de dadosAdiciona linha ao banco de dados com o bloco Notion.
Acrescentar conteúdoAcrescenta conteúdo com o bloco Notion.
Acrescentar blocos filhosAcrescenta blocos filhos com o bloco Notion.
Consultar blocos filhosConsulta blocos filhos com o bloco Notion.
Atualizar blocoAtualiza bloco com o bloco Notion.
Excluir blocoExclui bloco com o bloco Notion.
Criar comentárioCria comentário com o bloco Notion.
Listar comentáriosLista comentários com o bloco Notion.
Listar usuáriosLista usuários com o bloco Notion.
Consultar usuárioConsulta usuário com o bloco Notion.
Consultar banco de dadosConsulta banco de dados com o bloco Notion.
Buscar no espaço de trabalhoBusca no espaço de trabalho com o bloco Notion.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Ler página · Ler banco de dados · Criar página · Atualizar propriedades da página · Criar banco de dados · Adicionar linha ao banco de dados · Acrescentar conteúdo · Acrescentar blocos filhos · Consultar blocos filhos · Atualizar bloco · Excluir bloco · Criar comentário · Listar comentários · Listar usuários · Consultar usuário · Consultar banco de dados · Buscar no espaço de trabalho
    Padrão:
    Ler página

  • Conta do Notion

    Obrigatório

    Seleciona a conta já conectada que autoriza o acesso ao serviço.

    Exemplo:
    (escolha a conta conectada)

  • Conta do Notion

    ObrigatórioEm campos adicionais

    Informa manualmente a credencial usada pela integração no modo avançado.

  • Página

    Obrigatório conforme a operação

    Selecione a página do Notion.

    Aparece em:
    Ler página, Acrescentar conteúdo, Atualizar propriedades da página
    Exemplo:
    (escolha na lista do campo)

  • ID da página

    Obrigatório conforme a operaçãoEm campos adicionais

    Informe o ID da página do Notion.

    Aparece em:
    Ler página, Acrescentar conteúdo, Atualizar propriedades da página
    Exemplo:
    id-do-recurso

  • Banco de dados

    Obrigatório conforme a operação

    Selecione o banco de dados do Notion.

    Aparece em:
    Ler banco de dados, Consultar banco de dados, Adicionar linha ao banco de dados
    Exemplo:
    (escolha na lista do campo)

  • ID do banco de dados

    Obrigatório conforme a operaçãoEm campos adicionais

    Informe o ID do banco de dados do Notion.

    Aparece em:
    Ler banco de dados, Consultar banco de dados, Adicionar linha ao banco de dados
    Exemplo:
    id-do-recurso

  • Página pai

    Obrigatório conforme a operação

    Selecione a página pai.

    Aparece em:
    Criar página, Criar banco de dados
    Exemplo:
    (escolha na lista do campo)

  • ID da página pai

    Obrigatório conforme a operaçãoEm campos adicionais

    ID da página pai.

    Aparece em:
    Criar página, Criar banco de dados
    Exemplo:
    id-do-recurso

  • Título da página

    Título da nova página.

    Aparece em:
    Criar página
    Exemplo:
    Exemplo de atendimento

  • Conteúdo

    Obrigatório conforme a operação

    Informe o conteúdo a acrescentar à página.

    Aparece em:
    Acrescentar conteúdo
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Filtro

    Informe as condições do filtro em JSON (opcional).

    Aparece em:
    Consultar banco de dados
    Exemplo:
    status = 'ativo'

  • Critérios de ordenação

    Informe os critérios de ordenação como lista JSON (opcional).

    Aparece em:
    Consultar banco de dados
    Exemplo:
    { "chave": "valor" }

  • Itens por página

    Em campos adicionais

    Número de resultados (padrão: 100, máximo: 100).

    Aparece em:
    Consultar banco de dados, Consultar blocos filhos, Listar comentários, Listar usuários, Buscar no espaço de trabalho
    Exemplo:
    10

  • Consulta de busca

    Informa a consulta usada para localizar ou transformar dados.

    Aparece em:
    Buscar no espaço de trabalho
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Tipo de filtro

    Define a consulta ou o filtro aplicado aos dados.

    Aparece em:
    Buscar no espaço de trabalho
    Opções:
    Todos · Somente páginas · Somente bancos de dados
    Exemplo:
    Todos

  • Propriedades do banco de dados

    Informe as propriedades do banco de dados como objeto JSON.

    Aparece em:
    Criar banco de dados
    Exemplo:
    { "chave": "valor" }

  • ID da página ou do bloco

    Obrigatório conforme a operação

    Informe o ID da página ou do bloco do Notion.

    Aparece em:
    Acrescentar blocos filhos, Consultar blocos filhos, Atualizar bloco, Excluir bloco, Listar comentários
    Exemplo:
    id-do-recurso

  • Blocos filhos

    Obrigatório conforme a operação

    Informe uma lista de objetos de bloco do Notion em JSON.

    Aparece em:
    Acrescentar blocos filhos
    Exemplo:
    { "chave": "valor" }

  • Acrescentar depois do bloco (ID)

    Em campos adicionais

    UUID do bloco depois do qual acrescentar (opcional).

    Aparece em:
    Acrescentar blocos filhos
    Exemplo:
    UUID do bloco depois do qual acrescentar (opcional)

  • Atualização do bloco

    Obrigatório conforme a operação

    Informe em JSON os campos do tipo de bloco a atualizar.

    Aparece em:
    Atualizar bloco
    Exemplo:
    { "chave": "valor" }

  • Arquivar bloco

    Em campos adicionais

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Atualizar bloco
    Opções:
    Não alterar · Não (restaurar) · Sim (arquivar)
    Padrão:
    Não alterar

  • ID da página

    UUID da página a comentar.

    Aparece em:
    Criar comentário
    Exemplo:
    id-do-recurso

  • ID da discussão

    Em campos adicionais

    UUID de uma discussão existente (opcional).

    Aparece em:
    Criar comentário
    Exemplo:
    id-do-recurso

  • Comentário

    Obrigatório conforme a operação

    Informe o texto do comentário.

    Aparece em:
    Criar comentário
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • ID do usuário

    Obrigatório conforme a operação

    UUID do usuário do Notion a consultar.

    Aparece em:
    Consultar usuário
    Exemplo:
    id-do-recurso

  • Cursor inicial

    Em campos adicionais

    Cursor de paginação de uma resposta anterior (opcional).

    Aparece em:
    Consultar blocos filhos, Listar comentários, Listar usuários, Consultar banco de dados, Buscar no espaço de trabalho
    Exemplo:
    Cursor de paginação de uma resposta anterior (opcional)

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <notion.content>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<notion.content>stringConteúdo da página, texto do comentário, resultados da busca ou mensagens de confirmação.
<notion.metadata>jsonMetadados com detalhes específicos da operação, incluindo informações da página/banco de dados, resultados e dados de paginação.
<notion.id>stringID da linha, do bloco, do comentário ou do usuário.
<notion.url>stringURL da página do Notion.
<notion.title>stringTítulo da linha.
<notion.created_time>stringData e hora de criação.
<notion.last_edited_time>stringData e hora da última edição.
<notion.results>arrayLista de resultados (blocos, comentários ou usuários).
<notion.has_more>booleanIndica se há mais resultados disponíveis.
<notion.next_cursor>stringCursor de paginação.
<notion.type>stringTipo do bloco.
<notion.block>jsonObjeto completo do bloco do Notion.
<notion.has_children>booleanIndica se o bloco tem blocos aninhados.
<notion.archived>booleanIndica se o bloco está arquivado.
<notion.discussion_id>stringID da discussão.
<notion.rich_text>jsonTexto formatado (rich text) do comentário, em lista.
<notion.name>stringNome de exibição do usuário.
<notion.avatar_url>stringURL da imagem de avatar do usuário.
<notion.email>stringEndereço de e-mail do usuário (somente usuários do tipo pessoa).

Exemplo de uso

Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

InícioNotionpróxima etapa
Operação
Ler página
Conta do Notion
(escolha a conta conectada)
Página
(escolha na lista do campo)

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <notion.content>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados