@ourlu/assistant-spip

Plugin SPIP pour intégrer l'assistant IA Ourlu sur les sites de collectivités.

Installation

Depuis npm (téléchargement)

npm pack @ourlu/assistant-spip

Dézippez l'archive et placez le contenu dans plugins/ourlu_chatbot/.

Installation manuelle

1. Copiez le dossier complet dans plugins/ourlu_chatbot/
2. Activez le plugin dans Configuration > Gestion des plugins

Configuration

1. Allez dans Configuration > Ourlu Chatbot
2. Renseignez :

| Champ | Description | |-------|-------------| | Tenant ID | Identifiant de votre collectivité (fourni par Ourlu) | | Clé publique widget | Clé wpk_... visible dans votre espace admin Ourlu |

3. Validez le formulaire

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é SPIP)
• 📱 Responsive mobile et desktop
• 🛡️ Protection anti-bot Cloudflare Turnstile (optionnelle)
• ♿ Accessible (navigation clavier)

Compatibilité

• SPIP 4.x
• PHP 7.4+

Fonctionnement

Le plugin injecte un tag <script> via le pipeline insert_head :

<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 plugin n'est nécessaire lors d'un changement de design.

Sécurité & RGPD

• Aucun cookie tiers
• Aucune donnée personnelle stockée côté plugin
• 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.