Intrare generică
Intrarea generică este punctul de intrare universal în AiHummer. Când nu există un canal construit special pentru sursa dumneavoastră — un releu email-to-webhook, o sarcină cron, un instrument intern — postați mesajul la un singur endpoint și acesta intră în motorul de tururi ca orice alt mesaj de canal.
Endpoint-ul
Trimiteți un singur POST JSON către gateway:
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"
}Corpul poartă trei câmpuri:
channel— un nume logic de canal pe care îl alegeți pentru sursă.external_id— un identificator stabil pentru utilizatorul final sau conversație.text— conținutul mesajului.
Autentificare
Endpoint-ul este securizat de un HMAC purtat în antetul
X-AIHummer-Inbound-Secret, derivat din secretul partajat
AIHUMMER_INBOUND_SECRET. Cererile fără o semnătură validă sunt respinse,
astfel încât doar apelanții care dețin secretul pot injecta mesaje.
[!NOTE] Gateway-ul trebuie să aibă un spațiu de lucru implicit configurat (
AIHUMMER_DEFAULT_WORKSPACE_ID) pentru a expedia mesaje de intrare generică.
Conectori disponibili / în previzualizare
AiHummer oferă conectori de canal suplimentari în previzualizare: aceștia sunt
deja implementați, dar încă nevalidați față de conturi reale. Fiecare este
instalat din Marketplace, rulează nativ pe gazdă pe propriul port și
redirecționează mesajele de intrare către /v1/inbound/generic.
| Conector | Port | Note |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matrix | 8803 | |
| Signal | 8804 | necesită un sidecar signal-cli |
| Microsoft Teams | 8805 | |
| Email (IMAP/SMTP) | 8806 | |
| WhatsApp Cloud API | 8807 |
[!WARNING] Tratați acești conectori ca disponibili / în previzualizare. Sunt implementați, dar nedovediți în direct față de conturi reale ale furnizorilor — validați-i în propriul mediu înainte de a vă baza pe ei în producție.
Extensia de browser
AiHummer livrează, de asemenea, o extensie de browser, o suprafață de chat de tip
panou lateral Manifest V3. Este un client al /v1/chat/completions
folosind o cheie API personală ah- — nu un canal de partea serverului.
Folosiți-o pentru chat personal, în browser, mai degrabă decât ca o sursă de
intrare pentru direcționare.
Unde mergem mai departe
- Pentru chat în producție, vedeți Telegram și MAX.
- Pentru IM pentru personal, vedeți Bitrix24.
- Construiți pe baza API-ului? Vedeți chat/completions.