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

Important

[Dieser Artikel ist eine Vorabdokumentation und kann geändert werden.]

Wenn Copilot in Outlook und der Vertriebsmitarbeiter zusammen verwendet werden, enthalten E-Mail-Zusammenfassungen, die in Outlook angezeigt werden, Verkaufsinformationen, die aus Ihrem CRM-System (Customer Relationship Management) stammen, z. B. Dynamics 365 oder Salesforce CRM. Sie können die E-Mail-Zusammenfassungsfunktion erweitern, die der Vertriebsmitarbeiter mit Einblicken aus Ihrer eigenen Anwendung bietet.

Note

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 dem Vertriebsmitarbeiter, die richtige API zu identifizieren, die aufgerufen werden soll, um die Funktion zu erweitern.

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 Datentyp Erforderlich Details Beschreibung zum Hinzufügen der Aktion
Ressourcen-Daten Object 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 No 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 String No 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 String No 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.
top Integer No Die Anzahl der abzurufenden Elemente. Diese Eingabe gibt die Anzahl der abzurufenden Dateiverknüpfungen an.
skip Integer No 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

Eigentum Typ Details Beschreibung zum Hinzufügen der Aktion
plaintextBody String 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 String 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 String Betreff der E-Mail. Diese Eingabe gibt den Betreff der E-Mail an.
from String Die E-Mail-Adresse des Absenders. Diese Eingabe gibt die E-Mail-Adresse des Absenders an.
zu String[] E-Mail-Adressen des Empfängers. Diese Eingabe liefert die E-Mail-Adresse des Empfängers.
cc String[] 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 String[] 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 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 String Die Graph-Nachricht-ID der E-Mail. Diese Eingabe gibt die Nachrichten-ID der E-Mail an.
conversationId String Die Graph-Unterhaltungs-ID des E-Mail-Threads. Diese Eingabe gibt die Konversations-ID des E-Mail-Threads an.
Eigentum Typ Erforderlich Details Beschreibung zum Hinzufügen der Aktion
entityId String 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.
entityType String 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 String No Diese Eingabe gibt die Entitätsquelle an, die derzeit „verbundene“ oder leere Werte enthält. Diese Eingabe gibt den Entitätsquellentyp an.

Ausgabeparameter

Der Vertriebsmitarbeiter erwartet, dass er eine Liste von Einblicken (Objekten) von Ihren APIs empfängt und erwartet, dass jeder Einblick bestimmte Parameter hat. Um sicherzustellen, dass der Vertriebsmitarbeiter die Ausgabe korrekt analysieren kann, muss die Antwortstruktur den Richtlinien in der folgenden Tabelle entsprechen.

Parameter Datentyp Erforderlich Details
value Array Ja

Eine Liste der Einblicke (Objekte), die wie im Abschnitt "Schema für Einblicke " 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 Boolean No Ein Wert, der angibt, ob weitere Ergebnisse verfügbar sind.

Schema für Einblicke

Name Datentyp/Format Erforderlich Details Beschreibung zum Hinzufügen der Aktion
Erkenntnis String 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
Erweitern von Gelegenheitserkenntnissen mit Daten aus Ihrer Anwendung
CRM-Datensatzdetails mit Erkenntnissen aus Ihrer Anwendung anreichern
Anreichern von CRM-Datensatzzusammenfassungen mit Erkenntnissen aus Ihrer Anwendung
Erweitern des Vertriebsmitarbeiters mit Partneranwendungen
Anreichern von E-Mail-Entwürfen mit Dateilinks aus Ihrer Anwendung
Erstellen von Erweiterungen für Vertriebsmitarbeiter

  • Last updated on