Verrijk e-mailconcepten met bestandskoppelingen uit uw applicatie (preview)

Artikel
12/31/2024

Belangrijk

Dit is een productieklare preview-functie.
Productieklare previews zijn onderworpen aan aanvullende gebruiksvoorwaarden.

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Wanneer u Copilot voor Sales gebruikt om een e-mail op te stellen, wordt rekening gehouden met de intentie van de e-mail en wordt CRM-informatie uit Salesforce of Dynamics 365 gebruikt om het concept te maken. U kunt de mogelijkheden voor het opstellen van e-mailberichten die Copilot voor Sales biedt, uitbreiden met aanbevolen bestanden uit uw eigen toepassing.

Notitie

Deze functie wordt alleen ondersteund voor e-mailconcepten die zijn gemaakt met behulp van het zijpaneel Copilot voor Sales in Outlook.

API-omschrijving

U moet de volgende API-beschrijving aan de actie toevoegen. Op deze manier kan Copilot voor Sales de juiste API identificeren die moet worden aangeroepen om de mogelijkheden uit te breiden.

Met deze actie worden bestanden opgehaald die relevant zijn voor de e-mailconversatie. Deze worden weergegeven in C4S-e-mailconcepten in Outlook. De actie verbetert de bestaande vaardigheden van Copilot voor Sales.

Invoernettolading

Meting	Gegevenstype	Vereist	DETAILS	Beschrijving die in de actie moet worden toegevoegd
resourceData	Object	Ja	De brongegevens die gebruikt moeten worden om de voorgestelde inhoud op te halen. Ga voor de gegevensstructuur naar Uitbreidbaarheids-e-mailgegevensmodel.	Met deze invoer wordt de inhoud van de e-mail geïdentificeerd. Deze bestaat uit een verzameling van e-mailthreads, onderwerpen en andere details.
resourceType	String	Ja	Het type bron waarvoor suggesties voor inhoud moeten worden opgehaald. Bijvoorbeeld 'e-mail-thread' of 'teams-chat'.	Met deze invoer wordt het type bron geïdentificeerd dat wordt gedeeld voor het ophalen van voorgestelde bestandskoppelingen. In dit geval is dat 'email-thread'.
recordType	String	No	Het type CRM-record, bijvoorbeeld account of verkoopkans.	Met deze invoer wordt het recordtype in CRM geïdentificeerd dat verband houdt met de e-mailthread.
recordId	String	No	De unieke identificatie van het CRM-record dat moet worden gebruikt voor voorgestelde inhoud.	Deze invoer bevat de unieke identificatie van het CRM-record dat aan de e-mailthread is gekoppeld.
crmType	String	No	Het type CRM-systeem, indien aangesloten. De geldige waarden zijn Salesforce en Dynamics 365.	Met deze invoer wordt het type CRM aangegeven waarin de record met betrekking tot de e-mailthread zich bevindt.
crmOrgUrl	String	No	De URL van de CRM-organisatie.	Met deze invoer wordt de URL aangegeven van de CRM-omgeving waarin het record dat aan de e-mailthread is gekoppeld, zich bevindt.
invoerprompt	String	No	De momenteel gebruikte suggestie van de gebruiker om een e-mailconcept te genereren. Bijvoorbeeld: 'Reageer op een zorg' of 'Doe een voorstel'.	Deze invoer geeft de prompt aan die de gebruiker geeft tijdens het opstellen van een e-mail.
top	Integer	No	Het aantal op te halen items.	Met deze invoer geeft u aan hoeveel bestandskoppelingen u wilt ophalen.
skip	Integer	No	Het aantal items dat moet worden overgeslagen.	Met deze invoer geeft u aan hoeveel items u wilt overslaan bij het ophalen van voorgestelde bestandskoppelingen.

Uitbreidbaarheid e-mail datamodel

Eigenschappen	Type	DETAILS	Beschrijving die in de actie moet worden toegevoegd
plaintextBody	String	De volledige e-mailtekst bevat alle voorgaande berichten van de e-mailthread.	Met deze invoer wordt alle inhoud van de e-mailthread in tekstformaat weergegeven.
volledigeHtmlBody	String	De volledige HTML-versie van de e-mailtekst, met daarin alle voorgaande berichten van de e-mailthread.	Met deze invoer krijgt u alle inhoud van de e-mailthread in HTML-formaat.
subject	String	Onderwerp van het e-mailbericht.	Met deze invoer geeft u het onderwerp van de e-mail op.
from	String	Het e-mailadres van de afzender.	Deze invoer geeft het e-mailadres van de afzender weer.
to	Tekenreeks[]	E-mailadressen van ontvanger.	Deze invoer geeft het e-mailadres van de ontvanger weer.
cc	Tekenreeks[]	E-mailadressen van ontvangers worden toegevoegd in het Cc-veld van de e-mail.	Met deze invoer geeft u alle e-mailadressen van de ontvanger op die in het Cc-veld van de e-mail zijn opgenomen.
bcc	Tekenreeks[]	E-mailadressen van ontvangers worden toegevoegd in het Bcc-veld van de e-mail.	Met deze invoer worden alle e-mailadressen van de ontvanger weergegeven die zijn toegevoegd aan het Bcc-veld van de e-mail.
sentDateTime	DateTimeOffset	De datum en tijd van het e-mailbericht in UTC-indeling, samen met de eigenschap Offset. Ga voor meer informatie naar DateTimeOffset Struct (Systeem)	Deze invoer geeft het tijdstempel van de e-mail weer.
messageId	String	De Graph-bericht-id van het e-mailbericht.	Met deze invoer wordt de bericht-ID van de e-mail weergegeven.
conversationId	String	De Graph-gespreks-id van de e-mailthread.	Deze invoer geeft de conversatie-ID van de e-mailthread weer.

Uitvoerparameters

Eigenschappen	Gegevenstype	Vereist	DETAILS
value	Matrix	Ja	Een lijst met bestandskoppelingen (objecten) die zijn gedefinieerd zoals beschreven in het schema voor reacties op suggesties voor bestands- of koppelingsinhoud.
hasMoreResults	Booleaans	No	Een waarde die aangeeft of meer resultaten beschikbaar zijn.

Schema voor respons op suggesties voor bestands- of koppelingsinhoud

Meting	Gegevenstype indeling	Vereist	DETAILS	Beschrijving die in de actie moet worden toegevoegd
contentType	string	Ja	Het type inhoud dat moet worden weergegeven. Meer informatie, ga naar Vooraf gedefinieerde waarden voor contentType	Deze uitvoer geeft aan welk type inhoud bij het e-mailconcept is gevoegd.
inhoud	string	Ja	Daadwerkelijk opgenomen inhoud. Het kan een webpagina of een URL van het bestand zijn.	Deze uitvoer geeft de werkelijke inhoud weer die in het e-mailconcept is opgenomen. Het kan een webpagina of een URL zijn.
contentTitle	string	Ja	Titel van de voorgestelde inhoud die aan de gebruiker wordt getoond.	Deze uitvoer geeft de titel van de inhoud weer.
contentDescription	string	Ja	Beschrijving van de voorgestelde inhoud die aan de gebruiker wordt getoond.	Deze uitvoer geeft aan welke tekst moet worden opgenomen bij het beschrijven van de bestanden.
contentIconUrl	string	No	Icoon van de voorgestelde inhoud die aan de gebruiker wordt getoond. Als er geen pictogram is opgegeven, wordt er een algemeen pictogram gebruikt.	Deze uitvoer geeft aan welk pictogram voor de inhoud moet worden opgenomen.
additionalProperties	Object	No	Een set naam-waardeparen die aanvullende eigenschappen aangeven van de gerelateerde bestandskoppeling die de actie retourneert.	Deze uitvoer geeft aanvullende eigenschappen weer als naam-waardeparen van elke gerelateerde koppeling die door de actie wordt geretourneerd.

Vooraf gedefinieerde waarden voor contentType

Tekenreekswaarde	Type inhoud
inhoud-bestand	Extern bestand (generiek)
inhoud-web	Externe webpagina
inhoud-doc	Microsoft Word-document
inhoud-pdf	Microsoft PDF-document
inhoud-pptx	Microsoft PowerPoint-presentatie
inhoud-xlsx	Microsoft Excel-spreadsheet

Voorbeeld

{
  "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
}

Het voorbeeld in de onderstaande afbeelding laat zien hoe de uitvoer van de API wordt gekoppeld aan het e-mailconcept.

Schermafbeelding met bestandskoppelingen van partner-apps in het e-mailconcept.

Legenda:

Bestandskoppelingen van partner-apps.

Zie ook

Een overzicht maken van een e-mailthread met behulp van verkoopinformatie met Copilot in Outlook
E-mailsamenvattingen verrijken met inzichten uit uw toepassing
Belangrijke verkoopinformatie verrijken met inzichten uit uw toepassing
Belangrijke CRM-recorddetails verrijken met inzichten uit uw toepassing
CRM-recordsamenvattingen verrijken met inzichten uit uw toepassing
Microsoft 365 Copilot voor Sales uitbreiden met partnertoepassingen
Copilot voor Sales-uitbreidingen bouwen

Delen via