Conexões da API do Notion

Visite a nossa central para desenvolvedores se quiser conferir recursos, documentação e ferramentas de gestão de conexões.

1. Na barra lateral esquerda, acesse Configurações e, em seguida, a guia Conexões.

2. Somente os proprietários do espaço de trabalho poderão acessar a guia Conexões e criar integrações. Se você não for um administrador, entre em contato com o administrador do espaço de trabalho ou use outro espaço de trabalho.

3. Clique no link Desenvolva suas próprias conexões na parte inferior.

4. A seção Minhas conexões se abrirá no seu navegador padrão. Clique no botão + Nova conexão .

5. Insira um Nome para sua conexão. Também é possível carregar uma imagem para usar como logotipo.

6. Use o menu dropdown para especificar o espaço de trabalho associado onde você gostaria de usar a conexão.

   

   Nota: verifique se você está conectado ao Notion na sua sessão da web com a mesma conta que usou no desktop. Caso contrário, você não verá a conta e os espaços de trabalho corretos!

   

7. A conexão interna foi adicionada! Agora você poderá vê-la no seu espaço de trabalho, no menu Configurações  → Conexões.

8. Clique no botão ••• ao lado da conexão interna para recuperar o token de conexão interna. Você precisará desse token para automações ou fluxos de trabalho baseados em API criados pela sua equipe ou para vincular seu espaço de trabalho a algumas plataformas de parceiros.

Todas as conexões recém-adicionadas são internas a princípio. Se você é um desenvolvedor que está trabalhando em uma conexão pública, siga primeiro as instruções acima para criar uma conexão interna.

Depois, siga as instruções no nosso guia do desenvolvedor para convertê-la em uma conexão pública.

Durante o processo de configuração do app, os desenvolvedores poderão escolher o nível de acesso exigido dos usuários.

• Funções do conteúdo:

  • Ler conteúdo somente

  • Gravar conteúdo somente

  • Inserir conteúdo

• Funções dos usuários

  • Sem informações dos usuários

  • Ler informações dos usuários (exceto e-mail)

  • Ler informações dos usuários (incluindo e-mail)

Quando os usuários instalarem conexões, esse nível de acesso será exibido. Ele também será exibido no menu Compartilhar de todas as páginas às quais a conexão foi adicionada. Saiba mais sobre como instalar conexões em um espaço de trabalho →

Os webhooks de conexão permitem que as conexões monitorem e respondam a alterações nos espaços de trabalho do Notion em tempo real.

Quando ocorrem alterações em páginas ou bases de dados compartilhados com a sua conexão, o Notion envia notificações automaticamente para o seu endpoint de webhook, permitindo que a conexão atualize instantaneamente outras ferramentas, execute tarefas automatizadas ou exiba as alterações mais recentes.

Para obter instruções, acesse a nossa documentação para desenvolvedores.

As ações de webhook e os webhooks de conexão apresentam algumas semelhanças: ambos têm gatilhos e podem enviar eventos para serviços de terceiros. No entanto, os webhooks de conexão oferecem recursos mais amplos:

• Podem monitorar atividades em vários espaços de trabalho.

• Podem lidar com um número ilimitado de ações.

Por outro lado, as ações de webhook são projetadas para casos de uso mais simples e são configuradas por meio de automações de bases de dados com um conjunto limitado de gatilhos.