Freigeben über

Bereichern Sie die CRM-Datensatzzusammenfassung mit Erkenntnissen aus Ihrer Anwendung (Vorschauversion)

  • Artikel

Wichtig

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

Verkäufer können Details zu einem gespeicherten Kontakt sowie die zugehörigen Datensätze wie Konten und Chancen anzeigen. Sie können die von Copilot für Vertrieb bereitgestellten CRM-Datensatzdetails (Customer Relationship Management) mit Erkenntnissen aus Ihrer eigenen Anwendung erweitern.

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 Datensätze abgerufen, die sich auf einen CRM-Datensatz beziehen. Die Aktion erweitert die vorhandenen Fähigkeiten von Copilot für Vertrieb.

Eingabeparameter

Copilot für Vertrieb dient der Bereitstellung der folgenden Eingabeparameter für Ihre APIs.

Name des Dataflows Datentyp/-format Erforderlich Informationen Der Aktion hinzuzufügende Beschreibung
recordType String Ja Der Entitäts- oder Objekttyp im CRM, für den zugehörige Datensätze angefordert werden. Der Wert enthält den sprachunabhängigen eindeutigen Namen der Entität oder des Objekttyps, nicht den Anzeigenamen, der lokalisiert werden kann. Beispiele hierfür sind Konto und Verkaufschance. Diese Eingabe identifiziert die Datensatztyp im CRM, für die wichtige Datensätze angefordert werden.
recordId String Ja Der eindeutige Bezeichner des DRM-Datensatzes. Diese Eingabe stelt den eindeutigen Bezeichner für den CRM-Datensatz bereit, für den der zugehörige Datensatz angefordert wurden.
oben Ganzzahl Nein Die Anzahl der abzurufenden Aktivitäten. Diese Eingabe gibt die Anzahl der zugehörigen, abzurufenden Datensätze an.
skip Ganzzahl Nein Die Anzahl der zu überspringenden Aktivitäten. Diese Eingabe gibt die Anzahl der zu überspringenden Datensätzee an, wenn Datensätze abgerufen werden.
crmType String Nein Der Typ des CRM-Systems Die gültigen Werte sind Dynamics 365 und Salesforce. Diese Eingabe gibt den CRM-Typ an, aus dem die zugehörigen Datensätze abgerufen werden.
crmOrgUrl String Nein Der Hostname der CRM-Organisation, z. B. contoso.crm.dynamics.com. Diese Eingabe gibt die URL für die CRM-Umgebung an, aus dem die zugehörigen Datensätze abgerufen werden.

Anmerkung

Dieser Erweiterungspunkt unterstützt die Darstellung von Erkenntnissen aus bis zu fünf Konnektor-Erweiterungen im Outlook-Sidecar.

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
value Array Ja Eine Liste mit Erkenntnissen (Objekten), die wie im Abschnitt Schema für Erkenntnisse beschrieben, definiert sind.
hasMoreResults 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
recordId String Ja Der eindeutige Bezeichner des Datensatzes. Diese Ausgabe identifiziert eindeutig jeden zugehörigen Datensatz, der von der Aktion zurückgegeben wird.
recordTypeDisplayName String Ja Der Anzeigename des Datensatztyps, z. B Vertrag. Er sollte in der Sprache lokalisiert werden, die durch den Header Accept-Language angegeben wird. Diese Ausgabe gibt die Anzeigename von Datensatztyp jedes zugehörigen Datensatzes an, der von der Aktion zurückgegeben wird.
recordTypePluralDisplayName String Ja Der Plural des Anzeigenamens des Datensatztyps, z. B Verträge. Er sollte in der Sprache lokalisiert werden, die durch den Header Accept-Language angegeben wird. Diese Ausgabe gibt die Plural.Anzeigename vom Datensatztyp jedes zugehörigen Datensatzes an, der von der Aktion zurückgegeben wird.
recordType String Ja Der Systemname des Datensatztyps, z. B Vertrag. Diese Ausgabe gibt den Datensatztyp jedes zugehörigen Datensatzes an, der von der Aktion zurückgegeben wird.
recordTitle String Ja Der Name des Datensatzes, z. B Verlängerungsvertrag für Contoso 2023. Diese Ausgabe gibt den Titel jedes zugehörigen Datensatzes an, der von der Aktion zurückgegeben wird.
url String Nein Eine gültige URL zum Öffnen des Datensatzes in der Partneranwendung. Diese Ausgabe gibt die URL jedes zugehörigen Datensatzes an, der von der Aktion zurückgegeben wird.
additionalProperties Ein Objekt mit den Werten Eigenschaftsname und Eigenschaftswert vom Typ Zeichenfolge Nein

Zusätzliche Eigenschaften, die in der Detailansicht angezeigt werden. Eigenschaftsnamen und -werte liegen in natürlicher Sprache in der Sprache vor, die über den Header Accept-Language angegeben wird. Im Folgenden finden Sie ein Beispiel.

{
 „Statusgrund“: „Abgemeldet“,
 „Besitzer“: „Kenny Smith“
}
 Diese Ausgabe gibt zusätzliche Eigenschaften als Name-Wert-Paare jedes zugehörigen Datensatzes an, der von der Aktion zurückgegeben wird.

Beispiel

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

Das Beispiel in der folgenden Abbildung zeigt, wie die Ausgabe der API der zugehörigen Datensätze zugeordnet wird.

Screenshot mit der Anatomie der zugehörigen Datensätze aus einer Partneranwendung.

Legende:

  1. Karte mit verknüpften Datensätzen aus der Partneranwendung.
  2. Symbol und Titel der Karte. Das Symbol wird aus den Microsoft Power Platform-Konnektormetadaten abgerufen. Der Titel des Namens des Microsoft Power Platform-Konnektors.
  3. Zugehörige Datensatztitel aus der API-Antwort. Zwei zusätzliche Eigenschaften aus der API-Antwort werden als Schlüsselfelder jedes verknüpften Datensatzes gerendert.
  4. Die Schaltfläche „Weitere Aktionen“, die entweder zum Kopieren eines Links zum Datensatz oder zum Anzeigen von Datensatzdetails in der Partneranwendung verwendet werden kann. Der Link basiert auf der URL des zugehörigen Datensatzes in der API-Antwort.
  5. Zusätzliche Eigenschaften des zugehörigen Datensatzes aus der API-Antwort.

Anzeigen von Datensatzdetails
E-Mail-Zusammenfassungen mit Erkenntnissen aus Ihrer Anwendung anreichern
E-Mail-Entwürfe mit Dateilinks aus Ihrer Anwendung anreichern
Wichtige Vertriebsinformationen 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