Enrichir les résumés de l’enregistrement de CRM avec 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.]
Pour mieux comprendre le contexte d’une réunion à laquelle ils se préparent ou d’un courrier électronique qu’ils lisent, les commerciaux veulent des informations pertinentes sur la gestion de la relation client (CRM), telles que les requêtes, les préoccupations et les notes des clients. Copilot pour les ventes utilise l’IA pour générer un résumé de chaque enregistrement CRM. Ce résumé met en évidence des détails cruciaux, tels que l’étape de vente, le budget et la date de clôture prévue. Vous pouvez étendre la fonctionnalité de résumé d’enregistrement de CRM 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 permet d’obtenir des informations supplémentaires sur les ventes liées à un enregistrement CRM qui seront affichées dans la fiche récapitulative de l’enregistrement C4S. 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’entité ou d’objet dans CRM pour lequel des informations associées telles que des activités sont demandées. La valeur inclut le nom unique de l’entité ou du type d’objet, sans langue indépendante, et non le nom complet qui peut être localisé. Parmi des exemples figurent compte et opportunité. | Cette entrée indique le type d’entité ou d’objet dans CRM pour lequel des informations associées sont demandées. |
| recordId | Chaîne | Oui | Identificateur unique de l’enregistrement CRM. | Cette entrée fournit l’identifiant unique de l’enregistrement de CRM pour lequel les informations sont demandées. |
| startDateTime | Chaîne au format « date/heure » | Non | Date et heure de début de recherche d’informations. Le format est conforme aux spécifications OpenAPI. Prenons un exemple : 2017-07-21T17:32:28Z. | Cette entrée indique la date et l’heure de début des informations demandées. |
| endDateTime | Chaîne au format « date/heure » | Non | Date et heure de fin de recherche d’informations. Le format est conforme aux spécifications OpenAPI. Prenons un exemple : 2017-07-21T17:32:28Z. | Cette entrée indique la date et l’heure de fin des informations demandées. |
| haut | Entier | Non | Nombre d’informations à récupérer. | Cette entrée indique le nombre d’informations à récupérer. |
| ignorer | Entier | Non | Nombre d’informations à ignorer. | Cette entrée indique le nombre d’informations à ignorer. |
| crmType | Chaîne | Non | Les valeurs valides sont Dynamics 365 et Salesforce. | Cette entrée indique le type de CRM dans lequel existe l’enregistrement CRM, pour lequel les informations sont demandées. |
| crmOrgUrl | Chaîne | Non | Nom d’hôte de l’organisation CRM, par exemple contoso.crm.dynamics.com. | Cette entrée indique l’URL de l’environnement de CRM dans lequel existe l’enregistrement CRM, pour lequel les informations sont demandées. |
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 l’aperçu dans la carte de citation. Il s’agit du titre en langage naturel de l’aperçu dans la langue spécifiée dans l’en-tête de la requête Accept-Language. Voici un exemple : Contrat signé. |
Cette sortie indique le titre de l’activité dans la carte de citation. |
| description | Chaîne | Oui | La description de l’aperçu. Il est affiché sous forme de puces dans le résumé de l’enregistrement et constitue la description en langage naturel de l’aperçu dans la langue spécifiée dans l’en-tête Accept-Language. Voici un exemple : Kenny, Logan et deux autres ont signé le contrat de renouvellement Contoso 2023 le 07/09/2023. |
Cette sortie indique la description de l’aperçu. |
| dateTime | Chaîne au format « date/heure » | Oui | 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. |
| url | Chaîne | Non | URL valide pour ouvrir l’activité dans l’application partenaire. | Cette sortie indique l’URL pour ouvrir l’aperçu. |
| additionalProperties | Objet ayant les valeurs Nom de propriété et Valeur de propriété du type Chaîne | Non | Propriétés supplémentaires affichées dans la vue détaillée. Les noms de propriété et les valeurs sont en langage naturel dans la langue spécifiée dans l’en-tête { |
Cette sortie indique des propriétés supplémentaires affichées dans la vue détaillée de l’aperçu. |
Remarque
Même si les exigences de l’API pour étendre les fonctionnalités de résumé des courriers électroniques et de résumé des enregistrements peuvent sembler similaires, elles doivent être ajoutées en tant qu’actions distinctes dans le connecteur.
Exemple
{
"value": [
{
"title": "Contract signed",
"description": "You have 5 connections in Fourth Coffee Inc",
"dateTime": "2024-05-07T03:28:38.0667701Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
},
{
"title": "Contract signed",
"description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
"dateTime": "2024-05-07T03:28:38.0669445Z",
"url": null,
"additionalProperties": {
"Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
"Signed by": "Alberto Burgos, Tony",
"Signed": "9/7/23"
}
}
],
"hasMoreResults": false
}
L’image suivante affiche un exemple de la manière dont le résultat de l’API est mappé au résumé de l’enregistrement.
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 texte du titre est le 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
Afficher le résumé des enregistrements
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 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
Étendre Microsoft 365 Copilot pour les ventes avec des applications partenaires
Créer des extensions Copilot pour les ventes