El. pašto suvestinės praturtinimas programos turinio pasiūlymais (peržiūra)

Svarbu

• Tai gamybai paruoštos peržiūros versijos funkcija.
• Gamybai paruoštoms peržiūroms taikomos papildomos naudojimo sąlygos.

[Šis straipsnis yra negalutinio leidimo dokumentacija ir gali keistis.]

Kai "Copilot" programoje "Outlook" ir "Sales" programėlė naudojamos kartu, "Outlook" rodomos el. laiškų suvestinės apima pardavimo informaciją, gautą iš jūsų ryšių su klientais valdymo (CRM) sistemos, pvz., "Dynamics 365" arba "Salesforce CRM". Galite išplėsti el. laiškų suvestinės galimybę, kurią teikia "Sales" programa, naudodami įžvalgas iš jūsų programos.

Pastaba.

Ši API pakeičia esamą el. pašto suvestinės įgūdžių API (operacijos ID: scp-get-email-insights) nauja versija.

API aprašymas

Prie veiksmo turite pridėti toliau pateiktą API aprašą. Tai padeda "Sales" programai nustatyti tinkamą API, kurią reikia iškviesti norint praturtinti galimybes.

Šis veiksmas gauna papildomų pardavimo įžvalgų, kurios bus rodomos C4S el. pašto suvestinės patirtyje "Outlook" suvestinėje. Šis veiksmas sustiprina esamus pardavimų kopiloto įgūdžius.

API informacija

• API pavadinimas: El. pašto suvestinės įgūdžių 2 versija
• "Swagger" operacijos ID: scp-get-email-insights-v2
• "Swagger" veikimo metodas: paštas
• Kelias: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Įveskite paketo turinį

Ši naudingoji apkrova yra API užklausos tekstas.

Pavadinimą	Duomenų tipas	Privalomas	Informacija	Aprašymas, kurį reikia įtraukti į veiksmą
ištekliaiDuomenys	Objektas	Taip	Išteklių duomenys, kurie turi būti naudojami siūlomam turiniui gauti. Norėdami gauti duomenų struktūrą, eikite į El. pašto duomenų modelio išplėtimas.	Ši įvestis identifikuoja el. laiško turinį, kuris yra el. laiškų gijos, temos ir kitos informacijos rinkinys.
susijęSubjektai	Masyvas	No	Susijusių objektų masyvas. Norėdami gauti duomenų struktūrą, eikite į Susijusio objekto duomenų modelis.	Ši įvestis identifikuoja CRM įrašų masyvą, susijusį su el. pašto gija.
crmType	String	No	CRM sistemos tipas, jei prijungtas. Leistinos reikšmės yra "Salesforce" ir "Dynamics 365".	Ši įvestis nurodo CRM tipą, kuriame yra įrašas, susijęs su el. pašto gija.
crmOrgUrl	String	No	CRM organizacijos URL.	Ši įvestis nurodo CRM aplinkos, kurioje yra su el. pašto gija susijęs įrašas, URL.
viršuje	Integer	No	Prekių, kurias reikia gauti, skaičius.	Ši įvestis nurodo failų saitų, kuriuos reikia gauti, skaičių.
praleisti	Integer	No	Elementų, kuriuos reikia praleisti, skaičius.	Ši įvestis nurodo elementų, kuriuos reikia praleisti gaunant siūlomus failų saitus, skaičių.

Išplečiamumo el. pašto duomenų modelis

Ypatybė	Tipas	Informacija	Aprašymas, kurį reikia įtraukti į veiksmą
Paprastasis tekstasKūnas	String	Visas el. laiško turinys apima visus ankstesnius el. pašto gijos pranešimus.	Ši įvestis pateikia visą el. pašto gijos turinį teksto formatu.
fullHtmlBody	String	Visa el. laiško turinio HTML versija, kurioje yra visi ankstesni el. pašto gijos pranešimai.	Ši įvestis pateikia visą el. pašto gijos turinį HTML formatu.
tema	String	El. Laiško tema.	Ši įvestis pateikia el. laiško temą.
nuo	String	Siuntėjo el. pašto adresas.	Ši įvestis pateikia siuntėjo el. pašto adresą.
iki	Eilutė[]	Gavėjo el. pašto adresai.	Ši įvestis pateikia gavėjo el. pašto adresą.
Cc	Eilutė[]	Gavėjo el. pašto adresai, įtraukti į el. laiško lauką Kopija.	Ši įvestis pateikia visus gavėjo el. pašto adresus, įtrauktus į el. laiško lauką Kopija.
Bcc	Eilutė[]	Gavėjo el. pašto adresai, įtraukti į el. laiško lauką Nematoma kopija.	Ši įvestis pateikia visus gavėjo el. pašto adresus, kurie pridedami el. laiško lauke Nematoma kopija.
sentDateTime	DateTimeOffset	El. laiško data ir laikas UTC formatu kartu su ypatybe Poslinkis. Norėdami gauti daugiau informacijos, eikite į DateTimeOffset Struct (sistema)	Ši įvestis pateikia el. laiško laiko žymą.
messageId	String	The Graph pranešimo El. laiško ID.	Ši įvestis pateikia el. laiško pranešimo ID.
conversationId	String	El. laiško gijos "Graph" pokalbio ID.	Ši įvestis pateikia el. pašto gijos pokalbio ID.

Susijusio objekto duomenų modelis

Ypatybė	Tipas	Privalomas	Informacija	Aprašymas, kurį reikia įtraukti į veiksmą
entityId	String	Taip	CRM įrašo tipas, pvz., klientas arba galimybė.	Ši įvestis pateikia unikalų CRM įrašo, susijusio su el. pašto gija, identifikatorių.
entityType	String	Taip	Unikalus CRM įrašo identifikatorius, naudojamas siūlomam turiniui.	Ši įvestis identifikuoja įrašo tipą CRM, kuris yra susijęs su el. pašto gija.
entitySource	String	No	Ši įvestis nurodo objekto šaltinį, šiuo metu jame yra "prijungtų" arba tuščių reikšmių.	Ši įvestis nurodo objekto šaltinio tipą.

Išvesties parametrai

Programa "Sales" tikisi gauti įžvalgų (objektų) sąrašą iš jūsų API ir tikisi, kad kiekviena įžvalga turės konkrečius parametrus. Siekiant užtikrinti, kad "Sales" programa galėtų tinkamai išanalizuoti išvestį, atsakymo struktūra turi atitikti toliau pateiktoje lentelėje pateiktas gaires.

Parametras	Duomenų tipas	Privalomas	Informacija
reikšmė	Masyvas	Taip	Įžvalgų (objektų), apibrėžtų taip, kaip aprašyta skyriuje Įžvalgų schema, sąrašas. Pastaba: nors šis parametras apima įžvalgų sąrašą, "Outlook Canvas" naudojimo el. laiškų papildymo suvestinėje naudojama tik pirmoji įžvalga.
hasMoreResults	Bulio logikos	No	Reikšmė, nurodanti, ar yra daugiau rezultatų.

Įžvalgų schema

Pavadinimą	Duomenų tipas / formatas	Privalomas	Informacija	Aprašymas, kurį reikia įtraukti į veiksmą
įžvalga	String	Taip	Įžvalgos, kurios pateikiamos vartotojams, pvz., jūsų kolegoms Mona Kane, Ray Tanaka ir Daniela Smith, su jais dirbo anksčiau.	Ši išvestis nurodo tekstą, kurį norėtumėte įtraukti į el. pašto suvestinę.

Pavyzdžiui

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

Toliau pateiktame paveikslėlyje pateiktame pavyzdyje parodyta, kaip API išvestis susiejama su el. laiško suvestine šoninėje srityje.

Legenda:

1. Įžvalgos pavadinimas. Įžvalgos, turinčios tą patį pavadinimą, sugrupuojamos.
2. Įžvalgos aprašymai. Kiekviena įžvalga turi vieną aprašymą.

Toliau pateiktame paveikslėlyje pateiktame pavyzdyje parodyta, kaip API išvestis susiejama su el. laiško turinio el. laiško suvestine.

Legenda:

1. Įžvalgos pavadinimas. Įžvalgos, turinčios tą patį pavadinimą, sugrupuojamos.
2. Įžvalgos aprašymas. Kiekviena įžvalga turi vieną aprašymą.

Susijusi informacija

El. pašto gijos apibendrinimas naudojant pardavimo informaciją naudojant "Copilot" programoje "Outlook"
Galimybių įžvalgų praturtinimas programos duomenimis
Praturtinkite CRM įrašo informaciją įžvalgomis iš savo programos
Praturtinkite CRM įrašų suvestines įžvalgomis iš savo programos
Išplėskite pardavimus "Microsoft 365 Copilot" naudodami partnerių programas
Praturtinkite el. laiškų juodraščius failų nuorodomis iš savo programos
"Sales" plėtinių kūrimas "Microsoft 365 Copilot"