საერთო შემომავალი

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"
}

**უნივერსალური შემომავალი ნაკადი — ეს არის AiHummer-ის უნივერსალური შესასვლელი წერტილი.** როდესაც თქვენი წყაროსთვის სპეციფიკური არხი არ არსებობს — ელექტრონული ფოსტის გადამისამართება ვებ-ჰუკზე, cron-ის დავალებები, შიდა ინსტრუმენტები — თქვენ აწვდით შეტყობინებას ერთ ბოლოს წერტილზე, და ის მოხვდება დამუშავების ძრავში, როგორც ნებისმიერი სხვა არხის შეტყობინება. ## საბოლოო წერტილი გაგზავნეთ ერთი JSON `POST` გეითისკენ: ```http 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`** — შეტყობინების შინაარსი. ## ავტენტიფიკაცია ფინალური წერტილი დაცულია გამოყენებით **HMAC** გარეთ წაიღეს **`X-AIHummer-Inbound-Secret`** სათაური, მიღებული საერთოიდან **`AIHUMMER_INBOUND_SECRET`**. მოთხოვნები, რომლებიც არ შეიცავენ ვალიდურ ხელმოწერას, უარყოფილდებიან, ამიტომ მხოლოდ ის არასაკმამდებლები, რომლებიც ფლობენ საიდუმლოს, შეუძლიათ შეტყობინებების შეყვანა. > [!NOTE] > შლიუსში უნდა იყოს დაყენებული ნაგულისხმევი სამუშაო სივრცე > (`AIHUMMER_DEFAULT_WORKSPACE_ID`) საერთო შემომავალი შეტყობინებების გასაგზავნად. ## დამატებითი არხების კავშირები AiHummer სთავაზობს დამატებით არხების კაპლიბრატორებს. თითოეული ინსტალირდება Marketplace-იდან, მუშაობს ნატიურად ჰოსტზე თავის პორტზე და გადამისამართებს შემომავალი შეტყობინებებს `/v1/inbound/generic`. | კავშირი | პორტი | შენიშვნები | |---|---|---| | დისქორდი | 8801 | | | სლეკი | 8802 | | | მატრიცა | 8803 | | | სიგნალი | 8804 | მობაძვის `signal-cli` ბავშვის ეტლი | | Microsoft Teams | 8805 | | | ელექტრონული ფოსტა (IMAP/SMTP) | 8806 | | | ღრუბლოვანი WhatsApp API | 8807 | | > [!NOTE] > კონექტორები მიდიან მარკეტფლეისიდან; ზოგიერთი საჭიროებს დამატებით სერვისს > (მაგალითად, `signal-cli` Signal-ისთვის). ## ბრაუზერის გაფართოება AiHummer ასევე გამოაქვეყნება ბრაუზერის გაფართოებასთან ერთად, a **Manifest V3 გვერდითი პანელი** ჩატის ზედაპირი. ეს **კლიენტი `/v1/chat/completions`** პირადი გამოყენებით `ah-` API გასაღები — **არა სერვერული არხი**გამოიყენეთ იგი პირადი ჩატისთვის ბრაუზერში, ნუ გამოიყენებთ შესასვლელ წყაროდ რაუტინგისთვის. ## სად შემდეგ? - სამრეწველო ჩათისთვის იხილეთ [ტელეგრამი](/ka/v1.0/channels/telegram) და [მაქს](/ka/v1.0/channels/max). - თანამშრომლების შიდა შეტყობინებისთვის იხილეთ [ბიტრიქს24](/ka/v1.0/channels/bitrix24). - ქვესტთინი API-ს წინააღმდეგ? შეხედეთ [ჩატი/დასრულება](/ka/v1.0/api/chat-completions).