Îmbogățiți rezumatele înregistrărilor CRM cu informații 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.]

Pentru a înțelege mai bine contextul unei întâlniri pentru care se pregătesc sau al unui e-mail pe care îl citesc, vânzătorii doresc informații relevante pentru managementul relațiilor cu clienții (CRM), cum ar fi întrebările clienților, preocupările și notele. Aplicația Sales folosește AI pentru a genera un rezumat al fiecărui record CRM. Acest rezumat evidențiază detalii cruciale, cum ar fi stadiul vânzărilor, bugetul și data de închidere proiectată. Poți extinde capacitatea de sumare a înregistrărilor CRM pe care aplicația Sales o oferă cu informații din propria ta aplicație.

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 obține informații suplimentare despre vânzări legate de o înregistrare CRM care va fi afișată în cardul de rezumat al înregistrării C4S. Acțiunea sporește abilitățile existente ale copilotului pentru vânzări.

Operare API

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

Parametri de intrare

Aplicația de vânzări este concepută pentru a furniza următorii parametri de intrare API-urilor tale.

Nume	Tipul/formatul datelor	Obligatoriu	Detalii	Descriere de adăugat în acțiune
recordType	Șir	Da	Tipul de entitate sau obiect din CRM pentru care sunt solicitate informații legate, cum ar fi activitățile. 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 indică tipul de entitate sau obiect din CRM pentru care sunt solicitate informații.
recordId	Șir	Da	Identificatorul unic al înregistrării CRM.	Această intrare indică identificatorul unic al înregistrării CRM pentru care sunt solicitate informații.
startDateTime	Șir în format „dat-oră”.	Nicio	Data și ora de începere pentru a căuta statistici. Formatul urmează OpenAPI specificația. Iată un exemplu: 2017-07-21T17:32:28Z.	Această intrare indică data și ora de începere a informațiilor solicitate.
endDateTime	Șir în format „dat-oră”.	Nicio	Data și ora de încheiere pentru a căuta statistici. Formatul urmează OpenAPI specificația. Iată un exemplu: 2017-07-21T17:32:28Z.	Această intrare indică data și ora de încheiere pentru informațiile solicitate.
sus	Întreg	Nicio	Numărul de informații de preluat.	Această intrare indică numărul de informații de preluat.
Sări peste	Întreg	Nicio	Numărul de statistici de ignorat.	Această intrare indică numărul de statistici de ignorat.
Tip crm	Șir	Nicio	Valorile valide sunt Dynamics 365 și Salesforce.	Această intrare indică tipul de CRM în care există înregistrarea CRM, pentru care sunt solicitate informații.
crmOrgUrl	Șir	Nicio	Numele de gazdă al organizației CRM, cum ar fi contoso.crm.dynamics.com.	Această intrare indică adresa URL a mediului CRM în care există înregistrarea CRM, pentru care sunt solicitate informaț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 .
areMoreResults	Boolean	Nicio	O valoare care indică dacă sunt disponibile mai multe rezultate.

Schemă pentru perspective

Nume	Tip de date/Format	Obligatoriu	Detalii	Descrierea de adăugată în acțiune
Funcția	Șir	Da	Titlul insight-ului de pe cardul de citare. Este titlul în limbaj natural al insight-ului în limba care este specificată prin antetul `Accept-Language` cerere. Iată un exemplu: Contract semnat.	Această ieșire indică titlul activității în fișa de citare.
descriere	Șir	Da	Descrierea insight-ului. Este afișat sub formă de puncte în rezumatul înregistrării și este descrierea în limbaj natural a perspectivei în limba specificată prin antetul `Accept-Language` . Iată un exemplu: Kenny, Logan și alți doi au semnat Contractul de reînnoire Contoso 2023 la 07.09.2023.	Această ieșire indică descrierea insight-ului.
dateTime	Șir în format „dat-oră”.	Da	Data și ora activității în format UTC. Dacă activitatea are atât o oră de începere, cât și o oră de sfârșit, aplicația trebuie să stabilească ce oră să arate. Formatul urmează OpenAPI specificația. Iată un exemplu: 2017-07-21T17:32:28Z.	Această ieșire indică timpul asociat cu insight-ul.
URL	Șir	Nicio	O adresă URL validă pentru a deschide activitatea în aplicația parteneră.	Această ieșire indică adresa URL pentru deschiderea informațiilor.
Proprietăți suplimentare	Un obiect care are Numele proprietății și Valoare proprietății valori de tipul Șir	Nicio	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 afișate în vizualizarea detaliată a perspectivei.

Notă

Deși cerințele API pentru extinderea capabilităților de rezumat de e-mail și a capabilităților de rezumat de înregistrări pot arăta similare, acestea trebuie adăugate ca acțiuni separate în conector.

Exemplu

{
    "value": [
        {
            "title": "Contract signed",
            "description": "You have 5 connections in Fourth Coffee Inc",
            "dateTime": "2024-05-07T03:28:38.0667701Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        },
        {
            "title": "Contract signed",
            "description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
            "dateTime": "2024-05-07T03:28:38.0669445Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        }
    ],
    "hasMoreResults": false
}

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

Captură de ecran care arată anatomia celor mai recente activități dintr-o aplicație parteneră.

Legendă:

Secțiune care arată informații despre aplicația parteneră. Titlul secțiunii este derivat din numele conectorului Microsoft Power Platform .
Descrieri ale informațiilor din răspunsul API.
Numere de citare care pot fi selectate pentru a vedea detalii despre insight.
Card de citare care arată detalii despre insight.
Pictograma și titlul insight-ului. Pictograma este preluată din metadatele Microsoft Power Platform conectorului. Textul titlului este titlul informațiilor din răspunsul API.
Proprietăți suplimentare ale informațiilor din răspunsul API.
Numele aplicației partener. Numele care este afișat este numele conectorului Microsoft Power Platform .
Link care poate fi selectat pentru a vizualiza detaliile statistice în aplicația parteneră. Se bazează pe adresa URL a informațiilor din răspunsul API.

Vizualizați rezumatul î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 despre oportunități cu date din aplicația dvs.
Îmbogățiți detaliile î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