Enrichir les détails 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 aperçus prêts à être produits sont soumis à 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 afficher les détails d’un contact enregistré, ainsi que les enregistrements associés tels que les comptes et les opportunités. Vous pouvez étendre la capacité des détails des enregistrements de gestion de la relation client (CRM) fournie par Copilot pour les ventes avec des informations provenant de votre propre application.
Description de l’API
Vous devez ajouter la description d’API suivante à l’action. De cette façon, Copilot pour les ventes peut identifier l’API correcte qui doit être invoquée pour enrichir la capacité.
Cette action obtient les enregistrements liés à un enregistrement CRM. L’action renforce le compétences existant de Copilot pour les ventes.
Paramètres d’entrée
Copilot for Sales est conçu pour fournir les paramètres d’entrée suivants à vos API.
| Nom | Type/format de données | Requise | Informations | Description à ajouter dans l’action |
|---|---|---|---|---|
| recordType | String | Oui | Le type d’entité ou d’objet dans CRM pour lequel des enregistrements associés sont demandés. La valeur inclut le nom unique indépendant de la langue de l’entité ou du type d’objet, et non le nom complet qui peut être localisé. Les exemples incluent compte et opportunité. | Cette entrée identifie le type d’enregistrement dans CRM pour lequel des enregistrements associés sont demandés. |
| recordId | String | Oui | L’identifiant unique de l’enregistrement CRM. | Cette entrée fournit le l’identificateur unique de l’enregistrement CRM pour lequel des enregistrements associés sont demandés. |
| top | Integer | No | Le nombre d’activités à récupérer. | Cette entrée indique le nombre d’enregistrements associés à extraire. |
| skip | Integer | No | Le nombre d’activités à ignorer. | Cette entrée indique le nombre d’enregistrements à ignorer lors de l’extraction d’enregistrements associés. |
| crmType | String | No | Le type de système CRM. Les valeurs valides sont Dynamics 365 et Salesforce. | Cette entrée indique le type de CRM à partir duquel les enregistrements associés sont extraits. |
| crmOrgUrl | String | No | Le nom de l’hôte de l’organisation CRM, tel que contoso.crm.dynamics.com. | Cette entrée indique l’URL de l’environnement CRM à partir duquel les enregistrements associés sont extraits. |
Note
Cette extension pointer prend en charge le rendu des informations provenant d’un maximum de cinq extensions de connecteur dans le sidecar Outlook.
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 la sortie, la structure réponse doit respecter les directives du tableau suivant.
| Paramètre | Type de données | Requise | Informations |
|---|---|---|---|
| value | Tableau | Oui | Une liste d’informations (objets) définies comme décrit dans la section Schéma pour les informations . |
| hasMoreResults | Valeur booléenne | No | Une valeur qui indique si d’autres résultats sont disponibles. |
Schéma pour les informations
| Nom | Type/format de données | Requise | Informations | Description à ajouter dans l’action |
|---|---|---|---|---|
| recordId | String | Oui | Identificateur unique de l’enregistrement. | Cette sortie identifie de manière unique chaque enregistrement associé renvoyé par l’action. |
| recordTypeDisplayName | String | Oui | Le nom complet du type d’enregistrement, tel que Contrat. Il doit être localisé dans la langue spécifiée via l’en-tête. Accept-Language |
Cette sortie indique le nom d’affichage du type de chaque enregistrement associé renvoyé par l’action. |
| recordTypePluralDisplayName | String | Oui | Le pluriel nom complet des type d’enregistrement, comme Contrats. Il doit être localisé dans la langue spécifiée via l’en-tête. Accept-Language |
Cette sortie indique le nom d’affichage pluriel du type de chaque enregistrement associé renvoyé par l’action. |
| recordType | String | Oui | Le nom du système du type d’enregistrement, tel que contrat. | Cette sortie indique le type de chaque enregistrement associé renvoyé par l’action. |
| recordTitle | String | Oui | Le nom de l’enregistrement, tel que Contrat de renouvellement Contoso 2023. | Cette sortie indique le titre de chaque enregistrement associé renvoyé par l’action. |
| url | String | No | Une URL valide pour ouvrir l’enregistrement dans l’application partenaire. | Cette sortie indique l’URL de chaque enregistrement associé renvoyé par l’action. |
| additionalProperties | Un objet qui a des valeurs Nom de propriété et Valeur de propriété de type Chaîne | No | Propriétés supplémentaires affichées dans la vue détaillée. Les noms et valeurs des propriétés sont en langage naturel dans la langue spécifiée via l’en-tête {
|
Cette sortie indique des propriétés supplémentaires sous forme de paires nom-valeur de chaque enregistrement associé renvoyé par l’action. |
Exemple
{
"value": [
{
"recordId": "ID1",
"recordTypeDisplayName": "Contract",
"recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
"recordTypePluralDisplayName": "Documents",
"recordType": "contract",
"url": "https://contosohub.com/contract/id1",
"additionalProperties": {
"Status": "Signed",
"Date": "9/7/23",
"Signed by": "Alberto Burgos, Tony [last name]"
}
},
{
"recordId": "ID2",
"recordTypeDisplayName": "Contract",
"recordTitle": "ABC Company 2023 Renewal Contract",
"recordTypePluralDisplayName": "Documents",
"recordType": "contract",
"url": "https://contosohub.com/contract/id2",
"additionalProperties": {
"Status": "Delivered",
"Date": "9/3/23",
"Signed by": "Alberto Burgos"
}
}
],
"hasMoreResults": false
}
L’exemple dans l’image suivante montre comment la sortie de l’API est mappée aux enregistrements associés.
Légende :
- Carte qui affiche les enregistrements associés à l’application partenaire.
- Icône et titre de la carte. L’icône est récupérée à partir des métadonnées du connecteur. Microsoft Power Platform Le titre est le nom du connecteur. Microsoft Power Platform
- Titres d’enregistrements associés de l’API réponse. Deux propriétés supplémentaires de l’API réponse sont rendues sous forme de champs clés de chaque enregistrement associé.
- Bouton "Plus d’actions" qui peut être utilisé soit pour copier un lien vers l’enregistrement, soit pour afficher les détails de l’enregistrement dans l’application partenaire. Le lien est basé sur l’URL de l’enregistrement associé dans l’API réponse.
- Propriétés supplémentaires de l’enregistrement associé de l’API réponse.
Voir aussi
Afficher les détails de l’enregistrement
Ajoutez de nouvelles fonctionnalités de questions et réponses (Q&A) au chat des ventes
Enrichissez les résumés des e-mails avec des informations sur votre application
Enrichissez les informations clés sur les ventes avec les informations issues de votre application
Enrichissez les résumés d’enregistrements CRM avec des informations issues de votre application
Prolongez Microsoft 365 Copilot pour les ventes avec des applications partenaires
Créer des extensions Copilot pour les ventes