AiHummer
हिन्दी
साइन इन करेंखाता
v1.2.x
{ }Swagger

सामान्य इनबाउंड

v1.2.x · अपडेट किया गया 2026-06-26

सामान्य इनबाउंड 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- एपीआई कुंजी — सर्वर-साइड चैनल नहींइसे रूटिंग के लिए इनबाउंड स्रोत के रूप में उपयोग करने के बजाय व्यक्तिगत, ब्राउज़र में चैट के लिए उपयोग करें।

अगला कहाँ