Partager via

Enrichir les brouillons de courriers électroniques avec des liens de fichiers à partir 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.]

Lorsque vous utilisez l’application Sales pour rédiger un e-mail, elle prend en compte l’intention de l’e-mail et utilise les informations CRM de Salesforce ou Dynamics 365 pour créer le brouillon. Vous pouvez étendre la fonctionnalité de rédaction de brouillons d’e-mails que l’application Sales offre en ajoutant des fichiers recommandés de votre propre application.

Nonte

Cette fonctionnalité est prise en charge uniquement pour les brouillons d’e-mail créés à l’aide de l’application Sales dans Outlook.

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 obtient les fichiers pertinents pour la conversation par courrier électronique, qui seront affichés dans les brouillons de courrier électronique C4S dans Outlook. L’action améliore les compétences existantes de Copilot pour les ventes.

Opération API

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

Charge utile d’entrée

Cette charge utile sert de corps de la demande d’API.

Nonm Type de données Requise Informations Description à ajouter à l’action
resourceData Objet Oui Données de ressource à utiliser pour récupérer le contenu suggéré. Pour la structure des données, accédez à Modèle de données de courrier électronique pour l’extensibilité. Cette entrée identifie le contenu du courrier électronique, qui est une collection de fil de discussion par courrier électronique, d’objets et d’autres détails.
type de ressource Chaîne Oui Type de ressource pour laquelle récupérer les suggestions de contenu. Par exemple, « email-thread » ou « teams-chat ». Cette entrée identifie le type de ressource partagée pour récupérer les liens de fichiers suggérés, qui dans ce cas est « email-thread ».
type d’enregistrement Chaîne Non Le type d’enregistrement CRM tel que compte ou opportunité. Cette entrée identifie le type d’enregistrement dans CRM associé au fil de discussion par courrier électronique.
recordId Chaîne Non Identificateur unique de l’enregistrement CRM à utiliser pour les contenus suggérés. Cette entrée fournit le l’identificateur unique de l’enregistrement CRM associé au fil de discussion par courrier électronique.
type de CRM Chaîne Non Le type de système CRM, s’il est connecté. Les valeurs valides sont Salesforce et Dynamics 365. Cette entrée indique le type de CRM dans lequel l’enregistrement associé au fil de discussion de courrier électronique existe.
crmOrgUrl Chaîne Non URL de l’organisation du CRM. Cette entrée indique l’URL de l’environnement de CRM dans lequel l’enregistrement associé au fil de discussion de courrier électronique existe.
inputPrompt Chaîne Non Incitation suggérée actuellement utilisée donnée par l’utilisateur pour générer un brouillon de courrier électronique. Par exemple, « Répondre à une préoccupation » ou « Faire une proposition ». Cette entrée indique l’invite fournie par l’utilisateur lors de la rédaction d’un courrier électronique.
top Nombre entier Non Nonmbre d’éléments à récupérer. Cette entrée indique le nombre de liens de fichiers à récupérer.
ignorer Nombre entier Non Nonmbre d’éléments à ignorer. Cette entrée indique le nombre d’éléments à ignorer lors de la récupération de liens de fichiers.

Modèle de données d’extensibilité des courriers électroniques

Propriété Type Informations Description à ajouter à l’action
plaintextBody Chaîne Le corps complet de l’e-mail comprend tous les messages précédents du fil de discussion. Cette entrée fournit tout le contenu du fil de discussion par courrier électronique au format texte.
fullHtmlBody Chaîne La version HTML complète du corps de l’e-mail qui inclut tous les messages précédents du fil de discussion de l’e-mail. Cette entrée fournit tout le contenu du fil de discussion par courrier électronique au format HTML.
objet Chaîne Objet du courrier électronique. Cette entrée fournit l’objet du courrier électronique.
de Chaîne Adresse e-mail de l’expéditeur. Cette entrée fournit l’adresse e-mail de l’expéditeur.
à Chaîne[] Adresses e-mail du destinataire. Cette entrée fournit l’adresse e-mail du destinataire.
cc Chaîne[] Adresses e-mail des destinataires ajoutées dans le champ Cc de l’e-mail. Cette entrée fournit toutes les adresses e-mail du destinataire qui sont incluses dans le champ Cc du courrier électronique.
bcc Chaîne[] Adresses e-mail des destinataires ajoutées dans le champ Bcc de l’e-mail. Cette entrée fournit toutes les adresses e-mail du destinataire qui sont ajoutées dans le champ Cci du courrier électronique.
sentDateTime DateTimeOffset La date et l’heure de l’e-mail au format UTC, ainsi que la propriété Offset. Pour plus d’informations, accédez à DateTimeOffset Struct (système) Cette entrée fournit l’horodatage du courrier électronique.
messageId Chaîne ID de message Graph du courrier électronique. Cette entrée fournit l’ID du message du Courrier électronique.
ID de conversation Chaîne ID de la conversation Graph du fil de discussion de messagerie. Cette entrée fournit l’ID de conversation du fil de discussion par courrier électronique.

Paramètres de sortie

Propriété Type de données Requise Informations
value Tableau Oui Liste de liens (objets) de fichiers définis comme décrit dans la réponse de suggestions de contenu de fichier ou de lien.
aPlusDeRésultats Valeur booléenne Non Valeur qui indique si plus de résultats sont disponibles.

Schéma des réponses aux suggestions de contenu de fichier ou de lien

Nonm Format du type de données Requise Informations Description à ajouter à l’action
type de contenu chaine Oui Type de contenu à afficher. Pour plus d’informations, consultez Valeurs prédéfinies pour contentType Cette sortie indique le type de contenu inclus dans le brouillon du courrier électronique.
contenu chaine Oui Contenu réel inclus. Il peut s’agir d’une page Web ou d’une URL du fichier. Cette sortie indique le contenu réel inclus dans le brouillon de courrier électronique. Il peut s’agir d’une page Web ou d’une URL.
Titre du contenu chaine Oui Titre du contenu suggéré affiché à l’utilisateur. Cette sortie indique le titre du contenu.
contenuDescription chaine Oui Description du contenu suggéré affiché à l’utilisateur. Cette sortie indique le texte à inclure lors de la description des fichiers.
contentIconUrl chaine Non Icône du contenu suggéré affiché à l’utilisateur. Si aucune icône n’est fournie, une icône générique est utilisée. Cette sortie indique l’icône à inclure pour le contenu.
additionalProperties Objet Non Ensemble de paires nom-valeur qui indiquent des propriétés supplémentaires du lien de fichier associé renvoyé par l’action. Cette sortie indique des propriétés supplémentaires sous forme de paires nom-valeur de chaque lien associé renvoyé par l’action.

Valeurs prédéfinies pour contentType

Valeur de chaîne Type de contenu
content-file Fichier externe (générique)
contenu-web Page web externe
content-doc Document Microsoft Word
content-pdf Document PDF Microsoft
contenu-pptx Présentation Microsoft PowerPoint
content-xlsx Feuille de calcul Microsoft Excel

Exemple

{
  "value": [
    {
      "contentType": 0,
      "content": "https://www.bing.com",
      "contentTitle": "Purchase Contract",
      "contentDescription": "Purchase Contract Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Logan Edwards",
        "Sender Name": "Kenny Smith"
      }
    },
    {
      "contentType": 3,
      "content": "https://www.microsoft.com",
      "contentTitle": "Strategy Planning",
      "contentDescription": "Strategy Planning Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Recipients": "Gabriela Edwards",
        "Sender Name": "Maria Smith"
      }
    },
    {
      "contentType": 1,
      "content": "https://www.bing.com",
      "contentTitle": "Contoso Website",
      "contentDescription": "Contoso Website Description",
      "contentIconUrl": null,
      "additionalProperties": {
        "Total Views": "100",
        "Domain": "Contoso.com"
      }
    }
  ],
  "hasMoreResults": false
}

L’exemple d’image suivante montre comment la sortie de l’API est mappée au brouillon de courrier électronique.

Capture d’écran montrant les liens de fichiers des applications partenaires dans le brouillon de courrier électronique.

Légende :

  1. Liens de fichiers à partir d’applications partenaires.

Voir aussi

Résumer un fil de discussion à l’aide d’informations de vente avec Copilot dans Outlook
Enrichir le résumé des courriers électroniques avec les informations 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
Enrichir les résumés 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

  • Last updated on