Zdieľať cez

Obohaťte podrobnosti záznamov CRM o informácie z vašej aplikácie (ukážka)

  • Článok

Dôležité

[Tento článok je predbežnou dokumentáciou a môže sa zmeniť.]

Predajcovia môžu zobraziť podrobnosti o uloženom kontakte spolu so súvisiacimi záznamami, ako sú účty a príležitosti. Schopnosť podrobností záznamov správy vzťahov so zákazníkmi (CRM), ktorú Copilot for Sales poskytuje, môžete rozšíriť o informácie z vašej vlastnej aplikácie.

Popis API

K akcii musíte pridať nasledujúci popis API. Týmto spôsobom môže Copilot for Sales identifikovať správne rozhranie API, ktoré je potrebné vyvolať na obohatenie schopnosti.

Táto akcia získa záznamy súvisiace so záznamom CRM. Akcia zlepšuje existujúce zručnosti Copilota pre predaj.

Prevádzka API

Toto rozhranie API používa typ operácie: GET

Vstupné parametre

Copilot for Sales je navrhnutý tak, aby poskytoval nasledujúce vstupné parametre pre vaše rozhrania API.

Name Typ/formát údajov Požaduje sa Details Popis, ktorý sa má pridať do akcie
RecordType String Áno Typ entity alebo objektu v CRM, pre ktorý sa vyžadujú súvisiace záznamy. Hodnota zahŕňa jedinečný názov entity alebo typu objektu agnostický pre jazyk, nie zobrazovaný názov, ktorý možno lokalizovať. Príklady zahŕňajú účet a príležitosť. Tento vstup identifikuje typ záznamu v CRM, pre ktorý sú požadované súvisiace záznamy.
recordId String Áno Jedinečný identifikátor záznamu CRM. Tento vstup poskytuje jedinečný identifikátor záznamu CRM, pre ktorý sú požadované súvisiace záznamy.
top Integer No Počet aktivít, ktoré sa majú načítať. Tento vstup označuje počet súvisiacich záznamov, ktoré sa majú načítať.
preskočiť Integer No Počet aktivít, ktoré sa majú preskočiť. Tento vstup označuje počet záznamov, ktoré sa majú preskočiť pri načítavaní súvisiacich záznamov.
crmType String No Typ CRM systému. Platné hodnoty sú Dynamics 365 a Salesforce. Tento vstup označuje typ CRM, z ktorého sa získavajú súvisiace záznamy.
crmOrgUrl String No Názov hostiteľa organizácie CRM, napríklad contoso.crm.dynamics.com. Tento vstup označuje adresu URL prostredia CRM, z ktorého sa získavajú súvisiace záznamy.

Poznámka

Tento bod rozšírenia podporuje vykresľovanie prehľadov až z piatich rozšírení konektorov v postrannom vozíku programu Outlook.

Výstupné parametre

Copilot for Sales očakáva, že dostane zoznam prehľadov (objektov) z vašich rozhraní API, a očakáva, že každý prehľad bude mať špecifické parametre. Aby Copilot for Sales mohol správne analyzovať výstup, štruktúra odpovede musí spĺňať pokyny v nasledujúcej tabuľke.

Parameter Typ údajov Požaduje sa Details
hodnota Pole Áno Zoznam prehľadov (objektov), ​​ktoré sú definované podľa popisu v sekcii Schéma prehľadov .
Has MoreResults Boolean No Hodnota, ktorá označuje, či je k dispozícii viac výsledkov.

Schéma prehľadov

Name Typ/formát údajov Požaduje sa Details Popis, ktorý sa má pridať do akcie
recordId String Áno Jedinečný identifikátor záznamu. Tento výstup jedinečne identifikuje každý súvisiaci záznam vrátený akciou.
recordTypeDisplayName String Áno Zobrazovaný názov typu záznamu, napríklad Zmluva. Mal by byť lokalizovaný v jazyku, ktorý je špecifikovaný v hlavičke Accept-Language . Tento výstup označuje zobrazovaný názov typu záznamu každého súvisiaceho záznamu vráteného akciou.
recordTypePluralDisplayName String Áno Zobrazovaný názov typu záznamu v množnom čísle, napríklad Zmluvy. Mal by byť lokalizovaný v jazyku, ktorý je špecifikovaný v hlavičke Accept-Language . Tento výstup označuje množné číslo zobrazovaného názvu typu záznamu každého súvisiaceho záznamu vráteného akciou.
RecordType String Áno Systémový názov typu záznamu, napríklad kontrakt. Tento výstup označuje typ každého súvisiaceho záznamu vráteného akciou.
recordTitle String Áno Názov rekordu, napríklad Contoso 2023 Renewal Contract. Tento výstup označuje názov každého súvisiaceho záznamu vráteného akciou.
URL adresa String No Platná adresa URL na otvorenie záznamu v partnerskej aplikácii. Tento výstup označuje URL každého súvisiaceho záznamu vráteného akciou.
dodatočnéVlastnosti Objekt, ktorý má hodnoty Názov vlastnosti a Hodnota vlastnosti typu Reťazec No

Ďalšie vlastnosti, ktoré sú zobrazené v detailnom zobrazení. Názvy vlastností a hodnoty sú v prirodzenom jazyku v jazyku, ktorý je špecifikovaný v hlavičke Accept-Language . Tu je príklad.

{
 "Dôvod stavu": "Odhlásený",
 "Vlastník": "Kenny Smith"
}
 Tento výstup označuje ďalšie vlastnosti ako páry názov-hodnota každého súvisiaceho záznamu vráteného akciou.

Príklad

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

Príklad na nasledujúcom obrázku ukazuje, ako sa výstup rozhrania API mapuje na súvisiace záznamy.

Snímka obrazovky zobrazujúca anatómiu súvisiacich záznamov z partnerskej aplikácie.

Legenda:

  1. Karta, ktorá zobrazuje súvisiace záznamy z partnerskej aplikácie.
  2. Ikona a názov karty. Ikona sa načíta z metadát konektora Microsoft Power Platform . Názov je názov konektora Microsoft Power Platform .
  3. Názvy súvisiacich záznamov z odpovede API. Dve ďalšie vlastnosti z odpovede API sa vykreslia ako kľúčové polia každého súvisiaceho záznamu.
  4. Tlačidlo "Ďalšie akcie", ktoré možno použiť buď na skopírovanie odkazu na záznam, alebo na zobrazenie podrobností záznamu v partnerskej aplikácii. Odkaz je založený na adrese URL súvisiaceho záznamu v odpovedi API.
  5. Ďalšie vlastnosti súvisiaceho záznamu z odpovede API.

Zobraziť podrobnosti záznamu
Obohaťte e-mailové súhrny o informácie z vašej aplikácie
Obohaťte koncepty e-mailov o odkazy na súbory z vašej aplikácie
Obohaťte kľúčové informácie o predaji o informácie z vašej aplikácie
Obohaťte súhrny záznamov CRM o informácie z vašej aplikácie
Rozšírte Microsoft 365 Copilot for Sales o partnerské aplikácie
Zostavte rozšírenia Copilot for Sales