Del via

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

  • Artikel

Vigtige oplysninger

[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. Copilot til salg bruger kunstig intelligens (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 postoversigten i CRM med de funktioner, der findes i Copilot til salg, 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 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.

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 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.
skip 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

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
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.
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"
}
 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:

  1. Afsnittet viser indsigt fra partnerprogrammet. Sektionstitlen er afledt af navnet på Microsoft Power Platform-connector.
  2. Beskrivelser af indsigt fra API-svaret.
  3. Citatnumre, der kan vælges for at få vist detaljer om indsigten.
  4. Citatkort, der viser detaljer om indsigten.
  5. Ikon og titel til indsigt. Ikonet hentes fra Microsoft Power Platform-connectorens metadata. Titelteksten er titlen på indsigt fra API-svaret.
  6. Yderligere egenskaber for indsigt fra API-svaret.
  7. Partnerprogrammets navn. Det navn, der vises, er navnet på Microsoft Power Platform-connectoren.
  8. 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
Forbedre vigtige salgsoplysninger med indsigt fra dit program
Forbedre oplysninger om CRM-poster med indsigt fra dit program
Udvide Microsoft 365 Copilot til salg med partnerapplikationer
Opbygge Copilot til salg-udvidelser