Иуниверсалу аиҵаху (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"
}

**Иуниверсалу аиҵаху — ари AiHummer аҩныҵҟа аиалагаратә ҭыԥ универсалуп.** Шәхыҵхырҭа азы ҷыдала иаԥҵоу аканал ыҟамзар — email-to-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`** — амессеж аҵаҵӷәы. ## Аутентификациа Аэндпоинт ихьчоуп **HMAC** ала, иани **`X-AIHummer-Inbound-Secret`** хы-аҟны инаргоу, иеицырзеиԥшу **`AIHUMMER_INBOUND_SECRET`** аҟынтә иаагоу. Иашоу амҩа змам аиҳәарақәа мап рцәахоит, убри аҟнытә асекрет ззыхьыԥшу автор-зегь амассежқәа рылагалара рылшоит. > [!NOTE] > Агейтуэй default-аусуратә ҭыԥ (workspace) иconfiguraны иамазароуп > (`AIHUMMER_DEFAULT_WORKSPACE_ID`) иуниверсалу аиҵаху амассежқәа рышьҭразы. ## Иҟоу / иаԥхьахо аконнекторқәа AiHummer ацхыраагӡатә каналтә коннекторқәа **аԥхьаԥшраҿы** инаит: урҭ ианагӡахьеит, аха **жәлартә аккаунтқәа рҿы иавалидмгеиц**. Урҭ-зегь Маркетплейс аҟынтә ишьҭаргылоуп, host-native ала рхатә порт ала аус руеит, насгьы аиҵаху амассежқәа `/v1/inbound/generic` ахь ишьҭуеит. | Аконнектор | Порт | Азгәаҭарақәа | |---|---|---| | Discord | 8801 | | | Slack | 8802 | | | Matrix | 8803 | | | Signal | 8804 | `signal-cli` сайдкар иаҭахуп | | Microsoft Teams | 8805 | | | Email (IMAP/SMTP) | 8806 | | | WhatsApp Cloud API | 8807 | | > [!WARNING] > Ари аконнекторқәа **иҟоу / аԥхьаԥшраҿы** иҟоуп ҳасабла иахәаԥш. Урҭ анагӡоуп, > аха **аредахатә провайдер-аккаунтқәа рҿы иарбагеиц** — продукциаҿы ирыдыҵаанӡа > шәхатә среда аҟны урҭ авалидмҵ. ## Абраузер-арҭбаагатә AiHummer убри аан абраузер-арҭбаагатә инаит, ари **Manifest V3 ган-панель** чат-аҿы. Уи **`/v1/chat/completions` аклиентуп** иуа ахатә `ah-` API-ацаԥха ала — **акәым асерверган-каналс**. Уи ахархәа ахатә, абраузер-аҩныҵҟатәи чатс акәымкәа, амҩақәҵаразы аиҵаху-хыҵхырҭас. ## Аҩаџьара аҟынӡа - Апродукциатә чатс [Telegram](/en/v1.0/channels/telegram) насгьы [MAX](/en/v1.0/channels/max) аба. - Аусуҩцәа рмессенджерс [Bitrix24](/en/v1.0/channels/bitrix24) аба. - API иадҳәаланы шәгьежьуа? [chat/completions](/en/v1.0/api/chat-completions) аба.