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

Important

[Cet article est une documentation préliminaire et est susceptible d’être modifié.]

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’agent 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 capacité de résumé des enregistrements CRM que fournit l’agent commercial avec des analyses provenant de votre propre application.

Description de l’API

Vous devez ajouter la description de l’API suivante à l’action. De cette façon, l’agent 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 du copilote au sein des ventes.

Opération d’API

Cette API utilise le type d’opération : GET

Paramètres d’entrée

L’agent sales est conçu pour fournir les paramètres d’entrée suivants à vos API.

Nom Type/format de données Obligatoire Détails Description à ajouter dans 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 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 » Non Date et heure de fin de recherche d’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 Non Nombre d’informations à récupérer. Cette entrée indique le nombre d’informations à récupérer.
skip Integer Non Nombre d’insights à 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’agent commercial 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’agent sales peut analyser correctement la sortie, la structure de réponse doit respecter les instructions du tableau suivant.

Paramètre Type de données Obligatoire Détails
valeur Array Oui Une liste d'analyses (objets) définies comme décrit dans la section Schéma pour les analyses.
aPlusDeRésultats Boolean Non Valeur qui indique si d’autres résultats sont disponibles.

Schéma pour perspectives

Nom Type/Format de données Obligatoire Détails 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.
descriptif 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.
dateHeure 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 suit la spécification OpenAPI. Voici un exemple : 2017-07-21T17:32:28Z. Cette sortie indique l’heure associée à l’insight.
url String Non URL valide pour ouvrir l’activité dans l’application partenaire. Cette sortie indique l’URL pour ouvrir l’aperçu.
propriétés supplémentaires Objet qui a des valeurs Property Name et Property Value du type String 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. Voici 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

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 montrant les insights de l’application partenaire. Le titre de la section est dérivé du nom du connecteur Microsoft Power Platform.
  2. Descriptions des analyses de la réponse de l'API.
  3. Numéros de citation qui peuvent être sélectionnés pour afficher des détails sur l’insight.
  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 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 de l’insight dans l’application partenaire. Elle est basée sur l’URL de l’insight dans la réponse de l’API.

Afficher le résumé des enregistrements
Enrichir les résumés d’e-mails avec des insights de votre application
Enrichir les brouillons d’e-mail 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 l’agent commercial avec des applications partenaires
Développer des extensions pour l'agent commercial

  • Last updated on