AiHummer
Deutsch▾
AnmeldenKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanäle/Allgemeiner eingehender

Allgemeiner eingehender

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

Generischer Inbound ist der universelle Einstiegspunkt in AiHummer. Wenn es keinen zweckgebauten Kanal für Ihre Quelle gibt — ein E-Mail-zu-Webhook-Relay, einen Cron-Job, ein internes Tool — senden Sie die Nachricht an einen Endpunkt, und sie gelangt wie jede andere Kanalnachricht in die Turn-Engine.

Der Endpunkt

Sende ein einzelnes JSON POST zum Tor:

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

Der Körper trägt drei Felder:

  • channel — ein logischer Kanalname, den Sie für die Quelle wählen.
  • external_id — ein stabiler Identifikator für den Endbenutzer oder das Gespräch.
  • text — der Nachrichteninhalt.

Authentifizierung

Der Endpunkt ist durch einen gesichert HMAC getragen in der X-AIHummer-Inbound-Secret Kopfzeile, abgeleitet von der freigegebenen AIHUMMER_INBOUND_SECRET. Anfragen ohne gültige Signatur werden abgelehnt, daher können nur Aufrufer, die das Geheimnis besitzen, Nachrichten einfügen.

[!NOTE] Das Gateway muss einen Standardarbeitsbereich konfiguriert haben (AIHUMMER_DEFAULT_WORKSPACE_ID) zum Versenden generischer eingehender Nachrichten.

Zusätzliche Kanalverbinder

AiHummer bietet zusätzliche Kanalverbinder an. Jeder wird über den Marketplace installiert, läuft host-nativ auf seinem eigenen Port und leitet eingehende Nachrichten weiter an /v1/inbound/generic.

Anschluss Port Notizen
Discord 8801
Slack 8802
Matrix 8803
Signal 8804 erfordert ein signal-cli-Sidecar
Microsoft Teams 8805
E-Mail (IMAP/SMTP) 8806
WhatsApp Cloud API 8807

[!NOTE] Die Connectoren werden über den Marketplace installiert; einige benötigen einen zusätzlichen Dienst (zum Beispiel, signal-cli für Signal).

Die Browser-Erweiterung

AiHummer liefert auch eine Browsererweiterung mit, eine Manifest V3 Seitenleiste Chat-Oberfläche. Es ist ein Kunde von /v1/chat/completions einen persönlichen nutzen ah- API-Schlüssel — kein serverseitiger KanalVerwenden Sie es für persönliche Chats im Browser und nicht als eingehende Quelle für die Weiterleitung.

Wohin als Nächstes