> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectando o Notion ao seu app

> Leia e escreva páginas e bancos de dados do Notion, adicione comentários e execute workflows pelo seu app, usando uma conta do Notion compartilhada ou a conta de cada pessoa.

Conecte seu app ao Notion para ler e escrever páginas e bancos de dados, adicionar comentários e executar workflows quando algo muda no seu workspace do Notion. Use uma conta compartilhada para todo o seu app ou deixe cada pessoa conectar a própria conta do Notion.

***

## O que você pode fazer

Traga suas páginas e bancos de dados do Notion para os workflows do seu app.

> [card] Sincronizar bancos de dados
>
> Mostre linhas de um banco de dados do Notion no seu app, ou mantenha um banco de dados alinhado com os registros do seu app.

> [card] Escrever páginas
>
> Crie páginas do Notion pelo seu app, como uma página para cada novo cliente, ou adicione atualizações a uma página existente.

> [card] Trabalhar com comentários
>
> Leia os comentários de uma página e adicione novos pelo seu app.

> [card] [Executar workflows](https://docs.base44.com/pt-BR/Building-your-app/Creating-workflows.md#connector)
>
> Inicie um workflow quando uma página ou um banco de dados for criado, atualizado, movido ou excluído, ou quando alguém comentar.

**Prompts de exemplo**

No chat de IA, descreva a página ou o banco de dados, o que aciona a ação e os campos dinâmicos. Por exemplo:

```text wrap theme={null}
Sincronize um banco de dados do Notion com os registros do meu CRM.
```

```text wrap theme={null}
Escreva as atualizações de projeto deste app em uma página do Notion.
```

```text wrap theme={null}
Mostre no meu painel o progresso da checklist do Notion para o onboarding da equipe.
```

```text wrap theme={null}
Crie novas páginas do Notion para cada novo cliente adicionado no meu app.
```

***

## Conectando o Notion

Escolha como as pessoas se conectam: uma conta compartilhada para todo o seu app ou a conta de cada pessoa.

> [tab] Conector compartilhado
>
> Conecte uma conta do Notion. Todos os apps que usam a conexão, e todos que usam esses apps, compartilham essa conta e as páginas que ela pode ver.
>
> **Para adicionar um conector compartilhado do Notion:**
>
> 1. Clique em **Conectores** na barra lateral do seu workspace.
>
> 2. Clique em **Adicionar conector**.
>
> 3. Pesquise **Notion** e clique no resultado.
>
> 4. Selecione **Conector compartilhado** e clique em **Avançar**.
>
> 5. Insira um **Nome da conexão**.
>
> 6. Escolha onde a conexão pode ser usada em **Quem pode acessar**:
>    * **Apps e Super agent:** Seus apps e seu Superagent podem usá-la. Este é o padrão.
>    * **Apenas apps:** Só seus apps podem usá-la.
>    * **Apenas Super agent:** Só seu Superagent pode usá-la.
>
> 7. Escolha o que seu app pode fazer em **Permissões**. **read content** e **read comment** já vêm selecionados. Adicione os que seu app precisar:
>
>    * **insert content:** Criar páginas e adicionar linhas a bancos de dados.
>    * **update content:** Alterar páginas e linhas de bancos de dados existentes.
>    * **insert comment:** Adicionar comentários.
>
>    ![Configuração do conector compartilhado do Notion mostrando Connection name, Who can access e Permissions com read content e read comment selecionados](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-shared-setup.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=4613834e2b9b1e12620ed0d4c2e5a189)
>
>    Configurando um conector compartilhado do Notion
>
> 8. Clique em **Adicionar conector**.
>
> 9. Entre no Notion e escolha as páginas que seu app pode usar. Saiba mais no guia do Notion para [instalar uma conexão](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).

> [tab] Conector de usuário do app
>
> Cada pessoa conecta a própria conta do Notion, para que seu app possa trabalhar com as páginas que ela escolher compartilhar.
>
> > [!WARNING]
> >
> > Somente proprietários e admins do workspace podem configurar isso.
>
> > [!TIP]
> >
> > **Antes de configurar:** Você precisa de uma integração pública do Notion e do Client ID e do Client Secret dela. Veja [Usando seu próprio cliente OAuth](https://docs.base44.com/pt-BR/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Para adicionar um conector de usuário do app do Notion:**
>
> 1. Clique em **Conectores** na barra lateral do seu workspace.
>
> 2. Clique em **Adicionar conector**.
>
> 3. Pesquise **Notion** e clique no resultado.
>
> 4. Selecione **Conector de usuário do app** e clique em **Avançar**.
>
> 5. Copie a **URL de callback**.
>
> 6. Adicione a URL de callback como redirect URI nas configurações da sua integração do Notion.
>
> 7. Preencha o formulário **Add Notion Connection**:
>
>    * **Nome do conector:** Um nome que você vai reconhecer depois.
>    * **ID do cliente** e **Segredo do cliente:** Copie esses valores das configurações da sua integração do Notion.
>
>    ![Formulário Add Notion Connection com Callback URL, Connector name, Client ID e Client Secret](https://mintcdn.com/base44/astRE1z0rD_F1xsn/images/apps-connectors-notion-app-user-credentials.png?fit=max\&auto=format\&n=astRE1z0rD_F1xsn\&q=85\&s=2d7f3ef817379a121bb34c45ca966c6a)
>
>    Inserindo as credenciais da sua integração do Notion
>
> 8. Clique em **Adicionar conector**.
>
> 9. Abra seu app no editor do app.
>
> 10. Peça ao chat de IA para adicionar uma forma de as pessoas conectarem a própria conta do Notion.

***

## Escopos e permissões

Você controla o acesso do seu app ao Notion em 2 lugares. Na Base44, você escolhe o que seu app pode fazer. No Notion, quem entra escolhe quais páginas ele pode ver.

> [card]
>
> **1. Você escolhe na Base44**
>
> Em um conector compartilhado, escolha o que seu app pode fazer em **Permissões**. Seu app pode ler páginas, bancos de dados e comentários por padrão. Adicione as permissões de escrita quando ele também precisar criar ou alterar páginas, linhas ou comentários.
>
> Em um conector de usuário do app, o que seu app pode fazer vem dos recursos definidos na sua integração do Notion.
>
> **2. Você escolhe no Notion**
>
> Quem entra no Notion escolhe as páginas que seu app pode usar. Em um conector compartilhado, é você. Em um conector de usuário do app, é cada pessoa. Saiba mais no guia do Notion para [instalar uma conexão](https://www.notion.com/help/add-and-manage-connections-with-the-api#install-directly-from-a-partner-platform-via-oauth).
>
> **Acesso:** Seu app trabalha com as páginas e os bancos de dados compartilhados durante o login, no workspace do Notion em que a pessoa entrou. Cada conexão mostra o nome do workspace do Notion dela, para que você possa diferenciar as conexões.

***

## Usando funções de backend

Depois que o Notion está conectado, suas funções de backend podem obter um token de acesso e chamar a Notion API diretamente. A Base44 cuida do login para você.

* Em uma conexão compartilhada, use `getConnection()` para obter o token.
* Em uma conexão de usuário do app, use `getCurrentAppUserConnection()` para que cada requisição use o token da pessoa conectada.

Chame a Notion API em `api.notion.com`. Passe o token no cabeçalho `Authorization` e a versão da API no cabeçalho `Notion-Version`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("notion");

const response = await fetch("https://api.notion.com/v1/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${accessToken}`,
    "Notion-Version": "2025-09-03",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ query: "Clients" }),
});
const { results } = await response.json();
```

> [card] [Conectores compartilhados](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/shared-connectors.md)
>
> Configure, implante e chame uma conexão compartilhada a partir de uma função de backend.

> [card] [Conectores de usuário do app](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/app-user-connectors.md)
>
> Obtenha um token por usuário e chame a API como a pessoa conectada.

***

## Solução de problemas

Verifique a conexão e as páginas que ela pode ver se o Notion parar de funcionar no seu app.

> [accordion] A conexão precisa ser reconectada
>
> Se seu app perder o acesso ao Notion ou o login dele expirar, a conexão mostra uma seção **Reconectar esta conexão**.
>
> * **Conector compartilhado:** [Reconecte-o](https://docs.base44.com/pt-BR/Integrations/Connectors.md#managing-your-connectors) e entre com a mesma conta do Notion. Todos os apps que o usam voltam a funcionar.
> * **Conector de usuário do app:** Cada pessoa reconecta a própria conta do Notion dentro do seu app.

> [accordion] Seu app não encontra uma página ou um banco de dados
>
> Seu app só vê as páginas compartilhadas com a conexão. Reconecte-a e escolha a página no Notion, ou [adicione a conexão à página](https://www.notion.com/help/add-and-manage-connections-with-the-api#add-connections-to-pages) no Notion.

> [accordion] Um workflow é executado com frequência demais
>
> O Notion envia um evento sempre que o conteúdo de uma página muda, então um workspace movimentado pode iniciar um workflow muitas vezes. Peça ao chat de IA para adicionar uma condição para que o workflow só rode para uma página ou um banco de dados.

> [!NOTE]
>
> Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md).


## Related topics

- [Conectando o Snowflake ao seu app](https://docs.base44.com/pt-BR/Integrations/snowflake-connector.md)
- [Conectando o Databricks ao seu app](https://docs.base44.com/pt-BR/Integrations/databricks-connector.md)
- [Conectando o Slack ao seu app](https://docs.base44.com/pt-BR/Integrations/slack-connectors.md)
- [Conectando a Wix ao seu app](https://docs.base44.com/pt-BR/Integrations/wix-connector.md)
- [Conectando o Outlook ao seu app](https://docs.base44.com/pt-BR/Integrations/outlook-connector.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.