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

Important

  • Det här är en funktion för produktionsklar förhandsgranskning.
  • Produktionsklara förhandsvisningar är föremål för kompletterande användarvillkor.

[Den här artikeln är förhandsdokumentation och kan komma att ändras.]

När du använder försäljningsagenten för att skapa ett e-postmeddelande tar den 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-postutkastning som försäljningsagenten tillhandahåller med rekommenderade filer från ditt eget program.

Anmärkning

Den här funktionen stöds endast för e-postutkast som skapats med hjälp av försäljningsagenten i Outlook.

API-beskrivning

Du måste lägga till följande API-beskrivning i åtgärden. På så sätt kan försäljningsagenten 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 försäljningskopilotens befintliga färdigheter.

API-åtgärd

Det här API:et använder åtgärdstyp: POST

Indata för nyttolast

Den här nyttolasten används som begärandetext i API-förfrågan.

Namn Datatyp Obligatoriskt Detaljer Beskrivning som ska läggas till i åtgärden
resourceData Object Yes 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 Yes 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 No 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 No 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.
CRM-typ String No 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 No URL:en för CRM-organisationen. Denna indata angerURL:en för den CRM-miljö där posten som är relaterad till det e-posttråden finns.
inputPrompt String No 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 Heltal No Antalet objekt att hämta. Denna indata anger antalet fillänkar som ska hämtas.
skip Heltal No 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

Fastighet Type Detaljer 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.
ämne String Ämne för e-postmeddelandet. Dessa indata anger ämnet för e-postmeddelandet.
från 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. För mer information, gå till DateTimeOffset Struct (System) Dessa indata anger tidsstämpeln för e-postmeddelandet.
meddelande-id 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

Fastighet Datatyp Obligatoriskt Detaljer
value Array Yes En lista över fillänkar (objekt) som definieras enligt beskrivningen i svaret Schema för förslag på fil- eller länkinnehåll.
hasMoreResults Boolesk No Ett värde som anger om fler resultat är tillgängliga.

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

Namn Datatyp/format Obligatoriskt Detaljer Beskrivning som ska läggas till i åtgärden
innehållstyp snöre Yes 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.
innehåll snöre Yes 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.
innehållTitel snöre Yes Titel på det föreslagna innehåll som visas för användaren. Denna utdata anger titeln för innehållet.
innehållBeskrivning snöre Yes 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 snöre No 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 No 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

Example

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

  1. Fillänkar från partnerappar.

Se även

Sammanfatta en e-posttråd med försäljningsinformation med Copilot i Outlook
Berika e-postsammanfattningar med insikter från ditt program
Berika affärsmöjlighetsinsikter med data från ditt program
Berika postinformation för CRM med insikter från ditt program
Berika CRM-postsammanfattningar med insikter från ditt program
Utöka försäljningsagenten med partnerprogram
Skapa tillägg för Försäljningsagent

  • Last updated on