Notion टूलकिट एजेंट्स और वर्कफ़्लो को Notion पेज और डेटाबेस के साथ इंटरैक्ट करने देता है। यह सामग्री खोजने, डेटाबेस रिकॉर्ड्स क्वेरी और अपडेट करने, पेज सामग्री पढ़ने और जोड़ने, और नए पेज बनाने का समर्थन करता है।
पूर्वावश्यकताएं
- एक Notion खाता (फ्री प्लान पर्याप्त है)
- एक Notion वर्कस्पेस (प्रत्येक खाते में डिफ़ॉल्ट रूप से एक होता है)
कनेक्शन बनाना
Workflow Builder
Agent Builder
- वर्कफ़्लो में, एक Notion टूलकिट चरण जोड़ें।
- Connect with Notion पर क्लिक करें।
- Notion सहमति स्क्रीन पर कनेक्शन प्राधिकृत करें और चुनें कि किन पेज और डेटाबेस को पहुँच प्रदान करनी है।
चैट में, जब टूलकिट पहली बार इन्वोक होता है तो आपको OAuth के माध्यम से अपने Notion खाते से कनेक्ट होने के लिए कहा जाएगा।
टूलकिट केवल उन पेज और डेटाबेस तक पहुँच सकता है जो कनेक्शन के साथ स्पष्ट रूप से साझा किए गए हैं। सामग्री साझा करने के लिए, Notion में पेज या डेटाबेस खोलें, ··· → Connections पर क्लिक करें, और अपना इंटीग्रेशन जोड़ें। उसी वर्कस्पेस में सामग्री जो साझा नहीं की गई है वह दिखाई नहीं देती।
उपलब्ध टूल्स
| टूल | विवरण |
|---|
| खोजें | शीर्षक के अनुसार सभी साझा किए गए पेज और डेटाबेस में खोजें |
| डेटाबेस सूचीबद्ध करें | कनेक्शन द्वारा एक्सेस किए जा सकने वाले सभी डेटाबेस लौटाएं |
| डेटाबेस प्राप्त करें | विशिष्ट डेटाबेस की स्कीमा (कॉलम नाम और प्रकार) लौटाएं |
| डेटाबेस क्वेरी करें | वैकल्पिक फ़िल्टर और सॉर्टिंग के साथ डेटाबेस से रिकॉर्ड्स प्राप्त करें |
| पेज प्राप्त करें | पेज या डेटाबेस रिकॉर्ड के प्रॉपर्टी मान और मेटाडेटा प्राप्त करें |
| पेज बनाएं | नया डेटाबेस रिकॉर्ड या सब-पेज बनाएं |
| पेज अपडेट करें | मौजूदा पेज की प्रॉपर्टी अपडेट करें, या इसे आर्काइव करें |
| पेज सामग्री प्राप्त करें | पेज का बॉडी टेक्स्ट (सामग्री ब्लॉक) पढ़ें |
| सामग्री जोड़ें | पेज के नीचे नई सामग्री ब्लॉक जोड़ें |
खोजें
सभी साझा किए गए पेज और डेटाबेस में खोजता है, शीर्षक के अनुसार मिलान लौटाता है।
मुख्य इनपुट:
| इनपुट | विवरण |
|---|
| Query | खोजने के लिए टेक्स्ट |
| Filter Type | वैकल्पिक रूप से page या database तक सीमित करें। दोनों खोजने के लिए खाली छोड़ें। |
| Page Size | लौटाने के लिए परिणामों की संख्या (डिफ़ॉल्ट: 10, अधिकतम: 100) |
डाउंस्ट्रीम चरणों में परिणामों का संदर्भ:
- पहले परिणाम की ID:
{{ step.output.results[0].id }}
उदाहरण उपयोग का मामला: नया ग्राहक रिकॉर्ड बनाने से पहले, ग्राहक के नाम से खोजें। यदि count 0 से अधिक है, तो ग्राहक पहले से मौजूद है — डुप्लिकेट बनाने के बजाय मौजूदा रिकॉर्ड के id का उपयोग करें।
डेटाबेस कार्य
डेटाबेस सूचीबद्ध करें
कनेक्शन द्वारा एक्सेस किए जा सकने वाले सभी डेटाबेस लौटाता है, उनके नाम और ID के साथ।
मुख्य इनपुट:
| इनपुट | विवरण |
|---|
| Page Size | लौटाने के लिए डेटाबेस की संख्या (डिफ़ॉल्ट: 20, अधिकतम: 100) |
कब उपयोग करें: अपनी डेटाबेस ID खोजने के लिए टेस्ट वर्कफ़्लो में इसे एक बार चलाएं। जिस डेटाबेस को आप चाहते हैं उसकी id कॉपी करें और बाद के चरणों में हार्ड-कोड करें।
डेटाबेस प्राप्त करें
विशिष्ट डेटाबेस की स्कीमा लौटाता है — इसके कॉलम नाम और प्रॉपर्टी प्रकार।
मुख्य इनपुट:
| इनपुट | विवरण |
|---|
| Database ID | डेटाबेस की ID — डेटाबेस सूचीबद्ध करें से, या Notion URL से: ?v= से पहले का सेगमेंट |
कब उपयोग करें: Create Page या Update Page चरण लिखने से पहले इसे चलाएं। यह आपको सटीक प्रॉपर्टी नाम (केस-सेंसिटिव) और उनके प्रकार बताता है, जो Properties फ़ील्ड में उपयोग किए जाने वाले JSON प्रारूप को निर्धारित करता है।
डेटाबेस प्राप्त करें प्रॉपर्टी प्रकार और नाम दिखाता है लेकिन Select फ़ील्ड के लिए उपलब्ध विकल्प मान नहीं। वैध चयन विकल्प देखने के लिए, Notion में सीधे डेटाबेस खोलें।
डेटाबेस क्वेरी करें
वैकल्पिक फ़िल्टरिंग और सॉर्टिंग के साथ डेटाबेस से रिकॉर्ड्स प्राप्त करता है।
मुख्य इनपुट:
| इनपुट | विवरण |
|---|
| Database ID | कौन सा डेटाबेस क्वेरी करना है |
| Filter | एक JSON फ़िल्टर ऑब्जेक्ट (नीचे उदाहरण देखें)। सभी रिकॉर्ड्स लौटाने के लिए खाली छोड़ें। |
| Sorts | सॉर्ट नियमों का एक JSON ऐरे (नीचे उदाहरण देखें) |
| Page Size | लौटाने के लिए रिकॉर्ड्स की संख्या (डिफ़ॉल्ट: 20, अधिकतम: 100) |
फ़िल्टर उदाहरण:
एकल फ़िल्टर — रिकॉर्ड्स जहाँ Status “In Progress” के बराबर है:
{
"property": "Status",
"select": { "equals": "In Progress" }
}
चेकबॉक्स द्वारा फ़िल्टर:
{
"property": "Done",
"checkbox": { "equals": false }
}
तिथि द्वारा फ़िल्टर — विशिष्ट तिथि से पहले Due Date वाले रिकॉर्ड्स:
{
"property": "Due Date",
"date": { "before": "2026-05-26" }
}
AND लॉजिक के साथ संयुक्त फ़िल्टर:
{
"and": [
{ "property": "Status", "select": { "equals": "In Progress" } },
{ "property": "Done", "checkbox": { "equals": false } }
]
}
सॉर्ट — सबसे नया पहले:
[
{ "property": "Created time", "direction": "descending" }
]
डाउंस्ट्रीम चरणों में परिणामों का संदर्भ:
- पहले परिणाम की ID:
{{ step.output.results[0].id }}
- पहले परिणाम की Status:
{{ step.output.results[0].properties.Status }}
- पहले परिणाम का शीर्षक:
{{ step.output.results[0].title }}
पेज कार्य
पेज प्राप्त करें
विशिष्ट पेज या डेटाबेस रिकॉर्ड के प्रॉपर्टी मान और मेटाडेटा प्राप्त करता है।
मुख्य इनपुट:
| इनपुट | विवरण |
|---|
| Page ID | पेज ID — Notion URL से, या डेटाबेस क्वेरी करें या खोजें परिणामों से |
डाउंस्ट्रीम चरणों में मानों का संदर्भ:
- स्थिति:
{{ step.output.page.properties.Status }}
- शीर्षक:
{{ step.output.page.title }}
- पेज ID:
{{ step.output.page.id }}
उदाहरण उपयोग का मामला: एक ट्रिगर पेज ID के साथ फ़ायर होता है। रिकॉर्ड की वर्तमान Status पढ़ने के लिए पेज प्राप्त करें का उपयोग करें। यदि Status “Pending” है, तो वर्कफ़्लो जारी रखें — अन्यथा रोकें।
पेज बनाएं
नया पेज बनाता है — या तो डेटाबेस के भीतर एक रिकॉर्ड (नई पंक्ति) के रूप में, या किसी अन्य पेज के अंतर्गत एक चाइल्ड पेज के रूप में।
मुख्य इनपुट:
| इनपुट | विवरण |
|---|
| Parent ID | डेटाबेस ID (नई पंक्ति के लिए) या पेज ID (सब-पेज के लिए) |
| Parent Type | डेटाबेस पंक्ति जोड़ने के लिए database_id, सब-पेज जोड़ने के लिए page_id। डिफ़ॉल्ट: database_id |
| Title | पेज या रिकॉर्ड शीर्षक प्लेन टेक्स्ट के रूप में |
| Properties | अतिरिक्त फ़ील्ड मानों के लिए वैकल्पिक JSON ऑब्जेक्ट। कुंजियां आपके डेटाबेस की प्रॉपर्टी नामों से बिल्कुल मेल खानी चाहिए — उन्हें पुष्टि करने के लिए डेटाबेस प्राप्त करें का उपयोग करें। |
फ़ील्ड प्रकार के अनुसार Properties प्रारूप:
// Select field
{ "Status": { "select": { "name": "To Do" } } }
// Status field (Notion's built-in Status type)
{ "Status": { "status": { "name": "In Progress" } } }
// Date field
{ "Due Date": { "date": { "start": "2026-06-01" } } }
// Checkbox field
{ "Done": { "checkbox": false } }
// Number field
{ "Priority Score": { "number": 8 } }
// Rich text field
{ "Notes": { "rich_text": [{ "text": { "content": "Needs review before sending." } }] } }
पूर्ण उदाहरण — एक कार्य पंक्ति बनाना:
Title: Follow up with client
Properties:
{
"Status": { "select": { "name": "To Do" } },
"Due Date": { "date": { "start": "2026-06-01" } },
"Done": { "checkbox": false }
}
लौटाया गया id नए पेज को अपडेट या लिंक करने के लिए डाउंस्ट्रीम चरणों में पास किया जा सकता है।
पेज अपडेट करें
मौजूदा पेज की प्रॉपर्टी अपडेट करता है, या इसे आर्काइव करता है।
मुख्य इनपुट:
| इनपुट | विवरण |
|---|
| Page ID | अपडेट करने के लिए पेज — डेटाबेस क्वेरी करें, पेज प्राप्त करें, या खोजें से |
| Properties | केवल उन फ़ील्ड्स वाला JSON ऑब्जेक्ट जिन्हें आप बदलना चाहते हैं (पेज बनाएं के समान प्रारूप)। शामिल न किए गए फ़ील्ड्स अपरिवर्तित छोड़ दिए जाते हैं। |
| Archived | पेज आर्काइव (सॉफ्ट-डिलीट) करने के लिए true सेट करें |
उदाहरण — कार्य को पूर्ण चिह्नित करना:
{
"Status": { "select": { "name": "Done" } },
"Done": { "checkbox": true },
"Completed On": { "date": { "start": "2026-05-26" } }
}
उदाहरण — रिकॉर्ड आर्काइव करना: Properties खाली छोड़ें और Archived को true सेट करें। रिकॉर्ड डेटाबेस व्यू से गायब हो जाता है लेकिन Notion के ट्रैश से पुनर्स्थापित किया जा सकता है।
सामान्य पैटर्न:
- रिकॉर्ड खोजने और उसका
id प्राप्त करने के लिए डेटाबेस क्वेरी करें का उपयोग करें
- उस
id को पेज अपडेट करें में फ़ील्ड्स बदलने के लिए दें
सामग्री कार्य
पेज सामग्री प्राप्त करें
Notion पेज के भीतर सामग्री ब्लॉक प्राप्त करता है — पैराग्राफ, शीर्षक, बुलेट लिस्ट, आदि। यह पेज की प्रॉपर्टी (डेटाबेस फ़ील्ड) से अलग है। दस्तावेज़ का बॉडी टेक्स्ट पढ़ने के लिए इसका उपयोग करें।
मुख्य इनपुट:
| इनपुट | विवरण |
|---|
| Page ID | सामग्री पढ़ने के लिए पेज |
| Page Size | लौटाने के लिए ब्लॉक की संख्या (डिफ़ॉल्ट: 50, अधिकतम: 100) |
डाउंस्ट्रीम चरणों में मानों का संदर्भ:
- पहले ब्लॉक का टेक्स्ट:
{{ step.output.blocks[0].text }}
- सभी ब्लॉक:
{{ step.output.blocks }}
उदाहरण उपयोग का मामला: पेज सामग्री प्राप्त करें, सभी टेक्स्ट ब्लॉक को AI चरण में पास करके सारांश जनरेट करें, फिर उस सारांश को ईमेल या Telegram के माध्यम से भेजें।
सामग्री जोड़ें
मौजूदा Notion पेज के नीचे नई सामग्री ब्लॉक जोड़ता है।
मुख्य इनपुट:
| इनपुट | विवरण |
|---|
| Page ID | सामग्री जोड़ने के लिए पेज |
| Children | जोड़ने के लिए Notion ब्लॉक ऑब्जेक्ट्स का एक JSON ऐरे |
उदाहरण — एक शीर्षक और पैराग्राफ जोड़ना:
[
{
"object": "block",
"type": "heading_2",
"heading_2": {
"rich_text": [{ "type": "text", "text": { "content": "Workflow Run — May 26" } }]
}
},
{
"object": "block",
"type": "paragraph",
"paragraph": {
"rich_text": [{ "type": "text", "text": { "content": "3 records processed. 1 error found." } }]
}
}
]
उदाहरण — एक बुलेट लिस्ट आइटम जोड़ना:
[
{
"object": "block",
"type": "bulleted_list_item",
"bulleted_list_item": {
"rich_text": [{ "type": "text", "text": { "content": "New lead: Jane Doe — jane@example.com" } }]
}
}
]
उदाहरण उपयोग का मामला: एक वर्कफ़्लो हर सुबह चलता है, डेटा प्रोसेस करता है, और “Daily Log” पेज में एक-पंक्ति लॉग प्रविष्टि जोड़ता है — हर बार नया पेज बनाए बिना एक चल रहा ऑडिट ट्रेल बनाता है।
समस्या निवारण
| लक्षण | संभावित कारण | समाधान |
|---|
401 Unauthorized | टोकन रद्द किया गया है या गायब है | OAuth फ़्लो के माध्यम से पुनः प्राधिकृत करें |
पेज या डेटाबेस पर 404 Not Found | सामग्री कनेक्शन के साथ साझा नहीं की गई | ··· → Connections के माध्यम से पेज साझा करें |
| खाली खोज या क्वेरी परिणाम | कनेक्शन के साथ कुछ साझा नहीं किया गया | कम से कम एक पेज या डेटाबेस साझा करें |
| प्रॉपर्टी अपडेट चुपचाप अनदेखा | प्रॉपर्टी नाम केस बेमेल | सटीक प्रॉपर्टी नाम पुष्टि करने के लिए डेटाबेस प्राप्त करें का उपयोग करें — ये केस-सेंसिटिव हैं |
oauth_not_configured त्रुटि | Client ID/secret Super Admin में सहेजा नहीं गया | Notion OAuth सेटअप देखें |