AiHummer
Română▾
AutentificareCont personal
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Canale/Intrare generică

Intrare generică

v1.0.x · actualizat 2026-06-26

Inbound generic este punctul de intrare universal în AiHummer. Când nu există un canal creat special pentru sursa ta — un relay de email către webhook, un job cron, un instrument intern — postezi mesajul către un singur endpoint și acesta intră în motorul de turnare ca orice alt mesaj de canal.

Punctul final

Trimite un singur JSON POST către poartă:

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 conține trei câmpuri:

  • channel — un nume de canal logic pe care îl alegi pentru sursă.
  • external_id — un identificator stabil pentru utilizatorul final sau conversație.
  • text — conținutul mesajului.

Autentificare

Punctul final este securizat de un HMAC transportat în X-AIHummer-Inbound-Secret antet, derivat din cel partajat AIHUMMER_INBOUND_SECRET. Cererile fără o semnătură validă sunt respinse, așa că doar apelanții care dețin secretul pot introduce mesaje.

[!NOTE] Poarta trebuie să aibă un spațiu de lucru implicit configurat (AIHUMMER_DEFAULT_WORKSPACE_ID) pentru a transmite mesaje generice de intrare.

Conectori suplimentari pentru canale

AiHummer oferă conectori suplimentari pentru canale. Fiecare este instalat din Marketplace, rulează nativ pe propriul port al gazdei și redirecționează mesajele primite către /v1/inbound/generic.

Conector Port Note
Discord 8801
Slack 8802
Matrice 8803
Semnal 8804 necesită un signal-cli sidecar
Microsoft Teams 8805
Email (IMAP/SMTP) 8806
API-ul WhatsApp Cloud 8807

[!NOTE] Conectorii se instalează din Marketplace; unii necesită un serviciu suplimentar (de exemplu, signal-cli pentru Signal).

Extensia browserului

AiHummer livrează, de asemenea, o extensie pentru browser, un Panou lateral Manifest V3 suprafață de chat. Este o client al /v1/chat/completions folosind un personal ah- Cheie API — nu un canal pe partea de serverUtilizați-l pentru chat personal în browser, mai degrabă decât ca sursă de intrare pentru rutare.

Unde următor?