Partager via


Enrichir les résumés de l’enregistrement de CRM avec avec les informations de votre application (version préliminaire)

Important

[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 Accept-Language. Prenons un exemple.

{
« Raison du statut » : « Approuvé »,
« Propriétaire » : « Kenny Smith »
}
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.

Capture d’écran montrant l’anatomie des dernières activités à partir d’une application partenaire.

Légende :

  1. Section affichant les informations de l’application partenaire. Le titre de la section est dérivé du nom du connecteur Microsoft Power Platform.
  2. Descriptions de l’aperçu de la réponse de l’API.
  3. Numéros de citation qui peuvent être sélectionnés pour afficher les détails de l’aperçu.
  4. Carte de citation montrant des détails sur l’aperçu.
  5. 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.
  6. Propriétés supplémentaires de l’aperçu provenant de la réponse de l’API.
  7. Nom de l’application partenaire. Le nom affiché est le nom du connecteur Microsoft Power Platform.
  8. 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.

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