Enrichir les détails de l’enregistrement de CRM avec avec les informations de votre application (version préliminaire)

Article
10/02/2024

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 `Accept-Language` . Prenons un exemple. { « Raison du statut » : « Approuvé », "Propriétaire" : "Kenny Smith" }	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.

Capture d’écran montrant l’anatomie des enregistrements associés d’une application partenaire.

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

Partager via