Del via


Forbedre oplysninger om CRM-poster med indsigt i programmet (forhåndsversion)

Vigtige oplysninger

[Denne artikel er til dokumentationen til den foreløbige udgivelse. Der kan forekomme ændringer.]

Sælgere kan få vist detaljer om en gemt kontakt sammen med de tilknyttede poster, f.eks. firmaer og salgsmuligheder. Du kan udvide funktionen til CRM-postdetaljer (Customer Relationship Management), som Copilot til salg leverer, med indsigt fra dit eget program.

API-beskrivelse

Du skal føje følgende API-beskrivelse til handlingen. På denne måde kan Copilot til salg identificere den korrekte API, der skal aktiveres for at forbedre funktionen.

Denne handling henter poster, der er relateret til en CRM-post. Handlingen forbedrer de eksisterende færdigheder i Copilot til salg.

Inputparametre

Copilot til salg er udviklet til at levere følgende inputparametre til dine API'er.

Navn Datatype/-format Påkrævet Oplysninger Beskrivelse, der skal føjes til handlingen
recordType String Ja Den type enhed eller objekt i CRM, som der anmodes om relaterede poster til. Værdien indeholder det entydige sprogagnostiske navn på enheds- eller objekttypen, ikke det viste navn, der kan oversættes. Eksempler omfatter konto og salgsmulighed. Dette input identificerer den posttype i CRM, hvor der anmodes om relaterede poster.
recordId String Ja Entydigt id for CRM-posten. Dette input leverer en entydig identifikation af den CRM-post, hvor der anmodes om relaterede poster.
top Integer Nej Antallet af aktiviteter, der skal hentes. Dette input angiver antallet af relaterede poster, der skal hentes.
skip Integer Nej Antallet af aktiviteter, der skal springes over. Dette input angiver antallet af poster, der skal springes over ved hentning af relaterede poster.
crmType String Nej Type af CRM-system. Gyldige værdier er Salesforce og Dynamics 365. Dette input angiver, hvilken type CRM de relaterede poster hentes fra.
crmOrgUrl String Nej CRM-organisationens værtsnavn, f.eks. contoso.crm.dynamics.com. Dette input angiver, hvilken type URL fra CRM-miljøet de relaterede poster hentes fra.

Bemærk

Dette udvidelsespunkt understøtter gengivelsesindsigt fra op til fem connectorudvidelser i Outlook-sideruden.

Outputparametre

Copilot til salg forventer at modtage en liste over indsigter (objekter) fra dine API'er og forventer, at hver indsigt har specifikke parametre. Hvis du vil sikre, at Copilot til salg kan fortolke outputtet korrekt, er det vigtigt at følge den responsstruktur, der er skitseret nedenfor.

Parameter Datatype Påkrævet Oplysninger
værdi Matrix Ja En liste over indsigter (objekter), der er defineret som beskrevet i afsnittet Skema for indsigt.
hasMoreResults Boolean Nej En værdi, der angiver, om der er flere resultater.

Skema for indsigt

Navn Datatype/-format Påkrævet Oplysninger Beskrivelse, der skal føjes til handlingen
recordId String Ja Entydigt id for posten. I dette output identificeres alle relaterede poster, der returneres af handlingen, entydigt.
recordTypeDisplayName String Ja Posttypens viste navn, f.eks. Kontrakt. Det skal være lokaliseret på det sprog, der er angivet gennem overskriften Accept-Language. Dette output angiver den visningsnavn posttype for hver relateret post, der returneres af handlingen.
recordTypePluralDisplayName String Ja Posttypens viste flertalsnavn, f.eks. Kontrakter. Det skal være lokaliseret på det sprog, der er angivet gennem overskriften Accept-Language. Dette output angiver den visningsnavn i flertal for posttypen for hver relateret post, der returneres af handlingen.
recordType String Ja Posttypens systemnavn, f.eks. kontrakt. Dette output angiver typen af hver relateret post, der returneres af handlingen.
recordTitle String Ja Postens navn, f.eks. Contoso 2023-fornyelseskontrakt. Dette output angiver titlen af hver relateret post, der returneres af handlingen.
url-adresse String Nej En gyldig URL-adresse til at åbne posten i partnerprogrammet. Dette output angiver URL for hver relateret post, der returneres af handlingen.
additionalProperties Et objekt, der har værdierne Egenskabsnavn og Egenskabsværdi af typen Streng Nej

Yderligere egenskaber, der vises i den detaljerede visning. Egenskabsnavne og -værdier er på det naturlige sprog på det sprog, der er angivet i overskriften til Accept-Language. Her er et eksempel.

{
"Statusårsag": "Signed off",
"Ejer": "Kenny Smith"
}
I dette output angives flere egenskaber som navneværdipar for den relaterede post, der returneres af handlingen.

Eksempel

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

I følgende billede vises et eksempel på, hvordan output af API'en knyttes til de relaterede poster.

Skærmbillede, der viser anatomien af relaterede poster fra et partnerprogram.

Forklaring:

  1. Kort, der viser relaterede poster fra partnerprogrammet.
  2. Titel på og ikon for kortet. Ikonet hentes fra Microsoft Power Platform-connectorens metadata. Titlen er navnet på Microsoft Power Platform-connectoren.
  3. Relaterede posttitler fra API-svaret. To yderligere egenskaber fra API-svaret gengives som nøglefelter for hver relateret post.
  4. Knappen "Flere handlinger", der enten kan bruges til at kopiere et link til posten eller til at få vist postdetaljer i partnerprogrammet. Linket er baseret på URL-adressen til den relaterede post i API-svaret.
  5. Yderligere egenskaber for den relaterede post fra API-svaret.

Vis oplysninger om poster
Forbedre mailoversigter med indsigt fra dit program
Berig mailkladder med fillinks fra dit program
Forbedre vigtige salgsoplysninger med indsigt fra dit program
Forbedre oversigter over CRM-poster med indsigt fra dit program
Udvide Microsoft 365 Copilot til salg med partnerapplikationer
Opbygge Copilot til salg-udvidelser