Sdílet prostřednictvím

Obohaťte informace o záznamu CRM o přehledy z vaší aplikace (preview)

  • Článek

Důležité

[Tento článek představuje předběžnou dokumentaci a může se změnit.]

Prodejci mohou zobrazit podrobnosti o uloženém kontaktu spolu s přidruženými záznamy, jako jsou účty a příležitosti. Podrobnosti záznamu řízení vztahů se zákazníky (CRM), který poskytuje Copilot pro Sales, můžete rozšířit o přehledy z vaší vlastní aplikace.

Popis API

K akci je nutné přidat následující popis rozhraní API. Tímto způsobem může Copilot pro Sales identifikovat správné rozhraní API, které musí být vyvoláno pro rozšíření funkce.

Tato akce získá záznamy související se záznamem CRM. Akce vylepšuje stávající funkce Copilot pro Sales.

Vstupní parametry

Copilot pro Sales je navržen tak, aby poskytoval následující vstupní parametry vašim rozhraním API.

Name Datový typ / formát Požadováno Detaily Popis, který je být přidán do akce
recordType Řetězcové Ano Typ entity nebo objektu v CRM, pro který jsou požadovány související záznamy. Tato hodnota obsahuje jedinečný název entity nebo typu objektu, který je nezávislý na jazyce, nikoli zobrazovaný název, který lze lokalizovat. Jedná se například o obchodní vztah nebo příležitost. Tento vstup identifikuje typ záznamu v CRM, pro který jsou požadovány související záznamy.
recordId Řetězcové Ano Jedinečný identifikátor záznamu CRM. Tento vstup poskytuje jedinečný identifikátor záznamu v CRM, pro který jsou požadovány související záznamy.
nejlepší Integer No Počet aktivit k načtení. Tento vstup udává počet souvisejících záznamů k načtení.
skip Integer No Počet aktivit, které se mají přeskočit. Tento vstup udává počet záznamů, které se mají přeskočit při načítání souvisejících záznamů.
crmType Řetězcové No Typ systému CRM. Platné hodnoty jsou Dynamics 365 a Salesforce. Tento vstup označuje typ CRM, ze kterého jsou načítány související záznamy.
crmOrgUrl Řetězcové No Název hostitele organizace CRM, například contoso.crm.dynamics.com. Tento vstup označuje Adresu URL prostředí CRM, ze kterého jsou načítány související záznamy.

Poznámka:

Tento bod rozšíření podporuje vykreslování přehledů z až pěti rozšíření konektoru v postranním vozíku aplikace Outlook.

Výstupní parametry

Copilot pro Sales očekává, že obdrží seznam přehledů (objektů) z vašich rozhraní API a očekává, že každý přehled bude mít konkrétní parametry. Aby bylo zajištěno, že Copilot pro Sales dokáže správně analyzovat výstup, je důležité dodržovat níže uvedenou strukturu dle popisu v následující tabulce.

Parametr Datový typ Požadováno Detaily
value Pole Ano Seznam přehledů (objektů), které jsou definovány způsobem popsaným v části Schéma pro přehledy.
hasMoreResults Logické No Hodnota, která označuje, zda je k dispozici více výsledků.

Schéma pro přehledy

Name Datový typ / formát Požadováno Detaily Popis, který je být přidán do akce
recordId Řetězcové Ano Jedinečný identifikátor záznamu. Tento výstup jednoznačně identifikuje každý související záznam vrácený akcí.
recordTypeDisplayName Řetězcové Ano Zobrazovaný název typu záznamu, například Smlouva. Měl by být lokalizován v jazyce, který je zadán prostřednictvím záhlaví Accept-Language. Tento výstup označuje zobrazované jméno z typu záznamu každého souvisejícího záznamu vráceného akcí.
recordTypePluralDisplayName Řetězcové Ano Zobrazovaný název typu záznamu v množném čísle, například Smlouvy. Měl by být lokalizován v jazyce, který je zadán prostřednictvím záhlaví Accept-Language. Tento výstup označuje zobrazované jméno v množném čísle z typu záznamu každého souvisejícího záznamu vráceného akcí.
recordType Řetězcové Ano Systémový název typu záznamu, například smlouva. Tento výstup označuje typ každého souvisejícího záznamu vráceného akcí.
recordTitle Řetězcové Ano Název záznamu, například Smlouva Contoso 2023 o prodloužení smlouvy. Tento výstup označuje název každého souvisejícího záznamu vráceného akcí.
adresa URL Řetězcové No Platná adresa URL pro otevření záznamu v partnerské aplikaci. Tento výstup označuje adresu URL každého souvisejícího záznamu vráceného akcí.
additionalProperties Objekt, který má hodnoty Název vlastnosti a Hodnota vlastnosti typu řetězec No

Další vlastnosti, které jsou zobrazeny v podrobném zobrazení. Názvy a hodnoty vlastností jsou v přirozeném jazyce, který je zadán prostřednictvím záhlaví Accept-Language. Zde je příklad:

{
 „Důvod stavu“: „Ukončeno“,
 „Vlastník“: „Kenny Smith“
}
 Tento výstup označuje další vlastnosti jako páry název-hodnota každého souvisejícího záznamu vráceného akcí.

Pří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
}

Příklad v následujícím obrázku ukazuje příklad, jak je výstup rozhraní API mapován na související záznamy.

Snímek obrazovky zobrazující anatomii souvisejících záznamů z partnerské aplikace.

Legenda

  1. Karta, která zobrazuje související záznamy z partnerské aplikace.
  2. Ikona a název karty. Ikona je načtena z metadat konektoru Microsoft Power Platform. Název konektoru Microsoft Power Platform.
  3. Související názvy záznamů z odpovědi rozhraní API. Dvě další vlastnosti z odpovědi rozhraní API jsou vykreslovány jako klíčová pole každého souvisejícího záznamu.
  4. Tlačítko „Další akce“, které lze použít buď pro zkopírování odkazu do záznamu nebo pro zobrazení podrobností záznamu v partnerské aplikaci. Odkaz je založený na adrese URL souvisejícího záznamu v odpovědi rozhraní API.
  5. Další vlastnosti souvisejícího záznamu z odpovědi rozhraní API.

Zobrazení podrobností o záznamu
Rozšíření souhrnů e-mailů o přehledy z vaší aplikace
Rozšíření konceptů e-mailů o odkazy na soubory z vaší aplikace
Rozšíření klíčových informací o prodeji o přehledy z vaší aplikace
Rozšíření shrnutí záznamu CRM o přehledy z vaší aplikace
Rozšíření nástroje Microsoft 365 Copilot pro Sales o partnerské aplikace
Sestavení rozšíření Copilot pro Sales