# Référence de l'API

API REST + WebSocket pour les assistants, les conversations, les connaissances, les outils, les téléphones et les webhooks

> Full REST + WebSocket API reference: https://api.happ.tools/reference

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](https://api.happ.tools/reference)**

## Groupes de ressources [#resource-groups]

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 [#authentication]

Toutes les requêtes exigent un **Access Token** généré dans les paramètres du compte sur [my.happ.tools](https://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 [#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](/docs/workspace/chats).

## Utiliser avec l'IA [#use-with-ai]

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 :

```text
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 [#next]

* [Conversations](/docs/workspace/chats) — la boîte de réception que pilotent ces endpoints
* [Webhooks](/docs/integrations/webhooks) — envoyez des événements vers votre serveur