> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Notion Sua recepcionista pode pesquisar seu espaço de trabalho do Notion, ler uma página e consultar um banco de dados, como uma lista de preços, uma tabela de produtos ou uma lista de vagas abertas, para responder aos chamadores. A leitura é feita por [ferramentas de webhook](/docs/pt/reception-ai/integrations/webhooks) com uma conexão interna do Notion, que funciona em todos os planos do Notion e só vê as páginas que você compartilha com ela. Adicionar entradas a um banco de dados também funciona com uma ferramenta de webhook, por meio de uma segunda conexão que só pode adicionar conteúdo. Você pode usar o [Zapier](/docs/pt/reception-ai/integrations/zapier) para isso, mas a ferramenta de webhook é recomendada: ela não precisa de uma conta do Zapier nem usa suas tarefas do Zapier, e cada solicitação vai direto para o Notion. Porém, a ferramenta de webhook não consegue preencher a propriedade de título. Portanto, se suas entradas precisarem de um título de verdade, use o Zapier. > **Note** > > Se o conteúdo do seu Notion raramente muda, talvez você não precise de uma integração. Exporte a página do > Notion e [faça upload dela para sua base de conhecimento](#use-the-knowledge-base-instead). > **Warning** > > Sua recepcionista pode ler tudo que você compartilhar com a conexão e repeti-lo aos chamadores. > Compartilhe apenas páginas sobre as quais os chamadores possam ouvir e adicione uma > [regra](/docs/pt/reception-ai/receptionist/rules-and-procedures) para que sua recepcionista nunca leia > registros privados, como dados de clientes, para os chamadores. ## Configuração ### Crie uma conexão interna Você precisa ser proprietário do espaço de trabalho. Acesse [app.notion.com/developers/connections](https://app.notion.com/developers/connections), selecione **Internal connections** e depois **Create a new connection**. Dê a ela o nome `Reception.ai` e escolha seu espaço de trabalho. Na aba **Configuration**, permita apenas a leitura de conteúdo e copie o **API token**. ### Compartilhe páginas com a conexão Abra a aba **Content access** da conexão, selecione **Edit access** e escolha as páginas e os bancos de dados que sua recepcionista deve ler. Você também pode abrir uma página no Notion, selecionar **•••** → **Connections** → **+ Add connection** e escolher `Reception.ai`. As páginas filhas também são compartilhadas. ### Encontre o ID da fonte de dados Para permitir que sua recepcionista leia um banco de dados, abra as configurações do banco de dados no Notion, selecione **Manage data sources**, abra o menu **•••** ao lado da fonte de dados e selecione **Copy data source ID**. ### Crie as ferramentas de webhook Crie as [ferramentas abaixo](#tools). Para cada uma, acesse **Integrations**, selecione **Add integration** e escolha **Webhook Tool**. ### Teste [Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) fazendo uma pergunta que uma de suas páginas compartilhadas responda. ## Ferramentas Todas as ferramentas enviam estes cabeçalhos de solicitação: | Cabeçalho | Tipo | Valor | | ---------------- | ------- | ----------------------------------------- | | `Authorization` | Segredo | `Bearer ` seguido do token da sua conexão | | `Notion-Version` | Valor | `2026-03-11` | Defina **Assign to agents** como **Receptionist** em cada ferramenta e selecione **Enable**. ### Pesquisar páginas | Campo | Valor | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Name** | `search_notion` | | **Description** | "Pesquise nossas páginas do Notion pelo título. Use esta ferramenta quando um chamador perguntar algo que nossos documentos possam responder e, em seguida, leia a melhor correspondência com `read_notion_page`." | | **Method** | POST | | **URL** | `https://api.notion.com/v1/search` | | **Body Parameters** | `query` (string, obrigatório): "Um título curto para pesquisar, como `pricing` ou `opening hours`." `page_size` (number, valor fixo): `10` | ### Ler uma página | Campo | Valor | | -------------------- | -------------------------------------------------------------------------------------- | | **Name** | `read_notion_page` | | **Description** | "Leia o texto completo de uma página do Notion encontrada com `search_notion`." | | **Method** | GET | | **URL** | `https://api.notion.com/v1/pages/{page_id}/markdown` | | **Path Parameters** | `page_id` (string, obrigatório): "O `id` de uma página retornada por `search_notion`." | | **Query Parameters** | `markdown_version` (string, valor fixo): `v2` | ### Ler um banco de dados | Campo | Valor | | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `read_notion_table` | | **Description** | "Liste as linhas da nossa lista de preços. Use esta ferramenta quando um chamador perguntar sobre preços ou o que oferecemos." Descreva sua própria tabela aqui. | | **Method** | POST | | **URL** | `https://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query` | | **Body Parameters** | `page_size` (number, valor fixo): `100` | Substitua `DATA_SOURCE_ID` pelo ID que você copiou. Crie uma ferramenta para cada banco de dados, cada uma com seu próprio nome e descrição. ## Adicione entradas ao banco de dados com uma ferramenta de webhook (recomendado) Para salvar algo de uma chamada em um banco de dados do Notion, como um lead ou uma solicitação de retorno, crie uma ferramenta que adicione uma entrada. ### Crie uma conexão para novas entradas Crie uma segunda conexão interna, por exemplo, `Reception.ai entries`, da mesma forma que a primeira. Na aba **Configuration**, permita apenas a inserção de conteúdo e copie o **API token**. Em **Content access**, compartilhe apenas o banco de dados ao qual ela adiciona entradas. Essa conexão não pode ler nada de volta, portanto as entradas permanecem privadas. ### Prepare o banco de dados Copie o ID da fonte de dados do banco de dados, como em [Configuração](#set-up). Cada propriedade preenchida pela ferramenta é uma chave na solicitação, e as chaves não podem conter espaços. Portanto, dê nomes de uma palavra a essas propriedades, como `Phone`, `Email` e `Status`. ### Crie a ferramenta de webhook Acesse **Integrations**, selecione **Add integration** e escolha **Webhook Tool**. | Campo | Valor | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | **Name** | `add_notion_entry` | | **Description** | "Salve um novo lead em nosso banco de dados de leads quando um chamador quiser um orçamento ou um retorno." Descreva seu próprio banco de dados aqui. | | **Method** | POST | | **URL** | `https://api.notion.com/v1/pages` | | **Request Headers** | `Authorization` (Secret): `Bearer ` seguido do token da nova conexão `Notion-Version` (Value): `2026-03-11` | | **Body Parameters** | `parent` (object, obrigatório) `markdown` (string, obrigatório) `markdown_version` (string) `properties` (object, obrigatório) | | **Assign to agents** | **Receptionist** | Configure os parâmetros do corpo assim: * `parent`: um campo, `data_source_id` (string, valor fixo): o ID da sua fonte de dados. * `markdown` (da conversa): "A entrada como Markdown. Comece com uma linha `# ` seguida do nome do chamador e do que ele precisa, por exemplo, `# Jane Doe: quote for a new boiler`. Em seguida, adicione uma linha em branco e os detalhes da solicitação." * `markdown_version` (valor fixo): `v2` * `properties`: selecione **Add field** uma vez para cada propriedade a preencher. Cada uma é um objeto com o nome exatamente igual ao da propriedade, com um campo para seu valor: * `Phone` (object): `phone_number` (string, da conversa): "O número de telefone do chamador." * `Email` (object): `email` (string, da conversa): "O endereço de e-mail do chamador, confirmado letra por letra com ele. Omita se ele não fornecer um." * `Status` (object, obrigatório): `select` (object, obrigatório), com um campo, `name` (string, valor fixo): `New` A documentação do Notion informa que, quando a propriedade de título é omitida, o primeiro cabeçalho `#` se torna o título da página; a documentação só mostra isso para páginas criadas dentro de uma página, então verifique se funciona para seu banco de dados. De qualquer forma, o cabeçalho e os detalhes são salvos como conteúdo da entrada, e as propriedades de telefone, e-mail e status são preenchidas. Não inclua a propriedade de título em `properties`: o Notion aninha valores de título e texto em seis níveis, um a mais do que as ferramentas de webhook permitem. As propriedades de número de telefone, e-mail, URL, número, caixa de seleção, seleção e data são compatíveis. Uma propriedade do tipo Status usa `status` em vez de `select`. Selecione **Enable** e [teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) pedindo um retorno. A entrada aparecerá no banco de dados. ## Adicione entradas ao banco de dados com o Zapier Para adicionar entradas pelo Zapier, conecte o [Zapier](/docs/pt/reception-ai/integrations/zapier). No seu servidor MCP do Zapier em [mcp.zapier.com](https://mcp.zapier.com), adicione a ação **Create Data Source Item** do Notion, defina o banco de dados como um valor fixo e deixe a IA preencher os campos. No Reception.ai, abra a aba **Tools** da integração do Zapier, selecione **Refresh tools** e atribua a ação ao **Client** (recepcionista). ## Use a base de conhecimento Para conteúdo que não muda com frequência, a [base de conhecimento](/docs/pt/reception-ai/knowledge-base/overview) é mais simples e rápida do que consultas em tempo real. No Notion, abra o menu **•••** da página, escolha **More** → **Export** e selecione **PDF**, **HTML** ou **Markdown & CSV**. As exportações em HTML e Markdown são baixadas como um arquivo zip, então descompacte-o primeiro. Em seguida, [faça upload do arquivo](/docs/pt/reception-ai/knowledge-base/file-uploads). Bancos de dados são exportados para CSV, que a base de conhecimento não aceita; por isso, exporte bancos de dados como PDF. Exporte e faça upload novamente quando o conteúdo mudar. ## Limitações * A pesquisa do Notion encontra títulos de páginas e bancos de dados, não o texto dentro das páginas. Dê títulos claros às páginas, como "Política de cancelamento". * `read_notion_table` retorna as primeiras 100 linhas e apenas suas propriedades, não o conteúdo dentro da página de cada linha. Mantenha pequenos os bancos de dados que sua recepcionista lê. * O servidor MCP hospedado do Notion exige login pelo navegador, exceto nos planos Business e Enterprise, nos quais o proprietário do espaço de trabalho pode criar um token MCP. As ferramentas de webhook acima funcionam em todos os planos. * `add_notion_entry` não consegue preencher propriedades de título ou texto. Coloque nomes e observações no cabeçalho e no conteúdo. * Se você adicionar entradas pelo Zapier, cada ação do Zapier executada pela sua recepcionista usa tarefas do seu plano Zapier. Atualmente, o Zapier conta duas tarefas por chamada bem-sucedida. ## Solução de problemas | Problema | O que verificar | | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 do Notion | O cabeçalho `Authorization` deve ser `Bearer ` seguido do token da conexão. | | 400 sobre a versão | Defina `Notion-Version` como `2026-03-11`. | | 404 ou `object_not_found` | Compartilhe a página ou o banco de dados com a conexão e use o ID da fonte de dados, não o ID do banco de dados. | | 403 em `read_notion_page` | A conexão precisa de permissão para ler conteúdo. | | 403 em `add_notion_entry` | A conexão de entradas precisa de permissão para inserir conteúdo e acesso ao banco de dados. | | 400 `validation_error` em `add_notion_entry` | Cada chave em `properties` deve corresponder exatamente a um nome de propriedade, e seu campo deve corresponder ao tipo da propriedade. | | Novas entradas aparecem como **Untitled** | O Notion não usou o cabeçalho `#` como título do seu banco de dados. O cabeçalho ainda fica no topo da página de cada entrada, e você pode encontrar entradas pelo telefone ou status. Para ter um título, use a opção do Zapier. | | A pesquisa não encontra nada | A pesquisa só encontra títulos e apenas de páginas compartilhadas com a conexão. | | A recepcionista fica lenta em uma tabela grande | Tabelas grandes retornam muitos dados. Divida a tabela ou mova o conteúdo para a base de conhecimento. |