Enriqueix els esborranys de correu electrònic amb enllaços de fitxer de la teva aplicació (versió preliminar)
Important
- Aquesta és una funció en versió preliminar llesta per a la producció.
- Les previsualitzacions preparades per a la producció estan subjectes a condicions d'ús addicionals.
[Aquest article forma part de la documentació preliminar i està subjecte a canvis.]
Quan utilitzeu el Copilot for Sales per redactar un correu electrònic, té en compte la intenció del correu electrònic i utilitza la informació del CRM del Salesforce o el Dynamics 365 per crear l'esborrany. Podeu ampliar la capacitat de redacció de correu electrònic que proporciona Copilot for Sales amb fitxers recomanats des de la vostra pròpia aplicació.
Nota
Aquesta característica només s'admet per als esborranys de correu electrònic creats amb la subfinestra lateral de Copilot for Sales a l'Outlook.
Descripció de l'API
Heu d'afegir la següent descripció de l'API a l'acció. D'aquesta manera, Copilot for Sales pot identificar l'API correcta que s'ha d'invocar per enriquir la capacitat.
Aquesta acció obté fitxers rellevants per a la conversa de correu electrònic, que es mostraran als esborranys de correu electrònic C4S a Outlook. L'acció potencia les habilitats existents de copilot per a les vendes.
Funcionament de l'API
Aquesta API utilitza el tipus d'operació: POST
Càrrega útil d'entrada
Aquesta càrrega útil va com el cos de la sol·licitud de l'API.
| Nom | Tipus de dades | Necessari | Detalles | Descripció per afegir a l'acció |
|---|---|---|---|---|
| resourceData | Objecte | Sí | Les dades de recursos que s'utilitzaran per obtenir el contingut suggerit. Per a l'estructura de dades, aneu a Model de dades de correu electrònic d'extensibilitat. | Aquesta entrada identifica el contingut del correu electrònic que és una col·lecció de fil de correu electrònic, assumpte i altres detalls. |
| Tipus de recurs | String | Sí | Tipus de recurs per al qual es poden obtenir suggeriments de contingut. Per exemple, "fil de correu electrònic" o "xat d'equips". | Aquesta entrada identifica el tipus de recurs compartit per obtenir enllaços de fitxers suggerits, que en aquest cas és "fil de correu electrònic". |
| recordType | String | No | El tipus de registre del CRM, com ara el compte o l'oportunitat. | Aquesta entrada identifica el tipus de registre al CRM, que està relacionat amb el fil de correu electrònic. |
| registreId | String | No | Identificador únic del registre CRM que s'utilitzarà per als continguts suggerits. | Aquesta entrada proporciona l'identificador únic del registre del CRM relacionat amb el fil de correu electrònic. |
| Tipus de crm | String | No | El tipus de sistema CRM, si està connectat. Els valors vàlids són Salesforce i Dynamics 365. | Aquesta entrada indica el tipus de CRM en què existeix el registre relacionat amb el fil de correu electrònic. |
| crmOrgUrl | String | No | L'adreça URL de l'organització del CRM. | Aquesta entrada indica l'adreça URL de l'entorn CRM en què existeix el registre relacionat amb el fil de correu electrònic. |
| inputPrompt | String | No | El missatge suggerit que utilitza actualment l'usuari per generar esborrany de correu electrònic. Per exemple, "Respon a una inquietud" o "Fes una proposta". | Aquesta entrada indica la sol·licitud proporcionada per l'usuari mentre redacta un correu electrònic. |
| principal | Integer | No | El nombre d'elements que s'han d'obtenir. | Aquesta entrada indica el nombre d'enllaços de fitxer que s'han d'obtenir. |
| omet | Integer | No | El nombre d'elements que s'han de saltar. | Aquesta entrada indica el nombre d'elements que s'han d'ometre quan s'obtenen enllaços de fitxers suggerits. |
Model de dades de correu electrònic d'extensibilitat
| Propietat | Type | Detalles | Descripció per afegir a l'acció |
|---|---|---|---|
| Cos de text pla | String | El cos complet del correu electrònic inclou tots els missatges anteriors del fil de correu electrònic. | Aquesta entrada proporciona tot el contingut del fil de correu electrònic en format de text. |
| fullHtmlBody | String | La versió HTML completa del cos del correu electrònic que inclou tots els missatges anteriors del fil de correu electrònic. | Aquesta entrada proporciona tot el contingut del fil de correu electrònic en format HTML. |
| subject | String | Assumpte del correu electrònic. | Aquesta entrada proporciona l'assumpte del correu electrònic. |
| de | String | Adreça electrònica del remitent. | Aquesta entrada proporciona l'adreça electrònica del remitent. |
| per a | Corda[modifica] | Adreces de correu electrònic del destinatari. | Aquesta entrada proporciona l'adreça de correu electrònic del receptor. |
| Cc | Corda[modifica] | Adreces de correu electrònic dels receptors afegides al camp Cc del correu electrònic. | Aquesta entrada proporciona totes les adreces de correu electrònic del receptor que s'inclouen al camp Cc del correu electrònic. |
| Bcc | Corda[modifica] | Adreces electròniques dels receptors afegides al camp Cco del correu electrònic. | Aquesta entrada proporciona totes les adreces de correu electrònic del destinatari que s'afegeixen al camp Cco del correu electrònic. |
| sentDateTime | DateTimeOffset | La data i l'hora del correu electrònic en format UTC juntament amb la propietat Offset. Per obtenir més informació, aneu a DateTimeOffset Struct (Sistema) | Aquesta entrada proporciona la marca de temps del correu electrònic. |
| Identificador del missatge | String | L'identificador del missatge gràfic del correu electrònic. | Aquesta entrada proporciona l'identificador del missatge del correu electrònic. |
| conversationId | String | L'identificador de conversa del gràfic del fil de correu electrònic. | Aquesta entrada proporciona l'identificador de conversa del fil de correu electrònic. |
Paràmetres de sortida
| Propietat | Tipus de dades | Necessari | Detalles |
|---|---|---|---|
| valor | Matriu | Sí | Llista d'enllaços de fitxer (objectes) que es defineixen tal com es descriu a la resposta Esquema per a suggeriments de contingut de fitxer o enllaç. |
| hasMoreResults | Boolean | No | Valor que indica si hi ha més resultats disponibles. |
Esquema per a la resposta de suggeriments de contingut de fitxer o enllaç
| Nom | Format del tipus de dades | Necessari | Detalles | Descripció per afegir a l'acció |
|---|---|---|---|---|
| contentType | cadena | Sí | El tipus de contingut que es mostrarà. Per a més informació, aneu a Valors predefinits per a contentType | Aquesta sortida indica el tipus de contingut inclòs amb l'esborrany del correu electrònic. |
| contingut | cadena | Sí | Contingut real inclòs. Pot ser una pàgina web o un URL del fitxer. | Aquesta sortida indica el contingut real que s'inclou amb l'esborrany del correu electrònic. Pot ser una pàgina web o un URL. |
| contingutTítol | cadena | Sí | Títol del contingut suggerit que es mostra a l'usuari. | Aquesta sortida indica el títol del contingut. |
| contingutDescripció | cadena | Sí | Descripció del contingut suggerit que es mostra a l'usuari. | Aquesta sortida indica el text que s'ha d'incloure en descriure els fitxers. |
| contingutIconUrl | cadena | No | Icona del contingut suggerit que es mostra a l'usuari. Si no es proporciona, s'utilitza una icona genèrica. | Aquesta sortida indica la icona que s'inclourà per al contingut. |
| Propietats addicionals | Objecte | No | Conjunt de parells nom-valor que indiquen propietats addicionals de l'enllaç de fitxer relacionat que retorna l'acció. | Aquesta sortida indica propietats addicionals com a parells nom-valor de cada enllaç relacionat retornat per l'acció. |
Valors predefinits per a contentType
| Valor de cadena | Tipus de contingut |
|---|---|
| Fitxer de contingut | Fitxer extern (genèric) |
| contingut-web | Pàgina web externa |
| Documentació de contingut | Microsoft Word Document |
| Contingut-PDF | Microsoft PDF Document |
| contingut-pptx | Presentació de Microsoft PowerPoint |
| contingut-xlsx | Microsoft Excel Càlcul |
Exemple
{
"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
}
L'exemple de la imatge següent mostra com s'assigna la sortida de l'API a l'esborrany de correu electrònic.
Llegenda:
- Enllaços de fitxers d'aplicacions associates.
Consulteu també
Resumir un fil de correu electrònic amb informació de vendes amb el Copilot a l'Outlook
Enriqueix els resums de correu electrònic amb informació de la teva aplicació
Enriqueix la informació clau de vendes amb informació de la teva aplicació
Enriqueix els detalls dels registres del CRM amb la informació de l'aplicació
Enriquir els resums de registres del CRM amb informació de l'aplicació
Ampliar Microsoft 365 Copilot for Sales amb aplicacions de partners
Crear extensions de Copilot per al Sales