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

Important

Dit artikel is documentatie voorafgaand aan de release en kan nog wijzigen.

Om de context van een vergadering waar ze zich op voorbereiden of een e-mail die ze lezen beter te begrijpen, willen verkopers beschikken over relevante CRM-informatie (Customer Relationship Management), zoals vragen, zorgen en notities van klanten. De verkoopagent gebruikt AI om een samenvatting van elke CRM-record te genereren. In deze samenvatting worden belangrijke details benadrukt, zoals de verkoopfase, het budget en de verwachte sluitingsdatum. U kunt de samenvattingsfunctie voor CRM-records uitbreiden die de verkoopagent biedt met inzichten uit uw eigen toepassing.

API-omschrijving

U moet de volgende API-beschrijving aan de actie toevoegen. Op deze manier kan de verkoopagent de juiste API identificeren die moet worden aangeroepen om de mogelijkheid te verrijken.

Met deze actie krijgt u aanvullende aan een CRM-record gerelateerde verkoopinzichten. Deze worden weergegeven op de samenvattingskaart van de C4S-record. De actie verbetert de bestaande vaardigheden van copilot voor verkoop.

API-bewerking

Deze API maakt gebruik van het bewerkingstype: GET

Invoerparameters

De verkoopagent is ontworpen om de volgende invoerparameters voor uw API's op te geven.

Naam Gegevenstype/-indeling Verplicht Details Beschrijving die moet worden toegevoegd aan de actie
recordType Snaar / Touwtje Yes Het type entiteit of object in CRM waarvoor gerelateerde inzichten, zoals activiteiten, 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 mogelijkheid. Deze invoer geeft het entiteits- of objecttype in CRM aan waarvoor inzichten worden aangevraagd.
recordId Snaar / Touwtje Yes De unieke identificatie van het CRM-record. Deze invoer geeft de unieke id van de CRM-record aan waarvoor inzichten worden aangevraagd.
startdatum en -tijd Een tekenreeks in datum-tijdnotatie No De begindatum en -tijd voor het zoeken naar inzichten. De indeling volgt de OpenAPI-specificatie. Hier volgt een voorbeeld: 2017-07-21T17:32:28Z. Deze invoer geeft de begindatum en -tijd aan voor de aangevraagde inzichten.
endDateTime Een tekenreeks in datum-tijdnotatie No De einddatum en -tijd voor het zoeken naar inzichten. De indeling volgt de OpenAPI-specificatie. Hier volgt een voorbeeld: 2017-07-21T17:32:28Z. Deze invoer geeft de einddatum en -tijd aan voor de aangevraagde inzichten.
top Geheel getal No Het aantal inzichten dat moet worden opgehaald. Deze invoer geeft het aantal inzichten aan dat moet worden opgehaald.
skip Geheel getal No Het aantal inzichten dat moet worden overgeslagen. Deze invoer geeft het aantal inzichten aan dat moet worden overgeslagen.
crmType-soort Snaar / Touwtje No De geldige waarden zijn Dynamics 365 en Salesforce. Deze invoer geeft het type CRM aan waarin de CRM-record bestaat, waarvoor inzichten worden aangevraagd.
crmOrgUrl Snaar / Touwtje No De hostnaam van de CRM-organisatie, bijvoorbeeld contoso.crm.dynamics.com. Deze invoer geeft de URL van de CRM-omgeving aan waarin de CRM-record bestaat, waarvoor inzichten worden aangevraagd.

Uitvoerparameters

De verkoopagent verwacht een lijst met inzichten (objecten) van uw API's te ontvangen en verwacht dat elk inzicht specifieke parameters heeft. Om ervoor te zorgen dat de verkoopagent de uitvoer correct kan parseren, moet de antwoordstructuur voldoen aan de richtlijnen in de volgende tabel.

Kenmerk Gegevenstype Verplicht Details
value Array Yes Een lijst met inzichten (objecten) die zijn gedefinieerd zoals beschreven in de sectie Schema voor inzichten.
heeftMeerResultaten Boolean No Een waarde die aangeeft of er meer resultaten beschikbaar zijn.

Schema voor inzichten

Naam Gegevenstype/-notatie Verplicht Details Beschrijving toe te voegen aan de actie
titel Snaar / Touwtje Yes De titel van het inzicht op de citeringskaart. Dit is de titel in natuurlijke taal van het inzicht in de taal die is opgegeven via de Accept-Language-aanvraagheader. Dit is een voorbeeld: Contract ondertekend. Deze uitvoer geeft de titel van de activiteit in de verwijzingskaart aan.
beschrijving Snaar / Touwtje Yes De beschrijving van het inzicht. Ze worden weergegeven als opsommingstekens in het recordoverzicht en vormen de beschrijving in natuurlijke taal van het inzicht, in de taal die is gespecificeerd via de Accept-Language-header. Hier is een voorbeeld: Kenny, Logan en twee anderen ondertekenden het Contoso 2023 verlengingscontract op 7-9-2023. Deze uitvoer geeft de beschrijving van het inzicht aan.
dateTime Een tekenreeks in datum-tijdnotatie Yes De datum en tijd van de activiteit in UTC-notatie. Als de activiteit zowel een begintijd als een eindtijd heeft, moet de toepassing bepalen welke tijd moet worden weergegeven. De indeling volgt de OpenAPI-specificatie. Hier volgt een voorbeeld: 2017-07-21T17:32:28Z. Deze uitvoer geeft de tijd aan die is gekoppeld aan het inzicht.
URL Snaar / Touwtje No Een geldige URL waarmee de activiteit in de partnertoepassing kan worden geopend. Deze uitvoer geeft de URL aan om Insight te openen.
extra eigenschappen Een object met eigenschapsnaam en eigenschapswaardewaarden van het tekenreekstype No

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

{
 "Statusreden": "Afgesloten",
 "Eigenaar": "Kenny Smith"
}
 Deze uitvoer geeft aanvullende eigenschappen aan die worden weergegeven in de gedetailleerde weergave van het inzicht.

Note

Hoewel de API-vereisten voor het uitbreiden van de mogelijkheden voor e-mailsamenvattingen en recordsamenvattingen er mogelijk hetzelfde uitzien, moeten ze als afzonderlijke acties in de connector worden toegevoegd.

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
}

De voorbeeld in de volgende afbeelding laat zien hoe de uitvoer van de API wordt toegewezen aan de recordsamenvatting.

Schermopname van de anatomie van de meest recente activiteiten van een partnertoepassing.

Legenda:

  1. Sectie waarin inzichten uit de partnertoepassing worden weergeven. De sectietitel is afgeleid van de naam van de Microsoft Power Platform-connector.
  2. Beschrijvingen van de inzichten uit de API-reactie.
  3. Bronvermeldingsnummers die kunnen worden geselecteerd om details over het inzicht weer te geven.
  4. Bronvermeldingskaart met details over het inzicht.
  5. Pictogram en titel van het inzicht. Het pictogram wordt opgehaald uit de metagegevens van de Microsoft Power Platform-connector. De titeltekst is de titel van het inzicht uit de API-respons.
  6. Aanvullende eigenschappen van het inzicht uit het API-antwoord.
  7. Naam van de partnertoepassing. De naam die wordt weergegeven, is de naam van de Microsoft Power Platform-connector.
  8. Link die geselecteerd kan worden om inzichten in de partnertoepassing te bekijken. Deze is gebaseerd op de URL van het inzicht in de API-respons.

Samenvatting van record weergeven
E-mailsamenvattingen verrijken met inzichten uit uw toepassing
Verrijk e-mailontwerpen met bestandslinks vanuit uw applicatie
Inzichten in verkoopkansen verrijken met gegevens uit uw toepassing
Belangrijke CRM-recorddetails verrijken met inzichten uit uw toepassing
Verkoopagent uitbreiden met partnertoepassingen
Extensies bouwen voor verkoopagent

  • Last updated on