Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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. L’application Sales 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é récapitulative des enregistrements CRM que l’application Sales fournit avec des insights à partir de votre propre application.
Description de l’API
Vous devez ajouter la description de l’API suivante à l’action. De cette façon, l’application Sales peut identifier l’API appropriée 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.
Opération API
Cette API utilise le type d’opération : GET
Paramètres d’entrée
L’application Sales est conçue pour fournir les paramètres d’entrée suivants à vos API.
| Nonm | Type/Format de données | Requise | Informations | Description à ajouter à l’action |
|---|---|---|---|---|
| type d’enregistrement | String | 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 | String | 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. |
| top | 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. |
| type de CRM | String | 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 | String | 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
L’application Sales s’attend à recevoir une liste d’insights (objets) de vos API, et chaque insight doit avoir des paramètres spécifiques. Pour vous assurer que l’application Sales peut analyser correctement la sortie, la structure de réponse doit respecter les instructions du tableau suivant.
| Paramètre | Type de données | Requise | Informations |
|---|---|---|---|
| value | Tableau | Oui | Liste d’informations (objets) définis comme décrit dans la section Schéma des informations. |
| 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 |
|---|---|---|---|---|
| titre | String | 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 | String | 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. |
| date et heure | 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 | String | 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 des insights sur les opportunités avec des données de votre application
Enrichir les détails de l’enregistrement de CRM avec les informations de votre application
Étendre les ventes dans Microsoft 365 Copilot avec des applications partenaires
Créer des extensions pour Sales dans Microsoft 365 Copilot