Dela via

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

  • Artikel

Viktigt

[Denna artikel är en förhandsversion av dokumentationen 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. Copilot för försäljning 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 funktionen för sammanfattning av CRM-post som tillhandahålls av Copilot för försäljning med insikter från din egen app.

API-beskrivning

Du måste lägga till följande API-beskrivning i åtgärden. På så sätt kan Copilot för försäljning 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 de befintliga färdigheterna i copilot för försäljning.

Indataparametrar

Copilot för försäljning har utformats för att tillhandahålla följande indataparametrar till dina API:er.

Name Datatyp/format Obligatoriskt Details Beskrivning som ska läggas till i åtgärden
recordType String Ja 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 Ja 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 Nej. Startdatumet och starttiden för att söka efter insikter. Formatet följer OpenAPI-specifikationen. Här följer ett exempel: 2017-07-21T17:32:28Z. Denna indata anger startdatum och starttid för de insikter som begärs.
endDateTime Sträng i datum-/tidformat Nej. Slutdatumet och sluttiden för att söka efter insikter. Formatet följer OpenAPI-specifikationen. Här följer ett exempel: 2017-07-21T17:32:28Z. Denna indata anger slutdatum och sluttid för de insikter som begärs.
top Integer Nej. Antalet insikter att hämta. Denna indata anger antalet insikter som ska hämtas.
hoppa över Integer Nej. Antalet insikter att hoppa över. Denna indata anger antalet insikter som ska hoppas över.
crmType String Nej. 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 Nej. 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

Copilot för försäljning förväntar sig att få en lista med insikter (objekt) från dina API:er, och lösningen förväntar sig att varje insikt har specifika parametrar. För att säkerställa att Copilot för försäljning kan parsa utdata korrekt måste svarsstrukturen följa riktlinjerna i följande tabell.

Parameter Datatyp Obligatoriskt Details
value Matris Ja En lista över insikter (objekt) som definieras enligt beskrivningen i avsnittet Schema för insikter.
hasMoreResults Booleskt Nej. Ett värde som anger om det finns fler resultat.

Schema för insikter

Name Datatyp/format Obligatoriskt Details Beskrivning som ska läggas till i åtgärden
rubrik String Ja 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 Ja 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.
dateTime Sträng i datum-/tidformat Ja Datum och tid för aktiviteten i UTC-format. Om aktiviteten har både en starttid och en sluttid måste appen kunna avgöra vilken tid som ska visas. Formatet följer OpenAPI-specifikationen. Här följer ett exempel: 2017-07-21T17:32:28Z. Denna utdata anger den tid som har associerats med insikten.
url String Nej. 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 värden för Egenskapsnamn och Egenskapsvärde av typen Sträng Nej.

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 följer ett exempel.

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

Obs

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.

Exempel

{
    "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 partnerappen. Avsnittsrubriken härleds från namnet på Microsoft Power Platform-anslutningsprogrammet.
  2. Beskrivningar av insikten från API-svaret.
  3. Källhänvisningsnummer som kan väljas för att visa information om insikten.
  4. Källhänvisningskort som visar information om insikten.
  5. Insiktens ikon och rubrik. Ikonen hämtas från metadata för Microsoft Power Platform anslutningsprogram. Rubriktexten är rubriken på insikten från API-svaret.
  6. Ytterligare egenskaper för insikten från API-svaret.
  7. Namn för partnerprogrammet. Namnet som visas är namnet på Microsoft Power Platform-anslutningsprogrammet.
  8. Länk som kan väljas för att visa insiktsinformation i partnerappen. Den baseras på URL:en för insikten i API-svaret.

Vissa postsammanfattning
Utöka e-postsammanfattningar med insikter från din app
Utöka e-postutkast med fillänkar från ditt program
Utöka viktig säljinformation med insikter från din app
Berika postinformation för CRM med insikter från ditt program
Utöka Microsoft 365 Copilot för försäljning med partnerappar
Skapa Copilot för försäljning-tillägg