Fonctionnalité: Extensions Rainbow / custo-manifest
Disponibilité: Rainbow Web et Rainbow Desktop prennent en charge les événements PBX, les boutons, les affichages et les extensions d’affichage de cadres. L’exécution d’applications natives ou de scripts reste réservée à la version Desktop.
Cet article vous permettra de comprendre comment les extensions Rainbow, également appelées extensions « custo-manifest », relient Rainbow Web et Rainbow Desktop à vos applications métier. Vous découvrirez ce qu’un manifeste peut apporter à Rainbow, quelles familles d’extensions sont disponibles et comment procéder en fonction de votre cas d’utilisation.
Ce que vous pouvez créer
| Famille d’extensions | Fonctionnalités | Cas d’utilisation type |
|---|---|---|
| Événements | Exécute automatiquement une action lorsqu'un événement d'appel PBX se produit. | Ouvrir une fiche CRM lorsqu’un appel entrant sonne, enregistrer les données de l’appel, enrichir un ticket. |
| Boutons | Ajoute des actions cliquables à différents endroits de l’interface utilisateur de Rainbow. | Créez un ticket à partir d’un contact, ouvrez la page d’un client à partir du journal des appels. |
| Affichage | Affiche automatiquement du contenu contextuel. | Affichez les notes CRM, le statut d'assistance ou un résumé client dans Rainbow. |
| Affichage dans un cadre | Ouvre une application Web tierce dans Rainbow ou dans une fenêtre contextuelle du navigateur. | Intégrez une application métier ou lancez-la avec le contexte utilisateur de Rainbow. |
Comportement sur le Web et sur le bureau
| Fonctionnalité | Rainbow Web | Rainbow Desktop |
|---|---|---|
| Appels REST | Prise en charge. Le service distant doit passer les contrôles de domaine de confiance et CORS. | Prise en charge. Le CORS peut encore avoir une incidence lorsque le navigateur intégré est utilisé. |
| Ouvrir une page Web | Prise en charge. | Prise en charge. |
commandType : « file » avec un fichier compressé au format ZIP |
Pris en charge pour les scénarios de lecture/affichage de fichiers. | Prise en charge. |
| Exécuter une application native ou un script | Non pris en charge. | Pris en charge uniquement sur ordinateur de bureau. |
| Accès au réseau local/privé | Soumis aux règles d’accès au réseau local (LNA) du navigateur. | N'est pas soumis aux règles d'accès au réseau local (LNA) du navigateur de la même manière. |
Ordre de lecture recommandé
Utilisez les articles de cette section comme un ensemble de documentation à plusieurs niveaux : commencez par les concepts, puis consultez les articles de référence lorsque vous créez ou dépannez un manifeste.
- Commencez par cette présentation générale.
- Lisez la section « Comprendre la structure du fichier custo-manifest » pour comprendre l’enveloppe JSON et les clés des points d’extension.
- Utilisez « Automatisation des événements d’appel PBX » ou « Création d’extensions de l’interface graphique Rainbow » en fonction du type d’intégration.
- Utilisez les références « Champs d’action et objet de commande » et « Variables Rainbow » lors de la modification du JSON.
- Utilisez « Affichage des résultats des extensions avec Markdown, JSON et Adaptive Cards » lorsqu’une extension renvoie du contenu visible.
- Terminez par les sections « Déploiement d’un fichier custo-manifest » et « Gestion des domaines de confiance et de la sécurité réseau ».
Package et déploiement
Un manifeste peut être déployé sous la forme d’un fichier JSON unique ou d’une archive ZIP. Utilisez une archive ZIP lorsque le manifeste fait référence à des ressources locales telles que des icônes, des scripts, des fichiers HTML ou des fichiers lus via ${custo.path}.
« jsonType » : « Rainbow-custo-manifest ». Conservez un seul manifeste valide à la racine de l’archive, sauf si votre procédure de déploiement prend explicitement en charge une autre structure.