Enrichir le résumé de courrier électronique avec des suggestions de contenu à partir de votre application (version préliminaire)

Important

• Il s’agit d’une fonctionnalité d’évaluation prête pour la production.
• Les versions préliminaires prêtes pour la production sont soumises à des conditions d’utilisation supplémentaires.

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Lorsque Copilot dans Outlook et Copilot pour les ventes sont utilisés ensemble, les résumés de courrier électronique affichés dans Outlook incluent des informations de vente provenant de votre système de gestion de la relation client (CRM), tel que Dynamics 365 ou Salesforce CRM. Vous pouvez étendre la fonctionnalité de résumé des courriers électroniques fournie par Copilot pour les ventes avec les informations de votre propre application.

Nonte

Cette API remplace l’API Compétence de résumé de courrier électronique existante (ID d’opération : scp-get-email-insights) par une nouvelle version.

Description de l’API

Vous devez ajouter la description de l’API suivante à l’action. Cela aide Copilot pour les ventes à identifier l’API correcte à invoquer pour enrichir la fonctionnalité.

Cette action obtient des informations supplémentaires sur les ventes qui seront affichées dans l’expérience de résumé de courrier électronique C4S dans le résumé Outlook. L’action améliore les compétences existantes de Copilot pour les ventes.

Détails API

• Nom de l’API : compétence de résumé de courrier électronique version 2
• ID de l’opération Swagger : scp-get-email-insights-v2
• Méthode de l’opération Swagger : post
• Chemin d’accès : <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Charge utile d’entrée

Cette charge utile sert de corps de la demande d’API.

Nonm	Type de données	Requise	Informations	Description à ajouter à l’action
resourceData	Objet	Oui	Données de ressource à utiliser pour récupérer le contenu suggéré. Pour la structure des données, accédez à Modèle de données de courrier électronique pour l’extensibilité.	Cette entrée identifie le contenu du courrier électronique, qui est une collection de fil de discussion par courrier électronique, d’objets et d’autres détails.
entités liées	Tableau	Non	Tableau des entités associées. Pour la structure de données, accédez à Modèle de données d’entité associé.	Cette entrée identifie le tableau d’enregistrements CRM, qui est lié au fil de discussion de messagerie.
type de CRM	Chaîne	Non	Le type de système CRM, s’il est connecté. Les valeurs valides sont Salesforce et Dynamics 365.	Cette entrée indique le type de CRM dans lequel l’enregistrement associé au fil de discussion de courrier électronique existe.
crmOrgUrl	Chaîne	Non	URL de l’organisation du CRM.	Cette entrée indique l’URL de l’environnement de CRM dans lequel l’enregistrement associé au fil de discussion de courrier électronique existe.
Haut de page	Nombre entier	Non	Nonmbre d’éléments à récupérer.	Cette entrée indique le nombre de liens de fichiers à récupérer.
ignorer	Nombre entier	Non	Nonmbre d’éléments à ignorer.	Cette entrée indique le nombre d’éléments à ignorer lors de la récupération de liens de fichiers.

Modèle de données d’extensibilité des courriers électroniques

Propriété	Catégorie	Informations	Description à ajouter à l’action
plaintextBody	Chaîne	Le corps complet de l’e-mail comprend tous les messages précédents du fil de discussion.	Cette entrée fournit tout le contenu du fil de discussion par courrier électronique au format texte.
fullHtmlBody	Chaîne	La version HTML complète du corps de l’e-mail qui inclut tous les messages précédents du fil de discussion de l’e-mail.	Cette entrée fournit tout le contenu du fil de discussion par courrier électronique au format HTML.
objet	Chaîne	Objet du courrier électronique.	Cette entrée fournit l’objet du courrier électronique.
de	Chaîne	Adresse e-mail de l’expéditeur.	Cette entrée fournit l’adresse e-mail de l’expéditeur.
à	Chaîne[]	Adresses e-mail du destinataire.	Cette entrée fournit l’adresse e-mail du destinataire.
cc	Chaîne[]	Adresses e-mail du destinataire ajoutées dans le champ Cc de l’e-mail.	Cette entrée fournit toutes les adresses e-mail du destinataire qui sont incluses dans le champ Cc du courrier électronique.
bcc	Chaîne[]	Adresses e-mail du destinataire ajoutées dans le champ Cci de l’e-mail.	Cette entrée fournit toutes les adresses e-mail du destinataire qui sont ajoutées dans le champ Cci du courrier électronique.
sentDateTime	DateTimeOffset	La date et l’heure de l’e-mail au format UTC, ainsi que la propriété Offset. Pour plus d’informations, accédez à DateTimeOffset Struct (système)	Cette entrée fournit l’horodatage du courrier électronique.
messageId	Chaîne	ID de message Graph du courrier électronique.	Cette entrée fournit l’ID du message du Courrier électronique.
ID de conversation	Chaîne	ID de la conversation Graph du fil de discussion de messagerie.	Cette entrée fournit l’ID de conversation du fil de discussion par courrier électronique.

Modèle de données d’entité associé

Propriété	Catégorie	Requise	Informations	Description à ajouter à l’action
identifiant d'entité	Chaîne	Oui	Le type d’enregistrement CRM tel que compte ou opportunité.	Cette entrée fournit le l’identificateur unique de l’enregistrement CRM associé au fil de discussion par courrier électronique.
type d'entité	Chaîne	Oui	Identificateur unique de l’enregistrement CRM à utiliser pour les contenus suggérés.	Cette entrée identifie le type d’enregistrement dans CRM associé au fil de discussion par courrier électronique.
entitySource	Chaîne	Non	Cette entrée indique la source de l’entité, qui contient actuellement des valeurs « connectées » ou vides.	Cette entrée indique le type de source de l’entité.

Paramètres de sortie

Copilot pour les ventes s’attend à recevoir une liste d’informations (objets) de vos API et s’attend à ce que chaque information ait des paramètres spécifiques. Pour garantir que Copilot pour les ventes puisse analyser correctement le résultat, il est crucial de suivre la structure de réponse décrite ci-dessous comme décrit dans la table suivante.

Paramètre	Type de données	Requise	Informations
valeur	Tableau	Oui	Liste d’informations (objets) définis comme décrit dans la section Schéma des informations. Remarque : bien que ce paramètre inclue une liste d’informations, seule la première information est utilisée dans le résumé d’enrichissement du courrier électronique pour l’expérience de canevas Outlook.
aPlusDeRésultats	Valeur booléenne	Non	Valeur qui indique si plus de résultats sont disponibles.

Schéma informatif

Nonm	Type/Format de données	Requise	Informations	Description à ajouter à l’action
information	Chaîne	Oui	Les informations fournies aux utilisateurs, tels que Vos collègues Mona Kane, Ray Tanaka et Daniela Smith ont déjà travaillé avec eux.	Ce résultat indique le texte que vous souhaitez inclure dans le résumé du courrier électronique.

Exemple

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}
 

L’exemple d’image suivante montre comment la sortie de l’API est mappée au résumé de courrier électronique dans le volet latéral.

Légende :

1. Titre de l’aperçu. Les aperçus avec le même titre sont regroupés.
2. Descriptions de l’insight. Chaque aperçu a une description.

L’exemple d’image suivante montre comment la sortie de l’API est mappée au résumé de l’e-mail dans le corps de l’e-mail.

Légende :

1. Titre de l’aperçu. Les aperçus avec le même titre sont regroupés.
2. Description de l’aperçu. Chaque aperçu a une description.

Informations associées

Résumer un fil de discussion à l’aide d’informations de vente avec Copilot dans Outlook
Enrichir les informations des ventes clés avec les informations de votre application
Enrichir les détails de l’enregistrement de CRM avec les informations de votre application
Enrichir les résumés de l’enregistrement de CRM avec les informations de votre application
Étendre Microsoft 365 Copilot pour les ventes avec des applications partenaires
Enrichir les brouillons de courriers électroniques avec des liens de fichiers à partir de votre application
Créer des extensions Copilot pour les ventes