**Papo की REST API के साथ, आप अपने खाते में उपलब्ध सभी Flows की सूची बना सकते हैं, जर्नी को सक्रिय या निष्क्रिय कर सकते हैं, और संपर्कों को ऑटोमेशन में प्रोग्रामेटिक रूप से नामांकित कर सकते हैं — सब कुछ प्रमाणित अनुरोधों के जरिए, बिना पैनल खोले। यह Flows इंजन को बाहरी सिस्टम, n8n वर्कफ़्लो, CRM या आंतरिक स्क्रिप्ट के साथ जोड़ने का तरीका है।**

Papo API Flows संसाधन उपलब्ध कराती है जो आपको ऑटोमेशन उसी तरह प्रबंधित करने देते हैं जैसे आप इनबॉक्स या संपर्कों को प्रबंधित करते हैं। इसके साथ, डेवलपमेंट टीमें, इंटीग्रेटर और व्हाइट लेबल रीसेलर बैच में नियंत्रित कर सकते हैं कि कौन सी जर्नी सक्रिय हैं, संपर्कों को अनुक्रमों में शुरू कर सकते हैं, और ऑटोमेशन की स्थिति को बिजनेस प्रक्रियाओं के साथ सिंक कर सकते हैं।

## API के जरिए Flow संचालनों का सारांश

| संचालन | विवरण | उपयोग का उदाहरण |
| :--- | :--- | :--- |
| Flows की सूची बनाएं | उपलब्ध Flows और अनुक्रमों को पहचानकर्ता, नाम, प्रकार और स्थिति (सक्रिय/निष्क्रिय) के साथ लौटाता है। | ऑटोमेशन ऑडिट करें, बाहरी डैशबोर्ड के साथ सिंक करें या जांचें कि क्या चल रहा है। |
| Flow सक्रिय/निष्क्रिय करें | किसी विशिष्ट Flow की स्थिति बदलता है, संपर्कों को प्राप्त करना और प्रोसेस करना शुरू या रोकता है। | रखरखाव के दौरान जर्नी रोकें, समायोजन के बाद शुरू करें या समाप्त कैंपेन को निष्क्रिय करें। |
| संपर्क नामांकित करें | किसी मौजूदा संपर्क को सक्रिय Flow की शुरुआत में डालता है, जिससे कॉन्फ़िगर की गई जर्नी शुरू होती है। | बाहरी CRM से लीड जोड़ें, इंटीग्रेशन के बाद वेलकम फ्लो ट्रिगर करें या मैन्युअल प्रविष्टियां ठीक करें। |

## API प्रमाणीकरण कैसे काम करता है

Flows से जुड़ी सभी API कॉल सहित सभी कॉल के लिए खाते की **गुप्त कुंजी** आवश्यक है। इसे `Authorization` हेडर में Bearer टोकन के रूप में भेजा जाना चाहिए। खाते की **सार्वजनिक कुंजी** वैकल्पिक है, लेकिन अगर भेजी जाती है तो उसे गुप्त कुंजी वाले उसी खाते से मेल खाना चाहिए।

API का बेस URL `https://app.papo.global/api/v1` है। कुंजियां Papo पैनल के डेवलपर क्षेत्र में जनरेट होती हैं। गुप्त कुंजी निर्माण के समय केवल एक बार दिखाई देती है; इसे सुरक्षित स्थान पर रखें और लीक होने का संदेह होने पर रद्द करें।

प्रमाणीकरण पैटर्न सभी एंडपॉइंट्स में समान है:

```
curl https://app.papo.global/api/v1/me \
  -H "Authorization: Bearer sk_live_…" \
  -H "X-Papo-Public-Key: pk_live_…"
```

## व्यवहार में API के जरिए Flows प्रबंधित करना

हालांकि प्रत्येक एंडपॉइंट और पैरामीटर का सटीक विवरण आधिकारिक API दस्तावेज़ में है, काम का सामान्य प्रवाह इन अवधारणात्मक चरणों का पालन करता है:

1. **प्रमाणित करें** गुप्त कुंजी (और चाहें तो सार्वजनिक कुंजी) से खाते को मान्य करें।
2. **Flows की सूची बनाएं** ताकि जर्नी की वर्तमान सूची, उनके पहचानकर्ता और स्थिति मिल सके। इससे यह मैप करने में मदद मिलती है कि क्या पहले से है और अगले संचालनों के लिए सही Flow चुन सकें।
3. **स्थिति बदलें** किसी विशिष्ट Flow की, यदि आवश्यक हो। ऐसा अनुरोध भेजें जो Flow को सक्रिय (संपर्क प्राप्त करने के लिए खुला) या निष्क्रिय (रोका गया) सेट करे। केवल सक्रिय Flows ही संपर्कों को प्रोसेस करते हैं और नामांकन स्वीकार करते हैं।
4. **संपर्क नामांकित करें** किसी सक्रिय Flow में। संपर्क का पहचानकर्ता और इच्छित Flow का पहचानकर्ता दें ताकि उसे जर्नी की शुरुआत में डाला जा सके। CRM में संपर्क का इतिहास सुरक्षित रहता है।
5. **बाहरी सिस्टम के साथ इंटीग्रेट करें** — वेबहुक या सीधे कॉल के जरिए, आप बाहरी फॉर्म, किसी अन्य सिस्टम की घटना या डेटा पाइपलाइन से आने वाले संपर्कों को शुरू कर सकते हैं।

प्लेटफ़ॉर्म खाली और निष्क्रिय Flows बनाने तथा API के जरिए उनके नोड्स भरने का भी समर्थन करता है, जिससे पूरी ऑटोमेशन को प्रोग्रामेटिक रूप से प्रोविज़न किया जा सकता है। सटीक पेलोड फॉर्मेट, आवश्यक फ़ील्ड और कोड उदाहरणों के लिए, Papo API दस्तावेज़ के Flows अनुभाग को देखें।

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

- **IT टीमें जो कई ऑटोमेशन चलाती हैं** और पैनल मैन्युअली खोले बिना Flows को बैच में रोकना, फिर से सक्रिय करना या मॉनिटर करना चाहती हैं।
- **व्हाइट लेबल रीसेलर** जो प्रत्येक नए ग्राहक के लिए मानकीकृत जर्नी स्वचालित रूप से प्रोविज़न करना, शुरुआती संपर्कों को नामांकित करना और प्लेटफ़ॉर्म के बीच तालमेल बनाए रखना चाहते हैं।
- **इंटीग्रेटर और डेवलपर्स** जो Papo को CRM, ERP या n8n जैसे टूल्स से जोड़ते हैं और बाहरी घटनाओं (खरीद, साइनअप, अपॉइंटमेंट) से Flows ट्रिगर करते हैं।
- **ऐसे ऑपरेशन जो सशर्त नामांकन के साथ काम करते हैं**, जहां संपर्कों को अन्य सिस्टम में परिभाषित बिजनेस नियमों से गुजरने के बाद ही Flows में शामिल किया जाता है।

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

### Flows की सूची बनाने के लिए क्या मुझे गुप्त कुंजी चाहिए?

हां। Flows की सूची बनाना, साथ ही खाते का डेटा लौटाने वाला कोई भी संचालन, गुप्त कुंजी से प्रमाणीकरण मांगता है। पैटर्न अन्य सभी एंडपॉइंट्स जैसा ही है: `Authorization` हेडर में Bearer टोकन भेजें।

### क्या मैं API से Flow को सक्रिय या निष्क्रिय कर सकता हूं?

हां। API किसी Flow की स्थिति को सक्रिय और निष्क्रिय के बीच बदल सकती है। आपको Flow का पहचानकर्ता और गुप्त कुंजी चाहिए। निष्क्रिय Flows संपर्क प्राप्त नहीं करते और जर्नी में आगे नहीं बढ़ते, भले ही नामांकन का प्रयास किया जाए।

### API के जरिए किसी संपर्क को Flow में कैसे नामांकित करूं?

नामांकन कॉल में संपर्क का पहचानकर्ता और सक्रिय Flow का पहचानकर्ता दें। संपर्क को जर्नी की शुरुआत में डाला जाएगा, बिना बातचीत का इतिहास या प्रोफ़ाइल डेटा मिटाए। आधिकारिक दस्तावेज़ पैरामीटर के सटीक फॉर्मेट का विवरण देता है।

### क्या API से शून्य से Flow बनाना संभव है?

हां। API एक खाली Flow (केवल Start नोड के साथ) और निष्क्रिय बनाने के साथ-साथ उसके नोड्स को प्रश्नों, संदेशों और शर्तों से भरने की अनुमति देती है। यह ऑटोमेशन को स्केलेबल तरीके से प्रोविज़न करने के लिए उपयोगी है, खासकर रीसेल या नए ग्राहकों के ऑनबोर्डिंग परिदृश्यों में।

### क्या API सूची बनाते समय प्रत्येक Flow की स्थिति लौटाती है?

हां। सूची में प्रत्येक Flow और अनुक्रम की स्थिति (सक्रिय या निष्क्रिय), साथ ही पहचानकर्ता, नाम और प्रकार शामिल होता है, जिससे बाहरी सिस्टम मॉनिटर कर सकते हैं कि क्या चल रहा है और क्या रोका गया है।

### Flows के रूट्स का पूरा दस्तावेज़ कहां मिलेगा?

आधिकारिक दस्तावेज़ [https://papo.global/pt/docs](https://papo.global/pt/docs) पर उपलब्ध है। वहां आपको सभी एंडपॉइंट्स, स्वीकृत पैरामीटर, त्रुटि कोड और कई भाषाओं में उदाहरण मिलेंगे। Flows के रूट्स अन्य मॉड्यूल के समान REST पैटर्न और प्रमाणीकरण का पालन करते हैं।

## यह भी पढ़ें

- [Papo API का उपयोग करके संपर्कों को थोक में बनाना और अपडेट करना](/hc/papo/articles/papo-api-create-update-contacts-in-bulk)
- [Papo API का उपयोग करके लेबल (टैग) बनाना और प्रबंधित करना](/hc/papo/articles/papo-api-tags-create-manage)

---

**[अभी अपने Flows को इंटीग्रेट करना शुरू करें →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

Papo पर अपना मुफ़्त खाता बनाएं, API कुंजियां एक्सेस करें और अपने ऑटोमेशन को बाहरी दुनिया से जोड़ें।