# Widget web

Intégrez un widget de chat IA sur le site d'un client, connecté depuis le catalogue Intégrations

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

Connecter le widget web place une bulle de chat IA sur le site de votre client pour que les visiteurs parlent à l'agent sans quitter la page — créé et géré depuis le catalogue **Intégrations** via une fenêtre, comme tous les autres canaux.

<WidgetPageDemo />

## Connexion [#connect]

1. Dans **Intégrations**, section **Messageries**, cliquez sur la tuile **Widget**.
2. Dans la boîte de dialogue de connexion du widget, renseignez :
   * **Nom du widget** — un libellé pour reconnaître ce widget.
   * **Description** (facultatif) — où il fonctionne.
   * **Origins autorisées** — sites autorisés à charger le widget, chacun sous forme d'adresse complète (`https://example.com`), ajoutés avec le bouton d'ajout ou Entrée. Laissez la liste vide pour autoriser n'importe quel site.
3. Cliquez sur **Connecter** pour créer le widget.
4. Récupérez le code d'intégration depuis la carte du widget dans **Mes intégrations** : **Copier le code** dans son menu le copie directement, **Modifier** l'affiche dans le bloc **Code d'intégration**. Collez-le avant `</body>` sur chaque page où le widget doit apparaître.
5. Assignez un assistant IA au widget.

## Personnaliser [#customize]

L'apparence et l'installation se règlent sur l'agent auquel le widget est assigné : ouvrez l'agent → **Widget**. La page **Web widget** comporte quatre onglets — **Appearance**, **Voice & content**, **Behaviour** et **Install** (pour l'instant en anglais uniquement). **Install** fournit l'extrait pour HTML, Google Tag Manager, WordPress ou Shopify et gère la liste **Allowed domains** (ajoutez des domaines sans protocole comme `example.com` avec **Add domain**) ; chaque domaine indique si le widget y a déjà été vu en service.

## Champs [#fields]

| Champ              | Valeur                                                                                                                                                                            |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nom du widget      | Libellé du widget                                                                                                                                                                 |
| Description        | Note facultative sur l'endroit où il fonctionne                                                                                                                                   |
| Origins autorisées | Sites autorisés à le charger. Liste vide ou `*` — n'importe quel site. Un domaine couvre aussi ses sous-domaines ; `localhost` fonctionne toujours. Les autres sites sont refusés |

**API :** [api.happ.tools/reference](https://api.happ.tools/reference)

## Pour aller plus loin [#next]

* [Canaux](/docs/integrations/messengers) — toutes les messageries
* [Agents](/docs/agents) — configurez qui répond