Session Link

डेवलपर API

अपने सिस्टम से किसी ग्राहक की बातचीत का सीधा लिंक पाएँ; अगर ग्राहक या बातचीत अभी नहीं है तो वे बना दिए जाते हैं।

WhatsApp
Instagram
REST API

MonoStore से इंस्टॉल करें monochat.ai पर देखें

ओवरव्यू

एक चैनल और ग्राहक के फ़ोन नंबर या ईमेल के साथ एक API कॉल ऐसा लिंक लौटाती है जो MonoChat में उस ग्राहक की बातचीत खोलता है। अगर ग्राहक या बातचीत अभी नहीं है, तो वे बना दिए जाते हैं।

लिंक को अपने CRM, हेल्प डेस्क या ऑर्डर स्क्रीन में रखें और आपकी टीम वहीं से सीधे चैट पर पहुँच जाएगी।

मुख्य विशेषताएँ

खोलें या बनाएँ। किसी दिए गए WhatsApp, Instagram या दूसरे चैनल के ग्राहक के लिए, फ़ोन नंबर या ईमेल से काम करता है।
रास्ते में ही रूट करें। उसी कॉल में बातचीत को आईडी या ईमेल से किसी एजेंट को, या किसी वर्कग्रुप को सौंपें।
वही ग्राहक, वही बातचीत। उसी ग्राहक और चैनल के लिए दोबारा कॉल करने पर मौजूदा बातचीत ही मिलती है।

इंस्टॉल और सेट अप करें

सेटिंग › MonoStore › ऐप से Session Link इंस्टॉल करें, या इंस्टॉल लिंक app.monochat.ai/apps/vvKJe8Nbp4EQNy2KA खोलें। अगर आपके पास MonoChat अकाउंट नहीं है, तो लिंक आपको पहले साइन अप करने देता है और फिर आपके लिए ऐप इंस्टॉल कर देता है।
प्रोफ़ाइल › API टोकन में एक API टोकन बनाएँ। टोकन सिर्फ़ एक बार दिखाया जाता है, इसलिए उसे तुरंत कॉपी कर लें। देखें API टोकन।
सेटिंग › Session Link API खोलें। वहाँ के डॉक्यूमेंटेशन में आपके वर्कस्पेस का सटीक एंडपॉइंट पता और कॉपी करने लायक तैयार उदाहरण अनुरोध हैं। उदाहरण को अपने किसी चैनल के साथ आज़माएँ।
अपने CRM, हेल्प डेस्क या ऑर्डर स्क्रीन में "WhatsApp पर चैट करें" बटन जोड़ें जो API को कॉल करे और लौटाया गया url खोले।

नोट

यह लिंक उन लोगों के लिए MonoChat खोलता है जो साइन इन हैं और जिन्हें वह बातचीत देखने की अनुमति है।
यह कॉल सिर्फ़ बातचीत खोलती है; ग्राहक को कोई संदेश नहीं भेजती। पहले संदेश लिखने के लिए WhatsApp Template API इस्तेमाल करें।

सुविधाएँ

बातचीत का लिंक

जवाब में MonoChat में बातचीत खोलने वाला लिंक और बातचीत की आईडी मिलती है।

ज़रूरत हो तो ग्राहक बनता है

आपके भेजे पहले और आख़िरी नाम से नया ग्राहक बनता है; जवाब बताता है कि ग्राहक पहले से जाना-पहचाना था या नहीं।

असाइनमेंट

आईडी या ईमेल से किसी एजेंट को, या किसी वर्कग्रुप को सौंपें।

डॉक्यूमेंटेशन स्क्रीन

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

API रेफ़रेंस

यह कॉल JSON बॉडी के साथ एक POST है, जो API टोकन से प्रमाणित होती है।

POST https://app.monochat.ai/api/<slug>/custom-functions/<app-folder>/methods/session-link.js
Authorization: Bearer <API_TOKEN>
Content-Type: application/json

<slug> आपके वर्कस्पेस का टेनेंट स्लग है, यानी आपके MonoChat पते में /tenants/ के बाद वाला हिस्सा।
<app-folder> वह फ़ोल्डर है जिसमें ऐप इंस्टॉल हुआ था। सेटिंग › Session Link API स्क्रीन दोनों भरा हुआ पूरा पता दिखाती है।
टोकन प्रोफ़ाइल › API टोकन में बनाएँ। देखें API टोकन।

अनुरोध के फ़ील्ड

फ़ील्ड	ज़रूरी	विवरण
`connectorBrand`	हाँ	चैनल का प्रकार, जैसे `whatsapp` या `instagram`।
`channelUsername`	हाँ	MonoChat में आपके चैनल का यूज़रनेम, जैसे `+` के बिना आपका WhatsApp नंबर।
`customer.identityType`	हाँ	`phoneNumber` या `email`।
`customer.identity`	हाँ	ग्राहक का फ़ोन नंबर (देश कोड के साथ, `+` के बिना) या ईमेल पता।
`customer.firstname`, `customer.lastname`	नहीं	जब ग्राहक MonoChat में नया हो तब इस्तेमाल होता है। डिफ़ॉल्ट `-`।
`assignment.type`	नहीं	`agent` (एजेंट यूज़र आईडी), `agentIdentity` (एजेंट का ईमेल) या `workgroup` (वर्कग्रुप आईडी)।
`assignment.value`	`assignment.type` के साथ	बातचीत जिसे सौंपनी है उसकी आईडी या ईमेल।

उदाहरण अनुरोध

curl --location 'https://app.monochat.ai/api/<slug>/custom-functions/<app-folder>/methods/session-link.js' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_TOKEN>' \
--data '{
  "connectorBrand": "whatsapp",
  "channelUsername": "905334445566",
  "customer": {
    "identityType": "phoneNumber",
    "identity": "905306667788",
    "firstname": "Ayşe",
    "lastname": "Yılmaz"
  },
  "assignment": { "type": "agentIdentity", "value": "sarah@yourcompany.com" }
}'

जवाब

{
  "result": {
    "url": "https://app.monochat.ai/tenants/<slug>?tab=messages&sessionTab=all&filter=…&_id=<sessionId>",
    "sessionId": "Zeii7vpeeFFnsJepZ",
    "isOldUser": true
  }
}

फ़ील्ड	विवरण
`url`	MonoChat में बातचीत खोलता है।
`sessionId`	बातचीत की आईडी। एक ही चैनल पर एक ही ग्राहक को हमेशा वही बातचीत मिलती है।
`isOldUser`	जब ग्राहक इसी कॉल से बना हो तो `false`।

त्रुटियाँ

असफल कॉल एक त्रुटि स्टेटस और संदेश के साथ जवाब देती है:

संदेश	कारण
`connectorBrand, channelUsername and customer fields are required`	कोई ज़रूरी टॉप-लेवल फ़ील्ड गायब है।
`customer.identityType must be one of: phoneNumber, email`	`identityType` गायब है या उसकी कोई और वैल्यू है।
`customer.identity field is required`	ग्राहक का फ़ोन नंबर या ईमेल गायब है।
`Channel not found`	आपके वर्कस्पेस में उस प्रकार और उस यूज़रनेम का कोई चैनल नहीं है।
`Customer Channel not found`	ग्राहक को किसी चैनल आइडेंटिटी से मिलाया नहीं जा सका।
`Agent user not found`	`assignment.value` में दिए गए ईमेल वाला कोई एजेंट नहीं है।
`401`	`Authorization` हेडर गायब है या टोकन अमान्य है।