Toute la documentation

Piloter l’assistant depuis votre site

Le widget vit dans un Shadow DOM : sa feuille de style et celle de votre site ne se touchent jamais. Pour lui parler depuis votre page, il expose six méthodes sur « window.convosia ». Aucune ne lève d’exception — un appel impossible est ignoré et rend « false », pour qu’une erreur chez nous ne casse jamais le reste de votre page.

Ouvrir l’écran →

Pas à pas

01 window.convosia.ouvrir() — ouvre le panneau. Rend « false » si le widget n’est pas encore posé.
02 window.convosia.fermer() — le ferme.
03 window.convosia.ouvert() — rend « true » si le panneau est ouvert.
04 window.convosia.poser("votre question") — ouvre le panneau ET pose la question, comme si le visiteur l’avait tapée. Le message suit exactement le même chemin : mêmes garde-fous, même décompte, même trace dans vos conversations.
05 window.convosia.reserver() — ouvre l’assistant sur la prise de rendez-vous : le visiteur dit ce qu’il veut, les créneaux de VOTRE agenda arrivent, un clic réserve. C’est le geste entre « il est intéressé » et « il a payé ».
06 window.convosia.pret() — rend une promesse tenue dès que le widget peut recevoir des appels. Le script est chargé en « defer » et ouvre sa session en arrière-plan : attendre est le cas normal, pas une erreur.

Ce qui bloque souvent

APPELER « poser » TROP TÔT NE FAIT RIEN, et c’est la seule erreur qu’on voit vraiment. Passez par « pret » : window.convosia.pret().then(function () { window.convosia.poser("Vous livrez à Abidjan ?"); }). Ces six méthodes ne changeront pas de nom ni de signature : le script est posé chez des marchands qui ne le mettront jamais à jour, et une signature qui change casserait leur site en silence. C’est pour cette raison qu’il y en a six et pas trente.