Partajați prin

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

  • Articol

Important

[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. Copilot for Sales folosește AI pentru a genera un rezumat al fiecărei înregistrări CRM. Acest rezumat evidențiază detalii cruciale, cum ar fi stadiul vânzărilor, bugetul și data de închidere proiectată. Puteți extinde capacitatea de rezumat a înregistrărilor 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 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

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 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ă”. No 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ă”. No 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 Integer No Numărul de informații de preluat. Această intrare indică numărul de informații de preluat.
skip Integer No Numărul de statistici de ignorat. Această intrare indică numărul de statistici de ignorat.
crmType Șir No 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 No 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

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 Tip de date/Format Obligatoriu Details 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 No 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 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 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ă:

  1. Secțiune care arată informații despre aplicația parteneră. Titlul secțiunii este derivat din numele conectorului Microsoft Power Platform .
  2. Descrieri ale informațiilor din răspunsul API.
  3. Numere de citare care pot fi selectate pentru a vedea detalii despre insight.
  4. Card de citare care arată detalii despre insight.
  5. Pictograma și titlul insight-ului. Pictograma este preluată din metadatele Microsoft Power Platform conectorului. Textul titlului este titlul informațiilor din răspunsul API.
  6. Proprietăți suplimentare ale informațiilor din răspunsul API.
  7. Numele aplicației partener. Numele care este afișat este numele conectorului Microsoft Power Platform .
  8. 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 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
Extindeți Microsoft 365 Copilot for Sales cu aplicații partenere
Creați extensii Copilot for Sales