Freigeben über

E-Mail-Entwürfe mit Dateilinks aus Ihrer Anwendung anreichern (Vorschauversion)

Wichtig

[Dieser Artikel ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]

Wenn Sie die Vertriebs-App zum Entwerfen einer E-Mail verwenden, berücksichtigt sie die Absicht der E-Mail und verwendet CRM-Informationen aus Salesforce oder Dynamics 365, um den Entwurf zu erstellen. Sie können die E-Mail-Entwurfsfunktion erweitern, die die Vertriebs-App mit empfohlenen Dateien aus Ihrer eigenen Anwendung bereitstellt.

Anmerkung

Dieses Feature wird nur für E-Mail-Entwürfe unterstützt, die mit der Verkaufs-App in Outlook erstellt wurden.

API-Beschreibung

Sie müssen der Aktion die folgende API-Beschreibung hinzufügen. Auf diese Weise kann die Vertriebs-App die richtige API identifizieren, die aufgerufen werden muss, um die Funktion zu erweitern.

Mit dieser Aktion werden für die E-Mail-Unterhaltung relevante Dateien abgerufen, die in C4S-E-Mail-Entwürfen in Outlook angezeigt werden. Die Aktion erweitert die vorhandenen Fähigkeiten von Copilot für Vertrieb.

API-Vorgang

Diese API verwendet den Vorgangstyp: POST

Eingabepayload

Diese Nutzdaten werden als Anforderungstext der API-Anforderung verwendet.

Name des Dataflows Datentyp Erforderlich Informationen Der Aktion hinzuzufügende Beschreibung
Ressourcen-Daten Objekt Ja Die Ressourcendaten, die zum Abrufen des vorgeschlagenen Inhalts verwendet werden sollen. Informationen zur Datenstruktur finden Sie unter Erweiterbarkeits-E-Mail-Datenmodell. Diese Eingabe identifiziert den E-Mail-Inhalt, bei dem es sich um eine Aufstellung von E-Mail-Thread, Betreff und anderen Details handelt.
Ressourcentyp Schnur Ja Der Ressourcentyp, für den Inhaltsvorschläge abgerufen werden sollen. Beispiel: „E-Mail-Thread“ oder „Teams-Chat“. Diese Eingabe gibt den Typ der Ressource an, die zum Abrufen vorgeschlagener Dateiverknüpfungen freigegeben wird, in diesem Fall „E-Mail-Thread“.
recordType Schnur Nr. Der Typ des CRM-Datensatzes, z. B. Konto oder Verkaufschance. Diese Eingabe identifiziert den Datensatztyp in CRM, der sich auf den E-Mail-Thread bezieht.
recordId Schnur Nr. Der eindeutige Bezeichner des CRM-Datensatzes, der für vorgeschlagene Inhalte verwendet werden soll. Diese Eingabe stellt den eindeutigen Bezeichner des CRM-Datensatzes bereit, der sich auf den E-Mail-Thread bezieht.
CRM-Typ Schnur Nr. Der Typ des CRM-Systems, falls verbunden. Die gültigen Werte sind Salesforce und Dynamics 365. Diese Eingabe gibt den CRM-Typ an, in dem der Datensatz vorhanden ist, der sich auf den E-Mail-Thread bezieht.
crmOrgUrl Schnur Nr. Die URL der CRM-Organisation Diese Eingabe gibt die URL der CRM-Umgebung an, in der der Datensatz vorhanden ist, der sich auf den E-Mail-Thread bezieht.
Eingabeaufforderung Schnur Nr. Die derzeit verwendete vorgeschlagene Eingabeaufforderung des Benutzers zum Generieren eines E-Mail-Entwurfs. Zum Beispiel „Antwort auf ein Anliegen“ oder „Einen Vorschlag machen“. Diese Eingabe gibt die Eingabeaufforderung an, die der Benutzer beim Verfassen einer E-Mail bereitstellt.
oben Ganzzahl Nr. Die Anzahl der abzurufenden Elemente. Diese Eingabe gibt die Anzahl der abzurufenden Dateiverknüpfungen an.
skip Ganzzahl Nr. Die Anzahl der zu überspringenden Elemente. Diese Eingabe gibt die Anzahl der Elemente an, die beim Abrufen vorgeschlagener Dateiverknüpfungen übersprungen werden sollen.

Erweiterbarkeits-E-Mail-Datenmodell

Eigenschaften typ Informationen Der Aktion hinzuzufügende Beschreibung
plaintextBody Schnur Der vollständige E-Mail-Text enthält alle vorherigen Nachrichten des E-Mail-Threads. Diese Eingabe stellt den gesamten Inhalt des E-Mail-Threads im Textformat bereit.
fullHtmlBody Schnur Die vollständige HTML-Version des E-Mail-Textkörpers, der alle vorherigen Nachrichten des E-Mail-Threads enthält. Diese Eingabe stellt den gesamten Inhalt des E-Mail-Threads im HTML-Format bereit.
Betreff Schnur Betreff der E-Mail. Diese Eingabe gibt den Betreff der E-Mail an.
from Schnur Die E-Mail-Adresse des Absenders. Diese Eingabe gibt die E-Mail-Adresse des Absenders an.
zu Zeichenfolge[] E-Mail-Adressen des Empfängers. Diese Eingabe liefert die E-Mail-Adresse des Empfängers.
cc Zeichenfolge[] E-Mail-Adressen der Empfänger, die im Feld „Cc“ der E-Mail hinzugefügt wurden. Diese Eingabe liefert alle E-Mail-Adressen des Empfängers, die im Cc-Feld der E-Mail enthalten sind.
bcc Zeichenfolge[] E-Mail-Adressen der Empfangenden, die dem Bcc-Feld der E-Mail hinzugefügt sind. Diese Eingabe enthält alle E-Mail-Adressen des Empfängers, die im Feld „Bcc“ der E-Mail hinzugefügt wurden.
sentDateTime DateTimeOffset Das Datum und die Uhrzeit der E-Mail im UTC-Format zusammen mit der Offset-Eigenschaft. Weitere Informationen finden Sie unter DateTimeOffset-Struktur (System) Diese Eingabe stellt den Zeitstempel der E-Mail bereit.
Nachrichten-ID Schnur Die Graph-Nachricht-ID der E-Mail. Diese Eingabe gibt die Nachrichten-ID der E-Mail an.
conversationId Schnur Die Graph-Unterhaltungs-ID des E-Mail-Threads. Diese Eingabe gibt die Konversations-ID des E-Mail-Threads an.

Ausgabe...parameter

Eigenschaften Datentyp Erforderlich Informationen
value Array Ja Eine Liste von Dateiverknüpfungen (Objekten), die wie im Schema für Vorschläge für Datei- oder Linkinhalt-Antworten beschrieben definiert sind.
hatMehrErgebnisse Boolesch Nr. Ein Wert, der angibt, ob mehr Ergebnisse verfügbar sind.

Schema für Vorschläge für Datei- oder Linkinhalt-Antworten

Name des Dataflows Datentypformat Erforderlich Informationen Der Aktion hinzuzufügende Beschreibung
Inhaltstyp Schnur Ja Der Typ des Inhalts, der angezeigt wird. Weitere Informationen finden Sie unter Vordefinierte Werte für contentType Diese Ausgabe gibt den Typ des Inhalts an, der im E-Mail-Entwurf enthalten ist.
Inhalt Schnur Ja Tatsächlicher Inhalt ist enthalten. Er kann entweder eine Webseite oder eine Datei-URL sein. Diese Ausgabe gibt den tatsächlichen Inhalt an, der im E-Mail-Entwurf enthalten ist. Dabei kann es sich entweder um eine Webseite oder eine URL handeln.
contentTitle Schnur Ja Titel des vorgeschlagenen Inhalts, der dem Benutzer angezeigt wird. Diese Ausgabe gibt den Titel des Inhalts an.
Inhaltsbeschreibung Schnur Ja Beschreibung des vorgeschlagenen Inhalts, der dem Benutzer angezeigt wird. Diese Ausgabe gibt den Text an, der beim Beschreiben der Dateien enthalten sein soll.
contentIconUrl Schnur Nr. Symbol des vorgeschlagenen Inhalts, der dem Benutzer angezeigt wird. Wenn nicht angegeben, wird ein generisches Symbol verwendet. Diese Ausgabe gibt das Symbol an, das in den Inhalt aufgenommen werden soll.
zusätzlicheEigenschaften Objekt Nr. Eine Reihe von Name-Wert-Paaren, die zusätzliche Eigenschaften der verknüpften Dateiverknüpfung angeben, die von der Aktion zurückgegeben wird. Diese Ausgabe gibt zusätzliche Eigenschaften als Name-Wert-Paare jedes verknüpften Links an, der von der Aktion zurückgegeben wird.

Vordefinierte Werte für contentType

Zeichenfolgenwert Inhaltstyp
content-file Externe Datei (generisch)
Inhaltsnetz Externe Website
content-doc Microsoft Word-Dokument
Inhalt-PDF Microsoft-PDF-Dokument
Inhalt-pptx Microsoft PowerPoint-Präsentation
Inhalt-XLSX Microsoft Excel-Kalkulationstabelle

Beispiel

{
  "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
}

Das Beispiel in der folgenden Abbildung zeigt, wie die Ausgabe der API dem E-Mail-Entwurf zugeordnet wird.

Screenshot mit Dateilinks von Partner-Apps im E-Mail-Entwurf

Legende:

  1. Dateiverknüpfungen aus Partner-Apps

Siehe auch

Mit Copilot in Outlook einen E-Mail-Thread mit Verkaufsinformationen zusammenfassen
E-Mail-Zusammenfassungen mit Erkenntnissen aus Ihrer Anwendung anreichern
Erweitern von Gelegenheitserkenntnissen mit Daten aus Ihrer Anwendung
CRM-Datensatzdetails mit Erkenntnissen aus Ihrer Anwendung anreichern
CRM-Datensatzzusmmenfassungen mit Erkenntnissen aus Ihrer Anwendung anreichern
Erweitern des Umsatzes in Microsoft 365 Copilot mit Partneranwendungen
Erstellen von Erweiterungen für Vertrieb in Microsoft 365 Copilot

  • Last updated on