Partajați prin

Îmbogățiți detaliile înregistrării CRM cu informații din aplicația dvs. (previzualizare)

  • Articol

Important

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

Vânzătorii pot vedea detalii despre un contact salvat, împreună cu înregistrările asociate, cum ar fi conturile și oportunitățile. Puteți extinde capacitatea de înregistrare a detaliilor de gestionare a relațiilor cu clienții (CRM) pe care o oferă Copilot for Sales cu informații din propria aplicație.

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 înregistrări legate de o înregistrare CRM. Acțiunea îmbunătățește abilitățile existente ale Copilot for Sales.

Operare API

Acest API folosește tipul de operație: GET

Parametri de intrare

Copilot for Sales este conceput pentru a furniza următorii parametri de intrare API-urilor dvs.

Nume Tipul/formatul datelor Obligatoriu Details Descriere de adăugat în acțiune
recordType Șir Da Tipul de entitate sau obiect din CRM pentru care sunt solicitate înregistrările aferente. Valoarea include numele unic independent de limbă al entității sau al tipului de obiect, nu numele afișat care poate fi localizat. Exemplele includ contul și oportunitate. Această intrare identifică tipul de înregistrare în CRM pentru care sunt solicitate înregistrările aferente.
recordId Șir Da Identificatorul unic al înregistrării CRM. Această intrare furnizează identificatorul unic al înregistrării CRM pentru care sunt solicitate înregistrările aferente.
sus Integer No Numărul de activități de preluat. Această intrare indică numărul de înregistrări asociate de preluat.
skip Integer No Numărul de activități de sărit. Această intrare indică numărul de înregistrări de ignorat atunci când se preiau înregistrări asociate.
crmType Șir No Tipul de sistem CRM. Valorile valide sunt Dynamics 365 și Salesforce. Această intrare indică tipul de CRM din care sunt preluate înregistrările aferente.
crmOrgUrl Șir No Numele de gazdă al organizației CRM, cum ar fi contoso.crm.dynamics.com. Această intrare indică adresa URL a mediului CRM din care sunt preluate înregistrările aferente.

Notă

Acest punct de extensie acceptă redarea statisticilor de la până la cinci extensii de conector în sidecar-ul Outlook.

Parametri de ieșire

Copilot for Sales se așteaptă să primească o listă de informații (obiecte) de la API-urile dvs. și se așteaptă ca fiecare informație să aibă parametri specifici. Pentru a vă asigura că Copilot for Sales poate analiza corect rezultatul, structura răspunsului trebuie să respecte instrucțiunile din tabelul următor.

Parametru Tip de date Obligatoriu Details
valoare Vector Da O listă de perspective (obiecte) care sunt definite așa cum este descris în secțiunea Schema pentru perspective .
areMoreResults Boolean No O valoare care indică dacă sunt disponibile mai multe rezultate.

Schemă pentru perspective

Nume Tipul/formatul datelor Obligatoriu Details Descriere de adăugat în acțiune
recordId Șir Da Identificatorul unic al înregistrării. Această ieșire identifică în mod unic fiecare înregistrare asociată returnată de acțiune.
recordTypeDisplayName Șir Da Numele afișat al tipului de înregistrare, cum ar fi Contract. Ar trebui să fie localizat în limba specificată prin antetul Accept-Language . Această ieșire indică numele afișat al tipului de înregistrare al fiecărei înregistrări asociate returnate de acțiune.
recordTypePluralDisplayName Șir Da Numele afișat la plural al tipului de înregistrare, cum ar fi Contracte. Ar trebui să fie localizat în limba specificată prin antetul Accept-Language . Această ieșire indică numele afișat la plural al tipului de înregistrare al fiecărei înregistrări asociate returnate de acțiune.
recordType Șir Da Numele de sistem al tipului de înregistrare, cum ar fi contract. Această ieșire indică tipul fiecărei înregistrări asociate returnate de acțiune.
recordTitle Șir Da Numele înregistrării, cum ar fi Contract de reînnoire Contoso 2023. Această ieșire indică titlul fiecărei înregistrări asociate returnate de acțiune.
URL Șir No O adresă URL validă pentru a deschide înregistrarea în aplicația parteneră. Această ieșire indică adresa URL a fiecărei înregistrări asociate returnate de acțiune.
Proprietăți suplimentare Un obiect care are Numele proprietății și Valoare proprietății valori de tipul Șir No

Proprietăți suplimentare care sunt afișate în vizualizarea detaliată. Numele și valorile proprietăților sunt în limbaj natural, în limba specificată prin antetul Accept-Language . Iată un exemplu.

{
 „Motivul stării”: „Deconectat”,
 „Proprietar”: „Kenny Smith”
}
 Această ieșire indică proprietăți suplimentare ca perechi nume-valoare ale fiecărei înregistrări asociate returnate de acțiune.

Exemplu

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

Exemplul din imaginea următoare arată modul în care ieșirea API-ului este mapată la înregistrările aferente.

Captură de ecran care arată anatomia înregistrărilor asociate dintr-o aplicație parteneră.

Legendă:

  1. Card care arată înregistrările aferente din aplicația partener.
  2. Pictograma și titlul cardului. Pictograma este preluată din metadatele Microsoft Power Platform conectorului. Titlul este numele conectorului Microsoft Power Platform .
  3. Titluri de înregistrări similare din răspunsul API. Două proprietăți suplimentare din răspunsul API sunt redate ca câmpuri cheie ale fiecărei înregistrări asociate.
  4. Buton „Mai multe acțiuni” care poate fi folosit fie pentru a copia un link către înregistrare, fie pentru a vizualiza detaliile înregistrării în aplicația parteneră. Linkul se bazează pe adresa URL a înregistrării asociate din răspunsul API.
  5. Proprietăți suplimentare ale înregistrării asociate din răspunsul API.

Vizualizați detaliile înregistrării
Îmbogățiți rezumatele prin e-mail cu informații despre aplicația dvs
Îmbogățiți proiectele de e-mail cu link-uri de fișiere din aplicația dvs
Îmbogățiți informațiile cheie de vânzări 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