Utöka e-postutkast med fillänkar från ditt program (förhandsversion)

Artikel
12/27/2024

Viktigt

Det här är en produktionsklar förhandsgranskningsfunktion.
Produktionsklara förhandsversioner har kompletterande användningsvillkor.

[Den här artikeln är en förhandsversion av dokumentationen och kan ändras.]

När du använder Copilot för försäljning för att skapa ett utkast till ett e-postmeddelande tar det hänsyn till e-postmeddelandets avsikt och använder CRM-information från Salesforce eller Dynamics 365 för att skapa utkastet. Du kan utöka funktionen för e-postutkast som tillhandahålls från Copilot för försäljning med rekommenderade filer från ditt eget program.

Obs

Den här funktionen stöds endast för e-postutkast som skapats med sidofönstret Copilot för försäljning i Outlook.

API-beskrivning

Du måste lägga till följande API-beskrivning i åtgärden. På så sätt kan Copilot för försäljning identifiera rätt API som måste anropas för att utöka funktionen.

Den här åtgärden hämtar filer som är relevanta för e-postkonversationen, som visas i C4S-e-postutkast i Outlook. Åtgärden förbättrar de befintliga färdigheterna i copilot för försäljning.

Indata för nyttolast

Name	Datatyp	Obligatoriskt	Details	Beskrivning som ska läggas till i åtgärden
resourceData	Object	Ja	Resursdata som ska användas för att hämta det föreslagna innehållet. Datastrukturen finns i E-postdatamodell för utökningsbarhet.	Dessa indata identifierar e-postinnehållet som är en samling e-posttrådar, ämnen och annan information.
resourceType	String	Ja	Den typ av resurs som innehållsförslag ska hämtas för. Till exempel "e-posttråd" eller "teams-chatt".	Dessa indata identifierar vilken typ av resurs som delas för att hämta föreslagna fillänkar, som i det här fallet är "e-posttråd".
recordType	String	Nej.	Typ av CRM-post, till exempel konto eller affärsmöjlighet.	Denna indata identifierar posttypen i CRM, som är relaterad till det e-posttråden.
recordId	String	Nej.	Den unika identifieraren för CRM-posten som ska användas för föreslaget innehåll.	Denna indata tillhandahåller den unika identifieraren för den CRM-post som relatera till i e-posttråden.
crmType	String	Nej.	Typen av CRM-system, om den är ansluten. Giltiga värden är Salesforce och Dynamics 365.	Denna indata anger den typ av CRM där posten som är relaterad till e-posttråden finns.
crmOrgUrl	String	Nej.	CRM-organisationens URL.	Denna indata angerURL:en för den CRM-miljö där posten som är relaterad till det e-posttråden finns.
inputPrompt	String	Nej.	Den föreslagna prompt som för närvarande ges av användaren för att generera e-postutkast. Till exempel "Svara på en fråga" eller "Ge ett förslag".	Dessa indata anger den uppmaning som användaren ger när han eller hon skriver ett e-postmeddelande.
top	Integer	Nej.	Antalet objekt att hämta.	Denna indata anger antalet fillänkar som ska hämtas.
hoppa över	Integer	Nej.	Antalet objekt att hoppa över.	Denna indata anger antalet objekt som ska hoppas över när föreslagna fillänkar hämtas.

E-postdatamodell för utökningsbarhet

Property	Type	Details	Beskrivning som ska läggas till i åtgärden
plaintextBody	String	Den fullständiga e-posttexten innehåller alla tidigare meddelanden i e-posttråden i den.	Dessa indata innehåller allt innehåll från e-posttråden i textformat.
fullHtmlBody	String	Den fullständiga HTML-versionen av e-posttexten som innehåller alla tidigare meddelanden i e-posttråden i den.	Dessa indata innehåller allt innehåll från e-posttråden i HTML-format.
certifikatmottagare	String	E-postmeddelandets ämne.	Dessa indata anger ämnet för e-postmeddelandet.
from	String	Avsändarens e-postadress.	Dessa indata innehåller avsändarens e-postadress.
till	Sträng[]	Mottagarens e-postadresser.	Dessa indata innehåller mottagarens e-postadress.
kopia	Sträng[]	Mottagarnas e-postadresser har lagts till i fältet Kopia i e-postmeddelandet.	Den här inmatningen innehåller alla mottagarens e-postadresser som ingår i fältet Kopia i e-postmeddelandet.
Hemlig kopia	Sträng[]	Mottagarnas e-postadresser har lagts till i fältet Hemlig kopia i e-postmeddelandet.	Den här inmatningen innehåller alla mottagarens e-postadresser som har lagts till i fältet Hemlig kopia i e-postmeddelandet.
sentDateTime	DateTimeOffset	Datum och tid för e-postmeddelandet i UTC-format tillsammans med egenskapen Offset. Mer information finns i DateTimeOffset Struct (System)	Dessa indata anger tidsstämpeln för e-postmeddelandet.
messageId	String	Grafmeddelande-ID för e-postmeddelandet.	Dessa indata anger meddelandet-ID för e-postmeddelandet.
conversationId	String	Grafkonversation-ID för e-posttråden.	Dessa indata anger konversations-ID för e-posttråden.

Utdataparametrar

Property	Datatyp	Obligatoriskt	Details
value	Matris	Ja	En lista över fillänkar (objekt) som definieras enligt beskrivningen i svaret Schema för förslag på fil- eller länkinnehåll.
hasMoreResults	Booleskt	Nej.	Ett värde som anger om det finns fler resultat.

Schema för svar på förslag på fil- eller länkinnehåll

Name	Datatyp/format	Obligatoriskt	Details	Beskrivning som ska läggas till i åtgärden
contentType	string	Ja	Typ av innehåll att visa. Mer information finns i Fördefinierade värden för contentType	Dessa utdata anger vilken typ av innehåll som ingår i e-postutkastet.
content	string	Ja	Faktiskt innehåll ingår. Det kan antingen vara en webbsida eller en URL till filen.	Dessa utdata anger vilken typ av innehåll som ingår i e-postutkastet. Det kan antingen vara en webbsida eller en URL.
contentTitle	string	Ja	Titel på det föreslagna innehåll som visas för användaren.	Denna utdata anger titeln för innehållet.
contentDescription	string	Ja	Beskrivning av det föreslagna innehåll som visas för användaren.	Dessa utdata anger den text som ska inkluderas när filerna beskrivs.
contentIconUrl	string	Nej.	Ikon för det föreslagna innehåll som visas för användaren. Om den inte anges används en generisk ikon.	Dessa utdata anger ikonen som ska inkluderas för innehållet.
additionalProperties	Object	Nej.	En uppsättning namn/värde-par som anger ytterligare egenskaper för den relaterade fillänken som returneras av åtgärden.	Denna utdata indikerar ytterligare egenskaper som namn/värde-par för respektive länk som returneras av åtgärden.

Fördefinierade värden för contentType

Strängvärde	Typ av innehåll
innehållsfil	Extern fil (allmän)
Innehållswebb	Extern webbsida
Innehållsdokument	Microsoft Word-dokument
Innehålls-pdf	Microsoft PDF-dokument
innehålls-pptx	Microsoft Powerpoint-presentation
innehålls-xlsx	Microsoft Excel-kalkylblad

Exempel

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

Exemplet i följande bild visar hur API-utdata mappas i e-postsutkastet.

Skärmbild som visar fillänkar från partnerprogram i e-postutkastet.

Förklaring:

Fillänkar från partnerappar.

Se även

Sammanfatta en e-posttråd med försäljningsinformation med Copilot i Outlook
Utöka e-postsammanfattningar med insikter från din app
Utöka viktig säljinformation med insikter från din app
Berika postinformation för CRM med insikter från ditt program
Berika postsammanfattningar för CRM med insikter från din app
Utöka Microsoft 365 Copilot för försäljning med partnerappar
Skapa Copilot för försäljning-tillägg

Dela via