CRM-rekordösszegzések gazdagítása az alkalmazásból származó elemzésekkel (előzetes verzió)
Fontos
- Ez egy termelésre kész előzetes funkció.
- A gyártásra kész előzetesekre kiegészítő használati feltételek vonatkoznak.
[Ez a cikk egy előzetes kiadási dokumentáció, amely a későbbiekben változhat.]
Annak érdekében, hogy jobban megértsék egy értekezlet kontextusát, amelyre készülnek, vagy egy e-mailt, amelyet olvasnak, az eladók releváns ügyfélkapcsolat-kezelési (CRM) információkat szeretnének, például ügyféllekérdezéseket, aggályokat és megjegyzéseket. A Copilot for Sales mesterséges intelligencia segítségével összesíti az egyes CRM-bejegyzéseket. Ez az összegzés kiemeli a fontos részleteket, például az értékesítési szakaszt, a költségvetést és a tervezett zárási dátumot. A Copilot for Sales által biztosított CRM-rekordösszegzési képességet kiterjesztheti a saját alkalmazásából származó információkkal.
API leírás
A művelethez hozzá kell adnia a következő API-leírást. Ily módon a Copilot for Sales azonosítani tudja a megfelelő API-t, amelyet meg kell hívni a képesség gazdagításához.
Ez a művelet további értékesítési információkat kap egy CRM-bejegyzéssel kapcsolatban, amely megjelenik a C4S-rekord összegző kártyáján. Az akció fejleszti a copilot meglévő képességeit az értékesítés területén.
API-művelet
Ez az API a következő művelettípust használja: GET
Bemeneti paraméterek
A Copilot for Sales úgy lett kialakítva, hogy a következő bemeneti paramétereket biztosítsa az API-k számára.
| Name | Adattípus/formátum | Szükséges | Details | A művelethez hozzáadandó leírás |
|---|---|---|---|---|
| recordType | Sztring | Igen | Annak az entitásnak vagy objektumnak a típusa a CRM-ben, amelyhez kapcsolódó betekintéseket, például tevékenységeket kérnek. Az érték az entitás vagy objektumtípus nyelvfüggetlen egyedi nevét tartalmazza, nem a honosítható megjelenítendő nevet. Ilyen például a fiók és a lehetőség. | Ez a bemenet jelzi azt az entitás- vagy objektumtípust a CRM-ben, amelyhez betekintést kér. |
| recordId | Sztring | Igen | A CRM-bejegyzés egyedi azonosítója. | Ez a bemenet jelzi annak a CRM-bejegyzésnek az egyedi azonosítóját, amelyhez betekintést kér. |
| startDateTime | Karakterlánc "dátum-idő" formátumban | No | Az elemzések keresésének kezdő dátuma és időpontja. A formátum a OpenAPI specifikációt követi. Íme egy példa: 2017-07-21T17:32:28Z. | Ez a bevitel a kért betekintések kezdő dátumát és idejét jelzi. |
| endDateTime | Karakterlánc "dátum-idő" formátumban | No | Az elemzési adatok keresésének záró dátuma és időpontja. A formátum a OpenAPI specifikációt követi. Íme egy példa: 2017-07-21T17:32:28Z. | Ez a bevitel a kért betekintések záró dátumát és idejét jelzi. |
| felső | Egész szám | No | A lekérendő elemzések száma. | Ez a bevitel a beolvasáshoz szükséges betekintések számát jelzi. |
| Kihagyás | Egész szám | No | A kihagyandó elemzések száma. | Ez a bevitel a kihagyandó betekintések számát jelzi. |
| crmType | Sztring | No | Az érvényes értékek: Dynamics 365 és Salesforce. | Ez a bemenet jelzi a CRM típusát, amelyben a CRM-bejegyzés létezik, amelyhez betekintést kér. |
| crmOrgUrl | Sztring | No | A CRM-szervezet állomásneve, például contoso.crm.dynamics.com. | Ez a bemenet annak a CRM-környezetnek az URL-címét jelzi, amelyben a CRM-bejegyzés létezik, és amelyhez betekintést kér. |
Kimeneti paraméterek
A Copilot for Sales arra számít, hogy megkapja az API-k elemzéseinek (objektumainak) listáját, és elvárja, hogy minden betekintés meghatározott paraméterekkel rendelkezzen. Annak érdekében, hogy a Copilot for Sales megfelelően tudja elemezni a kimenetet, a válaszstruktúrának meg kell felelnie az alábbi táblázatban található irányelveknek.
| Paraméter | Adattípus | Szükséges | Details |
|---|---|---|---|
| érték | Tömb | Igen | Az elemzések sémája szakaszban leírtak szerint definiált elemzések (objektumok) listája. |
| hasMoreResults | Boolean | No | Egy érték, amely azt jelzi, hogy rendelkezésre állnak-e további eredmények. |
Elemzések sémája
| Name | Adattípus/formátum | Szükséges | Details | A művelet során hozzáadandó leírás |
|---|---|---|---|---|
| beosztás | Sztring | Igen | A betekintés címe az idézetkártyán. Ez az elemzés természetes nyelvű címe a kérelem fejlécében Accept-Language megadott nyelven. Íme egy példa: Szerződés aláírva. |
Ez a kimenet a tevékenység címét jelzi a hivatkozási kártyában. |
| description | Sztring | Igen | A betekintés leírása. Felsorolásjelként jelenik meg a rekordösszegzésben, és az elemzés természetes nyelvű leírása a fejlécben Accept-Language megadott nyelven. Íme egy példa: Kenny, Logan és két másik személy 2023. 09. 07-én aláírta a Contoso 2023 megújítási szerződést. |
Ez a kimenet a betekintések leírását jelzi. |
| dateTime | Karakterlánc "dátum-idő" formátumban | Igen | A tevékenység dátuma és időpontja UTC formátumban. Ha a tevékenységnek kezdési és befejezési időpontja is van, az alkalmazásnak meg kell határoznia, hogy melyik időpontot jelenítse meg. A formátum a OpenAPI specifikációt követi. Íme egy példa: 2017-07-21T17:32:28Z. | Ez a kimenet a betekintésekhez társított időt jelzi. |
| url-cím | Sztring | No | Egy érvényes URL-cím a tevékenység megnyitásához a partneralkalmazásban. | Ez a kimenet a betekintések megnyitásához használható URL-címet jelzi. |
| additionalProperties | Olyan objektum, amelynek Karakterlánc típusú tulajdonságnév és tulajdonságérték értékei | No | A részletes nézetben megjelenő további tulajdonságok. A tulajdonságnevek és -értékek természetes nyelven jelennek meg a fejlécben { |
Ez a kimenet a betekintések részletes nézetében megjelenő további tulajdonságokat jelzi. |
Feljegyzés
Bár az e-mail-összefoglaló képességek és a rekordösszegzési képességek kiterjesztésének API-követelményei hasonlóak lehetnek, ezeket külön műveletként kell hozzáadni az összekötőhöz.
Példa
{
"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
}
Az alábbi képen látható példa bemutatja, hogyan van leképezve az API kimenete a rekordösszegzésre.
Jelmagyarázat:
- A partneralkalmazásból származó elemzéseket bemutató szakasz. A szakasz címe az Microsoft Power Platform összekötő nevéből származik.
- Az API-válaszból származó betekintés leírása.
- Idézetszámok, amelyek kiválaszthatók az elemzés részleteinek megtekintéséhez.
- Idézetkártya, amely a betekintés részleteit jeleníti meg.
- A betekintés ikonja és címe. Az ikont a rendszer az Microsoft Power Platform összekötő metaadataiból olvassa be. A cím szövege az API-válaszból származó betekintés címe.
- Az API-válaszból származó betekintés további tulajdonságai.
- A partneralkalmazás neve. A megjelenő név az Microsoft Power Platform összekötő neve.
- A partneralkalmazás elemzési részleteinek megtekintéséhez kiválasztható hivatkozás. Ez az API-válaszban található betekintés URL-címén alapul.
Kapcsolódó információk
Rekordösszegzés megtekintése
Az e-mail-összefoglalók gazdagítása az alkalmazásból származó elemzésekkel
E-mail piszkozatok gazdagítása az alkalmazásból származó fájlhivatkozásokkal
A legfontosabb értékesítési információk gazdagítása az alkalmazásból származó elemzésekkel
A CRM-rekordok részleteinek gazdagítása az alkalmazásból származó elemzésekkel
A Copilot for Sales kiterjesztése Microsoft 365 partneralkalmazásokkal
A Copilot for Sales bővítmények létrehozása