Rozšiřte klíčové informace o prodeji 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.]
Prodejci mohou používat Copilota pro Sales při čtení a psaní e-mailů v aplikaci Outlook k zobrazení klíčových prodejních informací o kontaktech, účtech a příležitostech souvisejících s e-mailem. Klíčové informace o prodeji vycházejí z jednoho z následujících zdrojů:
- Příležitost, která je připojena k e-mailu
- Nejrelevantnější příležitost na základě kontaktů a obchodních vztahů v e-mailu
Funkce klíčových prodejních informací, kterou poskytuje Copilot pro Sales, můžete rozšířit o informace 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, které se zobrazí na kartě s klíčovými informacemi o prodeji C4S v sajdkáře Outlooku. Akce vylepšuje stávající funkce Copilot pro Sales.
Operace rozhraní API
Toto rozhraní API používá typ operace: GET
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 záznamu v řízení vztahů se zákazníky (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, pro který jsou požadovány klíčové informace o prodeji. |
| recordId | Řetězcové | Ano | ID záznamu ve CRM. | Tento vstup poskytuje jedinečný identifikátor záznamu v CRM, pro který jsou požadovány klíčové informace o prodeji. |
| crmType | Řetězcové | No | Typ systému CRM. Platné hodnoty jsou Salesforce a Dynamics 365. | Tento vstup označuje typ CRM, ve kterém existuje záznam CRM, pro který jsou požadovány klíčové informace o prodeji. |
| crmOrgUrl | Řetězcové | No | Adresa URL organizace CRM. | Tento vstup označuje adresu URL prostředí CRM, ve kterém existuje záznam CRM, pro který jsou požadovány klíčové informace o prodeji. |
| nejlepší | Integer | No | Počet přehledů k načtení. | Tento vstup udává počet prodejních zvýraznění k načtení. |
| skip | 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í prodejních zvýraznění. |
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 |
|---|---|---|---|---|
| nadpis | Řetězcové | Ano | Název karty citace přehledu prodeje. Může obsahovat pouze jméno partnera a mít maximálně 20 znaků. | Tento výstup označuje název citační karty pro přehled. |
| Popis | Řetězcové | Ano | Popis přehledu prodejů. Zobrazuje se jako odrážka v podokně Klíčové informace o prodeji a může mít až 130 znaků. Zde je příklad: Ověření: Další kroky: Sladění s časovou osou a kritérii úspěchu. | Tento výstup označuje text přehledu, který má být zahrnut do klíčových informací o prodeji. |
| adresa URL | Řetězcové | No | Platná adresa URL pro otevření přehledu v partnerské aplikaci. | Tento výstup uvádí adresu URL, kde se o přehledech dozvíte více. |
| dateTime | DateTime | No | 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. |
| additionalProperties | Objekt, který má hodnoty Název vlastnosti a Hodnota vlastnosti typu řetězec | No | Sada páru název-hodnota, které označují dodatečné vlastnosti souvisejícího přehledu vráceného akcí. Tyto informace se zobrazí v automaticky otevírané kartě, když uživatelé vyberou přehledy v podokně Klíčové informace o prodeji. | Tento výstup označuje další vlastnosti jako páry název-hodnota každého souvisejícího přehledu vráceného akcí. |
Příklad
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
Příklad v následujícím obrázku ukazuje příklad, jak je výstup rozhraní API mapován na klíčové informace o prodeji.
Legenda
- Sekce ukazující přehledy z partnerské aplikace. Název sekce je odvozen od názvu konektoru Microsoft Power Platform.
- Popisy přehledu z odpovědi rozhraní API.
- Čísla citací, která lze vybrat pro zobrazení podrobností o přehledu.
- Citační karta s podrobnostmi o přehledu.
- 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.
- Další vlastnosti přehledu z odpovědi rozhraní API.
- Název partnerské aplikace. Název, který se zobrazí, je název konektoru Microsoft Power Platform.
- 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.
Související informace
Zobrazení klíčových prodejních informací v Copilot pro Sales
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í 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
Sestavení rozšíření Copilot pro Sales