Entrant générique

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

**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 : ```http 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-cli` pour 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é serveur**Utilisez-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](/fr/v1.0/channels/telegram) et [MAX](/fr/v1.0/channels/max). - Pour la messagerie instantanée du personnel, voir [Bitrix24](/fr/v1.0/channels/bitrix24). - Construire contre l'API ? Voir [chat/complétions](/fr/v1.0/api/chat-completions).