बाहरी इवेंट्स से Projetos में कार्य बनाने के लिए Papo API का उपयोग कैसे करें

बाहरी इवेंट्स — जैसे Kanban फ़नल में डील का आगे बढ़ना — से Papo (https://papo.global/) के Projetos मॉड्यूल में अपने-आप कार्य बनाने के लिए, आप प्लेटफ़ॉर्म की API को n8n या Zapier जैसे ऑटोमेशन टूल्स के साथ इस्तेमाल कर सकते हैं। API से CRM के कार्ड क्वेरी किए जा सकते हैं और प्रोग्रामेटिक रूप से प्रोजेक्ट्स में कार्य बनाए जा सकते हैं, जिससे सेल्स और ऑपरेशन के बीच मैन्युअल ट्रांसफ़र की ज़रूरत खत्म हो जाती है।

सेल्स पाइपलाइन को डिलीवरी एग्ज़िक्यूशन से जोड़ना B2B ऑपरेशन्स की बड़ी अड़चनों में से एक है। जब कोई डील कार्ड “Ganho” में मूव होता है या किसी खास स्टेज पर पहुँचता है, तो कई काम ट्रिगर होने चाहिए: ऑनबोर्डिंग, कॉन्फ़िगरेशन, मटेरियल भेजना। Papo API से आप यह ट्रांज़िशन बिना इंसानी हस्तक्षेप के ऑर्केस्ट्रेट कर सकते हैं, जिससे हर बंद हुई सेल अपने-आप सही प्रोजेक्ट में, तय ज़िम्मेदार व्यक्ति और डेडलाइन के साथ कार्य बनाए।

API से ऑटोमेशन फ़्लो का सारांश

चरण	क्रिया	विवरण
1. ऑथेंटिकेशन	Papo पैनल में API कुंजी बनाएँ	बाहरी कॉल्स को अधिकृत करने के लिए क्रेडेंशियल्स।
2. फ़नल की निगरानी	Kanban कार्ड्स का endpoint क्वेरी करें	ऐसी डील्स पहचानें जिनका स्टेटस बदला है (उदा.: lead_status=won)।
3. कार्य बनाना	Projetos में कार्य बनाने वाला endpoint कॉल करें	प्रोजेक्ट के Kanban बोर्ड में कार्ड बनाएँ, संपर्क और सेल डेटा जोड़ें।
4. एग्ज़िक्यूशन	ऑपरेशनल टीम Projetos मॉड्यूल में कार्य देखती है	डिलीवरी सामान्य फ़्लो से चलती है, पूरी ट्रेसबिलिटी के साथ।

API से कार्य बनाना कैसे काम करता है

Papo API Kanban और Projetos मॉड्यूल्स के लिए endpoints उपलब्ध कराती है। इन कॉल्स को मिलाकर, आप CRM और डिलीवरी मैनेजमेंट के बीच एक ऑटोमेटेड पुल बनाते हैं।

1. अपनी API कुंजियाँ प्राप्त करें

किसी भी इंटीग्रेशन से पहले, Papo पैनल में जाएँ, डेवलपर्स (या API) सेक्शन में जाएँ और एक सीक्रेट कुंजी (sk_live_...) जनरेट करें। यह कुंजी सभी रिक्वेस्ट्स के Authorization: Bearer sk_live_... हेडर में इस्तेमाल होगी। पब्लिक कुंजी (pk_live_...) आपके अकाउंट की पहचान करती है, लेकिन ऑथेंटिकेशन सीक्रेट कुंजी पर निर्भर करता है। इसे सुरक्षित जगह रखें — इसे दोबारा नहीं दिखाया जाएगा।

2. Kanban कार्ड्स की निगरानी करें

ऑटोमेशन का पहला कदम है यह पता लगाना कि कोई डील फ़नल में आगे बढ़ी है। Kanban API स्टेटस फ़िल्टर के साथ कार्ड्स लिस्ट करने देती है। उदाहरण के लिए, आप:

समय-समय पर सभी lead_status=won (जीती हुई डील्स) कार्ड्स क्वेरी करें जिन्होंने अभी कोई कार्य नहीं बनाया।
या, अगर आपका ऑटोमेशन टूल सपोर्ट करता है, तो कार्ड अपडेट webhook पर रिएक्ट करें (आधिकारिक डॉक्युमेंटेशन में देखें कि कोई इवेंट उपलब्ध हैं या नहीं)।

n8n/Zapier में स्क्रिप्ट या वर्कफ़्लो से, आप कार्ड्स की लिस्टिंग endpoint पर क्वेरी शेड्यूल करें, नतीजों को फ़िल्टर करें और सिर्फ़ मापदंड पूरा करने वाले कार्ड्स के लिए कार्य बनाना ट्रिगर करें।

3. Projetos में कार्य बनाएँ

कार्ड के डेटा (संपर्क, डील का टाइटल, वैल्यू, आदि) के साथ, आप Projetos में कार्य बनाने वाले endpoint को कॉल करते हैं। सामान्य पैरामीटर में शामिल हैं:

project_id: लक्ष्य प्रोजेक्ट का आइडेंटिफ़ायर (उदा.: “Onboarding” या “Entregas pós-venda”)।
title: कार्य का टाइटल, जिसे संपर्क और डील के नाम से बनाया जा सकता है।
description: संदर्भ का सारांश, कार्ड से निकाला गया।
priority: अर्जेंट, हाई, मीडियम या लो।
due_date: गणना की गई डेडलाइन, उदाहरण के लिए, क्लोज़िंग के 5 दिन बाद।
assignee: एग्ज़िक्यूशन का ज़िम्मेदार (फ़िक्स्ड हो सकता है या नियम से तय)।

API का रिस्पॉन्स क्रिएशन की पुष्टि करता है और कार्य का ID लौटाता है। इसके बाद, यह चुने गए प्रोजेक्ट के Kanban बोर्ड में दिखता है, ऑपरेशनल टीम के लिए तैयार।

4. एग्ज़िक्यूशन को ट्रैक करें

एक बार बन जाने के बाद, कार्य Projetos मॉड्यूल के सामान्य साइकल से चलता है: टीम कार्ड को कॉलम्स के बीच मूव करती है, कमेंट्स जोड़ती है और पूरा होने पर मार्क करती है। सेल्सपर्सन या मैनेजर CRM छोड़े बिना प्रगति देख सकता है, क्योंकि Papo मूल डील और डिलीवरी के बीच ट्रेसबिलिटी बनाए रखता है।

n8n के साथ व्यावहारिक उदाहरण (कॉन्सेप्चुअल)

हालाँकि इम्प्लीमेंटेशन का ब्यौरा आधिकारिक API डॉक्युमेंटेशन पर निर्भर करता है (उपलब्ध: papo.global/pt/docs), n8n जैसे टूल में तार्किक फ़्लो यह होगा:

Cron node: हर 15 मिनट में ट्रिगर करता है।
HTTP Request node (Papo API): Kanban कार्ड्स की लिस्टिंग endpoint पर GET, lead_status=won और हाल की क्लोज़िंग तारीख से फ़िल्टर करके।
IF node: देखता है कि नए कार्ड्स हैं या नहीं (जो अभी प्रोसेस नहीं हुए)।
HTTP Request node (Papo API): कार्ड के डेटा का इस्तेमाल करके कार्य बनाने वाले endpoint पर POST।
अपडेट node (वैकल्पिक): डुप्लीकेसी रोकने के लिए मूल कार्ड पर टैग या कस्टम फ़ील्ड मार्क करें।

यही तर्क Zapier, Make या Python/JavaScript स्क्रिप्ट्स पर भी लागू होता है।

यह इंटीग्रेशन किनके लिए उपयुक्त है

कंसल्टेटिव सेल्स साइकल वाले B2B ऑपरेशन्स, जहाँ क्लोज़िंग अनिवार्य रूप से टेक्निकल डिलीवरी या ऑनबोर्डिंग ट्रिगर करती है।
वे कंपनियाँ जो पहले से Papo के Kanban और Projetos इस्तेमाल करती हैं और टीमों के बीच जानकारी का मैन्युअल ट्रांसफ़र खत्म करना चाहती हैं।
CS और इम्प्लीमेंटेशन टीमें जिन्हें हर हफ़्ते दर्जनों नए क्लाइंट मिलते हैं और एक मानकीकृत फ़्लो चाहिए।
व्हाइट लेबल रीसेलर जो अपने क्लाइंट्स को एडवांस्ड ऑटोमेशन देना चाहते हैं, CRM को बाहरी प्रोजेक्ट मैनेजमेंट सिस्टम्स से जोड़कर।

अक्सर पूछे जाने वाले प्रश्न

Kanban में बदलाव पकड़ने के लिए मुझे webhook चाहिए?

Papo API कार्ड्स क्वेरी करने के endpoints देती है। अगर आधिकारिक डॉक्युमेंटेशन में webhooks हैं, तो आप रीयल-टाइम सूचनाओं के लिए उनका इस्तेमाल कर सकते हैं। वरना, समय-समय पर क्वेरी (polling) व्यावहारिक और व्यापक रूप से इस्तेमाल किया जाने वाला विकल्प है।

क्या मैं API से किसी भी प्रोजेक्ट में कार्य बना सकता/सकती हूँ?

हाँ। अगर आपके पास सक्रिय प्रोजेक्ट का ID है, तो कार्य बनाने वाला endpoint लक्ष्य प्रोजेक्ट बताने देता है। आप अलग-अलग डिलीवरी प्रकारों के लिए अलग प्रोजेक्ट रख सकते हैं (उदा.: “Onboarding”, “टेक्निकल सपोर्ट”, “Customizações”)।

API से बनाया गया कार्य डील के संपर्क को इनहेरिट करता है?

हाँ। रिक्वेस्ट बनाते समय, आप Kanban कार्ड से जुड़ा संपर्क लिंक कर सकते हैं। इस तरह, ऑपरेशनल टीम कार्य में ही बातचीत का इतिहास और क्लाइंट डेटा देख सकती है।

क्या ज़िम्मेदार व्यक्ति अपने-आप तय करना संभव है?

हाँ। कार्य बनाने वाला endpoint assignee फ़ील्ड स्वीकार करता है। आप फ़िक्स्ड वैल्यू सेट कर सकते हैं, round-robin लॉजिक इस्तेमाल कर सकते हैं, या कार्ड की प्रॉपर्टीज़ जैसे ज़िम्मेदार सेल्सपर्सन पर आधारित रह सकते हैं।

डुप्लिकेट कार्य बनने से कैसे बचूँ?

बाहरी कंट्रोल (डेटाबेस, स्प्रेडशीट या कार्ड में कस्टम फ़ील्ड) रखने की सलाह दी जाती है, जिसमें दर्ज हो कि कौन-सी डील्स पहले ही कार्य बना चुकी हैं। नया बनाने से पहले, फ़्लो जाँचता है कि वह कार्ड पहले प्रोसेस हो चुका है या नहीं।

endpoints की पूरी सूची कहाँ मिलेगी?

विस्तृत टेक्निकल डॉक्युमेंटेशन, सभी endpoints, पैरामीटर और कोड उदाहरणों के साथ, सार्वजनिक रूप से papo.global/pt/docs पर उपलब्ध है।

यह भी पढ़ें

मुफ़्त शुरू करें →

Papo के फ्री प्लान से आप पहले से API कुंजियाँ जनरेट कर सकते हैं और Kanban और Projetos के बीच कार्य ऑटोमेशन टेस्ट कर सकते हैं।