Megosztás a következőn keresztül:

A CRM-rekordok részleteinek gazdagítása az alkalmazásból származó elemzésekkel (előzetes verzió)

  • Cikk

Fontos

  • Ez egy termelésre kész előzetes funkció.
  • A gyártásra kész előzetesekre kiegészítő használati feltételek vonatkoznak.

[Ez a cikk egy előzetes kiadási dokumentáció, amely a későbbiekben változhat.]

Az eladók megtekinthetik a mentett kapcsolattartók részleteit a kapcsolódó rekordokkal, például partnerekkel és lehetőségekkel együtt. Kiterjesztheti a Copilot for Sales által biztosított ügyfélkapcsolat-kezelési (CRM) rekordrészletek képességet a saját alkalmazásából származó elemzésekkel.

API leírás

A művelethez hozzá kell adnia a következő API-leírást. Ily módon a Copilot for Sales azonosítani tudja a megfelelő API-t, amelyet meg kell hívni a képesség gazdagításához.

Ez a művelet lekéri a CRM-bejegyzéshez kapcsolódó bejegyzéseket. Az akció fejleszti a Copilot for Sales meglévő készségeit.

API-művelet

Ez az API a következő művelettípust használja: GET

Bemeneti paraméterek

A Copilot for Sales úgy lett kialakítva, hogy a következő bemeneti paramétereket biztosítsa az API-k számára.

Name Adattípus/formátum Szükséges Details A művelethez hozzáadandó leírás
recordType Sztring Igen Annak az entitásnak vagy objektumnak a típusa a CRM rendszerben, amelyhez kapcsolódó bejegyzéseket kérnek. Az érték az entitás vagy objektumtípus nyelvfüggetlen egyedi nevét tartalmazza, nem a honosítható megjelenítendő nevet. Ilyen például a fiók és a lehetőség. Ez a bemenet azonosítja azt a bejegyzéstípust a CRM rendszerben, amelyhez kapcsolódó bejegyzéseket kérnek.
recordId Sztring Igen A CRM-bejegyzés egyedi azonosítója. Ez a bemenet biztosítja annak a CRM-bejegyzésnek az egyedi azonosítóját, amelyhez kapcsolódó bejegyzéseket kér.
felső Egész szám No A lekérendő tevékenységek száma. Ez a bevitel a beolvasandó kapcsolódó rekordok számát jelzi.
Kihagyás Egész szám No A kihagyandó tevékenységek száma. Ez a bevitel a kapcsolódó rekordok beolvasásakor átugrandó rekordok számát jelzi.
crmType Sztring No A CRM rendszer típusa. Az érvényes értékek: Dynamics 365 és Salesforce. Ez a bemenet jelzi a CRM típusát, amelyből a kapcsolódó bejegyzéseket lekérik.
crmOrgUrl Sztring No A CRM-szervezet állomásneve, például contoso.crm.dynamics.com. Ez a bemenet annak a CRM-környezetnek az URL-címét jelzi, amelyből a kapcsolódó bejegyzéseket lekéri.

Feljegyzés

Ez a bővítménypont legfeljebb öt összekötőbővítmény elemzéseinek renderelését támogatja az Outlook oldalkocsiban.

Kimeneti paraméterek

A Copilot for Sales arra számít, hogy megkapja az API-k elemzéseinek (objektumainak) listáját, és elvárja, hogy minden betekintés meghatározott paraméterekkel rendelkezzen. Annak érdekében, hogy a Copilot for Sales megfelelően tudja elemezni a kimenetet, a válaszstruktúrának meg kell felelnie az alábbi táblázatban található irányelveknek.

Paraméter Adattípus Szükséges Details
érték Tömb Igen Az elemzések sémája szakaszban leírtak szerint definiált elemzések (objektumok) listája.
hasMoreResults Boolean No Egy érték, amely azt jelzi, hogy rendelkezésre állnak-e további eredmények.

Elemzések sémája

Name Adattípus/formátum Szükséges Details A művelethez hozzáadandó leírás
recordId Sztring Igen A rekord egyedi azonosítója. Ez a kimenet egyedileg azonosítja a művelet által visszaadott, kapcsolódó rekordokat.
recordTypeDisplayName Sztring Igen A rekordtípus megjelenítendő neve, például Szerződés. A fejlécen keresztül Accept-Language megadott nyelven kell honosítani. Ez a kimenet a művelet által visszaadott, kapcsolódó rekordtípusok megjelenítendő nevét jelzi.
recordTypePluralDisplayName Sztring Igen A rekordtípus többes számú megjelenítendő neve, például Szerződések. A fejlécen keresztül Accept-Language megadott nyelven kell honosítani. Ez a kimenet a művelet által visszaadott, kapcsolódó rekordtípusok többesszámú megjelenítendő nevét jelzi.
recordType Sztring Igen A rekordtípus rendszerneve, például szerződés. Ez a kimenet a művelet által visszaadott, kapcsolódó rekordtípusokat jelzi.
recordTitle Sztring Igen A rekord neve, például Contoso 2023 megújítási szerződés. Ez a kimenet a művelet által visszaadott, kapcsolódó rekordcímeket jelzi.
url-cím Sztring No Egy érvényes URL-cím a rekord megnyitásához a partneralkalmazásban. Ez a kimenet a művelet által visszaadott, kapcsolódó rekordok URL-címét jelzi.
additionalProperties Olyan objektum, amelynek Karakterlánc típusú tulajdonságnév és tulajdonságérték értékei No

A részletes nézetben megjelenő további tulajdonságok. A tulajdonságnevek és -értékek természetes nyelven jelennek meg a fejlécben Accept-Language megadott nyelven. Íme egy példa.

{
 "Állapot oka": "Aláírva",
 "Tulajdonos": "Kenny Smith"
}
 Ez a kimenet a további tulajdonságokat a művelet által visszaadott, kapcsolódó rekord név-érték párjaként jeleníti meg.

Példa

{
    "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
}

Az alábbi képen látható példa bemutatja, hogyan van leképezve az API kimenete a kapcsolódó rekordokra.

Képernyőkép egy partneralkalmazás kapcsolódó rekordjainak anatómiájáról.

Jelmagyarázat:

  1. A partneralkalmazás kapcsolódó rekordjait megjelenítő kártya.
  2. A kártya ikonja és címe. Az ikont a rendszer az Microsoft Power Platform összekötő metaadataiból olvassa be. A cím az Microsoft Power Platform összekötő neve.
  3. Kapcsolódó rekordcímek az API-válaszból. Az API-válasz két további tulajdonsága az egyes kapcsolódó rekordok kulcsmezőiként jelenik meg.
  4. "További műveletek" gomb, amely a rekordra mutató hivatkozás másolására vagy a rekord részleteinek megtekintésére használható a partneralkalmazásban. A hivatkozás az API-válaszban található kapcsolódó rekord URL-címén alapul.
  5. A kapcsolódó rekord további tulajdonságai az API-válaszból.

Rekord részleteinek megtekintése
Az e-mail-összefoglalók gazdagítása az alkalmazásból származó elemzésekkel
E-mail piszkozatok gazdagítása az alkalmazásból származó fájlhivatkozásokkal
A legfontosabb értékesítési információk gazdagítása az alkalmazásból származó elemzésekkel
CRM-rekordösszegzések gazdagítása az alkalmazásból származó elemzésekkel
A Copilot for Sales kiterjesztése Microsoft 365 partneralkalmazásokkal
A Copilot for Sales bővítmények létrehozása