सामान्य इनबाउंड
सामान्य इनबाउंड AiHummer में प्रवेश का सार्वभौमिक बिंदु है। जब आपके स्रोत के लिए कोई विशेष रूप से निर्मित चैनल नहीं होता — एक ईमेल-से-वेबहूक रिले, एक क्रॉन जॉब, एक आंतरिक उपकरण — आप संदेश को एक एंडपॉइंट पर पोस्ट करते हैं और यह किसी अन्य चैनल संदेश की तरह टर्न इंजन में प्रवेश करता है।
अंत बिंदु
एक ही JSON भेजें POST मुख्य द्वार की ओर:
POST /v1/inbound/generic
Content-Type: application/json
X-AIHummer-Inbound-Secret: <hmac>
{
"channel": "my-app",
"external_id": "user-42",
"text": "Hello from my custom integration"
}
शरीर में तीन क्षेत्र होते हैं:
channel— स्रोत के लिए आप जो तार्किक चैनल नाम चुनते हैं।external_id— अंतिम उपयोगकर्ता या वार्तालाप के लिए एक स्थिर पहचानकर्ता।text— संदेश सामग्री।
प्रमाणीकरण
एंडपॉइंट को एक द्वारा सुरक्षित किया गया है एचएमएसी में ले जाया गया X-AIHummer-Inbound-Secret हेडर, साझा से व्युत्पन्न AIHUMMER_INBOUND_SECRET. वैध हस्ताक्षर के बिना अनुरोध अस्वीकृत कर दिए जाते हैं, इसलिए केवल वही कॉल करने वाले संदेश डाल सकते हैं जिनके पास रहस्य है।
[!NOTE] गेटवे में एक डिफ़ॉल्ट वर्कस्पेस कॉन्फ़िगर किया हुआ होना चाहिए (
AIHUMMER_DEFAULT_WORKSPACE_ID) सामान्य इनबाउंड संदेश भेजने के लिए।
अतिरिक्त चैनल कनेक्टर
AiHummer अतिरिक्त चैनल कनेक्टर्स प्रदान करता है। प्रत्येक को मार्केटप्लेस से स्थापित किया जाता है, अपने स्वयं के पोर्ट पर होस्ट-नेटिव चलता है, और इनबाउंड संदेशों को फॉरवर्ड करता है /v1/inbound/generic.
| संयोजक | बंदरगाह | नोट्स |
|---|---|---|
| डिस्कॉर्ड | 8801 | |
| स्लैक | 8802 | |
| मैट्रिक्स | 8803 | |
| सिग्नल | 8804 | की आवश्यकता होती है signal-cli साइडकार |
| माइक्रोसॉफ्ट टीम्स | 8805 | |
| ईमेल (IMAP/SMTP) | 8806 | |
| व्हाट्सएप क्लाउड एपीआई | 8807 |
[!NOTE] कनेक्टर्स मार्केटप्लेस से इंस्टॉल होते हैं; कुछ को अतिरिक्त सेवा की आवश्यकता होती है (उदाहरण के लिए,
signal-cliसिग्नल के लिए)।
ब्राउज़र एक्सटेंशन
AiHummer एक ब्राउज़र एक्सटेंशन भी भेजता है, एक मेनिफेस्ट V3 साइड-पैनल चैट सतह। यह एक है का ग्राहक /v1/chat/completions एक व्यक्तिगत का उपयोग करना ah- एपीआई कुंजी — सर्वर-साइड चैनल नहींइसे रूटिंग के लिए इनबाउंड स्रोत के रूप में उपयोग करने के बजाय व्यक्तिगत, ब्राउज़र में चैट के लिए उपयोग करें।
अगला कहाँ
- उत्पादन चैट के लिए देखें टेलीग्राम और मैक्स.
- कर्मचारी IM के लिए, देखें बिट्रिक्स24.
- एपीआई के खिलाफ निर्माण कर रहे हैं? देखें चैट/पूर्णताएँ.