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. Minhas conexões serão abertas no seu navegador padrão. Clique no botão + Nova conexão.

5. Forneça um Nome para a sua conexão. Opcionalmente, você também pode 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 sua conexão interna foi adicionada com sucesso! Agora você poderá vê-la no seu espaço de trabalho, no menu Configurações → Conexões.

8. Clique em ••• ao lado da conexão interna para recuperar o token de conexão interna. Você precisará desse token para quaisquer 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 inicialmente. Se você for um desenvolvedor que trabalha 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 a instalação de 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.

Ações de webhook e webhooks de conexão compartilham algumas semelhanças — ambos possuem 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.