Utöka e-postsammanfattningen med innehållsförslag 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 Copilot i Outlook och försäljningsagenten används tillsammans innehåller e-postsammanfattningar som visas i Outlook försäljningsinformation som kommer från ditt CRM-system (Customer Relationship Management), till exempel Dynamics 365 eller Salesforce CRM. Du kan utöka funktionen för e-postsammanfattning som försäljningsagenten tillhandahåller med insikter från ditt eget program.

Anmärkning

Det här API:et ersätter det befintliga API:et för E-postsammanfattningsfärdighet (åtgärds-ID: scp-get-email-insights) med en ny version.

API-beskrivning

Du måste lägga till följande API-beskrivning i åtgärden. Detta hjälper försäljningsagenten att identifiera rätt API som ska anropas för att utöka funktionen.

Den här åtgärden hämtar ytterligare försäljningsinsikter som visas i e-postsammanfattningen för C4S i Outlook-sammanfattningen. Åtgärden förbättrar försäljningskopilotens befintliga färdigheter.

API-information

  • API-namn: Färdighetsversion 2 för e-postsammanfattning
  • Swagger-åtgärds-ID: scp-get-email-insights-v2
  • Swagger-åtgärdsmetod: post
  • Sökväg: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

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.
relateradeEnheter Array No Matrisen med relaterade entiteter. Datastrukturen finns i Relaterad entitetsdatamodell. Dessa indata identifierar matrisen med CRM-poster, som är relaterade till 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.
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.
cc Sträng[] Mottagarens e-postadresser tillagda 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[] Mottagarens e-postadresser tillagda 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.
Fastighet Type Obligatoriskt Detaljer Beskrivning som ska läggas till i åtgärden
entitets-ID String Yes Typ av CRM-post, till exempel konto eller affärsmöjlighet. Denna indata tillhandahåller den unika identifieraren för den CRM-post som relatera till i e-posttråden.
enhetstyp String Yes Den unika identifieraren för CRM-posten som ska användas för föreslaget innehåll. Denna indata identifierar posttypen i CRM, som är relaterad till det e-posttråden.
entitySource String No Dessa indata anger entitetskällan, som för närvarande innehåller ”anslutna” eller tomma värden. Dessa indata anger typen av entitetskälla.

Utdataparametrar

Försäljningsagenten förväntar sig att få en lista över insikter (objekt) från dina API:er och förväntar sig att varje insikt har specifika parametrar. För att försäljningsagenten ska kunna parsa utdata korrekt måste svarsstrukturen följa riktlinjerna i följande tabell.

Parameter Datatyp Obligatoriskt Detaljer
value Array Yes

En lista över insikter (objekt) som definieras enligt beskrivningen i avsnittet Schema för insikter .

Obs!: Även om den här parametern innehåller en lista med insikter används bara den första insikten i sammanfattningen av e-postberikning för Outlook-arbetsytan.
hasMoreResults Boolesk No Ett värde som anger om fler resultat är tillgängliga.

Schema för insikter

Namn Datatyp/format Obligatoriskt Detaljer Beskrivning som ska läggas till i åtgärden
Insikt String Yes Insikterna som levereras till användare, till exempel Dina kollegor Mona Kane, Ray Tanaka och Daniela Smith har arbetat med dem tidigare. Denna utdata anger texten som du vill ska tas med i e-postsammanfattningen.

Example

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}

Exemplet i följande bild visar hur utdata från API:et mappas till e-postsammanfattningen i sidofönstret.

Skärmbild med insikter från partnerprogram i e-postsammanfattningen.

Förklaring:

  1. Insiktens rubrik. Insikter som har samma rubrik grupperas tillsammans.
  2. Beskrivningar av insikten. Varje insikt har en beskrivning.

Exemplet i följande bild visar hur utdata från API:et mappas till e-postsammanfattningen i e-postmeddelandets brödtext.

Skärmbild som visar insikter från partnerappar i e-postmeddelandets brödtext.

Förklaring:

  1. Insiktens rubrik. Insikter som har samma rubrik grupperas tillsammans.
  2. Beskrivning av insikten. Varje insikt har en beskrivning.

Sammanfatta en e-posttråd med försäljningsinformation med Copilot i Outlook
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
Utöka e-postutkast med fillänkar från ditt program
Skapa tillägg för Försäljningsagent

  • Last updated on