Enrichir les informations des ventes clés avec les informations 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.]
Les vendeurs peuvent utiliser Copilot pour les ventes tout en lisant et en rédigeant des courriers électroniques dans Outlook pour afficher des informations commerciales clés sur les contacts, les comptes et les opportunités liés au courrier électronique. Les informations clés sur les ventes sont basées sur l’une des sources suivantes :
- Opportunité connectée au courrier électronique
- Opportunité la plus pertinente, en fonction des contacts et des comptes dans le courrier électronique
Vous pouvez développer la fonctionnalité d’informations de ventes clés fournie par Copilot pour les ventes avec les informations de votre propre application.
Description de l’API
Vous devez ajouter la description de l’API suivante à l’action. De cette façon, Copilot pour les ventes peut identifier l’API correcte qui doit être appelée pour enrichir la fonctionnalité.
Cette action obtient des informations supplémentaires sur les ventes qui seront affichées dans la fiche de renseignements des ventes clés C4S dans l’assistant Outlook. L’action améliore les compétences existantes de Copilot pour les ventes.
Paramètres d’entrée
Copilot pour les ventes est conçu pour fournir les paramètres d’entrée suivants à vos API.
| Nom | Type/Format de données | Requise | Informations | Description à ajouter à l’action |
|---|---|---|---|---|
| recordType | Chaîne | Oui | Type d’enregistrement dans la gestion de la relation client (CRM). L’enregistrement peut préciser le compte, l’opportunité, le prospect ou le contact lié au courrier électronique. | Cette entrée identifie le type d’enregistrement dans CRM pour lequel des informations de vente clés sont demandées. |
| recordId | Chaîne | Oui | ID de l’enregistrement dans le CRM. | Cette entrée fournit l’identifiant unique de l’enregistrement de CRM pour lequel les informations de vente clés sont demandées. |
| crmType | Chaîne | Non | Type du système de CRM. Les valeurs valides sont Salesforce et Dynamics 365. | Cette entrée indique le type de CRM dans lequel existe l’enregistrement CRM, pour lequel les informations de vente clés sont demandées. |
| crmOrgUrl | Chaîne | Non | URL de l’organisation du CRM. | Cette entrée indique l’URL de l’environnement de CRM dans lequel existe l’enregistrement CRM, pour lequel les informations de vente clés sont demandées. |
| haut | Entier | Non | Nombre d’informations à récupérer. | Cette entrée indique le nombre de points clés de vente à récupérer. |
| ignorer | Entier | Non | Nombre d’informations à ignorer. | Cette entrée indique le nombre d’éléments à ignorer lors de la récupération des informations clés de vente. |
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. |
| hasMoreResults | Valeur booléenne | Non | Valeur qui indique si plus de résultats sont disponibles. |
Schéma informatif
| Nom | Type/Format de données | Requise | Informations | Description à ajouter à l’action |
|---|---|---|---|---|
| titre | Chaîne | Oui | Titre de la carte de citation d’aperçu des ventes. Il ne doit inclure que le nom du partenaire et peut comporter jusqu’à 20 caractères. | Cette sortie indique le titre de la carte de citation pour l’aperçu. |
| description | Chaîne | Oui | Description de l’aperçu des ventes. Il s’affiche sous forme de puce dans le volet Informations clés sur les ventes et peut comporter jusqu’à 130 caractères. Voici un exemple : Validation : Prochaines étapes : S’aligner sur le calendrier et les critères de réussite. | Cette sortie indique le texte de l’aperçu à inclure dans les informations de vente clés. |
| url | Chaîne | Non | URL valide pour ouvrir l’aperçu dans l’application partenaire. | Ce résultat indique l’URL permettant d’en savoir plus sur l’aperçu. |
| dateTime | DateHeure | Non | Date et heure de l’activité au format UTC. Si l’activité a à la fois une heure de début et une heure de fin, l’application doit déterminer l’heure à afficher. Le format est conforme aux spécifications OpenAPI. Prenons un exemple : 2017-07-21T17:32:28Z. | Ce résultat indique l’heure associée à l’aperçu. |
| additionalProperties | Objet ayant les valeurs Nom de propriété et Valeur de propriété du type Chaîne | Non | Un ensemble de paires nom-valeur qui indique des propriétés supplémentaires de l’aperçu associé renvoyé par l’action. Ces informations s’affichent dans une carte contextuelle lorsque les utilisateurs sélectionnent des informations dans le volet Informations clés sur les ventes. | Ce résultat indique des propriétés supplémentaires sous forme de paires nom-valeur de chaque aperçu associé renvoyé par l’action. |
Exemple
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
L’image suivante montre un exemple de la façon dont la sortie de l’API est mappée aux informations clés sur les ventes.
Légende :
- Section affichant les informations de l’application partenaire. Le titre de la section est dérivé du nom du connecteur Microsoft Power Platform.
- Descriptions de l’aperçu de la réponse de l’API.
- Numéros de citation qui peuvent être sélectionnés pour afficher les détails de l’aperçu.
- Carte de citation montrant des détails sur l’aperçu.
- Icône et titre de l’aperçu. L’icône est récupérée à partir des métadonnées du connecteur Microsoft Power Platform. Le titre correspond au titre de l’aperçu provenant de la réponse de l’API.
- Propriétés supplémentaires de l’aperçu provenant de la réponse de l’API.
- Nom de l’application partenaire. Le nom affiché est le nom du connecteur Microsoft Power Platform.
- Lien qui peut être sélectionné pour afficher les détails des informations dans l’application partenaire. Il est basé sur l’URL de l’aperçu dans la réponse de l’API.
Informations associées
Vue sur les infos ventes clés dans Copilot pour les ventes
Enrichir le résumé des courriers électroniques avec les informations de votre application
Enrichir les brouillons de courriers électroniques avec des liens de fichiers à partir 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
Créer des extensions Copilot pour les ventes