Zdieľať cez

Obohaťte súhrny 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ť.]

Aby predajcovia lepšie pochopili kontext stretnutia, na ktoré sa pripravujú, alebo e-mailu, ktorý čítajú, chcú relevantné informácie o riadení vzťahov so zákazníkmi (CRM), ako sú otázky zákazníkov, obavy a poznámky. Copilot for Sales používa AI na generovanie súhrnu každého záznamu CRM. V tomto súhrne sú zvýraznené kľúčové detaily, ako napríklad štádium predaja, rozpočet a plánovaný dátum uzávierky. Schopnosť súhrnu záznamov 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 ďalšie štatistiky predaja súvisiace so záznamom CRM, ktoré sa zobrazia na karte súhrnu záznamov C4S. Akcia zlepšuje existujúce zručnosti druhého pilota 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 požadujú súvisiace poznatky, ako sú aktivity. 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 označuje typ entity alebo objektu v CRM, pre ktorý sa požadujú prehľady.
recordId String Áno Jedinečný identifikátor záznamu CRM. Tento vstup označuje jedinečný identifikátor záznamu CRM, pre ktorý sa požaduje prehľad.
startDateTime Reťazec vo formáte „dátum a čas“. No Dátum a čas začiatku vyhľadávania štatistík. Formát sa riadi špecifikáciou OpenAPI . Tu je príklad: 2017-07-21T17:32:28Z. Tento vstup označuje dátum a čas začiatku požadovaných štatistík.
endDateTime Reťazec vo formáte „dátum a čas“. No Dátum a čas ukončenia vyhľadávania štatistík. Formát sa riadi špecifikáciou OpenAPI . Tu je príklad: 2017-07-21T17:32:28Z. Tento vstup označuje dátum a čas ukončenia požadovaných štatistík.
top Integer No Počet prehľadov na načítanie. Tento vstup označuje počet štatistík, ktoré sa majú načítať.
preskočiť Integer No Počet prehľadov, ktoré sa majú preskočiť. Tento vstup označuje počet prehľadov, ktoré sa majú preskočiť.
crmType String No Platné hodnoty sú Dynamics 365 a Salesforce. Tento vstup označuje typ CRM, v ktorom existuje záznam CRM, pre ktorý sa požadujú prehľady.
crmOrgUrl String No Názov hostiteľa organizácie CRM, napríklad contoso.crm.dynamics.com. Tento vstup označuje adresu URL prostredia CRM, v ktorom existuje záznam CRM, pre ktorý sa požadujú prehľady.

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 .
hasMoreResults 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 bude pridaný v akcii
nadpis String Áno Názov náhľadu na citačnom lístku. Je to názov prirodzeného jazyka prehľadu v jazyku, ktorý je špecifikovaný v hlavičke požiadavky Accept-Language . Tu je príklad: Podpísaná zmluva. Tento výstup uvádza názov aktivity v citačnom lístku.
description String Áno Popis náhľadu. Zobrazuje sa ako odrážky v súhrne záznamov a je to prirodzený jazykový popis prehľadu v jazyku, ktorý je špecifikovaný v hlavičke Accept-Language . Tu je príklad: Kenny, Logan a dvaja ďalší podpísali zmluvu o obnovení Contoso 2023 dňa 7. septembra 2023. Tento výstup označuje popis náhľadu.
Dátum a čas Reťazec vo formáte „dátum a čas“. Áno Dátum a čas aktivity vo formáte UTC. Ak má aktivita čas začiatku aj čas ukončenia, aplikácia musí určiť, ktorý čas sa má zobraziť. Formát sa riadi špecifikáciou OpenAPI . Tu je príklad: 2017-07-21T17:32:28Z. Tento výstup označuje čas spojený s prehľadom.
URL adresa String No Platná adresa URL na otvorenie aktivity v partnerskej aplikácii. Tento výstup označuje adresu URL na otvorenie štatistiky.
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 zobrazené v podrobnom zobrazení prehľadu.

Poznámka

Hoci požiadavky rozhrania API na rozšírenie možností súhrnu e-mailov a možností súhrnu záznamov môžu vyzerať podobne, musia byť pridané ako samostatné akcie v konektore.

Príklad

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

Príklad na nasledujúcom obrázku ukazuje, ako je výstup rozhrania API namapovaný na súhrn záznamov.

Snímka obrazovky zobrazujúca anatómiu najnovších aktivít z partnerskej aplikácie.

Legenda:

  1. Sekcia, ktorá zobrazuje štatistiky z partnerskej aplikácie. Názov sekcie je odvodený od názvu konektora Microsoft Power Platform .
  2. Popisy prehľadu z odpovede API.
  3. Čísla citácií, ktoré je možné vybrať na zobrazenie podrobností o prehľade.
  4. Citačná karta, ktorá zobrazuje podrobnosti o prehľade.
  5. Ikona a názov prehľadu. Ikona sa načíta z metadát konektora Microsoft Power Platform . Text nadpisu je názov prehľadu z odpovede rozhrania API.
  6. Ďalšie vlastnosti prehľadu z odpovede API.
  7. Názov partnerskej aplikácie. Zobrazený názov je názov konektora Microsoft Power Platform .
  8. Odkaz, ktorý je možné vybrať na zobrazenie podrobností prehľadu v partnerskej aplikácii. Je založená na adrese URL prehľadu v odpovedi rozhrania API.

Zobraziť súhrn záznamov
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 podrobnosti 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