## Capacidades A integração Notion para Botpress Studio permite-lhe fazer o seguinte: > As seguintes acções requerem que conheça os Ids das entidades Notion com as quais o seu bot irá trabalhar. Todas as entidades notion (páginas, bases de dados, etc) têm um id que pode ser encontrado no URL quando as visita na sua conta Notion num Browser, ou obtendo o link clicando no item "Copy Link" no menu (...). Consulte [Obter um ID de base de dados - Notion Developers] (https://developers.notion.com/docs/create-a-notion-integration#step-3-save-the-database-id) para obter mais informações ### Adicionar comentário a uma discussão Esta ação permite-lhe adicionar um comentário a uma discussão existente. Utilize-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. Isto é idealmente utilizado com a ação `Adicionar Página a uma Base de Dados`. Para além da resposta da API Notion ([Retreive a Database - Notion Developers](https://developers.notion.com/reference/retrieve-a-database)), esta ação também devolve uma propriedade `structure` optimizada (tecnicamente uma declaração de tipo) que pode ser utilizada como entrada para uma tarefa de IA para a instruir a gerar um payload para adicionar ou atualizar uma página numa Base de Dados Notion com base numa entrada do utilizador. ### Adicionar página a uma base de dados Esta ação deve idealmente ser utilizada em conjunto com `Get a Database` que devolve a estrutura da Base de Dados que pode ser utilizada para instruir uma [tarefa de IA](https://botpress.com/docs/cloud/generative-ai/ai-task-card/) para gerar um payload. Consulte [Trabalhar com bases de dados - Notion Developers] (https://developers.notion.com/docs/working-with-databases) para mais informações. ### Apagar um bloco É possível eliminar as seguintes entidades: - uma página numa base de dados - uma página - um bloco ## Instalação e configuração ### Passo 1 - Criar integração Criar uma integração Notion [Criar uma integração - Notion Developers] (https://developers.notion.com/docs/create-a-notion-integration) ### Passo 2 - Dar acesso a Notion Activos Dê à sua integração acesso a todas as páginas e bases de dados que pretende utilizar com Botpress ### Passo 3 - Configurar o seu Bot Dê à sua integração acesso a todas as páginas e bases de dados que pretende utilizar com Botpress. [Partilhar uma base de dados com a sua integração - Notion Developers] (https://developers.notion.com/docs/create-a-notion-integration#step-2-share-a-database-with-your-integration) Precisa de um token para que a sua recém-criada integração Notion _(não é a mesma que a integração Notion do Botpress Studio)_ seja ligada ao Botpress Studio: - `Auth Token` - Você encontrará isso indo para sua integração em `https://www.notion.so/my-integrations`. Depois de clicar na sua integração, vá para a 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 "Integrations" 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 Notion.
