/dashboard/web-widgets) crée et gère
les clés publiables qui alimentent le widget vocal intégrable de ThunderPhone.
Tout ce que la version API de ce guide
fait avec cURL, cette page le fait avec un formulaire — et génère en plus le code
d’intégration pour vous.
Créer un widget
1
Cliquez sur Nouveau widget et choisissez un mode
- Mode agent — le widget exécute toujours un agent que vous sélectionnez dans la liste déroulante. La configuration la plus simple.
- Mode webhook — à chaque session de widget, ThunderPhone appelle l’URL de votre webhook et votre serveur renvoie la configuration de l’agent pour ce visiteur (routage par page, utilisateurs connectés, déploiements progressifs). Laissez l’URL vide pour utiliser le webhook par défaut de votre organisation ; lorsque vous saisissez une nouvelle URL, vous pouvez également la définir comme valeur par défaut de l’organisation.
2
Répertoriez les domaines autorisés
Les clés publiables sont verrouillées par origine : au moins un domaine est requis,
et le widget fonctionne uniquement sur les noms d’hôte que vous répertoriez. Les
jokers de sous-domaines tels que
*.example.com sont autorisés (ils correspondent aux sous-domaines,
pas au domaine racine) ; les jokers seuls tels que * sont refusés.
localhost et 127.0.0.1 sont toujours autorisés, afin que le développement local
fonctionne sans avoir à les répertorier.3
Nommez-le, activez-le et créez-le
Le bouton Activer le widget contrôle si la clé accepte
les sessions — vous pouvez créer un widget désactivé et l’activer au lancement.
Récupérer le code d’intégration
Juste après la création (ou via le bouton Intégrer de chaque ligne), une boîte de dialogue d’intégration génère du code prêt à coller avec votre clé publiable déjà renseignée :- React — un extrait
<ThunderPhoneWidget />pour les applications avec bundler. - Balise script — une paire
<script>CDN + feuille de style pour tout site.
Les clés publiables (
pk_live_…) sont publiques par conception — elles peuvent être incluses
sans risque dans le code front-end. Copiez-en une à tout moment avec le bouton de copie de sa ligne.Gérer les widgets depuis la liste
Chaque ligne se modifie sur place :- Mode / Agent — basculez entre le mode agent et le mode webhook, ou modifiez l’agent, avec des sélecteurs intégrés.
- Domaines — ajoutez ou supprimez des domaines autorisés sous forme d’étiquettes.
- Activer/désactiver — un interrupteur par widget ; les widgets désactivés cessent immédiatement d’accepter les sessions.
- Transférer vers une organisation — copiez ou déplacez le widget vers une autre organisation à laquelle vous appartenez (le déplacement le supprime d’ici).
- Supprimer — révoque la clé publiable ; le widget cesse de fonctionner immédiatement sur tous les domaines. Cette action est irréversible.
Étapes suivantes
Référence du SDK de widget
Détails sur le composant React, le hook headless et le script CDN.
Routage en mode webhook
Renvoyez la configuration de l’agent par visiteur depuis votre serveur.