AiHummer
Azərbaycanca▾
Daxil ol
v1.0.x▾
v1.0.xstable
{ }Swagger
Kanallar/Generic inbound

Generic inbound

v1.0.x · yeniləndi 2026-06-26

Generic inbound AiHummer-ə universal giriş nöqtəsidir. Mənbəniz üçün xüsusi hazırlanmış kanal olmadıqda — email-to-webhook relesi, cron işi, daxili alət — siz mesajı bir endpoint-ə göndərirsiniz və o, hər hansı digər kanal mesajı kimi turn mühərrikinə daxil olur.

Endpoint

Gateway-ə tək bir JSON POST göndərin:

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

Gövdə üç sahə daşıyır:

  • channel — mənbə üçün seçdiyiniz məntiqi kanal adı.
  • external_id — son istifadəçi və ya söhbət üçün sabit identifikator.
  • text — mesajın məzmunu.

Autentifikasiya

Endpoint X-AIHummer-Inbound-Secret başlığında daşınan və paylaşılan AIHUMMER_INBOUND_SECRET-dən törədilən bir HMAC ilə mühafizə olunur. Etibarlı imzası olmayan sorğular rədd edilir, ona görə də yalnız sirri saxlayan çağırıcılar mesaj yerləşdirə bilər.

[!NOTE] Generic inbound mesajlarını dispetçer etmək üçün gateway-də default işçi sahə konfiqurasiya edilmiş olmalıdır (AIHUMMER_DEFAULT_WORKSPACE_ID).

Mövcud / önizləmə konnektorları

AiHummer önizləmə rejimində əlavə kanal konnektorları təklif edir: onlar artıq tətbiq edilib, lakin canlı hesablara qarşı hələ yoxlanılmayıb. Hər biri Marketplace-dən quraşdırılır, host-native öz portunda işləyir və daxil olan mesajları /v1/inbound/generic ünvanına yönləndirir.

Konnektor Port Qeydlər
Discord 8801
Slack 8802
Matrix 8803
Signal 8804 bir signal-cli sidecar tələb edir
Microsoft Teams 8805
Email (IMAP/SMTP) 8806
WhatsApp Cloud API 8807

[!WARNING] Bu konnektorları mövcud / önizləmə kimi qiymətləndirin. Onlar tətbiq edilib, lakin real provayder hesablarına qarşı canlı sübut olunmayıb — istehsalda onlara güvənmədən əvvəl onları öz mühitinizdə yoxlayın.

Brauzer genişlənməsi

AiHummer həmçinin bir brauzer genişlənməsi — Manifest V3 yan-panel söhbət səthi — təqdim edir. Bu, şəxsi ah- API açarından istifadə edən /v1/chat/completions-in müştərisidir — server tərəfli kanal deyil. Onu yönləndirmə üçün daxil olan mənbə kimi deyil, şəxsi, brauzerdaxili söhbət üçün istifadə edin.

Növbəti addım