Obogatite detalje CRM zapisa uvidima iz svoje aplikacije (pretpregled)

Članak
07/08/2024

Važno

Ovo je značajka pretpregleda spremnog za proizvodnju.
Pretpregledi spremni za proizvodnju podliježu dodatnim uvjetima upotrebe. Više informacija: Dodatni uvjeti korištenja sustava Dynamics 365

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

Prodavači mogu vidjeti detalje o spremljenom kontaktu, zajedno s povezanim zapisima kao što su poslovni subjekti i prilike. Mogućnost detalja o CRM zapisu koju pruža Copilot za prodaju možete proširiti uvidima iz vlastite aplikacije.

Opis API-ja

Akciji morate dodati opis API-ja da biste Copilot za prodaju omogućili da identificira ispravan API za pozivanje za obogaćivanje te mogućnosti. Opis mora biti sljedeći:

This action gets records related to a CRM record. The action enhances the existing skills of Copilot for Sales.

Ulazni parametri

Copilot za prodaju je dizajniran za pružanje sljedećih ulaznih parametara vašim API-jevima.

Ime/naziv	Vrsta podataka / Oblik	Obvezno	Pojedinosti	Opis koji treba dodati u akciji
Vrsta zapisa	String	Jest	Vrsta entiteta ili objekta u sustavu CRM za koji se traže povezani zapisi. Uključuje jezično agnostičko jedinstveno ime entiteta ili vrste objekta, a ne zaslonsko ime koje se mogu lokalizirati. Na primjer, račun, prilika i tako dalje.	Ovaj unos identificira vrsta zapisa u CRM-u za koje se traže povezani zapisi.
ID zapisa	String	Jest	Jedinstveni identifikator CRM zapisa.	Ovaj unos pruža jedinstveni identifikator CRM zapisa za koji se traže povezani zapisi.
najbolje	Integer	No	Broj aktivnosti koje treba dohvatiti.	Ovaj unos označava broj povezanih zapisa koje treba dohvatiti.
preskoči	Integer	No	Broj aktivnosti koje treba preskočiti.	Ovaj unos označava broj zapisa koje treba preskočiti prilikom dohvaćanja povezanih zapisa.
crmType	String	No	Valjane vrijednosti su Dynamics 365 i Salesforce.	Ovaj unos označava vrstu CRM-a iz kojeg se dohvaćaju povezani zapisi.
crmOrgUrl	String	No	Naziv glavnog računala CRM organizacije. Npr `contoso.crm.dynamics.com`.	Ovaj unos označava URL CRM okruženja iz kojeg se dohvaćaju povezani zapisi.

Napomena

Ova točka proširenja podržava prikazivanje uvida iz više proširenja poveznika u bočnoj prikolici programa Outlook, do maksimalnog ograničenja od pet.

Izlazni parametri

Copilot za prodaju predviđa dobivanje popisa uvida (objekata), svaki s određenim parametrima, od vaših API-ja. Kako biste osigurali da Copilot za prodaju može pravilno raščlaniti izlaz, ključno je slijediti strukturu odgovor navedenu u nastavku.

Parametar	Vrsta podataka	Obvezno	Pojedinosti
vrijednost	Polje	Jest	Popis uvida (objekata) definiranih kako je navedeno u shemi za uvid
hasMoreResults	Booleov	No	Označava ima li još dostupnih rezultata.

Shema za uvid

Ime/naziv	Vrsta podataka / Oblik	Obvezno	Pojedinosti	Opis koji treba dodati u akciji
ID zapisa	String	Jest	Jedinstveni identifikator zapisa.	Ovaj izlaz jedinstveno identificira svaki povezani zapis koji je akcija vratila.
recordTypeDisplayName	String	Jest	Zaslonsko ime vrsta zapisa koje treba lokalizirati na jeziku navedenom `Accept-Language` u zaglavlju. Na primjer, Ugovor.	Ovaj izlaz označava zaslonsko ime vrsta zapisa svakog povezanog zapisa koji je akcija vratila.
recordTypePluralDisplayName	String	Jest	Množina zaslonsko ime vrsta zapisa koja bi trebala biti lokalizirana na jeziku navedenom `Accept-Language` u zaglavlju. Na primjer, Ugovori.	Ovaj izlaz označava množinu zaslonsko ime vrsta zapisa svakog povezanog zapisa koji je akcija vratila.
Vrsta zapisa	String	Jest	Naziv sustava vrsta zapisa. Na primjer, ugovor.	Ovaj izlaz označava vrstu svakog povezanog zapisa koji je akcija vratila.
recordTitle	String	Jest	Naziv zapisa. Na primjer, Ugovor o obnovi tvrtke Contoso 2023.	Ovaj izlaz označava naslov svakog povezanog zapisa koji je akcija vratila.
url	String	No	Valjani URL za otvaranje zapisa u partnerskoj aplikaciji.	Ovaj izlaz označava URL svakog povezanog zapisa koji je akcija vratila.
additionalProperties	Objekt s nazivom svojstva i vrijednošću svojstva vrste Niz	No	Dodatna svojstva prikazana u detaljnom prikazu. Nazivi svojstava i vrijednosti su na prirodnom jeziku na jeziku navedenom u `Accept-Language` zaglavlju. Npr { "razlog stanja": "Odjavljeno", "Vlasnik": "Kenny Smith" }	Ovaj izlaz označava dodatna svojstva kao parove vrijednosti naziva za svaki povezani zapis koji akcija vrati.

Primjer

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

Sljedeća slika prikazuje primjer mapiranja izlaza API-ja u povezane zapise.

Snimka zaslona s prikazom anatomije povezanih zapisa iz partnerske aplikacije.

Legenda:

Kartica prikazuju povezane zapise iz partnerske aplikacije.
Ikona i naslov kartica. Ikona Power Platform se dohvaća iz metapodataka poveznika. Naslov kartica je naziv Power Platform poveznika.
Povezani naslovi zapisa iz API-ja odgovor. Dva dodatna svojstva iz API-ja odgovor prikazuju se kao ključna polja svakog povezanog zapisa.
Ikona Dodatne akcije da biste kopirali vezu na zapis ili prikazali detalje zapisa u partnerskoj aplikaciji. Veza se temelji na URL-u povezanog zapisa u API odgovor.
Dodatna svojstva povezanog zapisa iz API odgovor.

Pogledajte

Saznajte više o detaljima o CRM zapisu
Dodavanje nove mogućnosti pitanja i odgovora u prodajni chat
Obogaćivanje sažetka e-pošte uvidima iz aplikacije
Obogatite ključne podatke o prodaji uvidima iz svoje aplikacije
Obogatite sažetak CRM zapisa uvidima iz svoje aplikacije
Proširi Microsoft Copilot za prodaju s partnerskim aplikacijama
Sastavljanje API-ja za aplikacije radi proširenja Copilot za prodaju

Dijeli putem