Ümumi gələn məlumat AiHummer-ə giriş üçün universal nöqtədir. Mənbəyiniz üçün xüsusi hazırlanmış bir kanal olmadıqda — e-poçtdan webhook-a ötürücü, cron işi, daxili alət — siz mesajı bir son nöqtəyə göndərirsiniz və o, hər hansı digər kanal mesajı kimi turn mühərrikinə daxil olur.
Son nöqtə
Tək bir JSON göndərin POST darvazaya:
POST /v1/inbound/genericContent-Type: application/jsonX-AIHummer-Inbound-Secret: <hmac>{ "channel": "my-app", "external_id": "user-42", "text": "Hello from my custom integration"}
Cismin üç sahəsi var:
channel — mənbə üçün seçdiyiniz məntiqi kanal adı.
external_id — son istifadəçi və ya söhbət üçün sabit bir identifikator.
text — mesajın məzmunu.
Təsdiqləmə
Son nöqtə tərəfindən təmin olunur HMAC də daşıdı X-AIHummer-Inbound-Secret başlıq, paylaşılmışdan törədilmiş AIHUMMER_INBOUND_SECRET. Əlçatandırmayan imzası olan sorğular rədd edilir, buna görə yalnız sirri bilən çağırıcılar mesajları əlavə edə bilər.
[!NOTE]
Şlüzdə standart iş sahəsi konfiqurasiya edilməlidir
(AIHUMMER_DEFAULT_WORKSPACE_ID) ümumi daxil olan mesajları göndərmək üçün.
Əlavə kanal qoşucuları
AiHummer əlavə kanal birləşdiriciləri təklif edir. Hər biri Marketplace-dən quraşdırılır, öz portunda ana sistem kimi işləyir və gələn mesajları yönləndirir /v1/inbound/generic.
Qoşucu
Limanç
Qeydlər
Discord
8801
Slack
8802
Matrisa
8803
Siqnal
8804
tələb edir signal-cli yan araba
Microsoft Teams
8805
Elektron poçt (IMAP/SMTP)
8806
WhatsApp Bulud API
8807
[!NOTE]
Qoşucular Bazar yerindən quraşdırılır; bəziləri əlavə xidmət tələb edir
(məsələn, signal-cli Signal üçün).
Brauzer əlavəsi
AiHummer həmçinin bir brauzer əlavəsi göndərir, bir Manifest V3 yan paneli chat səthi. Bu bir müştəri /v1/chat/completions şəxsi istifadə ah- API açarı — server tərəfli kanal deyil. Bunu marşrutlaşdırma üçün gələn mənbə kimi istifadə etmək əvəzinə şəxsi, brauzer daxilində söhbət üçün istifadə edin.
**Ümumi gələn məlumat AiHummer-ə giriş üçün universal nöqtədir.** Mənbəyiniz üçün xüsusi hazırlanmış bir kanal olmadıqda — e-poçtdan webhook-a ötürücü, cron işi, daxili alət — siz mesajı bir son nöqtəyə göndərirsiniz və o, hər hansı digər kanal mesajı kimi turn mühərrikinə daxil olur.
## Son nöqtə
Tək bir JSON göndərin `POST` darvazaya:
```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"
}
```
Cismin üç sahəsi var:
- **`channel`** — mənbə üçün seçdiyiniz məntiqi kanal adı.
- **`external_id`** — son istifadəçi və ya söhbət üçün sabit bir identifikator.
- **`text`** — mesajın məzmunu.
## Təsdiqləmə
Son nöqtə tərəfindən təmin olunur **HMAC** də daşıdı **`X-AIHummer-Inbound-Secret`** başlıq, paylaşılmışdan törədilmiş **`AIHUMMER_INBOUND_SECRET`**. Əlçatandırmayan imzası olan sorğular rədd edilir, buna görə yalnız sirri bilən çağırıcılar mesajları əlavə edə bilər.
> [!NOTE]
> Şlüzdə standart iş sahəsi konfiqurasiya edilməlidir
> (`AIHUMMER_DEFAULT_WORKSPACE_ID`) ümumi daxil olan mesajları göndərmək üçün.
## Əlavə kanal qoşucuları
AiHummer əlavə kanal birləşdiriciləri təklif edir. Hər biri Marketplace-dən quraşdırılır, öz portunda ana sistem kimi işləyir və gələn mesajları yönləndirir `/v1/inbound/generic`.
| Qoşucu | Limanç | Qeydlər |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matrisa | 8803 | |
| Siqnal | 8804 | tələb edir `signal-cli` yan araba |
| Microsoft Teams | 8805 | |
| Elektron poçt (IMAP/SMTP) | 8806 | |
| WhatsApp Bulud API | 8807 | |
> [!NOTE]
> Qoşucular Bazar yerindən quraşdırılır; bəziləri əlavə xidmət tələb edir
> (məsələn, `signal-cli` Signal üçün).
## Brauzer əlavəsi
AiHummer həmçinin bir brauzer əlavəsi göndərir, bir **Manifest V3 yan paneli** chat səthi. Bu bir **müştəri `/v1/chat/completions`** şəxsi istifadə `ah-` API açarı — **server tərəfli kanal deyil**. Bunu marşrutlaşdırma üçün gələn mənbə kimi istifadə etmək əvəzinə şəxsi, brauzer daxilində söhbət üçün istifadə edin.
## Növbəti haradır
- İstehsal söhbəti üçün baxın [Telegram](/az/v1.0/channels/telegram) və
[MAKS](/az/v1.0/channels/max).
- Personal IM üçün bax [Bitrix24](/az/v1.0/channels/bitrix24).
- API-yə qarşı qurmaq? Bax [çat/tamamlamalar](/az/v1.0/api/chat-completions).