Partager via

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

Lorsque vous utilisez Copilot pour les ventes pour rédiger un brouillon, il tient compte de l’intention du courrier électronique et utilise les informations CRM de Salesforce ou Dynamics 365 pour créer le brouillon. Vous pouvez étendre la capacité de rédaction d’e-mails fournie par Copilot pour les ventes avec des fichiers recommandés à partir de votre propre application.

Note

Cette fonctionnalité n’est prise en charge que pour les brouillons de courrier électronique créés à l’aide du volet latéral Copilot pour les ventes dans Outlook.

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 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.

Charge utile d’entrée

Nom  Type de données Requise Informations Description à ajouter à l’action
resourceData Object 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 de l’e-mail, qui est une collection de fils de discussion d’e-mails, d’objets et d’autres détails.
resourceType String 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 ».
recordType String No Le type d’enregistrement CRM tel que compte ou opportunité. Cette entrée identifie le type d’enregistrement dans CRM, qui est lié au fil de discussion de messagerie.
recordId String No Identificateur unique de l’enregistrement CRM à utiliser pour les contenus suggérés. Cette entrée fournit l’identificateur unique de l’enregistrement CRM associé au fil de discussion de messagerie.
crmType String No 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 String No 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 String No Invite 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 e-mail.
top Integer No Nombre d’éléments à récupérer. Cette entrée indique le nombre de liens de fichiers à récupérer.
ignorer Integer No Nombre d’éléments à ignorer. Cette entrée indique le nombre d’éléments à ignorer lors de la récupération des liens de fichiers suggérés.

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

Property Type Informations Description à ajouter à l’action
plaintextBody String 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 au format texte.
fullHtmlBody String 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 au format HTML.
objet String Objet du courrier électronique. Cette entrée fournit l’objet du courrier électronique.
de String 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 Cci 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, consultez DateTimeOffset Struct (System) Cette entrée fournit l’horodatage de l’e-mail.
messageId String ID de message Graph du courrier électronique. Cette entrée fournit l’ID de message de l’e-mail.
conversationId String ID de conversation Graph du fil de discussion de messagerie. Cette entrée fournit l’ID de conversation du fil de discussion de messagerie.

Paramètres de sortie

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

Schéma de la réponse aux suggestions de contenu de fichier ou de lien

Nom  Format du type de données Requise Informations Description à ajouter à l’action
contentType 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 de 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.
contentTitle chaine Oui Titre du contenu suggéré affiché à l’utilisateur. Cette sortie indique le titre du contenu.
contentDescription chaine Oui Description du contenu suggéré présenté à l’utilisateur. Cette sortie indique le texte à inclure lors de la description des fichiers.
contentIconUrl chaine No 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 Object No 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 en tant que 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)
content-web Page web externe
content-doc Document Microsoft Word
content-pdf Document PDF Microsoft
content-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 les informations des ventes clés avec les informations 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 Microsoft 365 Copilot pour les ventes avec des applications partenaires
Créer des extensions Copilot pour les ventes