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

Vigtigt!

[Denne artikel er foreløbig dokumentation og kan ændres.]

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 Obligatorisk Detaljer Beskrivelse, der skal tilføjes i 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 OpenAPI-specifikationen. 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 OpenAPI-specifikationen. Her er et eksempel: 2017-07-21T17:32:28Z. Dette input angiver slutdatoen og klokkeslættet for den ønskede indsigt.
top Heltal Nej Det antal indsigter, der skal hentes. Dette input angiver antallet af indsigter, der skal hentes.
springe over Heltal Nej Det 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 Datatyp Obligatorisk Detaljer
Værdi Array 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 tilgængelige resultater.

Skema for indsigt

Name Datatype/-format Obligatorisk Detaljer 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 OpenAPI-specifikationen. Her er et eksempel: 2017-07-21T17:32:28Z. Dette output angiver den tid, der er knyttet til indsigten.
url 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 egenskabsnavn og egenskabsværdiværdieraf strengtypen 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ærkning

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. Sektion, der viser indsigt fra partnerprogrammet. Afsnitstitlen er afledt af navnet på Microsoft Power Platform-connectoren.
  2. Beskrivelser af indsigten 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 på indsigten. Ikonet hentes fra metadataene for Microsoft Power Platform-connectoren. Titelteksten er titlen på indsigt fra API-svaret.
  6. Yderligere egenskaber for indsigten fra API-svaret.
  7. Navnet på partnerprogrammet. Det viste navn er navnet på Microsoft Power Platform-connectoren.
  8. Link, der kan vælges for at få vist indsigtsoplysninger i partnerprogrammet. Den er baseret på URL-adressen for indsigten i API-svaret.

Se postoversigt
Gør mailoversigter bedre med indsigt fra dit program
Gør mailudkast bedre 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

  • Last updated on