Partager via

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

  • Article

Important

[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 concernant un contact enregistré, ainsi que ses enregistrements associés tels que les comptes et les opportunités. Vous pouvez étendre la fonctionnalité de gestion des détails d’enregistrement 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 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 enregistrements associés à un enregistrement CRM. 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 les enregistrements associés sont demandés. 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 identifie le type d’enregistrement dans CRM pour lequel des enregistrements associés sont demandés.
recordId Chaîne Oui Identificateur 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.
haut Entier Non Nombre d’activités à récupérer. Cette entrée indique le nombre d’enregistrements associés à extraire.
ignorer Entier Non Nombre d’activités à ignorer. Cette entrée indique le nombre d’enregistrements à ignorer lors de l’extraction d’enregistrements associés.
crmType Chaîne Non Type du système de 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 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 CRM à partir duquel les enregistrements associés sont extraits.

Remarque

Ce point d’extension prend en charge le rendu des informations à partir de cinq extensions de connecteur maximum dans l’assistant 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 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
recordId Chaîne Oui Identificateur unique de l’enregistrement. Cette sortie identifie de manière unique chaque enregistrement associé renvoyé par l’action.
recordTypeDisplayName Chaîne Oui Nom d’affichage du type d’enregistrement, tel que Contrat. Il doit être localisé dans la langue spécifiée dans l’en-tête Accept-Language. Cette sortie indique le nom d’affichage du type de chaque enregistrement associé renvoyé par l’action.
recordTypePluralDisplayName Chaîne Oui Nom d’affichage au pluriel du type d’enregistrement, tel que Contrats. Il doit être localisé dans la langue spécifiée dans 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 Chaîne Oui 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 Chaîne Oui Nom d’affichage du type d’enregistrement, tel que Contrat de renouvellement Contoso 2023. Cette sortie indique le titre de chaque enregistrement associé renvoyé par l’action.
url Chaîne Non URL valide pour ouvrir l’enregistrement dans l’application partenaire. Cette sortie indique l’URL de chaque enregistrement associé renvoyé par l’action.
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 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’image suivante montre un exemple de la façon dont la sortie de l’API est mappée aux enregistrements associés.

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

Légende :

  1. Fiche qui affiche les enregistrements associés de l’application partenaire.
  2. 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.
  3. Titres d’enregistrements associés à partir de la réponse d’API. Deux propriétés supplémentaires de la réponse d’API sont affichées en tant que champs clés de chaque enregistrement associé.
  4. Bouton « Autres 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 la réponse d’API.
  5. Propriétés supplémentaires de l’enregistrement associé de la réponse d’API.

Afficher les détails de l’enregistrement
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 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