CatéGPT
Documentation

Widget — chat & card à intégrer

Ajoutez l'assistant CatéGPT à n'importe quel site. Deux façons d'afficher le chat — vous pouvez utiliser les deux. Sous WordPress, TYPO3 ou PrestaShop, les plugins CMS font tout cela sans toucher au code.

A · Bulle flottanteCatéGPTB · Chat intégré
Deux modes : une bulle en bas de page, ou le chat directement dans une page.
ℹ️
Pour obtenir une clé de site, connectez-vous et ouvrez la page Intégrer le plugin. Voir aussi la documentation API.

A · Bulle flottante

<script
  src="https://categpt.chat/embed/widget.js"
  data-site-key="cgpt_site_VOTRE_CLE"
  data-language="fr"
  data-accent="#f9af19"></script>

Collez ce code tout en bas de vos pages (juste avant </body>) ou via Google Tag Manager.

B · Chat intégré dans une page

<div data-categpt-inline
  data-site-key="cgpt_site_VOTRE_CLE"
  data-language="fr"
  data-height="600"></div>
<script src="https://categpt.chat/embed/widget.js" defer></script>

Collez ce bloc à l'endroit exact où le chat doit apparaître.

Attributs

AttributDéfautDescription
data-site-keyClé de site (obligatoire).
data-languagelangue du navigateurfr, en, de, it, es, pt, pl.
data-accent#f9af19Couleur d'accent.
data-ink#0a1733Couleur d'encre (textes et en-tête).
data-positionrightright ou left (bulle).
data-height520Hauteur du chat intégré (px).
data-ordobothboth, nom, vom — quelle(s) fête(s) l'en-tête du chat annonce les jours où le Novus Ordo et le Vetus Ordo célèbrent des fêtes différentes. both les affiche sur deux lignes, chacune avec sa pastille de couleur liturgique et son lien permanent. Une valeur inconnue vaut both.

Card « Saint du jour » (gratuite, sans compte)

Affichez le saint et la fête du jour (pastille de la couleur liturgique, nom de la fête, court extrait, lien vers la page du jour) sur n'importe quel site. Contrairement au chatbot, cette card est entièrement gratuite : aucune clé de site, aucun compte.

<script src="https://categpt.chat/embed/saint-card.js" data-locale="fr" data-ordo="both" defer></script>
<div data-categpt-saint-card></div>

Le bloc <div data-categpt-saint-card> marque l'emplacement de la card ; s'il est absent, elle s'insère juste après la balise <script>. La date affichée suit le fuseau horaire du visiteur ; si les données du jour sont indisponibles, la card ne s'affiche simplement pas.

AttributDéfautValeurs
data-localefrfr, en, de, it, es, pt, pl.
data-ordobothboth, nom, vom — quel(s) ordo(s) la card affiche les jours où le Novus Ordo et le Vetus Ordo célèbrent des fêtes différentes. Une valeur inconnue vaut both.

Les deux attributs se posent sur la balise <script> ; chaque emplacement data-categpt-saint-card peut les redéfinir avec le même attribut, ce qui permet d'afficher plusieurs cards réglées différemment sur une même page.

Quand le jour dispose des données du Vetus Ordo Missae (calendrier de 1960), la card s'adapte : les deux ordos sont toujours présentés séparément, chacun avec son nom, sa classe (ex. « 3e classe ») et son lien permanent — y compris lorsqu'ils célèbrent le même saint, car ils n'en ont ni le même rang ni le même texte. data-ordo permet de n'en afficher qu'un. Chaque fête porte sa propre description courte, sous son nom.

💡
La card se nourrit de l’API gratuite de la fête du jour — la même que vous pouvez appeler directement.

Sécurité

ℹ️
La clé publiable (cgpt_site_…) est verrouillée sur les domaines que vous indiquez : elle ne fonctionne que sur vos sites. Pour un modèle serveur, le plugin WordPress peut utiliser une clé secrète (mode proxy) qui n’est jamais exposée au navigateur.

Continuité vers categpt.chat

Le widget répond de façon concise et propose de voir la réponse complète et de continuer la conversation sur categpt.chat. Le visiteur y arrive « frais » (les 3 questions anonymes ne sont pas entamées par ce passage).

Facturation

À la consommation (prépayé ou abonnement selon votre contrat). Le suivi se fait dans la console CatéGPT.

Confidentialité

ℹ️
Le widget ne dépose aucun cookie. Les questions sont conservées de façon pseudonymisée. L’attribution « Propulsé par CatéGPT » fait partie du widget.

Dépannage

Le widget n'apparaît pas. Vérifiez que la clé de site est correcte et que le domaine du site figure bien dans la liste des origines autorisées de votre clé.

« origin_not_allowed ». Le domaine d'où part la requête n'est pas autorisé pour cette clé — indiquez-le à l'équipe CatéGPT.

Le chat intégré ne s'affiche pas. Assurez-vous que le bloc <div data-categpt-inline> et la balise <script> sont tous deux présents, et que votre éditeur n'a pas échappé le HTML (utilisez le mode code / HTML).

Rien ne se passe au clic. La clé est peut-être suspendue ou le solde épuisé — vérifiez dans la console CatéGPT.

Aller plus loin

Widget · CatéGPT