Čitajte na engleskom

Dijeli putem

Obogaćivanje sažetaka CRM zapisa uvidima iz vaše aplikacije (pretpregled)

  • Članak

Važno

[Ovaj je članak iz dokumentacije predizdanja i podložan je promjenama.]

Da bi bolje razumjeli kontekst sastanka za koji se pripremaju ili poruke e-pošte koju čitaju, prodavači žele relevantne informacije o upravljanju odnosima s klijentima (CRM), kao što su upiti klijenata, zabrinutosti i bilješke. Copilot for Sales koristi AI za generiranje sažetka svakog CRM zapisa. Ovaj sažetak ističe ključne detalje, kao što su faza prodaje, proračun i predviđeni datum zatvaranja. Možete proširiti mogućnost sažetka CRM zapisa koju Copilot for Sales pruža uvidima iz vlastite aplikacije.

Opis API-ja

Akciji morate dodati sljedeći opis API-ja. Na taj način Copilot for Sales može identificirati ispravan API koji se mora pozvati za obogaćivanje mogućnosti.

Ova radnja dobiva dodatne uvide u prodaju povezane s CRM zapisom koji će biti prikazan na kartici sažetka C4S zapisa. Akcija poboljšava postojeće vještine kopilota za prodaju.

Rad API-ja

Ovaj API koristi vrstu operacije: GET

Ulazni parametri

Copilot for Sales osmišljen je za pružanje sljedećih ulaznih parametara vašim API-jima.

Ime/naziv Vrsta/format podataka Obvezno Pojedinosti Opis za dodavanje u akciju
Vrsta zapisa String Jest Vrsta entiteta ili objekta u CRM-u za koji se traže povezani uvidi kao što su aktivnosti. Vrijednost uključuje jedinstveni naziv entiteta ili vrste objekta koji nije zaostao za jezikom, a ne zaslonski naziv koji se može lokalizirati. Primjeri uključuju račun i priliku . Ovaj unos označava vrstu entiteta ili objekta u CRM-u za koju se traže uvidi.
recordId String Jest Jedinstveni identifikator CRM zapisa. Ovaj unos označava jedinstveni identifikator CRM zapisa za koji se traže uvidi.
početakDatumVrijeme Niz u formatu "datum-vrijeme" No Datum i vrijeme početka za traženje uvida. Format je u skladu sa OpenAPI specifikacijom. Evo primjera: 2017-07-21T17:32:28Z. Ovaj unos označava datum i vrijeme početka traženih uvida.
endDateTime Niz u formatu "datum-vrijeme" No Datum i vrijeme završetka za traženje uvida. Format je u skladu sa OpenAPI specifikacijom. Evo primjera: 2017-07-21T17:32:28Z. Ovaj unos označava datum i vrijeme završetka zatraženih uvida.
najbolje Integer No Broj uvida koje treba dohvatiti. Ovaj unos označava broj uvida koje treba dohvatiti.
preskoči Integer No Broj uvida koje treba preskočiti. Ovaj unos označava broj uvida koje treba preskočiti.
crmType String No Valjane vrijednosti su Dynamics 365 i Salesforce. Ovaj unos označava vrstu CRM-a u kojem postoji CRM zapis, za koji se traže uvidi.
crmOrgUrl String No Naziv glavnog računala CRM organizacije, kao što je contoso.crm.dynamics.com. Ovaj unos označava URL CRM okruženja u kojem postoji CRM zapis, za koji se traže uvidi.

Izlazni parametri

Copilot for Sales očekuje da će primiti popis uvida (objekata) iz vaših API-ja i očekuje da svaki uvid ima određene parametre. Kako bi se osiguralo da Copilot for Sales može ispravno raščlaniti izlaz, struktura odgovora mora biti u skladu sa smjernicama u sljedećoj tablici.

Parametar Vrsta podataka Obvezno Pojedinosti
vrijednost Polje Jest Popis uvida (objekata) koji su definirani kako je opisano u odjeljku Shema za uvide .
hasMoreResults Booleov No Vrijednost koja označava je li dostupno više rezultata.

Shema za uvide

Ime/naziv Vrsta/oblik podataka Obvezno Pojedinosti Opis koji će se dodati u akciji
naziv String Jest Naslov uvida na kartici citata. To je naslov uvida na prirodnom jeziku na jeziku koji je naveden u zaglavlju zahtjeva Accept-Language . Evo primjera: Ugovor potpisan. Ovaj izlaz označava naslov aktivnosti na kartici citata.
opis String Jest Opis uvida. Prikazan je kao grafičke oznake u sažetku zapisa i predstavlja opis uvida na prirodnom jeziku na jeziku koji je naveden u Accept-Language zaglavlju. Evo primjera: Kenny, Logan i još dvojica potpisali su ugovor o obnovi Contosa za 2023. 9.7.2023. Ovaj izlaz označava opis uvida.
datumVrijeme Niz u formatu "datum-vrijeme" Jest Datum i vrijeme aktivnosti u UTC formatu. Ako aktivnost ima i vrijeme početka i završetka, aplikacija mora odrediti koje će se vrijeme prikazati. Format je u skladu sa OpenAPI specifikacijom. Evo primjera: 2017-07-21T17:32:28Z. Ovaj izlaz označava vrijeme povezano s uvidom.
url String No Valjani URL za otvaranje aktivnosti u partnerskoj aplikaciji. Ovaj izlaz označava URL za otvaranje uvida.
dodatnaSvojstva Objekt koji ima vrijednosti Naziv svojstva i Vrijednost svojstva vrste Niz No

Dodatna svojstva koja su prikazana u detaljnom prikazu. Nazivi svojstava i vrijednosti su na prirodnom jeziku na jeziku koji je naveden kroz Accept-Language zaglavlje. Evo primjera.

{
 "Razlog statusa": "Potpisan",
 "Vlasnik": "Kenny Smith"
}
 Ovaj izlaz označava dodatna svojstva prikazana u detaljnom prikazu uvida.

Napomena

Iako zahtjevi API-ja za proširenje mogućnosti sažetka e-pošte i mogućnosti sažetka zapisa mogu izgledati slično, moraju se dodati kao zasebne radnje u povezniku.

Primjer

JSON 
{
    "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
}

Primjer na sljedećoj slici prikazuje kako se izlaz API-ja mapira na sažetak zapisa.

Snimka zaslona koja prikazuje anatomiju najnovijih aktivnosti iz partnerske aplikacije.

Legenda:

  1. Odjeljak koji prikazuje uvide iz partnerske aplikacije. Naslov odjeljka izveden je iz naziva Microsoft Power Platform poveznika.
  2. Opisi uvida iz odgovora API-ja.
  3. Brojevi citata koji se mogu odabrati za prikaz pojedinosti o uvidu.
  4. Kartica citata koja prikazuje detalje o uvidu.
  5. Ikona i naslov uvida. Ikona se dohvaća iz Microsoft Power Platform metapodataka poveznika. Tekst naslova je naslov uvida iz odgovora API-ja.
  6. Dodatna svojstva uvida iz odgovora API-ja.
  7. Naziv partnerske aplikacije. Naziv koji se prikazuje naziv je poveznika Microsoft Power Platform .
  8. Veza koja se može odabrati za prikaz pojedinosti o uvidu u partnerskoj aplikaciji. Temelji se na URL-u uvida u odgovoru API-ja.

Prikaz sažetka zapisa
Obogatite sažetke e-pošte uvidima iz svoje aplikacije
Obogatite skice e-pošte vezama na datoteke iz svoje aplikacije
Obogatite ključne informacije o prodaji uvidima iz svoje aplikacije
Obogatite detalje CRM zapisa uvidima iz svoje aplikacije
Proširite Microsoft 365 Copilot za prodaju s partnerskim aplikacijama
Izrada proširenja Copilot for Sales