Î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 folosești aplicația Sales pentru a redacta un email, aceasta ia în considerare intenția emailului și folosește informațiile CRM de la Salesforce sau Dynamics 365 pentru a crea schița. Poți extinde capacitatea de redactare a emailurilor pe care aplicația Sales o oferă cu fișiere recomandate din propria ta aplicație.

Notă

Această funcție este suportată doar pentru ciornele de email create folosind aplicația Sales din Outlook.

Descrierea API

Trebuie să adăugați următoarea descriere API la acțiune. Astfel, aplicația Sales poate identifica API-ul corect care trebuie invocat pentru a îmbogăți această capacitate.

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	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.
tip de resursă	Ș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	Nicio	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	Nicio	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.
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.
inputPrompt	Șir	Nicio	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	Î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 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.
Cci	Ş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.
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.

Parametri de ieșire

Proprietate	Tip de date	Obligatoriu	Detalii
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	Nicio	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	Detalii	Descriere de adăugat în acțiune
conținutTip	șir	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	șir	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.
conținutTitlu	șir	Da	Titlul conținutului sugerat afișat utilizatorului.	Această ieșire indică titlul conținutului.
contentDescriere	șir	Da	Descrierea conținutului sugerat afișată utilizatorului.	Această ieșire indică textul care trebuie inclus la descrierea fișierelor.
conținutIconUrl	șir	Nicio	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	Nicio	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.

Captură de ecran care arată linkuri de fișiere din aplicațiile partenere în 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 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
Construiește extensii pentru vânzări în Microsoft 365 Copilot

Feedback

Această pagină a fost utilă?

Last updated on 2025-11-20