E-Mail-Entwürfe mit Dateilinks aus Ihrer Anwendung anreichern (Vorschauversion)
Wichtig
- Dies ist eine einsatzbereite Previewfunktion.
- Für einsatzbereite Vorschauversionen gelten ergänzende Nutzungsbedingungen.
[Dieser Artikel ist Teil der Dokumentation zur Vorabversion und kann geändert werden.]
Wenn Sie Copilot für Vertrieb verwenden, um eine E-Mail zu entwerfen, 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 von Copilot für Vertrieb bereitgestellten E-Mail-Entwurfsfunktionen mit empfohlenen Dateien aus Ihrer eigenen Anwendung erweitern.
Anmerkung
Diese Funktion wird nur für E-Mail-Entwürfe unterstützt, die mit dem Seitenbereich Copilot für Vertrieb in Outlook erstellt wurden.
API Beschreibung
Sie müssen der Aktion die folgende API-Beschreibung hinzufügen. Auf diese Weise kann Copilot für Vertrieb die richtige API identifizieren, die aufgerufen werden muss, um die Funktionen zu erweitern.
Mit dieser Aktion werden für die E-Mail-Konversation 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.
Eingabepayload
| Name des Dataflows | Datentyp | Erforderlich | Informationen | Der Aktion hinzuzufügende Beschreibung |
|---|---|---|---|---|
| resourceData | 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 Sammlung von E-Mail-Thread, Betreff und anderen Details handelt. |
| resourceType | String | 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 | String | Nein | Der Typ des CRM-Datensatzes, z. B. Firma oder Verkaufschance. | Diese Eingabe identifiziert den Datensatztyp in CRM, der sich auf den E-Mail-Thread bezieht. |
| recordId | String | Nein | 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. |
| crmType | String | 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 | String | 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. |
| inputPrompt (Eingabeaufforderung) | String | Nein | 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 | Nein | Die Anzahl der abzurufenden Elemente. | Diese Eingabe gibt die Anzahl der abzurufenden Dateiverknüpfungen an. |
| skip | 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 | 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. |
| to | 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 enthält alle E-Mail-Adressen des Empfängers, die im Cc-Feld der E-Mail enthalten sind. |
| bcc | Zeichenfolge[] | E-Mail-Adressen der Empfänger, 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. |
| messageId | 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. |
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. |
| hasMoreResults | Boolesch | Nein | 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 |
|---|---|---|---|---|
| contentType | string | Ja | Der Typ des anzuzeigenden Inhalts. 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 | string | Ja | Tatsächlicher Inhalt ist enthalten. Dabei kann es sich entweder um eine Webseite oder eine URL der Datei handeln. | 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 | string | Ja | Titel des vorgeschlagenen Inhalts, der dem Benutzer angezeigt wird. | Diese Ausgabe gibt den Titel des Inhalts an. |
| contentDescription | string | 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 | string | Nein | 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. |
| additionalProperties | Object | Nein | 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) |
| content-web | Externe Website |
| content-doc | Microsoft Word-Dokument |
| content-pdf | Microsoft-PDF-Dokument |
| content-pptx | Microsoft PowerPoint-Präsentation |
| content-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.
Legende:
- 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
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
Copilot für Vertrieb-Erweiterungen erstellen