Dela via

Berika postinformationen för CRM med insikter från ditt program (förhandsgranskning)

  • Artikel

Viktigt

[Denna artikel är en förhandsversion av dokumentationen och kan komma att ändras.]

Säljare kan visa information om en sparad kontakt tillsammans med dess associerade poster, till exempel konton och affärsmöjligheter. Du kan utöka funktionen för CRM-postinformation (hantering av kundrelationer) som Copilot för försäljning tillhandahåller 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 poster som är relaterade till en CRM-post. Å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 Den typ av entitet eller objekt i CRM som relaterade poster 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 identifierar den posttyp i CRM för vilken relaterade poster begärs.
recordId String Ja Den unika identifieraren för CRM-posten. Denna indata tillhandahåller den unika identifierare för den CRM-post för vilken relaterde poster begärs.
top Integer Nej. Antalet aktiviteter att hämta. Denna indata anger antalet relaterade poster som ska hämtas.
hoppa över Integer Nej. Antalet aktiviteter att hoppa över. Denna indata anger antalet poster som ska hoppas över när relaterade poster hämtas.
crmType String Nej. Typen av CRM-system. Giltiga värden är Dynamics 365 och Salesforce. Denna indata anger vilken typ av CRM de relaterade posterna hämtas från.
crmOrgUrl String Nej. Värdnamnet för CRM-organisationen, till exempel contoso.crm.dynamics.com. Denna indata anger den URL för CRM-miljön som de relaterade posterna hämtas från.

Obs

Denna tilläggspunkt stöder rendering av insikter från upp till fem tillägg för anslutningsprogram i Outlook-sidovagnen.

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
recordId String Ja Den unika identifieraren för posten. Denna utdata identifierar unikt varje relaterad post som returneras av åtgärden.
recordTypeDisplayName String Ja Visningsnamnet för posttypen, till exempel Kontrakt. Det ska lokaliseras på det språk som anges i huvudetAccept-Language. Denna utdata anger visningsnamn av posttyp för varje relaterad post som returneras av åtgärden.
recordTypePluralDisplayName String Ja Visningsnamnet i plural för posttypen, till exempel Kontrakt. Det ska lokaliseras på det språk som anges i huvudetAccept-Language. Denna utdata anger visningsnamn i plural av posttypen för varje relaterad post som returneras av åtgärden.
recordType String Ja Systemnamnet för posttypen, till exempel contract. Denna utdata anger typen för varje relaterad post som returneras av åtgärden.
recordTitle String Ja Namnet på posttypen, till exempel Förnyelsekontrakt Contoso 2023. Denna utdata anger rubriken för varje relaterad post som returneras av åtgärden.
url String Nej. En giltig URL för att öppna posten i partnerappen. Denna utdata anger URL för varje relaterad post som returneras av åtgärden.
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 indikerar ytterligare egenskaper som namn/värde-par för respektive post som returneras av åtgärden.

Exempel

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

Exemplet i följande bild visar hur utdata från API:et mappas till relaterade poster.

Skärmbild som visar strukturen för relaterade poster från en partnerapp.

Förklaring:

  1. Kort som visar relaterade poster från partnerappen.
  2. Kortets ikon och rubrik. Ikonen hämtas från metadata för Microsoft Power Platform anslutningsprogram. Rubriken är namnet på Microsoft Power Platform-anslutningsprogrammet.
  3. Relaterade postrubriker från API-svaret. Ytterligare två egenskaper från API-svaret återges som nyckelfält för varje relaterad post.
  4. Knappen ”Fler åtgärder” som kan användas antingen för att kopiera en länk till posten eller för att visa postinformation i partnerappen. Länken baseras på URL:en för den relaterade posten i API-svaret.
  5. Ytterligare egenskaper för den relaterade posten från API-svaret.

Visa postinformation
Lägg till en ny funktion för frågor och svar i Sales-chatten
Utöka e-postsammanfattningar med insikter från din app
Utöka viktig säljinformation med insikter från din app
Berika postsammanfattningar för CRM med insikter från din app
Utöka Microsoft 365 Copilot för försäljning med partnerappar
Skapa Copilot för försäljning-tillägg