Kopīgot, izmantojot

CRM ierakstu kopsavilkumu bagātināšana ar ieskatiem no lietojumprogrammas (priekšskatījums)

  • Raksts

Svarīgi

[Šis raksts ir pirmsizlaides dokumentācija, kas var mainīties.]

Lai labāk izprastu kontekstu, kas raksturo sapulci, kurai viņi gatavojas, vai e-pasta ziņojumu, ko viņi lasa, pārdevēji vēlas saņemt atbilstošu klientu attiecību pārvaldības (CRM) informāciju, piemēram, klientu vaicājumus, bažas un piezīmes. Copilot for Sales izmanto AI, lai ģenerētu katra CRM ieraksta kopsavilkumu. Šajā kopsavilkumā ir izcelta būtiska informācija, piemēram, pārdošanas posms, budžets un prognozētais slēgšanas datums. Varat paplašināt CRM ierakstu kopsavilkuma iespēju, ko Copilot for Sales nodrošina ar ieskatiem no savas lietojumprogrammas.

API apraksts

Darbībai ir jāpievieno tālāk norādītais API apraksts. Tādā veidā Copilot for Sales var identificēt pareizo API, kas jāizmanto, lai bagātinātu iespēju.

Šī darbība iegūst papildu pārdošanas ieskatus saistībā ar CRM ierakstu, kas tiks parādīts C4S ierakstu kopsavilkuma kartītē. Darbība uzlabo esošās copilot prasmes pārdošanai.

API darbība

Šis API izmanto operācijas tipu: GET

Ievades parametri

Copilot for Sales ir izstrādāts, lai jūsu API nodrošinātu šādus ievades parametrus.

Nosaukums/vārds Datu tips/formāts Obligāti Detalizēta informācija Apraksts, ko pievienot darbībai
recordType String Jā Entītijas vai objekta tips programmā CRM, kuram tiek pieprasīti saistītie ieskati, piemēram, darbības. Vērtība ietver valodas agnostisku unikālo entītijas vai objekta tipa nosaukumu, nevis parādāmo vārdu, ko var lokalizēt. Kā piemērus var minēt kontu un iespēju. Šī ievade norāda entītijas vai objekta tipu programmā CRM, par kuru tiek pieprasīti ieskati.
recordId String Jā CRM ieraksta unikālais identifikators. Šī ievade norāda tā CRM ieraksta unikālo identifikatoru, kuram tiek pieprasīti ieskati.
startDateTime Virkne "datuma-laika" formātā Nē. Sākuma datums un laiks, lai meklētu ieskatus. Formāts atbilst OpenAPI specifikācijai. Šeit ir piemērs: 2017-07-21T17:32:28Z. Šī ievade norāda pieprasīto ieskatu sākuma datumu un laiku.
endDateTime Virkne "datuma-laika" formātā Nē. Beigu datums un laiks, lai meklētu ieskatus. Formāts atbilst OpenAPI specifikācijai. Šeit ir piemērs: 2017-07-21T17:32:28Z. Šī ievade norāda pieprasīto ieskatu beigu datumu un laiku.
top Integer Nē. Iegūstamo ieskatu skaits. Šī ievade norāda iegūstamo ieskatu skaitu.
skip Integer Nē. Izlaižamo ieskatu skaits. Šī ievade norāda izlaižamo ieskatu skaitu.
crmType String Nē. Derīgas vērtības ir Dynamics 365 un Salesforce. Šī ievade norāda CRM tipu, kurā pastāv CRM ieraksts, par kuru tiek pieprasīti ieskati.
crmOrgUrl String Nē. CRM organizācijas resursdatora nosaukums, piemēram , contoso.crm.dynamics.com. Šī ievade norāda tās CRM vides vietrādi URL, kurā pastāv CRM ieraksts un par kuru tiek pieprasīti ieskati.

Izvades parametri

Copilot for Sales sagaida, ka saņems ieskatu (objektu) sarakstu no jūsu API, un tas sagaida, ka katram ieskatam būs noteikti parametri. Lai nodrošinātu, ka Copilot for Sales var pareizi parsēt izvadi, atbildes struktūrai ir jāatbilst vadlīnijām nākamajā tabulā.

Parametrs Datu tips Obligāti Detalizēta informācija
value Masīvs Jā Saraksts ar ieskatiem (objektiem), kas ir definēti, kā aprakstīts sadaļā Ieskatu shēma.
hasMoreResults Boolean Nē. Vērtība, kas norāda, vai ir pieejami papildu rezultāti.

Shēma ieskatiem

Nosaukums/vārds Datu tips/formāts Obligāti Detalizēta informācija Darbībā pievienojamais apraksts
nosaukums String Jā Ieskata nosaukums citēšanas kartītē. Tas ir ieskata dabiskās valodas nosaukums valodā, kas tiek norādīts, Accept-Language izmantojot pieprasījuma galveni. Šeit ir piemērs: Parakstīts līgums. Šī izvade norāda aktivitātes nosaukumu citēšanas kartītē.
apraksts String Jā Ieskata apraksts. Tas tiek rādīts kā aizzīmju punkti ieraksta kopsavilkumā un ir dabiskās valodas apraksts ieskatam valodā, kas ir norādīta galvenē Accept-Language . Šeit ir piemērs: Kenijs, Logans un divi citi parakstīja Contoso 2023 atjaunošanas līgumu 9.07.2023. Šī izvade norāda ieskata aprakstu.
datumsLaiks Virkne "datuma-laika" formātā Jā Darbības datums un laiks UTC formātā. Ja darbībai ir gan sākuma, gan beigu laiks, lietojumprogrammai ir jānosaka, kuru laiku rādīt. Formāts atbilst OpenAPI specifikācijai. Šeit ir piemērs: 2017-07-21T17:32:28Z. Šī izvade norāda laiku, kas saistīts ar ieskatu.
url String Nē. Derīgs vietrādis URL, lai atvērtu darbību partnera lietojumprogrammā. Šī izvade norāda vietrādi URL, lai atvērtu ieskatu.
papilduRekvizīti Objekts, kuram ir virknes tipa rekvizīta nosaukums un rekvizīta vērtība Nē.

Papildu rekvizīti, kas tiek rādīti detalizētajā skatā. Rekvizītu nosaukumi un vērtības ir dabiskā valodā valodā, kas ir norādīta galvenē Accept-Language . Tālāk sniegts piemērs.

{
 "statusa iemesls": "Parakstīts",
 "Īpašnieks": "Kenijs Smits"
}
 Šī izvade norāda papildu rekvizītus, kas tiek parādīti detalizētajā ieskata skatā.

Piezīmes

Lai gan API prasības e-pasta kopsavilkuma iespēju paplašināšanai un ierakstu kopsavilkuma iespējām var izskatīties līdzīgi, savienotājā tās ir jāpievieno kā atsevišķas darbības.

Piemērs

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

Nākamajā attēlā redzamajā piemērā ir parādīts, kā API izvade tiek kartēta uz ieraksta kopsavilkumu.

Ekrānuzņēmums, kurā parādīta jaunāko darbību anatomija no partnera lietojumprogrammas.

Apzīmējumi:

  1. Sadaļa, kurā redzami ieskati no partnera lietojumprogrammas. Sadaļas nosaukums ir atvasināts no savienotāja Microsoft Power Platform nosaukuma.
  2. API atbildes ieskatu apraksti.
  3. Citātu numuri, kurus var atlasīt, lai skatītu detalizētu informāciju par ieskatu.
  4. Citēšanas kartīte, kurā redzama detalizēta informācija par ieskatu.
  5. Ikona un ieskata nosaukums. Ikona tiek izgūta no savienotāja Microsoft Power Platform metadatiem. Virsraksta teksts ir API atbildes ieskata virsraksts.
  6. API atbildes ieskata papildu rekvizīti.
  7. Partnera pieteikuma nosaukums. Parādītais nosaukums ir savienotāja Microsoft Power Platform nosaukums.
  8. Saite, ko var atlasīt, lai skatītu detalizētu informāciju par ieskatu partnera lietojumprogrammā. Tas ir balstīts uz ieskata vietrādi URL API atbildē.

Skatīt ieraksta kopsavilkumu
E-pasta kopsavilkumu bagātināšana ar ieskatiem no lietojumprogrammas
E-pasta melnrakstu bagātināšana ar failu saitēm no jūsu lietojumprogrammas
Bagātiniet galveno pārdošanas informāciju ar ieskatiem no savas lietojumprogrammas
CRM ierakstu informācijas bagātināšana ar ieskatiem no savas lietojumprogrammas
Paplašiniet Microsoft 365 Copilot for Sales ar partneru lietojumprogrammām
Izveidojiet Copilot for Sales paplašinājumus