Rozšíření souhrnů e-mailů o přehledy z vaší aplikace (Preview)
Důležité
- Toto je funkce Preview připravená pro produkční prostředí.
- Verze Preview připravené pro produkční prostředí podléhají doplňkovým podmínkám použití.
[Tento článek představuje předběžnou dokumentaci a může se změnit.]
Pokud se Copilot v Outlooku a Copilot pro Sales používají společně, e-mailové souhrny zobrazované v Outlooku obsahují informace o prodeji, které pocházejí z vašeho systému řízení vztahů se zákazníky (CRM), jako je Dynamics 365 nebo Salesforce CRM. E-mailové souhrny poskytované Copilotem 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á dodatečně přehledy prodeje, které se zobrazí v prostředí e-mailového souhrnu C4S v rámci souhrnu Outlooku. 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é | No | Typ záznamu v CRM. Záznam může specifikovat obchodní vztah, příležitost, zájemce nebo kontakt, který souvisí s e-mailem. | Tento vstup identifikuje typ záznamu v CRM, který souvisí se souhrnným e-mailem. |
| recordId | Řetězcové | No | ID záznamu v CRM, pro které jsou požadovány související záznamy. | Tento vstup poskytuje jedinečná identifikátor záznamu v CRM, který souvisí se souhrnným e-mailem. |
| crmType | Řetězcové | No | Typ systému CRM. Platné hodnoty jsou Salesforce a Dynamics 365. | Tento vstup označuje, že existuje typ CRM, ve kterým je záznam související se souhrnným e-mailem. |
| crmOrgUrl | Řetězcové | No | Adresa URL organizace CRM. | Tento vstup označuje, že existuje adresa URL prostředí CRM, ve kterým je záznam související se souhrnným e-mailem. |
| emailContacts | Řetězcové | Ano | Čárkami oddělený seznam e-mailových adres, například kenny@contoso.com,logan@contoso.com. |
Tento vstup označuje seznam všech relevantních e-mailů účastníků v aktuálním e-mailovém vláknu. |
| Hlavní | Integer | No | Počet přehledů k načtení. | Tento vstup udává počet přehledů k načtení. |
| Přeskočit | Integer | No | Počet přehledů, které se mají přeskočit. | Tento vstup udává počet položek, které se mají přeskočit při načítání přehledů. |
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. Poznámka: Přestože tento parametr obsahuje seznam přehledů, v e-mailovém souhrnu rozšíření se použije pouze první přehled. |
| 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 |
|---|---|---|---|---|
| Titulek | Řetězec do 20 znaků | Ano | Název přehledu prodeje. | Tento výstup označuje název partnerské sekce a měl by obsahovat pouze jméno partnera. |
| Description | Řetězcové | Ano | Přehled, který je poskytován uživatelům, například Vaši kolegové Mona Kane, Ray Tanaka a Daniela Smith s nimi již dříve pracovali. | Tento výstup označuje text, který chcete zahrnout do souhrnu e-mailu. |
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": "From Contoso Customer Insights",
"description": "Your colleagues Mona Kane, Ray Tanaka, and Daniela Smith have worked with them before."
}
],
"hasMoreResults": false
}
Příklad na následujícím obrázku ukazuje mapování výstupu z rozhraní API na e-mailový souhrn.
Legenda
- Název přehledu. Přehledy se stejným názvem jsou seskupeny.
- Popis přehledu. Každý přehled má jeden popis.
Související informace
Shrnutí e-mailového vlákna na základě informací o prodeji pomocí Copilota v aplikaci Outlook
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í shrnutí záznamu CRM o přehledy z vaší aplikace
Rozšíření nástroje Microsoft 365 Copilot pro Sales o partnerské aplikace
Rozšíření konceptů e-mailů o odkazy na soubory z vaší aplikace
Sestavení rozšíření Copilot pro Sales