> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Notion

आपका रिसेप्शनिस्ट कॉल करने वालों के सवालों का जवाब देने के लिए आपके Notion workspace में खोज सकता है, कोई पेज पढ़ सकता है और डेटाबेस देख सकता है—जैसे कीमतों की सूची, प्रोडक्ट टेबल या खुली नौकरियों की सूची। पढ़ने का काम Notion के आंतरिक कनेक्शन के साथ [webhook tools](/docs/hi/reception-ai/integrations/webhooks) से होता है, जो हर Notion प्लान पर काम करता है और सिर्फ़ वही पेज देखता है जो आप उसके साथ शेयर करते हैं। डेटाबेस में एंट्री जोड़ने का काम भी webhook tool से होता है, एक दूसरे कनेक्शन के ज़रिए जो सिर्फ़ कंटेंट जोड़ सकता है। इसके बजाय आप [Zapier](/docs/hi/reception-ai/integrations/zapier) इस्तेमाल कर सकते हैं, लेकिन webhook tool की सलाह दी जाती है: इसके लिए Zapier अकाउंट की ज़रूरत नहीं होती, यह आपके Zapier tasks इस्तेमाल नहीं करता और हर request सीधे Notion पर जाती है। हालांकि, webhook tool title property नहीं भर सकता, इसलिए आपकी एंट्री के लिए सही title चाहिए तो Zapier इस्तेमाल करें।

> **Note**
>
> अगर आपका Notion कंटेंट बहुत कम बदलता है, तो शायद आपको integration की ज़रूरत न हो। पेज को
> Notion से export करें और उसकी जगह [अपने knowledge base में upload करें](#use-the-knowledge-base-instead)।

> **Warning**
>
> आपका रिसेप्शनिस्ट कनेक्शन के साथ शेयर की गई हर चीज़ पढ़ सकता है और उसे कॉल करने वालों को दोहरा सकता है।
> सिर्फ़ वे पेज शेयर करें जिनके बारे में कॉल करने वाले सुन सकते हैं, और एक
> [rule](/docs/hi/reception-ai/receptionist/rules-and-procedures) जोड़ें कि आपका रिसेप्शनिस्ट कभी भी
> क्लाइंट विवरण जैसे निजी रिकॉर्ड कॉल करने वालों को न पढ़े।

## सेट अप करें

### एक आंतरिक कनेक्शन बनाएं

आपका workspace owner होना ज़रूरी है। [app.notion.com/developers/connections](https://app.notion.com/developers/connections) पर जाएं, **Internal connections** चुनें, फिर **Create a new connection** चुनें। इसका नाम `Reception.ai` रखें और अपना workspace चुनें। **Configuration** टैब में सिर्फ़ कंटेंट पढ़ने की अनुमति दें और **API token** कॉपी करें।

### कनेक्शन के साथ पेज शेयर करें

कनेक्शन का **Content access** टैब खोलें, **Edit access** चुनें और वे पेज व डेटाबेस चुनें जिन्हें आपका रिसेप्शनिस्ट पढ़ सके। आप Notion में कोई पेज खोलकर **•••** → **Connections** → **+ Add connection** भी चुन सकते हैं और `Reception.ai` चुन सकते हैं। चाइल्ड पेज भी शेयर हो जाते हैं।

### डेटा source ID खोजें

अपने रिसेप्शनिस्ट को डेटाबेस पढ़ने देने के लिए Notion में डेटाबेस की settings खोलें, **Manage data sources** चुनें, data source के आगे **•••** मेनू खोलें और **Copy data source ID** चुनें।

### webhook tools बनाएं

नीचे दिए गए [tools](#tools) बनाएं। हर tool के लिए **Integrations** में जाएं, **Add integration** चुनें और **Webhook Tool** चुनें।

### इसे टेस्ट करें

ऐसा सवाल पूछकर [अपने रिसेप्शनिस्ट को टेस्ट करें](/docs/hi/reception-ai/receptionist/testing) जिसका जवाब आपके किसी शेयर किए गए पेज में हो।

## Tools

हर tool ये request headers भेजता है:

| Header           | Type   | Value                                  |
| ---------------- | ------ | -------------------------------------- |
| `Authorization`  | Secret | `Bearer ` के बाद आपके कनेक्शन का token |
| `Notion-Version` | Value  | `2026-03-11`                           |

हर tool में **Assign to agents** को **Receptionist** पर सेट करें और **Enable** चुनें।

### पेज खोजें

| Field               | Value                                                                                                                                                                                    |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**            | `search_notion`                                                                                                                                                                          |
| **Description**     | "हमारे Notion पेजों को title से खोजें। कॉल करने वाला ऐसा कुछ पूछे जिसका जवाब हमारे दस्तावेज़ों में हो सकता है, तो इसका इस्तेमाल करें, फिर सबसे अच्छा match `read_notion_page` से पढ़ें।" |
| **Method**          | POST                                                                                                                                                                                     |
| **URL**             | `https://api.notion.com/v1/search`                                                                                                                                                       |
| **Body Parameters** | `query` (string, required): "खोजने के लिए छोटा title, जैसे `pricing` या `opening hours`।"  `page_size` (number, fixed value): `10`                                                       |

### कोई पेज पढ़ें

| Field                | Value                                                                    |
| -------------------- | ------------------------------------------------------------------------ |
| **Name**             | `read_notion_page`                                                       |
| **Description**      | "`search_notion` से मिले Notion पेज का पूरा टेक्स्ट पढ़ें।"              |
| **Method**           | GET                                                                      |
| **URL**              | `https://api.notion.com/v1/pages/{page_id}/markdown`                     |
| **Path Parameters**  | `page_id` (string, required): "`search_notion` से लौटाए गए पेज का `id`।" |
| **Query Parameters** | `markdown_version` (string, fixed value): `v2`                           |

### डेटाबेस पढ़ें

| Field               | Value                                                                                                                                            |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**            | `read_notion_table`                                                                                                                              |
| **Description**     | "हमारी कीमतों की सूची की rows दिखाएं। कॉल करने वाला कीमतों या हमारी पेशकश के बारे में पूछे, तो इसका इस्तेमाल करें।" यहां अपनी टेबल का विवरण दें। |
| **Method**          | POST                                                                                                                                             |
| **URL**             | `https://api.notion.com/v1/data_sources/DATA_SOURCE_ID/query`                                                                                    |
| **Body Parameters** | `page_size` (number, fixed value): `100`                                                                                                         |

`DATA_SOURCE_ID` को अपनी कॉपी की हुई ID से बदलें। हर डेटाबेस के लिए अलग tool बनाएं, जिसका अपना नाम और विवरण हो।

## webhook tool से डेटाबेस एंट्री जोड़ें (सुझाया गया)

कॉल से कोई चीज़ Notion डेटाबेस में सेव करने के लिए, जैसे कोई lead या callback request, ऐसा tool बनाएं जो एंट्री जोड़े।

### नई एंट्री के लिए कनेक्शन बनाएं

पहले वाले की तरह ही दूसरा आंतरिक कनेक्शन बनाएं, उदाहरण के लिए `Reception.ai entries`। **Configuration** टैब में सिर्फ़ कंटेंट insert करने की अनुमति दें और उसका **API token** कॉपी करें। **Content access** में सिर्फ़ वही डेटाबेस शेयर करें जिसमें यह एंट्री जोड़ता है। यह कनेक्शन कुछ भी वापस पढ़ नहीं सकता, इसलिए एंट्री निजी रहती हैं।

### डेटाबेस तैयार करें

[सेट अप करें](#set-up) में बताए अनुसार डेटाबेस की data source ID कॉपी करें। tool जिस हर property को भरता है, वह request में एक key है और key में spaces नहीं हो सकते। इसलिए उन properties के एक-शब्द नाम रखें, जैसे `Phone`, `Email` और `Status`।

### webhook tool बनाएं

**Integrations** में जाएं, **Add integration** चुनें और **Webhook Tool** चुनें।

| Field                | Value                                                                                                                           |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `add_notion_entry`                                                                                                              |
| **Description**      | "जब कोई कॉल करने वाला quote या callback चाहता है, तो हमारी leads डेटाबेस में नई lead सेव करें।" यहां अपने डेटाबेस का विवरण दें। |
| **Method**           | POST                                                                                                                            |
| **URL**              | `https://api.notion.com/v1/pages`                                                                                               |
| **Request Headers**  | `Authorization` (Secret): `Bearer ` के बाद नए कनेक्शन का token  `Notion-Version` (Value): `2026-03-11`                          |
| **Body Parameters**  | `parent` (object, required)  `markdown` (string, required)  `markdown_version` (string)  `properties` (object, required)        |
| **Assign to agents** | **Receptionist**                                                                                                                |

body parameters को इस तरह सेट करें:

* `parent`: एक field, `data_source_id` (string, fixed value): आपकी data source ID।
* `markdown` (conversation से): "Markdown के रूप में एंट्री। `# ` से शुरू होने वाली पंक्ति में कॉल करने वाले का नाम और उनकी ज़रूरत लिखें, उदाहरण के लिए `# Jane Doe: quote for a new boiler`। फिर एक खाली पंक्ति और request का विवरण जोड़ें।"
* `markdown_version` (fixed value): `v2`
* `properties`: भरने वाली हर property के लिए एक बार **Add field** चुनें। हर एक ठीक property के नाम वाला object है, जिसमें उसके value के लिए एक field होता है:
  * `Phone` (object): `phone_number` (string, conversation से): "कॉल करने वाले का फ़ोन नंबर।"
  * `Email` (object): `email` (string, conversation से): "कॉल करने वाले का ईमेल पता, उन्हें दोबारा बोलकर पुष्टि करें। अगर उन्होंने न दिया हो तो इसे छोड़ दें।"
  * `Status` (object, required): `select` (object, required), एक field के साथ, `name` (string, fixed value): `New`

Notion के दस्तावेज़ों के अनुसार, title property छोड़ने पर पहला `#` heading पेज का title बन जाता है; इसके दस्तावेज़ों में यह सिर्फ़ किसी पेज के अंदर बनाए गए पेजों के लिए दिखाया गया है, इसलिए जांच लें कि यह आपके डेटाबेस में काम करता है। किसी भी स्थिति में heading और विवरण एंट्री के कंटेंट के रूप में सेव होते हैं और फ़ोन, ईमेल व status properties भर जाते हैं। `properties` में title property न जोड़ें: Notion title और text values को छह स्तर गहराई में nest करता है, जो webhook tools की अनुमति से एक स्तर ज़्यादा है। फ़ोन नंबर, ईमेल, URL, number, checkbox, select और date properties फिट हो जाती हैं। Status-type property में `select` के बजाय `status` होता है।

**Enable** चुनें, फिर callback मांगकर [अपने रिसेप्शनिस्ट को टेस्ट करें](/docs/hi/reception-ai/receptionist/testing)। एंट्री डेटाबेस में दिखाई देगी।

## Zapier से डेटाबेस एंट्री जोड़ें

इसके बजाय Zapier के ज़रिए एंट्री जोड़ने के लिए [Zapier](/docs/hi/reception-ai/integrations/zapier) कनेक्ट करें। [mcp.zapier.com](https://mcp.zapier.com) पर अपने Zapier MCP server में Notion का **Create Data Source Item** action जोड़ें, डेटाबेस को fixed value पर सेट करें और AI को fields भरने दें। Reception.ai में Zapier integration का **Tools** टैब खोलें, **Refresh tools** चुनें और action को **Client** (receptionist) को assign करें।

## इसकी जगह knowledge base इस्तेमाल करें

जो कंटेंट अक्सर नहीं बदलता, उसके लिए live lookups की तुलना में [knowledge base](/docs/hi/reception-ai/knowledge-base/overview) आसान और तेज़ है। Notion में पेज का **•••** मेनू खोलें, **More** → **Export** चुनें और **PDF**, **HTML** या **Markdown & CSV** चुनें। HTML और Markdown exports zip file के रूप में डाउनलोड होते हैं, इसलिए पहले उन्हें unzip करें। फिर [file upload करें](/docs/hi/reception-ai/knowledge-base/file-uploads)। डेटाबेस CSV में export होते हैं, जिसे knowledge base स्वीकार नहीं करता, इसलिए डेटाबेस को PDF के रूप में export करें। कंटेंट बदलने पर फिर से export और upload करें।

## सीमाएं

* Notion की search पेज और डेटाबेस titles से match करती है, पेजों के अंदर मौजूद टेक्स्ट से नहीं। पेजों को स्पष्ट titles दें, जैसे "Cancellation policy"।
* `read_notion_table` पहले 100 rows और सिर्फ़ उनकी properties लौटाता है, हर row के पेज के अंदर का कंटेंट नहीं। आपका रिसेप्शनिस्ट जिन tables को पढ़ता है, उन्हें छोटा रखें।
* Notion के hosted MCP server में browser sign-in चाहिए, Business और Enterprise plans को छोड़कर, जहां workspace owner MCP token बना सकता है। ऊपर दिए webhook tools हर प्लान पर काम करते हैं।
* `add_notion_entry` title या text properties नहीं भर सकता। इसके बजाय नाम और notes heading व कंटेंट में रखें।
* Zapier के ज़रिए एंट्री जोड़ने पर आपका रिसेप्शनिस्ट चलाने वाला हर Zapier action आपके Zapier प्लान के tasks इस्तेमाल करता है। Zapier अभी हर सफल call के लिए दो tasks गिनता है।

## समस्या-निवारण

| Problem                                      | क्या जांचें                                                                                                                                                                                                      |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Notion से 401                                | `Authorization` header में `Bearer ` के बाद कनेक्शन का token होना चाहिए।                                                                                                                                         |
| version के बारे में 400                      | `Notion-Version` को `2026-03-11` पर सेट करें।                                                                                                                                                                    |
| 404 या `object_not_found`                    | पेज या डेटाबेस को कनेक्शन के साथ शेयर करें और database ID नहीं, data source ID इस्तेमाल करें।                                                                                                                    |
| `read_notion_page` पर 403                    | कनेक्शन को कंटेंट पढ़ने की अनुमति चाहिए।                                                                                                                                                                         |
| `add_notion_entry` पर 403                    | entries कनेक्शन को कंटेंट insert करने की अनुमति और डेटाबेस का access चाहिए।                                                                                                                                      |
| `add_notion_entry` पर 400 `validation_error` | `properties` में हर key property के नाम से बिल्कुल match करनी चाहिए और उसका field property के type से match करना चाहिए।                                                                                          |
| नई एंट्री **Untitled** के रूप में दिखती हैं  | Notion ने `#` heading को आपके डेटाबेस के title के रूप में नहीं लिया। heading फिर भी हर एंट्री के पेज में सबसे ऊपर है और आप फ़ोन या status से एंट्री खोज सकते हैं। title पाने के लिए Zapier विकल्प इस्तेमाल करें। |
| Search को कुछ नहीं मिलता                     | Search सिर्फ़ titles से match करती है और सिर्फ़ उन पेजों के titles से जो कनेक्शन के साथ शेयर किए गए हैं।                                                                                                         |
| बड़ी टेबल पर रिसेप्शनिस्ट धीमा है            | बड़ी tables बहुत सारा डेटा लौटाती हैं। टेबल को बांटें या कंटेंट को knowledge base में ले जाएं।                                                                                                                   |