Enrichissez les résumés des enregistrements CRM avec des informations issues 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.]

Pour mieux comprendre le contexte d’une réunion qu’ils préparent ou d’un e-mail qu’ils lisent, les vendeurs souhaitent disposer d’informations pertinentes sur la gestion de la relation client (CRM), telles que les requêtes, les préoccupations et les notes des clients. Copilot pour les ventes 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 prévue Fermer. Vous pouvez étendre la capacité de résumé des enregistrements 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 invoquée pour enrichir la capacité.

Cette action permet d’obtenir des informations de vente supplémentaires liées à un enregistrement CRM qui seront affichées dans le résumé de l’enregistrement C4S carte. L’action renforce le compétences existant de copilote 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 informations associées telles que des activités sont demandées. 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 indique le type d’entité ou d’objet dans CRM pour lequel des informations associées sont demandées.
recordId String Oui L’identifiant 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" No La date et l’heure de début pour rechercher des informations. Le format suit la spécification. OpenAPI Voici 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" No La date et l’heure de fin pour rechercher des informations. Le format suit la spécification. OpenAPI Voici un exemple : 2017-07-21T17:32:28Z. Cette entrée indique la date et l’heure de fin des informations demandées.
top Integer No Le nombre d’informations à extraire. Cette entrée indique le nombre d’informations à récupérer.
skip Integer No Le nombre d’informations à ignorer. Cette entrée indique le nombre d’informations à ignorer.
crmType String No 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 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 de CRM dans lequel existe l’enregistrement CRM, pour lequel les informations sont demandées.

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 à l’action
titre String Oui Le titre de l’insight sur la citation carte. Il s’agit du titre en langage naturel de l’aperçu dans la langue spécifiée via l’en-tête de 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’insight. 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 via l’en-tête. Accept-Language Voici un exemple : Kenny, Logan et deux autres personnes ont signé le contrat de renouvellement Contoso 2023 le 07/09/2023. Cette sortie indique la description de l’aperçu.
dateTime Chaîne au format "date-heure" Oui La date et l’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 quelle heure afficher. Le format suit la spécification. OpenAPI Voici un exemple : 2017-07-21T17:32:28Z. Ce résultat indique l’heure associée à l’aperçu.
url String No Une URL valide pour ouvrir l’activité dans l’application partenaire. Cette sortie indique l’URL pour ouvrir l’aperçu.
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 affichées dans la vue détaillée de l’aperçu.

Note

Bien que les exigences de l’API pour l’extension des capacités de résumé des e-mails et des capacités de résumé des enregistrements puissent 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’exemple dans l’image suivante montre comment la sortie de l’API est mappée au résumé de l’enregistrement.

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

Légende :

  1. Section qui présente des informations sur l’application partenaire. Le titre de la section est dérivé du nom du connecteur. Microsoft Power Platform
  2. Descriptions des informations de l’API réponse.
  3. Numéros de citation qui peuvent être sélectionnés pour afficher les détails de l’information.
  4. Citation carte qui montre 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 de l’API réponse.
  6. Propriétés supplémentaires de l’insight de l’API réponse.
  7. Nom de l’application partenaire. Le nom affiché est le nom du connecteur. Microsoft Power Platform
  8. Lien pouvant être sélectionné pour afficher les détails de l’analyse dans l’application partenaire. Il est basé sur l’URL de l’aperçu dans l’API réponse.

Voir aussi

Voir le résumé 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
Enrichir les détails de l’enregistrement de CRM avec les informations de votre application
Développer Microsoft Copilot for Sales avec des applications partenaires
Créer des extensions Copilot pour les ventes