Référence de l'API

Happ expose une API REST + WebSocket pour gérer les assistants, envoyer des messages, contrôler le mode IA et intégrer Happ dans vos processus. La référence complète et testable se trouve dans Scalar — c'est la source de vérité pour chaque endpoint, schéma et exemple.

api.happ.tools/reference

Groupes de ressources

La référence publique couvre ces groupes :

• Auth — se connecter, rafraîchir un jeton
• Companies — espaces de travail, membres, invitations
• Access Tokens — jetons longue durée pour les intégrations
• Assistants — GET/POST /api/assistants-new, PATCH /api/assistants-new/{id}
• Assistant tools — /api/assistant-tools-new
• Assistant knowledge — /api/assistant-knowledge-new
• Chats — lister les conversations, envoyer et lister les messages, basculer le contrôle de l'IA (PATCH /api/chats/{id} isUnderAiControl)
• Calls — lancer un appel sortant : POST /api/assistants/{id}/originate

Tout le reste de la plateforme (téléphones, intégrations, facturation, statistiques) se pilote depuis le tableau de bord, pas depuis l'API publique.

Authentification

Toutes les requêtes exigent un Access Token généré dans les paramètres du compte sur my.happ.tools. Envoyez-le dans l'en-tête :

X-Access-Token: happ_your_token_here

URL de base (production) : https://api.happ.tools.

WebSocket

Connectez-vous via Socket.IO à wss://api.happ.tools (namespace par défaut, sans suffixe de chemin) : authentifiez-vous avec votre jeton, passez auth: { companyId }, puis recevez les événements MESSAGE_CREATED, CHAT_MODE_CHANGED et CHAT_CREATED. Voir Conversations > Mises à jour en temps réel.

Utiliser avec l'IA

Vous faites l'intégration avec un assistant IA (Claude, Cursor, Copilot) ? Donnez-lui nos sources lisibles par machine au lieu de copier-coller la documentation :

• Spécification OpenAPI — https://api.happ.tools/api/swagger-json (chaque endpoint, schéma et règle d'authentification)
• Index de la documentation — https://docs.happ.tools/llms.txt

Prompt de départ :

You are integrating with the Happ Platform API.
Spec: https://api.happ.tools/api/swagger-json
Docs: https://docs.happ.tools/llms.txt
Auth: send the header X-Access-Token: happ_...
Task: <describe what you want to build>

Ensuite

• Conversations — la boîte de réception que pilotent ces endpoints
• Webhooks — envoyez des événements vers votre serveur