Generic inbound

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

**Generic inbound არის AiHummer-ში შესვლის უნივერსალური წერტილი.** როდესაც თქვენი წყაროსთვის არ არსებობს სპეციალურად შექმნილი არხი — email-to-webhook რელე, cron სამუშაო, თუ შიდა ხელსაწყო — თქვენ აგზავნით შეტყობინებას ერთ endpoint-ზე და ის შედის turn engine-ში როგორც ნებისმიერი სხვა არხის შეტყობინება. ## endpoint გააგზავნეთ ერთი JSON `POST` gateway-ში: ```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`** — შეტყობინების შინაარსი. ## ავთენტიფიკაცია endpoint დაცულია **HMAC**-ით, რომელიც გადატანილია **`X-AIHummer-Inbound-Secret`** ჰედერში და წარმოებულია გაზიარებული **`AIHUMMER_INBOUND_SECRET`**-დან. ხელმოწერის გარეშე მოთხოვნები უარყოფილია, ასე რომ მხოლოდ ის გამომძახებლები, რომელთაც აქვთ საიდუმლო, შეუძლიათ შეტყობინებების ინექცია. > [!NOTE] > gateway-ს უნდა ჰქონდეს კონფიგურირებული ნაგულისხმევი workspace > (`AIHUMMER_DEFAULT_WORKSPACE_ID`) generic inbound შეტყობინებების გასაგზავნად. ## ხელმისაწვდომი / preview კონექტორები AiHummer გთავაზობთ დამატებით არხის კონექტორებს **preview**-ში: ისინი უკვე დანერგილია, მაგრამ **ჯერ არ არის ვალიდირებული ცოცხალ ანგარიშებთან მიმართებაში**. თითოეული ინსტალირდება Marketplace-დან, მუშაობს host-native საკუთარ პორტზე და გადასცემს შემომავალ შეტყობინებებს `/v1/inbound/generic`-ზე. | კონექტორი | პორტი | შენიშვნები | |---|---|---| | Discord | 8801 | | | Slack | 8802 | | | Matrix | 8803 | | | Signal | 8804 | საჭიროებს `signal-cli` sidecar-ს | | Microsoft Teams | 8805 | | | Email (IMAP/SMTP) | 8806 | | | WhatsApp Cloud API | 8807 | | > [!WARNING] > ეს კონექტორები განიხილეთ როგორც **ხელმისაწვდომი / preview**. ისინი დანერგილია, მაგრამ > **არ არის ცოცხლად დადასტურებული** რეალურ პროვაიდერ ანგარიშებთან მიმართებაში — ვალიდირება გაუკეთეთ თქვენს > საკუთარ გარემოში, სანამ მათზე დააყრდნობდით პროდუქციაში. ## ბრაუზერის გაფართოება AiHummer ასევე მოწოდებულია ბრაუზერის გაფართოებით, **Manifest V3 side-panel** ჩატის ზედაპირით. ის არის **`/v1/chat/completions`-ის კლიენტი**, რომელიც იყენებს პერსონალურ `ah-` API გასაღებს — **და არა server-side არხი**. გამოიყენეთ ის პერსონალური, ბრაუზერში ჩატისთვის და არა მარშრუტიზაციის შემომავალ წყაროდ. ## შემდეგ სად - პროდუქციის ჩატისთვის იხილეთ [Telegram](/ka/v1.0/channels/telegram) და [MAX](/ka/v1.0/channels/max). - პერსონალის IM-ისთვის იხილეთ [Bitrix24](/ka/v1.0/channels/bitrix24). - შენდებით API-ზე დაყრდნობით? იხილეთ [chat/completions](/ka/v1.0/api/chat-completions).