Îmbogățiți rezumatul e-mailului cu sugestii de conținut din aplicația dvs. (previzualizare)

Important

• Aceasta este o caracteristică în regim de previzualizare, gata de producție.
• Previzualizările pregătite pentru producție sunt supuse termenilor de utilizare suplimentari.

[Acest articol este documentație de prelansare și poate suferi modificări.]

Când Copilot în Outlook și aplicația Sales sunt folosite împreună, rezumatele de email afișate în Outlook includ informații despre vânzări provenite din sistemul tău de management al relațiilor cu clienții (CRM), cum ar fi Dynamics 365 sau Salesforce CRM. Poți extinde capacitatea de rezumat prin email pe care aplicația Sales o oferă cu informații din propria ta aplicație.

Notă

Acest API înlocuiește Email Summary Skill API-ul existent (Id operațiune: scp-get-email-insights) cu o nouă versiune.

Descrierea API

Trebuie să adăugați următoarea descriere API la acțiune. Acest lucru ajută aplicația Sales să identifice API-ul corect de invocat pentru a îmbogăți capabilitatea.

Această acțiune obține informații suplimentare despre vânzări care vor fi afișate în experiența de rezumat prin e-mail C4S în rezumatul Outlook. Acțiunea sporește abilitățile existente ale copilotului pentru vânzări.

Detalii API

• Nume API: e-mail Summary Skill Versiunea 2
• Id-ul operațiunii Swagger: scp-get-email-insights-v2
• Metoda de operare Swagger: post
• Calea: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Sarcină de intrare

Această sarcină utilă merge ca corpul solicitării cererii API.

Nume	Tip de date	Obligatoriu	Detalii	Descriere de adăugat în acțiune
resursăData	Obiect	Da	Datele despre resurse care vor fi utilizate pentru preluarea conținutului sugerat. Pentru structura datelor, accesați Modelul de date pentru e-mail de extensie.	Această intrare identifică conținutul e-mailului, care este o colecție de fire de e-mail, subiect și alte detalii.
Entități conexe	Vector	Nicio	Gama de entități înrudite. Pentru structura de date, accesați Model de date de entitate asociată.	Această intrare identifică matricea de înregistrări CRM, care este legată de firul de e-mail.
Tip crm	Șir	Nicio	Tipul de sistem CRM, dacă este conectat. Valorile valide sunt Salesforce și Dynamics 365.	Această intrare indică tipul de CRM în care există înregistrarea legată de firul de e-mail.
crmOrgUrl	Șir	Nicio	Adresa URL a organizației CRM.	Această intrare indică adresa URL a mediului CRM în care există înregistrarea legată de firul de e-mail.
sus	Întreg	Nicio	Numărul de articole de preluat.	Această intrare indică numărul de link-uri la fișiere de preluat.
Sări peste	Întreg	Nicio	Numărul de elemente de sărit.	Această intrare indică numărul de elemente de ignorat atunci când se preiau linkurile de fișiere sugerate.

Model de date de e-mail de extensibilitate

Proprietate	Tipul	Detalii	Descriere de adăugat în acțiune
Text clar Corp	Șir	Corpul complet al e-mailului include toate mesajele anterioare ale firului de e-mail în el.	Această intrare furnizează tot conținutul din firul de e-mail în format text.
fullHtmlBody	Șir	Versiunea HTML completă a corpului de e-mail care include toate mesajele anterioare ale firului de e-mail în ea.	Această intrare furnizează tot conținutul din firul de e-mail în format HTML.
subiect	Șir	Subiectul e-mailului.	Această intrare furnizează subiectul e-mailului.
de la	Șir	Adresa de e-mail a expeditorului.	Această intrare furnizează adresa de e-mail a expeditorului.
până la	Şir[]	Adresele de e-mail ale destinatarului.	Această intrare furnizează adresa de e-mail a destinatarului.
Cc	Şir[]	Adresele de e-mail ale destinatarului adăugate în câmpul Cc al e-mailului.	Această intrare furnizează toate adresele de e-mail ale destinatarului care sunt incluse în câmpul Cc al e-mailului.
Cci	Şir[]	Adresele de e-mail ale destinatarului adăugate în câmpul Cco al e-mailului.	Această intrare furnizează toate adresele de e-mail ale destinatarului care sunt adăugate în câmpul Cco al e-mailului.
sendDateTime	DateTimeOffset	Data și ora e-mailului în format UTC împreună cu proprietatea Offset. Pentru mai multe informații, accesați DateTimeOffset Struct (System)	Această intrare furnizează marcajul de timp al e-mailului.
Mesaj ID	Șir	Id-ul mesajului grafic al e-mailului.	Această intrare furnizează ID-ul mesajului e-mailului.
conversațieId	Șir	Id-ul conversației Graph al firului de e-mail.	Această intrare furnizează ID-ul conversației al firului de e-mail.

Model de date de entitate aferentă

Proprietate	Tipul	Obligatoriu	Detalii	Descriere de adăugat în acțiune
entityId	Șir	Da	Tipul de înregistrare CRM, cum ar fi contul sau oportunitate.	Această intrare furnizează identificatorul unic al înregistrării CRM care are legătură cu firul de e-mail.
entitateTip	Șir	Da	Identificatorul unic al înregistrării CRM de utilizat pentru conținutul sugerat.	Această intrare identifică tipul de înregistrare în CRM, care este legat de firul de e-mail.
entitySource	Șir	Nicio	Această intrare indică sursa entității, care conține în prezent valori „conectate” sau goale.	Această intrare indică tipul sursei entității.

Parametri de ieșire

Aplicația Sales se așteaptă să primească o listă de insights (obiecte) de la API-urile tale și se așteaptă ca fiecare insight să aibă parametri specifici. Pentru a se asigura că aplicația Sales poate analiza corect rezultatul, structura de răspuns trebuie să respecte ghidurile din tabelul următor.

Parametru	Tip de date	Obligatoriu	Detalii
valoare	Vector	Da	O listă de perspective (obiecte) care sunt definite așa cum este descris în secțiunea Schema pentru perspective . Notă: deși acest parametru include o listă de informații, numai prima informație este utilizată în rezumatul de îmbogățire a e-mailului pentru experiența Outlook Canvas.
areMoreResults	Boolean	Nicio	O valoare care indică dacă sunt disponibile mai multe rezultate.

Schemă pentru perspective

Nume	Tipul/formatul datelor	Obligatoriu	Detalii	Descriere de adăugat în acțiune
perspicacitate	Șir	Da	Perspectiva oferită utilizatorilor, cum ar fi Colegii dvs. Mona Kane, Ray Tanaka și Daniela Smith au mai lucrat cu aceștia.	Această ieșire indică textul pe care doriți să îl includeți în rezumatul e-mailului.

Exemplu

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

Exemplul din imaginea următoare arată modul în care rezultatul API-ului este mapat la rezumatul e-mailului din panoul lateral.

Legendă:

1. Titlul intuiției. Persoanele care au același titlu sunt grupate.
2. Descrieri ale intuiției. Fiecare perspectivă are o descriere.

Exemplul din imaginea următoare arată modul în care rezultatul API-ului este mapat la rezumatul e-mailului din corpul e-mailului.

Legendă:

1. Titlul intuiției. Persoanele care au același titlu sunt grupate.
2. Descrierea intuiției. Fiecare perspectivă are o descriere.

Informații corelate

Rezumați un fir de e-mail folosind informații de vânzări cu Copilot în Outlook
Îmbogățiți informațiile despre oportunități cu date din aplicația dvs.
Îmbogățiți detaliile înregistrărilor CRM cu informații din aplicația dvs
Îmbogățiți rezumatele înregistrărilor CRM cu informații din aplicația dvs
Extinde vânzările în Microsoft 365 Copilot cu aplicațiile partenere
Îmbogățiți proiectele de e-mail cu link-uri de fișiere din aplicația dvs
Construiește extensii pentru vânzări în Microsoft 365 Copilot