Жалпы кіріс

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-ге әмбебап кіру нүктесі.** Сіздің көзіңіз үшін арнайы жасалған арна болмағанда — email-ден-webhook-қа реле, 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`** — хабарлама мазмұны. ## Аутентификация Соңғы нүкте **`X-AIHummer-Inbound-Secret`** тақырыбында алып жүрілетін, ортақ **`AIHUMMER_INBOUND_SECRET`**-тен шығарылған **HMAC** арқылы қорғалады. Жарамды қолтаңбасы жоқ сұраулар қабылданбайды, сондықтан хабарламаларды тек құпияны ұстайтын шақырушылар ғана еңгізе алады. > [!NOTE] > Шлюзде жалпы кіріс хабарламаларды жөнелту үшін әдепкі жұмыс кеңістігі > (`AIHUMMER_DEFAULT_WORKSPACE_ID`) конфигурацияланған болуы керек. ## Қолжетімді / алдын ала қарау коннекторлары AiHummer қосымша арна коннекторларын **алдын ала қарауда** ұсынады: олар әлдеқашан жүзеге асырылған, бірақ **тірі есептік жазбаларға қарсы әлі тексерілмеген**. Әрқайсысы Маркетплейстен орнатылады, өзінің портында хост-туған жұмыс істейді және кіріс хабарламаларды `/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] > Бұл коннекторларды **қолжетімді / алдын ала қарау** ретінде қабылдаңыз. Олар > жүзеге асырылған, бірақ нақты жеткізуші есептік жазбаларына қарсы **тірі-дәлелденбеген** — > өндірісте оларға сенбес бұрын өз ортаңызда тексеріңіз. ## Браузер кеңейтімі AiHummer сонымен қатар браузер кеңейтімін, **Manifest V3 бүйір-тақта** чат бетін жеткізеді. Ол жеке `ah-` API кілтін қолданатын **`/v1/chat/completions` клиенті** — **сервер-жақты арна емес**. Оны бағыттауға арналған кіріс көзі ретінде емес, жеке, браузер-ішілік чат үшін қолданыңыз. ## Әрі қарай қайда - Өндірістік чат үшін [Telegram](/kk/v1.0/channels/telegram) және [MAX](/kk/v1.0/channels/max) қараңыз. - Қызметкер IM үшін [Bitrix24](/kk/v1.0/channels/bitrix24) қараңыз. - API-ге қарсы құрастырып жатырсыз ба? [chat/completions](/kk/v1.0/api/chat-completions) қараңыз.