Entrant générique
L’entrée générique est le point d’accès universel à AiHummer. Lorsqu’il n’existe pas de canal spécialement conçu pour votre source — un relais email-vers-webhook, un travail cron, un outil interne — vous publiez le message sur un point de terminaison et il entre dans le moteur de tournées comme tout autre message de canal.
Le point de terminaison
Envoyez un seul JSON POST vers la passerelle :
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"
}Le corps contient trois champs :
channel— un nom de canal logique que vous choisissez pour la source.external_id— un identifiant stable pour l’utilisateur final ou la conversation.text— le contenu du message.
Authentification
Le point de terminaison est sécurisé par un HMAC porté dans le X-AIHummer-Inbound-Secret en-tête, dérivé du partagé AIHUMMER_INBOUND_SECRET. Les requêtes sans signature valide sont rejetées, donc seuls les appelants qui possèdent le secret peuvent injecter des messages.
[!NOTE] La passerelle doit avoir un espace de travail par défaut configuré (
AIHUMMER_DEFAULT_WORKSPACE_ID) pour envoyer des messages entrants génériques.
Connecteurs de canal supplémentaires
AiHummer propose des connecteurs de canal supplémentaires. Chacun est installé depuis le Marketplace, fonctionne de manière native sur son propre port et transfert les messages entrants vers /v1/inbound/generic.
| Connecteur | Port | Notes |
|---|---|---|
| Discord | 8801 | |
| Slack | 8802 | |
| Matrice | 8803 | |
| Signal | 8804 | nécessite un signal-cli side-car |
| Microsoft Teams | 8805 | |
| Email (IMAP/SMTP) | 8806 | |
| API Cloud WhatsApp | 8807 |
[!NOTE] Les connecteurs s’installent depuis le Marketplace ; certains nécessitent un service supplémentaire (par exemple,
signal-clipour Signal).
L’extension de navigateur
AiHummer expédie également une extension de navigateur, un Panneau latéral Manifest V3 surface de chat. C’est un client de /v1/chat/completions utilisant un personnel ah- Clé API — pas un canal côté serveurUtilisez-le pour des conversations personnelles dans le navigateur plutôt que comme source entrante pour le routage.
Où aller ensuite
- Pour la discussion en production, voir Télégramme et MAX.
- Pour la messagerie instantanée du personnel, voir Bitrix24.
- Construire contre l’API ? Voir chat/complétions.