**[Papo](https://papo.global/) की REST API के साथ, आप मौजूदा इनबॉक्स सूचीबद्ध कर सकते हैं और WhatsApp और Instagram जैसे चैनलों के लिए नए कनेक्शन बना सकते हैं — सब कुछ ऑथेंटिकेटेड रिक्वेस्ट के ज़रिए, बिना पैनल खोले। यह सपोर्ट चैनलों को प्रोग्रामेटिक रूप से प्रोविज़न करने, बाहरी सिस्टम्स को इंटीग्रेट करने और मल्टीचैनल ऑपरेशन को ऑटोमेशन के साथ संरेखित रखने का तरीका है।**

Papo की API इनबॉक्स संसाधन उपलब्ध कराती है जिनसे आप मौजूदा कॉन्फ़िगरेशन देख सकते हैं और नए चैनल जोड़ सकते हैं। इससे IT टीमें, इंटीग्रेटर और white label रीसेलर बल्क में कनेक्शन प्रबंधित कर सकते हैं, अकाउंट्स के बीच सेटअप रेप्लिकेट कर सकते हैं और इंटरफ़ेस पर निर्भर रहें बिना चैनल एक्टिवेशन ऑटोमेट कर सकते हैं।

## API के ज़रिए इनबॉक्स ऑपरेशन्स का सारांश

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

## API ऑथेंटिकेशन कैसे काम करता है

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

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

ऑथेंटिकेशन वैलिडेट करने के लिए, आप `GET /api/v1/me` endpoint कॉल कर सकते हैं, जो अकाउंट डेटा लौटाता है। ऑथेंटिकेशन पैटर्न वही है जो अन्य सभी endpoints में उपयोग होता है:

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

## व्यवहार में इनबॉक्स कैसे प्रबंधित करें

1. Papo पैनल के डेवलपर/API एरिया में जाएँ और सीक्रेट key जनरेट करें। अकाउंट की पब्लिक key भी कॉपी करें।
2. हर रिक्वेस्ट में, सीक्रेट key से Bearer टोकन के रूप में ऑथेंटिकेट करें। अगर वैलिडेशन मज़बूत करना चाहें, तो `X-Papo-Public-Key` हेडर में पब्लिक key भेजें।
3. **इनबॉक्स सूचीबद्ध करने** के लिए, इनबॉक्स लिस्टिंग endpoint कॉल करें। रिस्पॉन्स में हर इनबॉक्स का आइडेंटिफ़ायर, कॉन्फ़िगर किया गया चैनल और अन्य प्रॉपर्टीज़ होती हैं, जिससे नए बनाने से पहले मौजूदा चीज़ों का मैपिंग कर सकें।
4. **नया इनबॉक्स बनाने** के लिए, इच्छित चैनल की जानकारी के साथ JSON payload भेजें — जैसे WhatsApp (Meta की ऑफ़िशियल API), Instagram, ई‑मेल या Telegram। इनबॉक्स का नाम और एक्सेस वाले एजेंट्स के आइडेंटिफ़ायर शामिल करें। सटीक फ़ील्ड फ़ॉर्मेट और स्वीकार्य वैल्यूज़ के लिए ऑफ़िशियल डॉक्युमेंटेशन देखें।
5. बनने के बाद, इनबॉक्स तुरंत पैनल में उपलब्ध हो जाता है और चैनल कनेक्शन पूरा होते ही मैसेज प्राप्त करना शुरू कर देता है (WhatsApp जैसे पेयरिंग वाले चैनलों के मामले में, API ज़रूरी निर्देश लौटाती है)।

चूँकि API REST है और JSON का उपयोग करती है, HTTP सपोर्ट वाली कोई भी भाषा इनबॉक्स प्रबंधन को स्क्रिप्ट्स, ऑटोमेशन टूल्स (जैसे n8n) या प्रोविज़निंग सिस्टम्स से इंटीग्रेट करने के लिए उपयोग की जा सकती है। `https://papo.global/pt/docs` पर ऑफ़िशियल डॉक्युमेंटेशन में ऑथेंटिकेशन, पैरामीटर्स, रिस्पॉन्स और कोड उदाहरणों का विवरण है।

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

- **IT टीमें जो बल्क में चैनल प्रोविज़न करती हैं** नई यूनिट, फ्रैंचाइज़ी या ब्रांड के लिए, बिना एक-एक करके पैनल एक्सेस किए।
- **white label रीसेलर** जो हर नए क्लाइंट के लिए इनबॉक्स बनाना ऑटोमेट करना चाहते हैं, मानकीकृत कॉन्फ़िगरेशन बनाए रखते हुए।
- **ऐसे ऑपरेशन्स जो अकाउंट्स के बीच कॉन्फ़िगरेशन माइग्रेट या रेप्लिकेट करते हैं**, ऑडिट के लिए लिस्टिंग और चैनल मिरर करने के लिए क्रिएशन का उपयोग करते हुए।
- **इंटीग्रेटर जो Papo को बाहरी चैनल-प्रबंधन सिस्टम्स से जोड़ते हैं**, यह सुनिश्चित करते हुए कि सपोर्ट एनवायरनमेंट बदलावों को ऑटोमेटिक रूप से दर्शाए।

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

### क्या इनबॉक्स सूचीबद्ध करने के लिए सीक्रेट key ज़रूरी है?

हाँ। इनबॉक्स की लिस्टिंग के लिए अकाउंट की सीक्रेट key से ऑथेंटिकेशन ज़रूरी है, क्योंकि यह कॉन्फ़िगरेशन की संवेदनशील जानकारी लौटाती है। पैटर्न अन्य API कॉल्स जैसा ही है: `Authorization` हेडर में Bearer टोकन भेजें।

### क्या मैं API के ज़रिए WhatsApp के लिए इनबॉक्स बना सकता हूँ?

हाँ। इनबॉक्स बनाते समय, आप इच्छित चैनल प्रकार बताते हैं — जिसमें WhatsApp (Meta की ऑफ़िशियल API) और अन्य सपोर्टेड चैनल शामिल हैं। payload को चुने गए चैनल के अपेक्षित फ़ॉर्मेट का पालन करना चाहिए, जैसा ऑफ़िशियल डॉक्युमेंटेशन में है।

### क्या API से मौजूदा इनबॉक्स अपडेट करना संभव है?

मौजूदा API इनबॉक्स सूचीबद्ध करने और बनाने की अनुमति देती है। किसी मौजूदा इनबॉक्स की सेटिंग्स बदलने के लिए (जैसे एजेंट बदलना या नाम बदलना), आप Papo पैनल का उपयोग कर सकते हैं या ज़रूरत हो तो नए पैरामीटर्स के साथ इनबॉक्स फिर से बना सकते हैं।

### क्रिएशन के दौरान इनबॉक्स से एजेंट्स कैसे जोड़ें?

क्रिएशन payload में, आप उन एजेंट्स के आइडेंटिफ़ायर बता सकते हैं जिन्हें इनबॉक्स का एक्सेस होना चाहिए। ये IDs टीम्स और मेंबर्स की API से प्राप्त किए जा सकते हैं। सटीक फ़ॉर्मेट के लिए डॉक्युमेंटेशन देखें।

### क्या ऑथेंटिकेशन Papo के अन्य endpoints जैसा ही है?

हाँ। अकाउंट संसाधनों को एक्सेस करने वाली सभी कॉल्स सीक्रेट key को Bearer टोकन के रूप में उपयोग करती हैं। पब्लिक key ऑप्शनल है और अगर भेजी जाए तो उसे उसी अकाउंट से मेल खाना चाहिए।

### सटीक पाथ और payload फ़ॉर्मेट कहाँ मिलेंगे?

API की ऑफ़िशियल डॉक्युमेंटेशन में, जो `https://papo.global/pt/docs` पर उपलब्ध है। वहाँ इनबॉक्स और अन्य संसाधनों के लिए ऑथेंटिकेशन, पैरामीटर्स, रिस्पॉन्स और कोड उदाहरणों का विवरण है।

## यह भी पढ़ें

- [Papo API से टीम्स और मेंबर्स प्रबंधित कैसे करें](/hc/papo/articles/how-to-use-papo-api-manage-teams-and-members)
- [Papo API से एटिकेट्स (tags) बनाना और प्रबंधित करना कैसे करें](/hc/papo/articles/papo-api-tags-create-manage)

---

**[अभी अपने कनेक्शन्स ऑटोमेट करना शुरू करें →](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)**

अपना मुफ़्त अकाउंट बनाएँ और बिना पैनल खोले API के ज़रिए चैनल इंटीग्रेट करें।