Rozšíření konceptů e-mailů o odkazy na soubory 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.]
Když použijete Copilot pro Sales k vytvoření konceptu e-mailu, vezme v úvahu záměr e-mailu a k vytvoření konceptu použije informace CRM ze Salesforce nebo Dynamics 365. Funkci pro tvorbu e-mailů, kterou poskytuje Copilot pro Sales, můžete rozšířit o doporučené soubory z vlastní aplikace.
Poznámka:
Tato funkce je podporovaná jenom u konceptů e-mailů vytvořených pomocí bočního podokna Copilot pro Sales v Outlooku.
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.
Touto akcí získáte soubory relevantní pro e-mailovou konverzaci, které se zobrazí v návrzích e-mailů C4S v aplikaci Outlook. Akce vylepšuje stávající funkce Copilot pro Sales.
Vstupní datová část
| Name | Datový typ | Požadováno | Detaily | Popis, který je být přidán do akce |
|---|---|---|---|---|
| resourceData | Object | Ano | Data zdrojů, která se mají použít k načtení navrhovaného obsahu. Datovou strukturu najdete v části E-mailový datový model rozšiřitelnosti. | Tento vstup identifikuje obsah e-mailu, což je kolekce e-mailových vláken, předmětu a dalších podrobností. |
| resourceType | Řetězcové | Ano | Typ prostředku, pro který se mají načíst návrhy obsahu. Například "e-mailové vlákno" nebo "teams-chat". | Tento vstup identifikuje typ prostředku sdíleného pro načítání navrhovaných odkazů na soubory, což je v tomto případě "e-mailové vlákno". |
| recordType | Řetězcové | No | Typ záznamu CRM, například obchodní vztah nebo příležitost. | Tento vstup identifikuje typ záznamu v CRM, který souvisí s vláknem e-mailu. |
| recordId | Řetězcové | No | Jedinečný identifikátor záznamu CRM, který se má použít pro navrhovaný obsah. | Tento vstup poskytuje jedinečná identifikátor záznamu v CRM, který souvisí s vláknem e-mailu. |
| crmType | Řetězcové | No | Typ systému CRM, pokud je připojen. Platné hodnoty jsou Salesforce a Dynamics 365. | Tento vstup označuje, že existuje typ CRM, ve kterým je záznam související s vláknem e-mailu. |
| 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í s vláknem e-mailu. |
| inputPrompt | Řetězcové | No | Aktuálně používaná navrhovaná výzva uživatele k vygenerování konceptu e-mailu. Například "Odpovědět na obavu" nebo "Podat návrh". | Tento vstup označuje výzvu poskytnutou uživatelem při vytváření konceptu e-mailu. |
| nejlepší | Integer | No | Počet položek, které se mají načíst. | Tento vstup udává počet odkazů na soubory k načtení. |
| skip | Integer | No | Počet položek, které se mají přeskočit. | Tento vstup udává počet položek, které se mají při načítání navrhovaných odkazů na soubory přeskočit. |
Rozšiřitelnost e-mailového datového modelu
| Vlastnost | Type | Detaily | Popis, který je být přidán do akce |
|---|---|---|---|
| plaintextBody | Řetězcové | Celé tělo e-mailu obsahuje všechny předchozí zprávy e-mailového vlákna. | Tento vstup poskytuje veškerý obsah z e-mailového vlákna v textovém formátu. |
| fullHtmlBody | Řetězcové | Úplná verze HTML těla e-mailu, která obsahuje všechny předchozí zprávy e-mailového vlákna. | Tento vstup poskytuje veškerý obsah z e-mailového vlákna ve formátu HTML. |
| subject | Řetězcové | Předmět e-mailu. | Tento vstup poskytuje předmět e-mailu. |
| from | Řetězcové | E-mailová adresa odesílatele. | Tento vstup poskytuje e-mailovou adresu odesílatele. |
| to | String[] | E-mailové adresy příjemce. | Tento vstup poskytuje e-mailovou adresu příjemce. |
| Kopie | String[] | E-mailové adresy příjemců přidané do pole Kopie e-mailu. | Tento vstup poskytuje všechny e-mailové adresy příjemce, které jsou zahrnuty v poli Kopie e-mailu. |
| skrytá | String[] | E-mailové adresy příjemců přidané do pole Skrytá kopie e-mailu. | Tento vstup poskytuje všechny e-mailové adresy příjemce, které jsou přidány do pole Skrytá kopie e-mailu. |
| sentDateTime | DateTimeOffset | Datum a čas e-mailu ve formátu UTC spolu s vlastností Offset. Další informace najdete v tématu DateTimeOffset Struct (System) | Tento vstup poskytuje časové razítko e-mailu. |
| messageId | Řetězcové | ID zprávy Graph e-mailu. | Tento vstup poskytuje ID zprávy e-mailu. |
| conversationId | Řetězcové | Grafická konverzace Id e-mailového vlákna. | Tento vstup poskytuje ID konverzace e-mailového vlákna. |
Výstupní parametry
| Vlastnost | Datový typ | Požadováno | Detaily |
|---|---|---|---|
| value | Pole | Ano | Seznam odkazů na soubory (objekty), které jsou definovány podle popisu v odpovědi Schéma pro návrhy obsahu souborů nebo odkazů. |
| hasMoreResults | Logické | No | Hodnota, která označuje, zda je k dispozici více výsledků. |
Schéma pro odpověď na návrhy obsahu souborů nebo odkazů
| Name | Formát datového typu | Požadováno | Detaily | Popis, který je být přidán do akce |
|---|---|---|---|---|
| contentType | string | Ano | Typ obsahu, který se má zobrazit. Další informace najdete v tématu Předdefinované hodnoty pro contentType | Tento výstup označuje typ obsahu obsaženého v konceptu e-mailu. |
| obsah | string | Ano | Včetně aktuálního obsahu. Může to být buď webová stránka, nebo adresa URL souboru. | Tento výstup označuje skutečný obsah, který je součástí konceptu e-mailu. Může to být buď webová stránka, nebo adresa URL. |
| contentTitle | string | Ano | Název navrhovaného obsahu, který se zobrazí uživateli. | Tento výstup uvádí název obsahu. |
| contentDescription | string | Ano | Popis navrhovaného obsahu, který se zobrazí uživateli. | Tento výstup označuje text, který má být zahrnut při popisu souborů. |
| contentIconUrl | string | No | Ikona navrhovaného obsahu, která se zobrazí uživateli. Pokud není k dispozici, použije se obecná ikona. | Tento výstup označuje ikonu, která má být zahrnuta do obsahu. |
| additionalProperties | Object | No | Sada páru název-hodnota, které označují dodatečné vlastnosti souvisejícího odkazu na soubor vráceného akcí. | Tento výstup označuje další vlastnosti jako páry název-hodnota každého souvisejícího odkazu vráceného akcí. |
Předdefinované hodnoty pro contentType
| Řetězcová hodnota | Typ obsahu |
|---|---|
| obsah-soubor | Externí soubor (obecný) |
| obsah-web | Externí webová stránka |
| obsah-doc | Dokument Microsoft Word |
| obsah-pdf | Dokument Microsoft PDF |
| obsah-pptx | Prezentace Microsoft PowerPoint |
| obsah-xlsx | Tabulka Microsoft Excel |
Příklad
{
"value": [
{
"contentType": 0,
"content": "https://www.bing.com",
"contentTitle": "Purchase Contract",
"contentDescription": "Purchase Contract Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Logan Edwards",
"Sender Name": "Kenny Smith"
}
},
{
"contentType": 3,
"content": "https://www.microsoft.com",
"contentTitle": "Strategy Planning",
"contentDescription": "Strategy Planning Description",
"contentIconUrl": null,
"additionalProperties": {
"Recipients": "Gabriela Edwards",
"Sender Name": "Maria Smith"
}
},
{
"contentType": 1,
"content": "https://www.bing.com",
"contentTitle": "Contoso Website",
"contentDescription": "Contoso Website Description",
"contentIconUrl": null,
"additionalProperties": {
"Total Views": "100",
"Domain": "Contoso.com"
}
}
],
"hasMoreResults": false
}
Příklad na následujícím obrázku ukazuje mapování výstupu z rozhraní API na koncept e-mailu.
Legenda
- Odkazy na soubory z partnerských aplikací.
Viz také
Shrnutí e-mailového vlákna na základě informací o prodeji pomocí Copilota v aplikaci Outlook
Rozšíření souhrnů e-mailů o přehledy 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í 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