Verrijk de e-mailsamenvatting met inhoudelijke suggesties uit uw applicatie (voorbeeld)

Important

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

Wanneer Copilot in Outlook en de verkoopagent samen worden gebruikt, bevatten e-mailoverzichten die worden weergegeven in Outlook verkoopgegevens die afkomstig zijn van uw CRM-systeem (Customer Relationship Management), zoals Dynamics 365 of Salesforce CRM. U kunt de e-mailsamenvattingsmogelijkheid uitbreiden die de verkoopagent biedt met inzichten uit uw eigen toepassing.

Note

Deze API vervangt de bestaande API Vaardigheid e-mailsamenvatting (bewerkings-id: scp-get-email-insights) door een nieuwe versie.

API-omschrijving

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

Met deze actie krijgt u aanvullende verkoopinzichten die worden weergegeven in de C4S-e-mailsamenvatting-ervaring in de Outlook-samenvatting. De actie verbetert de bestaande vaardigheden van copilot voor verkoop.

API details

  • API-naam: Vaardigheid e-mailsamenvatting versie 2
  • Swagger-bewerkings-id: scp-get-email-insights-v2
  • Swagger-bewerkingsmethode: post
  • Pad: <PowerAppsConnectorHostName>/api/enhanceskills/email-insights-v2

Invoernettolading

Deze payload vormt de aanvraagbody van de API-aanvraag.

Naam Gegevenstype Verplicht Details Beschrijving die moet worden toegevoegd aan de actie
brongegevens Object Yes De brongegevens die gebruikt moeten worden voor het ophalen van de voorgestelde inhoud. Ga voor de gegevensstructuur naar Gegevensmodel voor e-mail voor uitbreidbaarheid. Met deze invoer wordt de inhoud van het e-mailbericht geïdentificeerd. Dit is een verzameling van e-mailthreads, onderwerpen en andere details.
verwanteEntiteiten Array No De matrix van gerelateerde entiteiten. Ga voor de gegevensstructuur naar Gegevensmodel voor gerelateerde entiteiten. Met deze invoer wordt de matrix van CRM-records geïdentificeerd die aan de e-mailthread is gerelateerd.
crmType-soort Snaar / Touwtje No Het type CRM-systeem, indien aangesloten. De geldige waarden zijn Salesforce en Dynamics 365. Met deze invoer wordt het type CRM aangegeven waarin de record met betrekking tot de e-mailthread zich bevindt.
crmOrgUrl Snaar / Touwtje No De URL van de CRM-organisatie. Met deze invoer wordt de URL van de CRM-omgeving aangegeven waarin de record die aan de e-mailthread is gekoppeld, zich bevindt.
top Geheel getal No Het aantal op te halen items. Met deze invoer geeft u aan hoeveel bestandskoppelingen u wilt ophalen.
skip Geheel getal No Het aantal items dat moet worden overgeslagen. Met deze invoer geeft u aan hoeveel items u wilt overslaan bij het ophalen van voorgestelde bestandskoppelingen.

Gegevensmodel voor e-mail voor uitbreidbaarheid

Vastgoed Typ Details Beschrijving die moet worden toegevoegd aan de actie
plaintextBody Snaar / Touwtje De volledige e-mailtekst bevat alle voorgaande berichten van de e-mailthread. Met deze invoer wordt alle inhoud van de e-mailthread in tekstformaat weergegeven.
fullHtmlBody Snaar / Touwtje De volledige HTML-versie van de e-mailtekst, met daarin alle voorgaande berichten van de e-mailthread. Met deze invoer krijgt u alle inhoud van de e-mailthread in HTML-formaat.
Onderwerp Snaar / Touwtje Onderwerp van de e-mail. Met deze invoer geeft u het onderwerp van het e-mailbericht op.
van Snaar / Touwtje Het e-mailadres van de afzender. Deze invoer geeft het e-mailadres van de afzender weer.
naar / te string[] E-mailadressen van ontvanger. Deze invoer geeft het e-mailadres van de ontvanger weer.
cc string[] E-mailadressen van ontvangers worden toegevoegd in het Cc-veld van de e-mail. Met deze invoer geeft u alle e-mailadressen van de ontvanger op die in het Cc-veld van de e-mail zijn opgenomen.
bcc string[] E-mailadressen van ontvangers worden toegevoegd in het Bcc-veld van de e-mail. Met deze invoer worden alle e-mailadressen van de ontvanger weergegeven die zijn toegevoegd in het Bcc-veld van de e-mail.
sentDateTime DateTimeOffset De datum en tijd van het e-mailbericht in UTC-indeling, samen met de eigenschap Offset. Ga voor meer informatie naar DateTimeOffset Struct (System) Deze invoer geeft het tijdstempel van de e-mail weer.
bericht-ID Snaar / Touwtje De Graph-bericht-id van het e-mailbericht. Met deze invoer wordt de bericht-ID van de e-mail weergegeven.
conversationId Snaar / Touwtje De Graph-gespreks-id van de e-mailthread. Met deze invoer wordt de conversatie-ID van de e-mailthread weergegeven.
Vastgoed Typ Verplicht Details Beschrijving die moet worden toegevoegd aan de actie
entityId Snaar / Touwtje Yes Het type CRM-record, bijvoorbeeld account of verkoopkans. Deze invoer bevat de unieke identificatie van het CRM-record dat aan de e-mailthread is gekoppeld.
entityType Snaar / Touwtje Yes De unieke identificatie van het CRM-record dat moet worden gebruikt voor voorgestelde inhoud. Met deze invoer wordt het recordtype in CRM geïdentificeerd dat is gerelateerd aan de e-mailthread.
entiteitBron Snaar / Touwtje No Deze invoer geeft de bron van de entiteit aan; bevat momenteel 'verbonden' of lege waarden. Deze invoer geeft het brontype van de entiteit aan.

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.

Opmerking: hoewel deze parameter een lijst met inzichten bevat, wordt alleen het eerste inzicht gebruikt in de e-mailverrijkingssamenvatting voor de Outlook-canvaservaring.
heeftMeerResultaten Boolean No Een waarde die aangeeft of er meer resultaten beschikbaar zijn.

Schema voor inzichten

Naam Gegevenstype/-indeling Verplicht Details Beschrijving die moet worden toegevoegd aan de actie
Inzicht Snaar / Touwtje Yes Het inzicht dat gebruikers krijgen, zoals Uw collega's Mona Kane, Ray Tanaka en Daniela Smith hebben al eerder met hen gewerkt. Deze uitvoer geeft de tekst aan die u in de e-mailsamenvatting wilt opnemen.

Example

{
    "value": [
        {
            "insight": "Your colleagues Mona Kane, Ray Tanaka and Daniela Smith have worked with them before."
        },
        {
            "insight": "The email was opened three times in the last month."
        }
    ],
    "hasMoreResults": false
}

Het voorbeeld in de onderstaande afbeelding laat zien hoe de uitvoer van de API wordt toegewezen aan de e-mailsamenvatting in het zijpaneel.

Schermopname met inzichten uit partnerapps in de e-mailsamenvatting.

Legenda:

  1. Titel van het inzicht. Inzichten met dezelfde titel worden gegroepeerd.
  2. Beschrijvingen van het inzicht. Elk inzicht heeft één beschrijving.

Het voorbeeld in de onderstaande afbeelding laat zien hoe de uitvoer van de API wordt toegewezen aan de e-mailsamenvatting in de e-mailhoofdtekst.

Schermopname met inzichten uit partner-apps in de e-mailhoofdtekst.

Legenda:

  1. Titel van het inzicht. Inzichten met dezelfde titel worden gegroepeerd.
  2. Beschrijving van het inzicht. Elk inzicht heeft één beschrijving.

Een overzicht maken van een e-mailthread met behulp van verkoopinformatie met Copilot in Outlook
Inzichten in verkoopkansen verrijken met gegevens uit uw toepassing
Belangrijke CRM-recorddetails verrijken met inzichten uit uw toepassing
CRM-recordsamenvattingen verrijken met inzichten uit uw toepassing
Verkoopagent uitbreiden met partnertoepassingen
Verrijk e-mailontwerpen met bestandslinks vanuit uw applicatie
Extensies bouwen voor verkoopagent

  • Last updated on