Enrichir les brouillons de courriers électroniques avec des liens de fichiers à partir de votre application (version préliminaire)

Important

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

Lorsque vous utilisez l’agent sales pour rédiger un e-mail, il 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 d'e-mails que l’agent commercial propose en y ajoutant des fichiers recommandés à partir de votre propre application.

Note

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

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 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 du copilote au sein des ventes.

Opération d’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.

Nom Type de données Obligatoire Détails Description à ajouter dans 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.
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 ».
type d’enregistrement String 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 String 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 String 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 String Non URL de l’organisation 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 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 Integer Non Nonmbre d’éléments à récupérer. Cette entrée indique le nombre de liens de fichiers à récupérer.
skip Integer 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 Détails Description à ajouter dans 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 par courrier électronique 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 par courrier électronique au format HTML.
Objet String Objet de l'email. 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 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.
l'identifiant de message String ID de message Graph du courrier électronique. Cette entrée fournit l’ID du message du Courrier électronique.
ID de conversation String 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 Obligatoire Détails
valeur Array 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 Boolean Non Valeur qui indique si d’autres résultats sont disponibles.

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

Nom Format du type de données Obligatoire Détails Description à ajouter dans l’action
type de contenu ficelle 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 ficelle 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 ficelle Oui Titre du contenu suggéré affiché à l’utilisateur. Cette sortie indique le titre du contenu.
contenuDescription ficelle Oui Description du contenu suggéré affiché à l’utilisateur. Cette sortie indique le texte à inclure lors de la description des fichiers.
contentIconUrl ficelle 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.
propriétés supplémentaires 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 les résumés d’e-mails avec des insights 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 d'enregistrements CRM avec des informations de votre application
Étendre l’agent commercial avec des applications partenaires
Développer des extensions pour l'agent commercial

  • Last updated on