Przejdź do nawigacji

Notion

Odpowiadaj rozmówcom na podstawie stron i baz danych Notion oraz dodawaj nowe wpisy do bazy danych.

Twoja recepcjonistka może przeszukiwać obszar roboczy Notion, czytać stronę i przeglądać bazę danych, np. cennik, tabelę produktów lub listę otwartych ofert pracy, by odpowiadać osobom dzwoniącym. Odczytywanie danych działa przez narzędzia webhook z wewnętrznym połączeniem Notion, które działa w każdym planie Notion i widzi tylko udostępnione mu strony. Dodawanie wpisów do bazy danych też działa przez narzędzie webhook, za pomocą drugiego połączenia, które może tylko dodawać treści. Możesz zamiast tego użyć Zapier, ale zalecamy narzędzie webhook: nie wymaga konta Zapier ani nie zużywa zadań Zapier, a każde żądanie trafia bezpośrednio do Notion. Narzędzie webhook nie może jednak uzupełnić właściwości tytułu, więc jeśli wpisy potrzebują prawdziwego tytułu, użyj Zapier.

Jeśli treści w Notion rzadko się zmieniają, integracja może nie być potrzebna. Wyeksportuj stronę z Notion i zamiast tego prześlij ją do bazy wiedzy.

Twoja recepcjonistka może odczytać wszystko, co udostępnisz połączeniu, i przekazać to osobom dzwoniącym. Udostępniaj tylko strony, o których dzwoniący mogą usłyszeć, i dodaj regułę, że recepcjonistka nigdy nie odczytuje osobom dzwoniącym prywatnych danych, takich jak dane klientów.

Konfiguracja

1

Utwórz wewnętrzne połączenie

Musisz być właścicielem obszaru roboczego. Otwórz app.notion.com/developers/connections, wybierz Internal connections, a potem Create a new connection. Nazwij je Reception.ai i wybierz swój obszar roboczy. Na karcie Configuration zezwól tylko na odczyt treści i skopiuj API token.

2

Udostępnij strony połączeniu

Otwórz kartę Content access połączenia, wybierz Edit access i wskaż strony oraz bazy danych, które recepcjonistka ma odczytywać. Możesz też otworzyć stronę w Notion, wybrać ••• → Connections → + Add connection i wskazać Reception.ai. Strony podrzędne też zostaną udostępnione.

3

Znajdź ID źródła danych

Aby recepcjonistka mogła odczytywać bazę danych, otwórz jej ustawienia w Notion, wybierz Manage data sources, otwórz menu ••• obok źródła danych i wybierz Copy data source ID.

4

Utwórz narzędzia webhook

Utwórz poniższe narzędzia. W każdym przejdź do Integrations, wybierz Add integration, a następnie Webhook Tool.

5

Przetestuj

Przetestuj recepcjonistkę, zadając pytanie, na które odpowiada jedna z udostępnionych stron.

Narzędzia

Każde narzędzie wysyła te nagłówki żądania:

NagłówekTypWartość
AuthorizationSekretBearer , a po nim token połączenia
Notion-VersionWartość2026-03-11

W każdym narzędziu ustaw Assign to agents na Receptionist i wybierz Enable.

Wyszukiwanie stron

PoleWartość
Namesearch_notion
Description”Przeszukaj nasze strony Notion według tytułu. Użyj, gdy dzwoniący pyta o coś, na co mogą odpowiadać nasze dokumenty, a potem odczytaj najlepszy wynik za pomocą read_notion_page.”
MethodPOST
URLhttps://api.notion.com/v1/search
Body Parametersquery (string, wymagane): “Krótki tytuł do wyszukania, np. pricing lub opening hours.”
page_size (number, stała wartość): 10

Odczyt strony

PoleWartość
Nameread_notion_page
Description”Odczytaj pełny tekst strony Notion znalezionej przez search_notion.”
MethodGET
URLhttps://api.notion.com/v1/pages/{page_id}/markdown
Path Parameterspage_id (string, wymagane): “id strony zwróconej przez search_notion.”
Query Parametersmarkdown_version (string, stała wartość): v2

Odczyt bazy danych

PoleWartość
Nameread_notion_table
Description”Wypisz wiersze naszego cennika. Użyj, gdy dzwoniący pyta o ceny lub naszą ofertę.” Opisz tu własną tabelę.
MethodPOST
URLhttps://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query
Body Parameterspage_size (number, stała wartość): 100

Zastąp DATA_SOURCE_ID skopiowanym ID. Utwórz jedno narzędzie na każdą bazę danych, każde z własną nazwą i opisem.

Dodawanie wpisów do bazy danych za pomocą narzędzia webhook (zalecane)

Aby zapisać w bazie danych Notion coś z rozmowy, np. kontakt sprzedażowy lub prośbę o oddzwonienie, utwórz narzędzie dodające wpis.

1

Utwórz połączenie dla nowych wpisów

Utwórz drugie wewnętrzne połączenie, np. Reception.ai entries, tak samo jak pierwsze. Na karcie Configuration zezwól tylko na wstawianie treści i skopiuj jego API token. W Content access udostępnij tylko bazę danych, do której dodaje wpisy. To połączenie nie może nic odczytać, więc wpisy pozostają prywatne.

2

Przygotuj bazę danych

Skopiuj ID źródła danych bazy, jak w sekcji Konfiguracja. Każda właściwość uzupełniana przez narzędzie jest kluczem w żądaniu, a klucze nie mogą zawierać spacji, więc nadaj tym właściwościom jednowyrazowe nazwy, np. Phone, Email i Status.

3

Utwórz narzędzie webhook

Przejdź do Integrations, wybierz Add integration, a następnie Webhook Tool.

PoleWartość
Nameadd_notion_entry
Description”Zapisz nowy kontakt sprzedażowy w naszej bazie kontaktów, gdy dzwoniący chce wycenę lub oddzwonienie.” Opisz tu własną bazę danych.
MethodPOST
URLhttps://api.notion.com/v1/pages
Request HeadersAuthorization (Secret): Bearer , a po nim token nowego połączenia
Notion-Version (Value): 2026-03-11
Body Parametersparent (object, wymagane)
markdown (string, wymagane)
markdown_version (string)
properties (object, wymagane)
Assign to agentsReceptionist

Skonfiguruj parametry body tak:

  • parent: jedno pole, data_source_id (string, stała wartość): ID źródła danych.
  • markdown (z rozmowy): “Wpis jako Markdown. Zacznij od wiersza # , po którym podaj imię i nazwisko dzwoniącego oraz to, czego potrzebuje, np. # Jane Doe: quote for a new boiler. Następnie dodaj pusty wiersz i szczegóły prośby.”
  • markdown_version (stała wartość): v2
  • properties: wybierz Add field raz dla każdej właściwości do uzupełnienia. Każda z nich jest obiektem nazwanym dokładnie jak właściwość, z jednym polem na jej wartość:
    • Phone (object): phone_number (string, z rozmowy): “Numer telefonu dzwoniącego.”
    • Email (object): email (string, z rozmowy): “Adres e-mail dzwoniącego, przeliterowany mu. Pomiń, jeśli go nie podał.”
    • Status (object, wymagane): select (object, wymagane), z jednym polem name (string, stała wartość): New

Notion dokumentuje, że gdy właściwość tytułu zostanie pominięta, pierwszy nagłówek # staje się tytułem strony; dokumentacja pokazuje to tylko dla stron utworzonych wewnątrz strony, więc sprawdź, czy działa w twojej bazie danych. W każdym przypadku nagłówek i szczegóły zostaną zapisane jako treść wpisu, a właściwości telefonu, e-maila i statusu będą uzupełnione. Pomiń właściwość tytułu w properties: Notion zagnieżdża wartości tytułu i tekstu na sześciu poziomach, o jeden więcej niż pozwalają narzędzia webhook. Mieszczą się właściwości numeru telefonu, e-maila, URL, liczby, pola wyboru, listy wyboru i daty. Właściwość typu Status przyjmuje status zamiast select.

Wybierz Enable, a następnie przetestuj recepcjonistkę, prosząc o oddzwonienie. Wpis pojawi się w bazie danych.

Dodawanie wpisów do bazy danych przez Zapier

Aby zamiast tego dodawać wpisy przez Zapier, połącz Zapier. Na serwerze Zapier MCP pod adresem mcp.zapier.com dodaj akcję Notion Create Data Source Item, ustaw bazę danych jako stałą wartość i pozwól AI uzupełniać pola. W Reception.ai otwórz kartę Tools integracji Zapier, wybierz Refresh tools i przypisz akcję do Client (recepcjonistki).

Użyj zamiast tego bazy wiedzy

W przypadku treści, które nie zmieniają się często, baza wiedzy jest prostsza i szybsza niż wyszukiwanie na żywo. W Notion otwórz menu ••• strony, wybierz More → Export i wskaż PDF, HTML lub Markdown & CSV. Eksport HTML i Markdown pobiera się jako plik zip, więc najpierw go rozpakuj. Następnie prześlij plik. Bazy danych są eksportowane do CSV, którego baza wiedzy nie obsługuje, więc eksportuj je jako PDF. Eksportuj i przesyłaj ponownie, gdy treść się zmieni.

Ograniczenia

  • Wyszukiwarka Notion dopasowuje tytuły stron i baz danych, a nie tekst wewnątrz stron. Nadawaj stronom jasne tytuły, np. “Cancellation policy”.
  • read_notion_table zwraca pierwsze 100 wierszy i tylko ich właściwości, a nie treść strony każdego wiersza. Tabele odczytywane przez recepcjonistkę powinny być małe.
  • Hostowany serwer MCP Notion wymaga logowania w przeglądarce, z wyjątkiem planów Business i Enterprise, w których właściciel obszaru roboczego może utworzyć token MCP. Powyższe narzędzia webhook działają w każdym planie.
  • add_notion_entry nie może uzupełniać właściwości tytułu ani tekstu. Zamiast tego umieszczaj nazwy i notatki w nagłówku oraz treści.
  • Jeśli dodajesz wpisy przez Zapier, każda akcja Zapier uruchomiona przez recepcjonistkę zużywa zadania z twojego planu Zapier. Zapier obecnie nalicza dwa zadania za każde udane wywołanie.

Rozwiązywanie problemów

ProblemCo sprawdzić
401 z NotionNagłówek Authorization musi zawierać Bearer , a po nim token połączenia.
400 dotyczący wersjiUstaw Notion-Version na 2026-03-11.
404 lub object_not_foundUdostępnij stronę lub bazę danych połączeniu i użyj ID źródła danych, a nie ID bazy danych.
403 przy read_notion_pagePołączenie potrzebuje uprawnień do odczytu treści.
403 przy add_notion_entryPołączenie do wpisów potrzebuje uprawnień do wstawiania treści i dostępu do bazy danych.
400 validation_error przy add_notion_entryKażdy klucz w properties musi dokładnie odpowiadać nazwie właściwości, a jego pole musi odpowiadać typowi właściwości.
Nowe wpisy wyświetlają się jako UntitledNotion nie użył nagłówka # jako tytułu w twojej bazie danych. Nagłówek nadal jest na górze strony każdego wpisu, a wpisy możesz znaleźć po telefonie lub statusie. Aby uzyskać tytuł, użyj Zapier.
Wyszukiwanie nic nie znajdujeWyszukiwanie dopasowuje tylko tytuły i tylko stron udostępnionych połączeniu.
Recepcjonistka działa wolno przy dużej tabeliDuże tabele zwracają dużo danych. Podziel tabelę lub przenieś treść do bazy wiedzy.