Ir para a navegação

Notion

Responda a quem liga usando suas páginas e bancos de dados do Notion e adicione novas entradas a um banco de dados.

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 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 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.

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.

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 para que sua recepcionista nunca leia registros privados, como dados de clientes, para os chamadores.

Configuração

1

Crie uma conexão interna

Você precisa ser proprietário do espaço de trabalho. Acesse 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.

2

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.

3

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.

4

Crie as ferramentas de webhook

Crie as ferramentas abaixo. Para cada uma, acesse Integrations, selecione Add integration e escolha Webhook Tool.

5

Teste

Teste sua recepcionista fazendo uma pergunta que uma de suas páginas compartilhadas responda.

Ferramentas

Todas as ferramentas enviam estes cabeçalhos de solicitação:

CabeçalhoTipoValor
AuthorizationSegredoBearer seguido do token da sua conexão
Notion-VersionValor2026-03-11

Defina Assign to agents como Receptionist em cada ferramenta e selecione Enable.

Pesquisar páginas

CampoValor
Namesearch_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.”
MethodPOST
URLhttps://api.notion.com/v1/search
Body Parametersquery (string, obrigatório): “Um título curto para pesquisar, como pricing ou opening hours.”
page_size (number, valor fixo): 10

Ler uma página

CampoValor
Nameread_notion_page
Description”Leia o texto completo de uma página do Notion encontrada com search_notion.”
MethodGET
URLhttps://api.notion.com/v1/pages/{page_id}/markdown
Path Parameterspage_id (string, obrigatório): “O id de uma página retornada por search_notion.”
Query Parametersmarkdown_version (string, valor fixo): v2

Ler um banco de dados

CampoValor
Nameread_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.
MethodPOST
URLhttps://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query
Body Parameterspage_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.

1

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.

2

Prepare o banco de dados

Copie o ID da fonte de dados do banco de dados, como em Configuração. 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.

3

Crie a ferramenta de webhook

Acesse Integrations, selecione Add integration e escolha Webhook Tool.

CampoValor
Nameadd_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.
MethodPOST
URLhttps://api.notion.com/v1/pages
Request HeadersAuthorization (Secret): Bearer seguido do token da nova conexão
Notion-Version (Value): 2026-03-11
Body Parametersparent (object, obrigatório)
markdown (string, obrigatório)
markdown_version (string)
properties (object, obrigatório)
Assign to agentsReceptionist

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 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. No seu servidor MCP do Zapier em 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 é 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. 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

ProblemaO que verificar
401 do NotionO cabeçalho Authorization deve ser Bearer seguido do token da conexão.
400 sobre a versãoDefina Notion-Version como 2026-03-11.
404 ou object_not_foundCompartilhe 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_pageA conexão precisa de permissão para ler conteúdo.
403 em add_notion_entryA conexão de entradas precisa de permissão para inserir conteúdo e acesso ao banco de dados.
400 validation_error em add_notion_entryCada chave em properties deve corresponder exatamente a um nome de propriedade, e seu campo deve corresponder ao tipo da propriedade.
Novas entradas aparecem como UntitledO 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 nadaA pesquisa só encontra títulos e apenas de páginas compartilhadas com a conexão.
A recepcionista fica lenta em uma tabela grandeTabelas grandes retornam muitos dados. Divida a tabela ou mova o conteúdo para a base de conhecimento.