Sdílet prostřednictvím

Rozšíření souhrnů 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.]

Aby prodejci lépe porozuměli kontextu schůzky, na kterou se připravují, nebo e-mailu, který čtou, potřebují relevantní informace o řízení vztahů se zákazníky (CRM), jako jsou dotazy, zájmy a poznámky zákazníků. Copilot pro Sales využívá AI ke generování souhrnu každého záznamu CRM. Tento souhrn upozorňuje na důležité podrobnosti, jako je fáze prodeje, rozpočet a předpokládané datum uzavření. Souhrn záznamu 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á další přehledy prodeje související se záznamem CRM, které se zobrazí na kartě souhrnu záznamů C4S. 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í přehledy, například aktivity. 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 označuje entitu nebo objekt v CRM, pro který jsou požadovány přehledy.
recordId Řetězcové Ano Jedinečný identifikátor záznamu CRM. Tento vstup označuje jedinečný identifikátor záznamu v CRM, pro který jsou požadovány přehledy.
startDateTime Řetězec ve formátu data a času No Počáteční datum a čas vyhledávání přehledů. Formát se řídí specifikací OpenAPI. Zde je příklad: 2017-07-21T17:32:28Z. Tento vstup označuje datum a čas zahájení požadovaných přehledů.
endDateTime Řetězec ve formátu data a času No Koncové datum a čas vyhledávání přehledů. Formát se řídí specifikací OpenAPI. Zde je příklad: 2017-07-21T17:32:28Z. Tento vstup označuje datum a čas ukončení požadovaných přehledů.
nejlepší Integer No Počet přehledů k načtení. Tento vstup udává počet přehledů k načtení.
skip Integer No Počet přehledů, které se mají přeskočit. Tento vstup udává počet přehledů k přeskočení.
crmType Řetězcové No Platné hodnoty jsou Dynamics 365 a Salesforce. Tento vstup označuje typ CRM, ve kterém existuje záznam CRM, pro který jsou požadovány přehledy.
crmOrgUrl Řetězcové No Název hostitele organizace CRM, například contoso.crm.dynamics.com. Tento vstup označuje adresu URL prostředí CRM, ve kterém existuje záznam CRM, pro který jsou požadovány přehledy.

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ý má být přidán v akci
nadpis Řetězcové Ano Nadpis přehledu na kartě citací. Je to nadpis v přirozeném jazyce, který je zadán v záhlaví požadavku Accept-Language. Zde je příklad: Smlouva podepsána. Tento výstup označuje název aktivity na citační kartě.
Popis Řetězcové Ano Popis přehledu. Zobrazuje se jako odrážky v souhrnu záznamů a je uveden v přirozeném jazyce, který je zadán prostřednictvím záhlaví Accept-Language. Zde je příklad: Kenny, Logan a dvě další osoby podepsali 9. 7. 2023 se společností Contoso smlouvu o prodloužení smlouvy. Tento výstup označuje popis přehledu.
dateTime Řetězec ve formátu data a času Ano Datum a čas aktivity ve formátu UTC. Pokud má aktivita počáteční i koncový čas, aplikace musí určit, který čas se má zobrazit. Formát se řídí specifikací OpenAPI. Zde je příklad: 2017-07-21T17:32:28Z. Tento výstup udává čas spojený s přehledem.
adresa URL Řetězcové No Platná adresa URL pro otevření aktivity v partnerské aplikaci. Tento výstup označuje adresu URL pro otevření přehledu.
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 zobrazené v podrobném zobrazení přehledu.

Poznámka:

I když požadavky rozhraní API na rozšíření možností souhrnu e-mailů a souhrnu záznamů mohou vypadat podobně, musí být přidány jako samostatné akce v konektoru.

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

Příklad na následujícím obrázku ukazuje mapování výstupu z rozhraní API na souhrn záznamů.

Snímek obrazovky zobrazující anatomii nejnovějších aktivit z partnerské aplikace.

Legenda

  1. Sekce ukazující přehledy z partnerské aplikace. Název sekce je odvozen od názvu konektoru Microsoft Power Platform.
  2. Popisy přehledu z odpovědi rozhraní API.
  3. Čísla citací, která lze vybrat pro zobrazení podrobností o přehledu.
  4. Citační karta s podrobnostmi o přehledu.
  5. Název a ikona přehledu. Ikona je načtena z metadat konektoru Microsoft Power Platform. Text názvu je název přehledu z odpovědi rozhraní API.
  6. Další vlastnosti přehledu z odpovědi rozhraní API.
  7. Název partnerské aplikace. Název, který se zobrazí, je název konektoru Microsoft Power Platform.
  8. Odkaz, jehož výběrem lze zobrazit podrobnosti přehledů v partnerské aplikaci. Je založen na adrese URL přehledu v odpovědi rozhraní API.

Zobrazení shrnutí 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í podrobností 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