Delen via

CRM-recorddetails verrijken met inzichten uit uw toepassing (preview)

  • Artikel

Belangrijk

[Dit artikel maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Verkopers kunnen details over een opgeslagen contactpersoon bekijken, samen met de bijbehorende records zoals accounts en verkoopkansen. U kunt de functionaliteit voor CRM-recordgegevens (Customer Relationship Management) die Copilot voor Sales biedt, uitbreiden met inzichten uit uw eigen toepassing.

API-omschrijving

U moet de volgende API-beschrijving aan de actie toevoegen. Op deze manier kan Copilot voor Sales de juiste API identificeren die moet worden aangeroepen om de mogelijkheden uit te breiden.

Met deze actie worden records opgehaald die gerelateerd zijn aan een CRM-record. De actie verbetert de bestaande vaardigheden van Copilot voor Sales.

Invoerparameters

Copilot voor Sales is ontworpen om de volgende invoerparameters aan uw API's te leveren.

Meting Gegevenstype/-indeling Vereist DETAILS Beschrijving die in de actie moet worden toegevoegd
recordType String Ja Het type entiteit of object in CRM waarvoor gerelateerde records worden aangevraagd. De waarde bevat de taalonafhankelijke unieke naam van het entiteits- of objecttype, niet de weergavenaam die kan worden gelokaliseerd. Voorbeelden hiervan zijn account en verkoopkans. Deze invoer geeft het recordtype in CRM aan waarvoor gerelateerde records worden aangevraagd.
recordId String Ja De unieke id van de CRM-record. Deze invoer biedt de unieke id van de CRM-record waarvoor gerelateerde records worden aangevraagd.
top Integer No Het aantal activiteiten dat moet worden opgehaald. Deze invoer geeft het aantal gerelateerde records aan dat moet worden opgehaald.
skip Integer No Het aantal activiteiten dat moet worden overgeslagen. Deze invoer geeft het aantal records aan dat moet worden overgeslagen bij het ophalen van gerelateerde records.
crmType String No Het type CRM-systeem. De geldige waarden zijn Dynamics 365 en Salesforce. Deze invoer geeft aan uit welk type CRM de gerelateerde records worden opgehaald.
crmOrgUrl String No De hostnaam van de CRM-organisatie, bijvoorbeeld contoso.crm.dynamics.com. Deze invoer geeft de URL van de CRM-omgeving aan waaruit de gerelateerde records worden opgehaald.

Notitie

Dit uitbreidingspunt ondersteunt het weergeven van inzichten uit maximaal vijf connectorextensies in het Outlook-zijpaneel.

Uitvoerparameters

Copilot voor Sales verwacht een lijst met inzichten (objecten) vanuit uw API's en verwacht dat elk inzicht specifieke parameters heeft. Om ervoor te zorgen dat Copilot voor Sales de uitvoer correct kan parseren, moet de antwoordstructuur de richtlijnen in de onderstaande tabel volgen.

Parameter Gegevenstype Vereist DETAILS
value Matrix Ja Een lijst met inzichten (objecten) die zijn gedefinieerd zoals beschreven in de sectie Schema voor inzichten.
hasMoreResults Booleaans No Een waarde die aangeeft of meer resultaten beschikbaar zijn.

Schema voor inzichten

Meting Gegevenstype/-indeling Vereist DETAILS Beschrijving die in de actie moet worden toegevoegd
recordId String Ja De unieke id van de record. Deze uitvoer identificeert op unieke wijze elke gerelateerde record die door de actie wordt geretourneerd.
recordTypeDisplayName String Ja De weergavenaam van het recordtype, zoals Contract. Deze moet worden gelokaliseerd in de taal die is opgegeven via de Accept-Language-koptekst. Deze uitvoer geeft de weergavenaam aan van het recordtype van elke gerelateerde record die door de actie wordt geretourneerd.
recordTypePluralDisplayName String Ja De meervoudige weergavenaam van het recordtype, zoals Contracten. Deze moet worden gelokaliseerd in de taal die is opgegeven via de Accept-Language-koptekst. Deze uitvoer geeft de meervoudsweergavenaam aan van het recordtype van elke gerelateerde record die door de actie wordt geretourneerd.
recordType String Ja De systeemnaam van het recordtype, zoals contract. Deze uitvoer geeft het type aan van elke gerelateerde record die door de actie wordt geretourneerd.
recordTitle String Ja De naam van de record, zoals Contoso 2023-verlengingscontract. Deze uitvoer geeft de titel aan van elke gerelateerde record die door de actie wordt geretourneerd.
url String No Een geldige URL waarmee de record in de partnertoepassing kan worden geopend. Deze uitvoer geeft de URL aan van elke gerelateerde record die door de actie wordt geretourneerd.
additionalProperties Een object met waarden voor Naam van eigenschap en Waarde van eigenschap van het type Tekenreeks No

Extra eigenschappen die in de gedetailleerde weergave worden weergegeven. Eigenschapsnamen en -waarden zijn in natuurlijke taal in de taal die is opgegeven via de Accept-Language-koptekst. Hier volgt een voorbeeld.

{
 "Reden van status": "Goedgekeurd",
 "Eigenaar": "Kenny Smith"
}
 Deze uitvoer geeft aanvullende eigenschappen aan als naam-waardeparen van elke gerelateerde record die door de actie wordt geretourneerd.

Voorbeeld

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

De volgende afbeelding toont een voorbeeld van hoe de uitvoer van de API wordt toegewezen aan de gerelateerde records.

Schermopname van de anatomie van gerelateerde records vanuit een partnertoepassing.

Legenda:

  1. Kaart met gerelateerde records uit de partnertoepassing.
  2. Pictogram en titel van de kaart. Het pictogram wordt opgehaald uit de metagegevens van de Microsoft Power Platform-connector. De titel is de naam van de Microsoft Power Platform-connector.
  3. Titels van gerelateerde records uit het API-antwoord. Twee extra eigenschappen uit het API-antwoord worden weergegeven als sleutelvelden van elke gerelateerde record.
  4. De knop Meer acties waarmee u een koppeling naar de record kunt kopiëren of recorddetails in de partnertoepassing kunt bekijken. De koppeling is gebaseerd op de URL van de gerelateerde record in het API-antwoord.
  5. Aanvullende eigenschappen van de gerelateerde record uit het API-antwoord.

Recorddetails bekijken
E-mailsamenvattingen verrijken met inzichten uit uw toepassing
Verrijk e-mailconcepten met bestandskoppelingen uit uw applicatie
Belangrijke verkoopinformatie verrijken met inzichten uit uw toepassing
CRM-recordsamenvattingen verrijken met inzichten uit uw toepassing
Microsoft 365 Copilot voor Sales uitbreiden met partnertoepassingen
Copilot voor Sales-uitbreidingen bouwen