@ourlu/assistant-drupal
v0.2.0
Published
Module Drupal pour l'assistant IA Ourlu Mairie.
Maintainers
Readme
@ourlu/assistant-drupal
Module Drupal pour intégrer l'assistant IA Ourlu sur les sites de collectivités.
Installation
Depuis npm (téléchargement)
npm pack @ourlu/assistant-drupalDézippez l'archive et placez le contenu dans modules/custom/ourlu_chatbot/.
Installation manuelle
- Copiez le dossier complet dans
modules/custom/ourlu_chatbot/ - Activez le module : Extend > Ourlu Chatbot
- Ou via Drush :
drush en ourlu_chatbot
Configuration
- Allez dans Configuration > Ourlu Chatbot (
/admin/config/services/ourlu-chatbot) - Renseignez :
| Champ | Description |
|-------|-------------|
| Tenant ID | Identifiant de votre collectivité (fourni par Ourlu) |
| Clé publique widget | Clé wpk_... visible dans votre espace admin Ourlu |
- Cliquez sur Enregistrer la configuration
L'assistant apparaît automatiquement en bas à droite de votre site.
Fonctionnalités
- 💬 Chat textuel avec IA en temps réel
- 🎙️ Entrée vocale avec transcription automatique
- 🎨 Thème personnalisable depuis l'espace admin Ourlu (aucune modification côté Drupal)
- 📱 Responsive mobile et desktop
- 🛡️ Protection anti-bot Cloudflare Turnstile (optionnelle)
- ♿ Accessible (navigation clavier)
Compatibilité
- Drupal 9.x, 10.x, 11.x
- PHP 8.1+
Fonctionnement
Le module injecte un tag <script> dans le <body> de chaque page via hook_page_attachments_alter :
<script
src="https://occe.ourlu.fr/v1/widget/runtime/loader.v1.js"
data-tenant-id="votre-tenant-id"
data-widget-key="wpk_votre_cle"
data-api-base-url="https://occe.ourlu.fr"
async
></script>Le thème, la mascotte, les couleurs et les textes sont gérés dynamiquement depuis votre espace d'administration Ourlu. Aucune mise à jour du module n'est nécessaire lors d'un changement de design.
Permissions
| Permission | Description |
|-----------|-------------|
| administer ourlu chatbot | Accéder à la page de configuration du module |
Sécurité & RGPD
- Aucun cookie tiers
- Aucune donnée personnelle stockée côté module
- Compatible CSP stricte
- Anonymisation native des données personnelles (PII masking)
Support
- Documentation : espace admin Ourlu > Intégration
- Contact technique : [email protected]
Licence
Propriétaire — Ourlu SAS. Usage réservé aux collectivités clientes.
