Berika postsammanfattningar för CRM med insikter från din app (förhandsversion)

Important

  • Det här är en funktion för produktionsklar förhandsgranskning.
  • Produktionsklara förhandsvisningar är föremål för kompletterande användarvillkor.

[Den här artikeln är förhandsdokumentation och kan komma att ändras.]

För att bättre förstå sammanhanget för ett möte som de förbereder sig för, eller ett e-postmeddelande som de läser, vill säljare ha relevant CRM-information (hantering av kundrelationer), till exempel kundfrågor, problem och anteckningar. Försäljningsagenten använder AI för att generera en sammanfattning av varje CRM-post. Den här sammanfattningen belyser viktiga detaljer, såsom försäljningsstadium, budget och beräknat stängningsdatum. Du kan utöka sammanfattningsfunktionen för CRM-poster som försäljningsagenten tillhandahåller med insikter från ditt eget program.

API-beskrivning

Du måste lägga till följande API-beskrivning i åtgärden. På så sätt kan försäljningsagenten identifiera rätt API som måste anropas för att utöka funktionen.

Den här åtgärden hämtar ytterligare försäljningsinsikter som är relaterade till en CRM-post som ska visas på sammanfattningskortet för C4S-posten. Åtgärden förbättrar försäljningskopilotens befintliga färdigheter.

API-åtgärd

Det här API:et använder åtgärdstyp: GET

Indataparametrar

Försäljningsagenten är utformad för att tillhandahålla följande indataparametrar till dina API:er.

Namn Datatyp/format Obligatoriskt Detaljer Beskrivning som ska läggas till i åtgärden
recordType String Yes Typen av entitet eller objekt i CRM som relaterade insikter såsom aktiviteter begärs för. Värdet innehåller det språkoberoende unika namnet på entiteten eller objekttypen, inte det visningsnamn som kan lokaliseras. Exempel är konto och affärsmöjlighet. Denna indata anger den entitets- eller objektstyp i CRM för vilka insikter begärs.
recordId String Yes Den unika identifieraren för CRM-posten. Denna indata indikerar den unika identifierare för den CRM-post för vilken insikter begärs.
startDateTime Sträng i datum-/tidformat No Startdatumet och starttiden för att söka efter insikter. Formatet följer OpenAPI-specifikationen. Här är ett exempel: 2017-07-21T17:32:28Z. Denna indata anger startdatum och starttid för de insikter som begärs.
sluttidpunkt Sträng i datum-/tidformat No Slutdatumet och sluttiden för att söka efter insikter. Formatet följer OpenAPI-specifikationen. Här är ett exempel: 2017-07-21T17:32:28Z. Denna indata anger slutdatum och sluttid för de insikter som begärs.
top Heltal No Antalet insikter som ska hämtas. Denna indata anger antalet insikter som ska hämtas.
skip Heltal No Antalet insikter att hoppa över. Denna indata anger antalet insikter som ska hoppas över.
CRM-typ String No Giltiga värden är Dynamics 365 och Salesforce. Denna indata anger i vilken typ av CRM som den CRM-post finns för vilken insikter begärs.
crmOrgUrl String No Värdnamnet för CRM-organisationen, till exempel contoso.crm.dynamics.com. Denna indata anger URL:en för den CRM-miljö i vilken CRM-posten finns för vilken insikter begärs.

Utdataparametrar

Försäljningsagenten förväntar sig att få en lista över insikter (objekt) från dina API:er och förväntar sig att varje insikt har specifika parametrar. För att försäljningsagenten ska kunna parsa utdata korrekt måste svarsstrukturen följa riktlinjerna i följande tabell.

Parameter Datatyp Obligatoriskt Detaljer
value Array Yes En lista över insikter (objekt) som definieras enligt beskrivningen i avsnittet Schema för insikter .
hasMoreResults Boolesk No Ett värde som anger om fler resultat är tillgängliga.

Schema för insikter

Namn Datatyp/format Obligatoriskt Detaljer Beskrivning som ska läggas till i åtgärden
rubrik String Yes Insiktens rubrik på hänvisningskortet. Det är insiktens rubrik på det naturliga språk som anges via begärandehuvudetAccept-Language. Här är ett exempel: Undertecknat kontrakt. Denna utdata anger rubriken för aktiviteten på hänvisningskortet.
beskrivning String Yes Beskrivning av insikten. Den visas som punkter i postsammanfattningen och är en beskrivning på naturligt språk av insikten på det språk som anges i huvudet Accept-Language. Här är ett exempel: Kenny, Logan och två andra undertecknade förnyelsekontraktet för Contoso den 9 juli 2023. Denna utdata anger beskrivningen av insikten.
datumtid Sträng i datum-/tidformat Yes Datum och tid för aktiviteten i UTC-format. Om aktiviteten har både en starttid och en sluttid måste programmet bestämma vilken tid som ska visas. Formatet följer OpenAPI-specifikationen. Här är ett exempel: 2017-07-21T17:32:28Z. Det här utdata anger den tid som är associerad med insikten.
URL String No En giltig URL för att öppna aktiviteten i partnerappen. Denna utdata visar URL:en för att öppna en insikt.
additionalProperties Ett objekt som har egenskapsnamn och egenskapsvärdevärden av strängtypen No

Ytterligare egenskaper som visas i den detaljerade vyn. Egenskapsnamn och värden är på naturligt språk och på det språk som anges via huvudet Accept-Language . Här är ett exempel:

{
 "Statusorsak": "Utloggad",
 ”Ägare”: ”Kenny Smith”
}
 Denna utdata anger ytterligare egenskaper som visas i den detaljerade vyn för insikten.

Anmärkning

API-kraven för att utöka funktionerna för e-postsammanfattning och postsammanfattning kanske ser likadana ut, men de måste läggas till som separata åtgärder i anslutningsprogrammet.

Example

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

Exemplet i följande bild visar hur API-utdata mappas i postsammanfattningen.

Skärmbild som visar strukturen för de senaste aktiviteterna från en partnerapp.

Förklaring:

  1. Avsnitt som visar insikter från partnerprogrammet. Avsnittsrubriken härleds från namnet på Microsoft Power Platform-anslutningsappen.
  2. Beskrivningar av insikten från API-svaret.
  3. Citatnummer som kan väljas för att visa information om insikten.
  4. Källhänvisningskort som visar information om insikten.
  5. Ikon och rubrik för insikten. Ikonen hämtas från metadata för Microsoft Power Platform-anslutningsappen. Rubriktexten är rubriken på insikten från API-svaret.
  6. Ytterligare egenskaper för insikten från API-svaret.
  7. Namnet på partnerprogrammet. Namnet som visas är namnet på Microsoft Power Platform-anslutningsappen.
  8. Länk som kan väljas för att visa insiktsinformation i partnerprogrammet. Den baseras på URL:en för insikten i API-svaret.

Vissa postsammanfattning
Berika e-postsammanfattningar med insikter från ditt program
Utöka e-postutkast med fillänkar från ditt program
Berika affärsmöjlighetsinsikter med data från ditt program
Berika postinformation för CRM med insikter från ditt program
Utöka försäljningsagenten med partnerprogram
Skapa tillägg för Försäljningsagent

  • Last updated on