Forbedre opsummeringer af CRM-poster med indsigt fra dit program (forhåndsversion)

Vigtige oplysninger

Dette er en produktionsklar prøveversionsfunktion.
Produktionsklare forhåndsversioner er underlagt supplerende vilkår for anvendelse.

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

For bedre at forstå konteksten for et møde, som de forbereder sig på, eller en mail, de læser, ønsker sælgere relevante CRM-oplysninger (Customer Relationship Management), f.eks. kundeforespørgsler, bekymringer og noter. Salgsagenten bruger AI til at generere en oversigt over hver CRM-post. Denne oversigt fremhæver vigtige detaljer, f.eks. salgsfasen, budgettet og den forventede slutdato. Du kan udvide den CRM-postoversigtsfunktion, som salgsagenten giver indsigt fra dit eget program.

API-beskrivelse

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

Denne handling får yderligere salgsindsigt, der er relateret til en CRM-post, som vises på oversigtskortet for C4S-post. Handlingen forbedrer de eksisterende færdigheder i Copilot til salg.

API-handling

Denne API bruger handlingstype: GET

Inputparametre

Salgsagenten er designet til at levere følgende inputparametre til dine API'er.

Name	Datatype/-format	Påkrævet	Oplysninger	Beskrivelse, der skal føjes til handlingen
recordType	String	Ja	Objekt- eller enhedstypen i CRM, hvor der anmodes om relateret indsigt, f.eks. aktiviteter. 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 angiver objekt- eller enhedstypen i CRM, hvor der anmodes om indsigt.
recordId	String	Ja	Entydigt id for CRM-posten.	Dette input angiver en entydig identifikation af den CRM-post, hvor der anmodes om indsigter.
startDateTime	Streng i 'date-time'-format	Nej	Startdato og -klokkeslæt for at slå indsigt op. Formatet følger specifikationen for OpenAPI. Her er et eksempel: 2017-07-21T17:32:28Z.	Dette input angiver startdatoen og klokkeslættet for den ønskede indsigt.
endDateTime	Streng i 'date-time'-format	Nej	Slutdato og -klokkeslæt for at slå indsigt op. Formatet følger specifikationen for OpenAPI. Her er et eksempel: 2017-07-21T17:32:28Z.	Dette input angiver slutdatoen og klokkeslættet for den ønskede indsigt.
top	Integer	Nej	Antal indsigter, der skal hentes.	Dette input angiver antallet af indsigter, der skal hentes.
springe over	Integer	Nej	Antal indsigter, der skal springes over.	Dette input angiver antallet af indsigter, der skal springes over.
crmType	String	Nej	Gyldige værdier er Salesforce og Dynamics 365.	Dette input angiver den type CRM-post, som CRM-posten findes i, og hvor der anmodes om indsigter.
crmOrgUrl	String	Nej	CRM-organisationens værtsnavn, f.eks. contoso.crm.dynamics.com.	Dette input angiver URL for det CRM-miljø, som CRM-posten findes i, og hvor der anmodes om vigtige indsigter.

Outputparametre

Salgsagenten forventer at modtage en liste over indsigter (objekter) fra dine API'er, og den forventer, at hver indsigt har specifikke parametre. Svarstrukturen skal overholde retningslinjerne i følgende tabel for at sikre, at salgsagenten kan fortolke outputtet korrekt.

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.
harMereResultater	Boolean	Nej	En værdi, der angiver, om der er flere resultater.

Skema for indsigt

Name	Datatype/-format	Påkrævet	Oplysninger	Beskrivelse, der skal føjes til handlingen
Titel	String	Ja	Titlen på indsigten i citatkortet. Det er den naturlige titel på det sprog, der er angivet i forespørgselsheaderen til `Accept-Language`. Her er et eksempel: Kontrakt underskrevet.	Dette output angiver titlen på aktiviteten i citatkortet.
Beskrivelse	String	Ja	Beskrivelsen af indsigten. Det vises som punkttegn i postoversigten og er den naturlige sprogbeskrivelse af indsigten på det sprog, der er angivet i overskriften til `Accept-Language` . Her er et eksempel: Kenny, Logan og to andre underskrev Contoso 2023-fornyelseskontrakten den 9/7/2023.	Dette output angiver beskrivelsen af indsigten.
datetime	Streng i 'date-time'-format	Ja	Dato og klokkeslæt for aktiviteten i UTC-format. Hvis aktiviteten både har et starttidspunkt og et sluttidspunkt, skal programmet bestemme, hvilket tidspunkt der skal vises. Formatet følger specifikationen for OpenAPI. Her er et eksempel: 2017-07-21T17:32:28Z.	Dette output angiver den tid, der er knyttet til indsigten.
url-adresse	String	Nej	En gyldig URL-adresse til at åbne aktivitet i partnerprogrammet.	Dette output angiver URL-adressen til at åbne indsigt.
yderligereEgenskaber	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" }	Dette output angiver flere egenskaber, der vises i den detaljerede visning af indsigten.

Bemærk

API-kravene til udvidelse af funktionerne for mailoversigt og postoversigt ser måske ens ud, men de skal tilføjes som separate handlinger i connectoren.

Eksempel

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

I følgende billede vises et eksempel på, hvordan outputtet af API'en knyttes til postoversigten.

Skærmbillede, der viser anatomien af de seneste aktiviteter fra et partnerprogram.

Forklaring:

Afsnittet viser indsigt fra partnerprogrammet. Sektionstitlen er afledt af navnet på Microsoft Power Platform-connector.
Beskrivelser af indsigt fra API-svaret.
Citatnumre, der kan vælges for at få vist detaljer om indsigten.
Citatkort, der viser detaljer om indsigten.
Ikon og titel til indsigt. Ikonet hentes fra Microsoft Power Platform-connectorens metadata. Titelteksten er titlen på indsigt fra API-svaret.
Yderligere egenskaber for indsigt fra API-svaret.
Partnerprogrammets navn. Det navn, der vises, er navnet på Microsoft Power Platform-connectoren.
Link, der kan vælges for at se indsigtsdetaljer i partnerprogrammet. Det er baseret på webadressen til indsigt i API-svaret.

Se postoversigt
Forbedre mailoversigter med indsigt fra dit program
Berig mailkladder med fillinks fra dit program
Få bedre indsigt i salgsmuligheder med data fra dit program
Forbedre oplysninger om CRM-poster med indsigt fra dit program
Udvid Salgsagent med partnerprogrammer
Udvikle udvidelser til salgsagenter

Feedback

Var denne side nyttig?

Last updated on 2026-03-12