A integração Notion para Botpress Studio permite-lhe fazer o seguinte ## Migrar da versão `0.x` ou `1.x` para `2.x` A versão `2.0` da integração Notion adiciona suporte a OAuth, que agora é a opção de configuração padrão. Se você criou anteriormente uma integração Notion no portal de desenvolvedores do Notion e deseja continuar usando essa integração, selecione a opção de configuração manual e siga as instruções abaixo. Caso contrário, selecione a opção de configuração automática, clique no botão de autorização e siga as instruções na tela para conectar seu chatbot Botpress ao Notion. ## Configuração ### Configuração automática com OAuth (recomendado) Esta é a maneira mais simples de configurar a integração. Para configurar a integração Notion usando o OAuth, clique no botão de autorização e siga as instruções na tela para conectar seu chatbot Botpress ao Notion. Esse método é recomendado, pois simplifica o processo de configuração e garante uma comunicação segura entre seu chatbot e o Notion. Ao usar esse modo de configuração, um aplicativo Notion Botpress será usado para se conectar à sua conta Notion . As ações realizadas pelo bot serão atribuídas a esse aplicativo, e não à sua conta pessoal Notion . ### Configuração manual com uma integração personalizada Notion #### Etapa 1 - Criar integração Criar uma integração Notion [Criar uma integração - Notion Developers]notion #### Etapa 2 - Dar acesso aos ativos Notion Dê à sua integração acesso a todas as páginas e bancos de dados que você deseja usar com o Botpress #### Passo 3 - Configure seu Bot Dê à sua integração acesso a todas as páginas e bases de dados que pretende utilizar com o Botpress. [Partilhar uma base de dados com a sua integração - Notion Developers]notion Você precisa de um token para que sua integração Notion recém-criada _(não é a mesma coisa que a integração Notion do Botpress Studio)_ se conecte com o Botpress Studio: - `Auth Token` - Você vai encontrar isso indo até sua integração em notion. Depois de clicar na sua integração, vá à secção "Secrets" e encontre o campo "Internal Integration Secret". Clique em "Mostrar" e depois em "Copiar". Cole o token copiado no campo `Auth Token` da integração Notion no separador "Integrações" do seu bot. Com isso, só precisa de ativar a sua integração e pode começar a expandir as capacidades do seu Bot com o Notion. ## Uso As ações a seguir requerem que você saiba os Ids das entidades Notion com as quais seu bot vai trabalhar. Todas as entidades notion (páginas, bancos de dados, etc) têm um id que pode ser encontrado na URL quando você as visita em sua conta Notion em um navegador, ou obtendo o link clicando no item "Copiar link" no menu (...). Veja [Obter um ID de banco de dados - Desenvolvedores Notion ]notion para mais informações ### Adicionar comentário a uma discussão Esta ação permite adicionar um comentário a uma discussão existente. Use-a para responder a um comentário. ### Adicionar comentário a uma página Com esta ação, pode adicionar comentários ao nível da página. ### Obter uma base de dados Esta ação permite-lhe obter os detalhes de uma Base de Dados. É ideal para ser utilizada com a ação `Adicionar página a um banco de dados`. Além da resposta da API Notion ([Retreive a Database - Notion Developers]notion), esta ação também retorna uma propriedade `structure` otimizada (tecnicamente uma declaração de tipo) que pode ser usada como entrada para uma tarefa de IA para instruí-la a gerar um payload para adicionar ou atualizar uma página em um banco de dados Notion baseado em uma entrada do usuário. ### Adicionar página a um banco de dados Esta ação deve ser usada idealmente em conjunto com `Get a Database` que retorna a estrutura do banco de dados que você pode usar para instruir uma [tarefa de IA]botpress para gerar um payload. Veja [Trabalhando com Bancos de Dados - Desenvolvedores de Notion ]notion para mais informações. ### Apagar um bloco Pode eliminar as seguintes entidades: - uma página numa base de dados - uma página - um bloco