Ogólny ruch przychodzący jest uniwersalnym punktem wejścia do AiHummer. Kiedy nie ma specjalnie stworzonego kanału dla twojego źródła — przekazywania e-maili do webhooka, zadania cron, wewnętrznego narzędzia — wysyłasz wiadomość do jednego punktu końcowego i trafia ona do silnika tur tak jak każda inna wiadomość z kanału.
Punkt końcowy
Wyślij pojedynczy JSON POST do bramy:
POST /v1/inbound/genericContent-Type: application/jsonX-AIHummer-Inbound-Secret: <hmac>{ "channel": "my-app", "external_id": "user-42", "text": "Hello from my custom integration"}
Ciało zawiera trzy pola:
channel — logiczna nazwa kanału, którą wybierasz dla źródła.
external_id — stabilny identyfikator dla końcowego użytkownika lub rozmowy.
text — treść wiadomości.
Uwierzytelnianie
Punkt końcowy jest zabezpieczony przez HMAC przenoszony w X-AIHummer-Inbound-Secret nagłówek, pochodzący ze wspólnego AIHUMMER_INBOUND_SECRET. Żądania bez ważnego podpisu są odrzucane, więc tylko osoby posiadające sekret mogą wstrzykiwać wiadomości.
[!NOTE]
Brama musi mieć skonfigurowaną domyślną przestrzeń roboczą
(AIHUMMER_DEFAULT_WORKSPACE_ID) do wysyłania ogólnych wiadomości przychodzących.
Dodatkowe złącza kanałów
AiHummer oferuje dodatkowe łączniki kanałów. Każdy jest instalowany z Marketplace, działa natywnie na własnym porcie i przekazuje przychodzące wiadomości do /v1/inbound/generic.
Złącze
Port
Notatki
Discord
8801
Slack
8802
Macierz
8803
Sygnał
8804
wymaga signal-cli boczne siedzenie
Microsoft Teams
8805
E-mail (IMAP/SMTP)
8806
API chmury WhatsApp
8807
[!NOTE]
Konektory instalują się z Marketplace; niektóre wymagają dodatkowej usługi
(na przykład, signal-cli dla Signal).
Rozszerzenie przeglądarki
AiHummer wysyła również rozszerzenie do przeglądarki, a Panel boczny Manifest V3 powierzchnia czatu. To jest klient /v1/chat/completions używając osobistego ah- Klucz API — nie jest kanałem po stronie serweraUżywaj go do osobistej rozmowy w przeglądarce, a nie jako źródła przychodzącego do routingu.
Dokąd dalej
W przypadku czatu produkcyjnego, zobacz Telegram i
MAX.
**Ogólny ruch przychodzący jest uniwersalnym punktem wejścia do AiHummer.** Kiedy nie ma specjalnie stworzonego kanału dla twojego źródła — przekazywania e-maili do webhooka, zadania cron, wewnętrznego narzędzia — wysyłasz wiadomość do jednego punktu końcowego i trafia ona do silnika tur tak jak każda inna wiadomość z kanału.
## Punkt końcowy
Wyślij pojedynczy JSON `POST` do bramy:
```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"
}
```
Ciało zawiera trzy pola:
- **`channel`** — logiczna nazwa kanału, którą wybierasz dla źródła.
- **`external_id`** — stabilny identyfikator dla końcowego użytkownika lub rozmowy.
- **`text`** — treść wiadomości.
## Uwierzytelnianie
Punkt końcowy jest zabezpieczony przez **HMAC** przenoszony w **`X-AIHummer-Inbound-Secret`** nagłówek, pochodzący ze wspólnego **`AIHUMMER_INBOUND_SECRET`**. Żądania bez ważnego podpisu są odrzucane, więc tylko osoby posiadające sekret mogą wstrzykiwać wiadomości.
> [!NOTE]
> Brama musi mieć skonfigurowaną domyślną przestrzeń roboczą
> (`AIHUMMER_DEFAULT_WORKSPACE_ID`) do wysyłania ogólnych wiadomości przychodzących.
## Dodatkowe złącza kanałów
AiHummer oferuje dodatkowe łączniki kanałów. Każdy jest instalowany z Marketplace, działa natywnie na własnym porcie i przekazuje przychodzące wiadomości do `/v1/inbound/generic`.
| Złącze | Port | Notatki |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Macierz | 8803 | |
| Sygnał | 8804 | wymaga `signal-cli` boczne siedzenie |
| Microsoft Teams | 8805 | |
| E-mail (IMAP/SMTP) | 8806 | |
| API chmury WhatsApp | 8807 | |
> [!NOTE]
> Konektory instalują się z Marketplace; niektóre wymagają dodatkowej usługi
> (na przykład, `signal-cli` dla Signal).
## Rozszerzenie przeglądarki
AiHummer wysyła również rozszerzenie do przeglądarki, a **Panel boczny Manifest V3** powierzchnia czatu. To jest **klient `/v1/chat/completions`** używając osobistego `ah-` Klucz API — **nie jest kanałem po stronie serwera**Używaj go do osobistej rozmowy w przeglądarce, a nie jako źródła przychodzącego do routingu.
## Dokąd dalej
- W przypadku czatu produkcyjnego, zobacz [Telegram](/pl/v1.0/channels/telegram) i
[MAX](/pl/v1.0/channels/max).
- Dla personelu IM, zobacz [Bitrix24](/pl/v1.0/channels/bitrix24).
- Budowanie w oparciu o API? Zobacz [czat/uzupełnienia](/pl/v1.0/api/chat-completions).
