Outils

Les outils permettent à l'assistant de faire des choses : chacun est une fonction que l'IA peut appeler en pleine conversation — votre webhook, ou un outil fourni par Happ.

Ajouter un outil

1. Ouvrez l'onglet Outils dans un assistant.
2. Webhook — requête HTTP vers votre API. Définissez le nom, la description, le schéma des paramètres, l'URL, la méthode et un secret partagé. Exemples : create_reservation (POST), lookup_customer (GET).
3. Intégrés — aucune configuration, chaque assistant les reçoit : searchKnowledge (recherche vectorielle dans la base de connaissances rattachée), turnOffAiMode (transfère la conversation à un opérateur humain avec tout le contexte), searchPreviousConversations (retrouve ce dont ce client a parlé auparavant) et sendImage (envoie une image de la base de connaissances dans la conversation).
4. Rédigez des descriptions qui expliquent quand appeler l'outil, pas seulement ce qu'il fait — l'IA voit le nom, la description et le schéma des paramètres dans son prompt.
5. Cliquez sur Vérifier sur n'importe quel outil pour lancer un appel de test et examiner la réponse.

L'IA remplit les paramètres requis à partir du contexte (en demandant d'abord au client si une information manque) et les appels d'outils sont récursifs — les résultats alimentent le tour suivant, elle peut donc enchaîner plusieurs outils dans une seule réponse.

Exemple d'appel webhook

POST vers votre endpoint avec les paramètres collectés plus chatId :

{ "table_id": "T-12", "time": "2026-05-18T19:30:00Z", "guests": 4, "phone": "+380501234567", "chatId": "chat-uuid" }

Renvoyez un JSON court que l'IA peut reformuler :

{ "result": "Booking confirmed. Confirmation number #12345." }

Donnez un secret à l'outil et chaque appel porte Authorization: Basic <secret>. Les appels avec un corps (POST, PUT, PATCH) portent aussi X-Signature: sha256=<hex> — HMAC-SHA256 du corps brut ; recalculez-le avant traitement. Un outil GET envoie ses paramètres dans la query string et ne porte aucune signature.

API : api.happ.tools/reference

Ensuite

• Base de connaissances — laissez-le chercher l'information avant d'agir
• Contrôle de l'IA — comment turnOffAiMode passe la main, et quand l'IA se réactive
• Canaux — où les appels d'outils ont lieu : Telegram, Instagram, WhatsApp, voix