Tester votre assistant avant la mise en ligne
Testez votre vrai assistant, ancré dans votre vrai contenu, depuis votre application locale ou de staging, sans consommer la moindre conversation facturée. Quand il répond comme vous le voulez, activez-le et publiez le snippet normal.
Le test sandbox est une fonctionnalité preview. Si les étapes ci-dessous ne fonctionnent pas encore, c’est simplement qu’elle n’est pas activée dans votre environnement : demandez-nous de l’activer.
Comment ça marche
Le sandbox pointe votre assistant vers votre propre page de dev ou de staging avec un preview token à durée de vie courte. Le trafic qui passe par ce token :
- exécute le vrai pipeline de réponse, récupération, grounding, CTA, détection de langue, exactement ce que recevront vos visiteurs ;
- n’est jamais facturé et ne se mélange jamais à vos analytics, CSAT ou leads en production ;
- atteint votre assistant avant même sa mise en ligne, ce qui permet un test bout en bout en amont.
Étapes
1. Générer un preview token
Dans le dashboard, ouvrez l’étape Installation de votre assistant et, sous Test in your own app, cliquez sur Generate sandbox snippet. Vous obtiendrez un snippet d’intégration qui inclut data-olotalk-sandbox-token. Le token est limité à cet assistant, expire au bout de 7 jours et peut être régénéré à tout moment.
2. Le déposer dans votre application locale ou de staging
Collez le snippet sandbox dans une page en cours de développement, localhost, un preview build ou un nom d’hôte de staging :
<script
src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
data-olotalk-assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy"
data-olotalk-sandbox-token="…"
async
></script>
Vous n’avez pas besoin d’ajouter votre hôte local ou de staging dans Domaines d’installation. C’est le token qui accorde l’accès ; il fonctionne donc sur localhost et en staging sans configuration supplémentaire.
3. Tester pour de vrai
Ouvrez la page et discutez avec l’assistant. Posez les questions que poseront vos visiteurs ; vérifiez que les réponses sont ancrées dans votre contenu, que les CTA se déclenchent comme prévu et que la détection de langue se comporte correctement. Rien ici n’est facturé.
4. Passer en production
Quand le résultat vous convient, publiez l’assistant. Si votre dashboard affiche un bouton Go live, cliquez dessus. Ensuite, intégrez le snippet normal, sans sandbox token, sur votre site de production :
<script
src="https://cdn.jsdelivr.net/npm/@olotalk/assistant-loader@0/dist/loader.iife.js"
data-olotalk-assistant-id="ast_oltk_7Kd2mQxRv9TbNhLpW3Zsy"
async
></script>
Bon à savoir
- Non facturé, mais borné. Les conversations sandbox ne comptent pas dans votre plan. Elles sont rate-limitées par assistant pour qu’un token partagé ou divulgué ne puisse pas faire exploser les coûts ; si vous atteignez la limite en test, attendez quelques minutes.
- Isolé. Les chats sandbox n’apparaissent jamais dans vos conversations live, analytics ou leads. Après quelques essais, un compteur séparé sandbox test conversations apparaît sur votre page de facturation.
- Le token est un identifiant sensible. Gardez-le dans votre embed de dev ou de staging, jamais sur votre site de production. Il expire de lui-même ; régénérez-le quand vous avez besoin d’un nouveau.
- Il cesse de fonctionner sur votre site live, volontairement. Une fois l’assistant active, le sandbox token est refusé depuis toute origine enregistrée dans Domaines d’installation, et ces visiteurs reçoivent alors des conversations live normales. Donc si un snippet sandbox arrive par erreur en production, votre trafic réel continue à recevoir des réponses normales, continue à être facturé et continue à apparaître dans le dashboard ; il ne peut pas être absorbé silencieusement comme trafic de test.
- Borné par design. Ailleurs, le token fonctionne depuis n’importe quelle origine, ce qui le rend pratique sur
localhostet les preview builds sans allowlist. Il reste borné parce qu’il est limité à un seul assistant, expire automatiquement, n’est jamais facturé et reste rate-limité.
Vous préférez tester sans token ? Vous pouvez aussi charger l’assistant live sur une page de staging ou de preview que vous avez déjà allowlistée. Voir Dépannage → Tester sur une page de preview. Ces conversations comptent dans votre plan comme n’importe quel autre trafic ; le sandbox ci-dessus est la voie non facturée.