Îmbogățiți proiectele de e-mail cu link-uri de fișiere 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 utilizați Copilot for Sales pentru a crea un e-mail, acesta ia în considerare intenția e-mailului și utilizează informații CRM de la Salesforce sau Dynamics 365 pentru a crea schița. Puteți extinde capacitatea de redactare a e-mailurilor pe care o oferă Copilot for Sales cu fișiere recomandate din propria aplicație.
Notă
Această caracteristică este acceptată numai pentru proiectele de e-mail create folosind panoul lateral Copilot for Sales din Outlook.
Descrierea API
Trebuie să adăugați următoarea descriere API la acțiune. În acest fel, Copilot for Sales poate identifica API-ul corect care trebuie invocat pentru a îmbogăți capacitatea.
Această acțiune primește fișiere relevante pentru conversația prin e-mail, care vor fi afișate în schițele de e-mail C4S în Outlook. Acțiunea sporește abilitățile existente ale copilotului pentru vânzări.
Operare API
Acest API folosește tipul de operație: POST
Sarcină de intrare
Această sarcină utilă merge ca corpul solicitării cererii API.
| Nume | Tip de date | Obligatoriu | Details | Descriere de adăugat în acțiune |
|---|---|---|---|---|
| resourceData | 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. |
| resourceType | Șir | Da | Tipul de resursă pentru care să obțineți sugestii de conținut. De exemplu, „e-mail-thread” sau „echipe-chat”. | Această intrare identifică tipul de resursă partajată pentru preluarea legăturilor de fișiere sugerate, care în acest caz este „e-mail-thread”. |
| recordType | Șir | No | Tipul de înregistrare CRM, cum ar fi contul sau oportunitate. | Această intrare identifică tipul de înregistrare în CRM, care este legat de firul de e-mail. |
| recordId | Șir | No | Identificatorul unic al înregistrării CRM de utilizat pentru conținutul sugerat. | Această intrare furnizează identificatorul unic al înregistrării CRM care are legătură cu firul de e-mail. |
| crmType | Șir | No | 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 | No | Adresa URL a organizației CRM. | Această intrare indică adresa URL a mediului CRM în care există înregistrarea legată de firul de e-mail. |
| inputPrompt | Șir | No | Promptul sugerat utilizat în prezent, dat de utilizator pentru a genera o versiune nefinalizată de e-mail. De exemplu, „Răspundeți la o îngrijorare” sau „Faceți o propunere”. | Această intrare indică solicitarea oferită de utilizator în timpul redactării unui e-mail. |
| sus | Integer | No | Numărul de articole de preluat. | Această intrare indică numărul de link-uri la fișiere de preluat. |
| skip | Integer | No | Numărul de articole 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 | Details | 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 destinatarilor 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. |
| bcc | Şir[] | Adresele de e-mail ale destinatarilor 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. |
| conversationId | Șir | Id-ul conversației Graph al firului de e-mail. | Această intrare furnizează ID-ul conversației al firului de e-mail. |
Parametri de ieșire
| Proprietate | Tip de date | Obligatoriu | Details |
|---|---|---|---|
| valoare | Vector | Da | O listă de legături de fișiere (obiecte) care sunt definite așa cum este descris în Schema pentru răspunsul la sugestiile de conținut de fișiere sau de legături. |
| areMoreResults | Boolean | No | O valoare care indică dacă sunt disponibile mai multe rezultate. |
Schemă pentru răspunsul la sugestiile de conținut pentru fișiere sau linkuri
| Nume | Format de tip de date | Obligatoriu | Details | Descriere de adăugat în acțiune |
|---|---|---|---|---|
| contentType | string | Da | Tipul de conținut de afișat. Mai multe informații, accesați Valori predefinite pentru contentType | Această ieșire indică tipul de conținut inclus cu schița de e-mail. |
| conținut | string | Da | Conținut real inclus. Poate fi fie o pagină web, fie o adresă URL a fișierului. | Această ieșire indică conținutul real care este inclus cu schița de e-mail. Poate fi fie o pagină web, fie o adresă URL. |
| contentTitle | string | Da | Titlul conținutului sugerat afișat utilizatorului. | Această ieșire indică titlul conținutului. |
| contentDescriere | string | Da | Descrierea conținutului sugerat afișată utilizatorului. | Această ieșire indică textul care trebuie inclus la descrierea fișierelor. |
| contentIconUrl | string | No | Pictograma conținutului sugerat afișată utilizatorului. Dacă nu este furnizată, este utilizată o pictogramă generică. | Această ieșire indică pictograma care trebuie inclusă pentru conținut. |
| Proprietăți suplimentare | Obiect | No | Un set de perechi nume-valoare care indică proprietăți suplimentare ale link-ului de fișier asociat pe care le returnează acțiunea. | Această ieșire indică proprietăți suplimentare ca perechi nume-valoare ale fiecărei legături asociate returnate de acțiune. |
Valori predefinite pentru contentType
| Valoare șir | Tip de conținut |
|---|---|
| fişier-conţinut | Fișier extern (generic) |
| continut-web | Pagina web externă |
| continut-doc | Microsoft Word Document |
| continut-pdf | Document Microsoft PDF |
| continut-pptx | Prezentare Microsoft PowerPoint |
| continut-xlsx | Microsoft Excel Foaie de calcul |
Exemplu
{
"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
}
Exemplul din imaginea următoare arată modul în care rezultatul API-ului este mapat cu schița de e-mail.
Legendă:
- Link-uri de fișiere din aplicațiile partenere.
Consultați și
Rezumați un fir de e-mail folosind informații de vânzări cu Copilot în Outlook
Îmbogățiți rezumatele prin e-mail cu informații despre aplicația dvs
Îmbogățiți informațiile cheie de vânzări cu informații 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ți Microsoft 365 Copilot for Sales cu aplicații partenere
Creați extensii Copilot for Sales