Freigeben über

E-Mail-Zusammenfassung mit Inhaltsvorschlägen aus Ihrer Anwendung anreichern (Vorschauversion)

Wichtig

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

Wenn Copilot in Outlook und Copilot für Vertrieb zusammen verwendet werden, enthalten E-Mail-Zusammenfassungen, die in Outlook angezeigt werden, Verkaufsinformationen, die aus Ihrem CRM-System (Customer Relationship Management) wie Dynamics 365 oder Salesforce CRM stammen. Sie können die von Copilot für Vertrieb bereitgestellte E-Mail-Zusammenfassungsfunktion mit Erkenntnissen aus Ihrer eigenen Anwendung erweitern.

Anmerkung

Diese API ersetzt die vorhandene E-Mail-Zusammenfassungsfertigkeit-API (Vorgangs-ID: scp-get-email-insights) durch eine neue Version.

API-Beschreibung

Sie müssen der Aktion die folgende API-Beschreibung hinzufügen. Dies hilft Copilot für Vertrieb, die richtige API zu identifizieren, die zum Anreichern der Funktion aufgerufen werden soll.

Diese Aktion ruft zusätzliche Vertriebserkenntnisse ab, die in der C4S-E-Mail-Zusammenfassungsumgebung in der Outlook-Zusammenfassung angezeigt werden. Die Aktion erweitert die vorhandenen Fähigkeiten von Copilot für Vertrieb.

API-Einzelheiten

  • API-Name: E-Mail-Zusammenfassungsfertigkeit Version 2
  • Swagger-Vorgangs-ID: scp-get-email-insights-v2
  • Swagger-Betriebsmethode: post
  • Pfad: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

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.
Verwandte Entitäten Array Nein Das Array der verknüpften Entitäten. Informationen zur Datenstruktur finden Sie unter Verknüpftes Entitätsdatenmodell. Diese Eingabe identifiziert das Array von CRM-Datensätzen, die sich auf den E-Mail-Thread beziehen.
CRM-Typ Schnur Nein 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 Nein 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.
oben Ganzzahl Nein Die Anzahl der abzurufenden Elemente. Diese Eingabe gibt die Anzahl der abzurufenden Dateiverknüpfungen an.
hüpfen Ganzzahl Nein 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 des Empfängers, die im Cc-Feld 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 des Empfängers, die im Bcc-Feld der E-Mail hinzugefügt wurden. Diese Eingabe enthält alle E-Mail-Adressen des Empfängers, die im Feld „Bcc“ der E-Mail hinzugefügt wurden.
sentDateTime DateTimeOffset (Datum/Uhrzeit mit Offset) 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.
Eigenschaften typ Erforderlich Informationen Der Aktion hinzuzufügende Beschreibung
entityId Schnur Ja Der Typ des CRM-Datensatzes, z. B. Konto oder Verkaufschance. Diese Eingabe stellt den eindeutigen Bezeichner des CRM-Datensatzes bereit, der sich auf den E-Mail-Thread bezieht.
Entitätstyp Schnur Ja Der eindeutige Bezeichner des CRM-Datensatzes, der für vorgeschlagene Inhalte verwendet werden soll. Diese Eingabe identifiziert den Datensatztyp in CRM, der sich auf den E-Mail-Thread bezieht.
entitySource Schnur Nein Diese Eingabe gibt die Entitätsquelle an, die derzeit „verbundene“ oder leere Werte enthält. Diese Eingabe gibt den Entitätsquellentyp an.

Ausgabe...parameter

Copilot für Vertrieb erwartet den Eingang einer Liste mit Erkenntnissen (Objekten) von Ihren APIs und dass jede Erkenntnis über bestimmte Parameter verfügt. Um sicherzustellen, dass Copilot für Vertrieb die Ausgabe richtig analysieren kann, muss die Antwortstruktur die Richtlinien in der folgenden Tabelle einhalten.

Parameter Datentyp Erforderlich Informationen
Wert Array Ja

Eine Liste mit Erkenntnissen (Objekten), die wie im Abschnitt Schema für Erkenntnisse beschrieben, definiert sind.

Hinweis: Obwohl dieser Parameter eine Liste von Erkenntnissen enthält, wird nur die erste Erkenntnis in der Zusammenfassung der E-Mail-Anreicherung für Outlook Canvas verwendet.
hatMehrErgebnisse Boolesch Nein Ein Wert, der angibt, ob mehr Ergebnisse verfügbar sind.

Schema für Erkenntnisse

Name des Dataflows Datentyp/-format Erforderlich Informationen Der Aktion hinzuzufügende Beschreibung
Einblick Schnur Ja Die Erkenntnis, die Benutzern zur Verfügung gestellt wird, z. B. Ihre Kollegen Mona Kane, Ray Tanaka und Daniela Smith haben bereits mit ihnen zusammengearbeitet. Diese Ausgabe gibt den Text an, der in die E-Mail-Zusammenfassung aufgenommen werden soll.

Beispiel

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}

Das Beispiel in der folgenden Abbildung zeigt, wie die Ausgabe der API der E-Mail-Zusammenfassung im Seitenbereich zugeordnet wird.

Screenshot, der Einblicke aus Partner-Apps in der E-Mail-Zusammenfassung zeigt.

Legende:

  1. Bezeichnung der Erkenntnis. Erkenntnisse mit demselben Titel werden zusammengefasst.
  2. Beschreibungen der Erkenntnis. Jed Erkenntnis verfügt über eine Beschreibung.

Das Beispiel in der folgenden Abbildung zeigt, wie die Ausgabe der API der E-Mail-Zusammenfassung im E-Mail-Text zugeordnet wird.

Screenshot mit Erkenntnissen aus Partner-Apps im E-Mail-Text

Legende:

  1. Bezeichnung der Erkenntnis. Erkenntnisse mit demselben Titel werden zusammengefasst.
  2. Eine Beschreibung der Erkenntnis. Jed Erkenntnis verfügt über eine Beschreibung.

Mit Copilot in Outlook einen E-Mail-Thread mit Verkaufsinformationen zusammenfassen
Wichtige Vertriebsinformationen mit Erkenntnissen aus Ihrer Anwendung anreichern
CRM-Datensatzdetails mit Erkenntnissen aus Ihrer Anwendung anreichern
CRM-Datensatzzusmmenfassungen mit Erkenntnissen aus Ihrer Anwendung anreichern
Microsoft 365 Copilot für Vertrieb um Partneranwendungen erweitern
E-Mail-Entwürfe mit Dateilinks aus Ihrer Anwendung anreichern
Copilot für Vertrieb-Erweiterungen erstellen