Delen via

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

  • Artikel

Belangrijk

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

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. Copilot voor Sales maakt gebruik van 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 mogelijkheid voor CRM-recordsamenvattingen 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 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 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 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 verkoopkans. Deze invoer geeft het entiteits- of objecttype in CRM aan waarvoor inzichten worden aangevraagd.
recordId String Ja De unieke id van de CRM-record. Deze invoer geeft de unieke id van de CRM-record aan waarvoor inzichten worden aangevraagd.
startDateTime Tekenreeks in datum-/tijd-notatie No De begindatum en -tijd voor het zoeken naar inzichten. De notatie 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 Tekenreeks in datum-/tijd-notatie No De einddatum en -tijd voor het zoeken naar inzichten. De notatie 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 Integer No Het aantal inzichten dat moet worden opgehaald. Deze invoer geeft het aantal inzichten aan dat moet worden opgehaald.
skip Integer No Het aantal inzichten dat moet worden overgeslagen. Deze invoer geeft het aantal inzichten aan dat moet worden overgeslagen.
crmType String 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 String 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

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/-notatie Vereist DETAILS Beschrijving die in de actie moet worden toegevoegd
titel String Ja De titel van het inzicht op de verwijzingskaart. 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.
description String Ja De beschrijving van het inzicht. Deze wordt weergegeven met opsommingstekens in het recordoverzicht en is de beschrijving in natuurlijke taal van het inzicht in de taal die is opgegeven 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 Tekenreeks in datum-/tijd-notatie Ja De datum en tijd van de activiteit in UTC-notatie. Als de activiteit zowel een begin- als een eindtijd heeft, moet de toepassing bepalen welke tijd moet worden weergegeven. De notatie volgt de OpenAPI-specificatie. Hier volgt een voorbeeld: 2017-07-21T17:32:28Z. Deze uitvoer geeft de tijd aan die aan het inzicht is gekoppeld.
url String No Een geldige URL waarmee de activiteit in de partnertoepassing kan worden geopend. Deze uitvoer geeft de URL aan om het inzicht te openen.
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 die worden weergegeven in de gedetailleerde weergave van het inzicht.

Opmerking

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.

Voorbeeld

{
    "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 wordt afgeleid van de naam van de Microsoft Power Platform-connector.
  2. Beschrijvingen het inzicht uit de API-respons.
  3. Verwijzingsnummers die geselecteerd kunnen worden om details over het inzicht te bekijken.
  4. Verwijzingskaart 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 de API-respons.
  7. Naam van de partnertoepassing. De naam die wordt weergegeven, is de naam van de Microsoft Power Platform-connector.
  8. Koppeling die kan worden geselecteerd om details over het inzicht te bekijken in de partnertoepassing. 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-mailconcepten met bestandskoppelingen uit uw applicatie
Belangrijke verkoopinformatie verrijken met inzichten uit uw toepassing
Belangrijke CRM-recorddetails verrijken met inzichten uit uw toepassing
Microsoft 365 Copilot voor Sales uitbreiden met partnertoepassingen
Copilot voor Sales-uitbreidingen bouwen