Architecture de plugin extensible — Construisez des capacités personnalisées (futur)

Chaque entreprise a des besoins uniques que les solutions génériques ne peuvent pas pleinement adresser. Le système de plugin prévu permettra aux développeurs d'étendre la fonctionnalité du widget avec des capacités personnalisées — sans forker le code ou perdre les chemins de mise à jour.

Pourquoi les plugins sont importants pour les cas d'utilisation avancés

Les widgets standard ne peuvent pas prédire chaque exigence commerciale. Vous pourriez avoir besoin de :

• Analyse de sentiment pour diriger les clients en colère vers des agents humains
• Intégration CRM pour enrichir les conversations avec l'historique d'achat des clients
• Modération personnalisée pour faire respecter des politiques de contenu spécifiques à la marque
• Rendus spécialisés pour des données spécifiques à l'industrie (tableaux médicaux, graphiques financiers, citations légales)
• Déclencheurs d'automatisation de flux de travail (créer un ticket de support lorsque certains mots-clés apparaissent)

Hooks de cycle de vie pour une intégration propre

Les plugins s'enregistrent lors de l'initialisation du widget et reçoivent des rappels à des moments clés du cycle de vie :

• onBeforeMessageSend — prétraiter les messages utilisateur avant de les envoyer au backend
• onAfterMessageReceive — post-traiter les réponses IA avant le rendu
• onConversationStart — initialiser l'état du plugin lorsque la conversation commence
• onConversationEnd — nettoyer les ressources, enregistrer les analyses
• onWidgetOpen / onWidgetClose — suivre l'engagement, déclencher des effets secondaires
• onError — gestion ou rapport d'erreurs personnalisés

Préprocesseurs et postprocesseurs de messages

Préprocesseurs modifient les messages utilisateur avant l'envoi :
- Vérification orthographique et correction automatique
- Filtre de grossièretés ou modération de contenu
- Extraction de données (détecter les e-mails, numéros de téléphone, ID de commande)
- Détection de sentiment

Postprocesseurs modifient les réponses IA avant le rendu :
- Amélioration Markdown (convertir des tableaux en composants interactifs)
- Enrichissement de liens (aperçu des URL, dépliage des métadonnées)
- Filtrage de conformité (rédaction de PII, données financières sensibles)

Sécurité par le sandboxing

Les plugins ne peuvent pas compromettre la sécurité ou la stabilité du widget :

• Les plugins s'exécutent dans des espaces JavaScript isolés (ne peuvent pas accéder aux variables globales ou polluer l'espace de noms)
• L'accès API est restreint (les plugins ne peuvent appeler que des domaines sur liste blanche)
• L'accès DOM est limité (les plugins ne peuvent pas modifier l'UI du widget en dehors des zones de rendu désignées)
• Le temps d'exécution est limité (les plugins de longue durée sont terminés pour éviter les gels de l'UI)

Exemple de configuration

WidgetSDK.registerPlugin({
  name: 'sentiment-analyzer',
  version: '1.0.0',
  hooks: {
    onBeforeMessageSend: async (message, context) => {
      const sentiment = await analyzeSentiment(message.text);
      return { ...message, metadata: { sentiment } };
    },
    onAfterMessageReceive: (message, context) => {
      if (message.metadata?.sentiment < -0.5) {
        context.escalateToHuman(message);
      }
      return message;
    }
  }
});