CRM-Datensatzzusmmenfassungen mit Erkenntnissen aus Ihrer Anwendung anreichern (Vorschauversion)

Important

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

Um den Kontext eines Meetings, auf das sie sich vorbereiten, oder einer E-Mail, die sie lesen, besser zu verstehen, benötigen Verkäufer relevante Informationen zum Customer Relationship Management (CRM), z. B. Kundenanfragen, Bedenken und Notizen. Der Vertriebsmitarbeiter verwendet KI, um eine Zusammenfassung der einzelnen CRM-Datensätze zu generieren. In dieser Zusammenfassung werden wichtige Details wie die Verkaufsphase, das Budget und das voraussichtliche Abschlussdatum hervorgehoben. Sie können die CRM-Datensatzzusammenfassungsfunktion erweitern, die der Vertriebsmitarbeiter mit Einblicken aus Ihrer eigenen Anwendung bietet.

API Beschreibung

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

Mit dieser Aktion werden zusätzliche Vertriebserkenntnisse in Bezug auf einen CRM-Datensatz abgerufen, die auf der Karte für C4S-Datensatzzusammenfassungen angezeigt werden. Die Aktion erweitert die vorhandenen Fähigkeiten von Copilot für Vertrieb.

API-Vorgang

Diese API verwendet Den Vorgangstyp: GET

Eingabeparameter

Der Vertriebsmitarbeiter wurde entwickelt, um die folgenden Eingabeparameter für Ihre APIs bereitzustellen.

Name Datentyp/Format Erforderlich Details Beschreibung zum Hinzufügen der Aktion
Aufzeichnungstyp String Ja Der Entitäts- oder Objekttyp im CRM, für den zugehörige Erkenntnisse wie Aktivitäten 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 zeigt den Entitäts- oder Objekttyp im CRM an, für den zugehörige Erkenntnisse wie Aktivitäten angefordert werden.
recordId String Ja Der eindeutige Bezeichner des DRM-Datensatzes. Diese Eingabe stellt den eindeutigen Bezeichner für den CRM-Datensatz, für den die Erkenntnisse angefordert wurden.
startDateTime Zeichenfolge im Datum/Uhrzeit-Format No Das Startdatum und die -uhrzeit zum Nachschlagen von Erkenntnissen. Das Format folgt der OpenAPI-Spezifikation. Hier ist ein Beispiel: 2017-07-21T17:32:28Z. Diese Eingabe gibt das Startdatum und die Startzeit für die angeforderten Erkenntnisse an.
endDateTime Zeichenfolge im Datum/Uhrzeit-Format No Das Enddatum und die -uhrzeit zum Suchen von Erkenntnissen. Das Format folgt der OpenAPI-Spezifikation. Hier ist ein Beispiel: 2017-07-21T17:32:28Z. Diese Eingabe gibt das Enddatum und die Startzeit für die angeforderten Erkenntnisse an.
top Integer No Die Anzahl der abzurufenden Erkenntnisse. Diese Eingabe gibt die Anzahl der abzurufenden Erkenntnisse an.
skip Integer No Die Anzahl der Erkenntnisse, die übersprungen werden sollen. Diese Eingabe gibt die Anzahl der abzurufenden Erkenntnisse an, die übersprungen werden.
CRM-Typ String No Die gültigen Werte sind Dynamics 365 und Salesforce. Diese Eingabe gibt den CRM-Typ an, in dem der CRM-Datensatz vorhanden ist, für den wichtige Erkenntnisse angefordert werden.
crmOrgUrl String No Der Hostname der CRM-Organisation, z. B. contoso.crm.dynamics.com. Diese Eingabe gibt die URL der CRM-Umgebung an, in dem der CRM-Datensatz vorhanden ist, für den wichtige Erkenntnisse angefordert werden.

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.
hatMehrErgebnisse Boolean No Ein Wert, der angibt, ob weitere Ergebnisse verfügbar sind.

Schema für Einblicke

Name Datentyp/-format Erforderlich Details Beschreibung, die der Aktion hinzugefügt wird
Titel String Ja Der Titel der Erkenntnis auf der Zitatkarte. Es handelt sich um den Titel der Erkenntnis in natürlicher Sprache, die durch den Accept-Language-Anforderungsheader definiert ist. Hier sehen Sie ein Beispiel: Vertrag unterzeichnet. Diese Ausgabe gibt den Titel der Aktivität in der Zitationskarte an.
Beschreibung String Ja Die Beschreibung der Erkenntnis. Sie wird als Aufzählungspunkt in der Datensatzzusammenfassung angezeigt und ist die Beschreibung der Erkenntnis in natürlicher Sprache, und zwar in der Sprache, die durch die Accept-Language-Kopfzeile angegeben wird. Beispiel: Kenny, Logan und zwei weitere Personen unterzeichneten am 07.09.2023 den Verlängerungsvertrag für Contoso 2023. Diese Ausgabe gibt die Beschreibung der Erkenntnis an.
DatumZeit Zeichenfolge im Datum/Uhrzeit-Format Ja Das Datum und die Uhrzeit der Aktivität im UTC-Format. Wenn die Aktivität sowohl über eine Startzeit als auch über eine Endzeit verfügt, muss die Anwendung bestimmen, welche Uhrzeit angezeigt werden soll. Das Format folgt der OpenAPI-Spezifikation. Hier ist ein Beispiel: 2017-07-21T17:32:28Z. Diese Ausgabe gibt die mit der Erkenntnis verbundene Zeit an.
url String No Eine gültige URL zum Öffnen der Aktivität in der Partneranwendung. Diese Ausgabe gibt die URL zum Öffnen von Insight an.
additionalProperties Ein Objekt mit Eigenschaftsnamen- und Eigenschaftswertwerten des Zeichenfolgentyps No

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. Hier ist ein Beispiel.

{
 „Statusgrund“: „Abgemeldet“,
 „Besitzer“: „Kenny Smith“
}
 Diese Ausgabe gibt zusätzliche Eigenschaften an, die in der Detailansicht der Erkenntnis angezeigt werden.

Note

Obwohl die API-Anforderungen zur Erweiterung der E-Mail-Zusammenfassungs- und Datensatzzusammenfassungsfunktionen ähnlich aussehen können, müssen sie im Connector als separate Aktionen hinzugefügt werden.

Beispiel

{
    "value": [
        {
            "title": "Contract signed",
            "description": "You have 5 connections in Fourth Coffee Inc",
            "dateTime": "2024-05-07T03:28:38.0667701Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        },
        {
            "title": "Contract signed",
            "description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
            "dateTime": "2024-05-07T03:28:38.0669445Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        }
    ],
    "hasMoreResults": false
}

Das Beispiel in der folgenden Abbildung zeigt, wie die API-Ausgabe mit der Datensatzzusammenfassung verknüpft ist.

Screenshot mit der Anatomie der letzten Aktivitäten aus einer Partneranwendung.

Legende:

  1. Abschnitt mit Einblicken aus der Partneranwendung. Der Abschnittstitel wird vom Namen des Microsoft Power Platform-Connectors abgeleitet.
  2. Beschreibungen des Einblicks aus der API-Antwort.
  3. Zitatnummern, die ausgewählt werden können, um Details zu den Einblicken anzuzeigen.
  4. Zitatkarte, die Details zu den Einblicken zeigt.
  5. Symbol und Titel der Erkenntnis. Das Symbol wird aus den Metadaten des Microsoft Power Platform-Connectors abgerufen. Der Titeltext ist der Titel der Erkenntnis aus der API-Antwort.
  6. Zusätzliche Eigenschaften des Einblicks aus der API-Antwort.
  7. Name der Partneranwendung. Der angezeigte Name ist der Name des Microsoft Power Platform-Connectors.
  8. Ein Link, der ausgewählt werden kann, um Einblicke in der Partneranwendung anzuzeigen. Sie basiert auf der URL des Einblicks in die API-Antwort.

Datensatzzusammenfassung anzeigen
Anreichern von E-Mail-Zusammenfassungen mit Erkenntnissen aus Ihrer Anwendung
Anreichern von E-Mail-Entwürfen mit Dateilinks aus Ihrer Anwendung
Erweitern von Gelegenheitserkenntnissen mit Daten aus Ihrer Anwendung
CRM-Datensatzdetails mit Erkenntnissen aus Ihrer Anwendung anreichern
Erweitern des Vertriebsmitarbeiters mit Partneranwendungen
Erstellen von Erweiterungen für Vertriebsmitarbeiter

  • Last updated on