Nata
Norint pasiekti šį puslapį, reikalingas leidimas. Galite pabandyti prisijungti arba pakeisti katalogus.
Norint pasiekti šį puslapį, reikalingas leidimas. Galite pabandyti pakeisti katalogus.
Svarbu
- Tai gamybai paruoštos peržiūros versijos funkcija.
- Gamybai paruoštoms peržiūroms taikomos papildomos naudojimo sąlygos.
[Šis straipsnis yra negalutinio leidimo dokumentacija ir gali keistis.]
Norėdami geriau suprasti susitikimo, kuriam jie ruošiasi, arba skaitomo el. laiško kontekstą, pardavėjai nori atitinkamos ryšių su klientais valdymo (CRM) informacijos, pvz., klientų užklausų, nuogąstavimų ir pastabų. Programa "Sales" naudoja dirbtinį intelektą, kad sugeneruotų kiekvieno CRM įrašo suvestinę. Šioje suvestinėje paryškinama svarbi informacija, pvz., pardavimo etapas, biudžetas ir numatoma uždarymo data. Galite išplėsti CRM įrašų suvestinės galimybę, kurią programa "Sales" teikia įžvalgomis iš jūsų programos.
API aprašymas
Prie veiksmo turite pridėti toliau pateiktą API aprašą. Tokiu būdu "Sales" programa gali nustatyti tinkamą API, kurią reikia iškviesti, kad būtų galima praturtinti galimybes.
Šis veiksmas gauna papildomų pardavimo įžvalgų, susijusių su CRM įrašu, kuris bus rodomas C4S įrašo suvestinės kortelėje. Šis veiksmas sustiprina esamus pardavimų kopiloto įgūdžius.
API operacija
Ši API naudoja operacijos tipą: GET
Įvesties parametrai
Programa "Sales" sukurta taip, kad jūsų API pateiktų šiuos įvesties parametrus.
| Pavadinimą | Duomenų tipas / formatas | Privalomas | Informacija | Aprašymas, kurį reikia įtraukti į veiksmą |
|---|---|---|---|---|
| recordType | Eilutės | Taip | CRM objekto arba objekto, kurio prašoma susijusių įžvalgų, pvz., veiklų, tipas. Reikšmė apima unikalų objekto arba objekto tipo pavadinimą agnostinį pavadinimą, o ne rodomą pavadinimą, kurį galima lokalizuoti. Pavyzdžiai apima paskyrą ir galimybę. | Ši įvestis nurodo CRM objektą arba objekto tipą, kuriam prašoma įžvalgų. |
| recordId | Eilutės | Taip | CRM įrašo unikalus identifikatorius. | Ši įvestis nurodo CRM įrašo, dėl kurio prašoma įžvalgų, unikalų identifikatorių. |
| startDateTime | Eilutė "datos ir laiko" formatu | Ne | Pradžios data ir laikas įžvalgoms ieškoti. Formatas atitinka OpenAPI specifikaciją. Štai pavyzdys: 2017-07-21T17:32:28Z. | Ši įvestis nurodo prašomų įžvalgų pradžios datą ir laiką. |
| endDateTime | Eilutė "datos ir laiko" formatu | Ne | Pabaigos data ir laikas įžvalgoms ieškoti. Formatas atitinka OpenAPI specifikaciją. Štai pavyzdys: 2017-07-21T17:32:28Z. | Ši įvestis nurodo prašomų įžvalgų pabaigos datą ir laiką. |
| viršuje | Sveikasis skaičius | Ne | Įžvalgų, kurias reikia gauti, skaičius. | Ši įvestis nurodo, kiek įžvalgų reikia gauti. |
| praleisti | Sveikasis skaičius | Ne | Įžvalgų, kurias reikia praleisti, skaičius. | Ši įvestis nurodo, kiek įžvalgų reikia praleisti. |
| crmType | Eilutės | Ne | Leistinos reikšmės yra "Dynamics 365 " ir "Salesforce". | Ši įvestis nurodo CRM tipą, kuriame yra CRM įrašas, dėl kurio prašoma įžvalgų. |
| crmOrgUrl | Eilutės | Ne | CRM organizacijos pagrindinio kompiuterio vardas, pvz., contoso.crm.dynamics.com. | Ši įvestis nurodo CRM aplinkos, kurioje yra CRM įrašas, URL, kuriam prašoma įžvalgų. |
Išvesties parametrai
Programa "Sales" tikisi gauti įžvalgų (objektų) sąrašą iš jūsų API ir tikisi, kad kiekviena įžvalga turės konkrečius parametrus. Siekiant užtikrinti, kad "Sales" programa galėtų tinkamai išanalizuoti išvestį, atsakymo struktūra turi atitikti toliau pateiktoje lentelėje pateiktas gaires.
| Parametras | Duomenų tipas | Privalomas | Informacija |
|---|---|---|---|
| reikšmė | Masyvas | Taip | Įžvalgų (objektų), apibrėžtų taip, kaip aprašyta skyriuje Įžvalgų schema, sąrašas. |
| hasMoreResults | Bulio logikos | Ne | Reikšmė, nurodanti, ar yra daugiau rezultatų. |
Įžvalgų schema
| Pavadinimą | Duomenų tipas / formatas | Privalomas | Informacija | Aprašas, kuris turi būti pridėtas veikiant |
|---|---|---|---|---|
| pavadinimas | Eilutės | Taip | Citatos kortelės įžvalgos pavadinimas. Tai natūralios kalbos pavadinimas, suteikiantis įžvalgą ta kalba, kuri nurodyta Accept-Language užklausos antraštėje. Štai pavyzdys: Sutartis pasirašyta. |
Ši išvestis nurodo veiklos pavadinimą citatos kortelėje. |
| aprašas | Eilutės | Taip | Įžvalgos aprašymas. Jis rodomas kaip ženkleliai įrašo suvestinėje ir yra natūralios kalbos įžvalgos aprašymas ta kalba, kuri nurodyta antraštėje Accept-Language . Štai pavyzdys: Kenny, Loganas ir du kiti pasirašė "Contoso 2023" atnaujinimo sutartį 9/7/2023. |
Ši išvestis nurodo įžvalgos aprašymą. |
| dateTime | Eilutė "datos ir laiko" formatu | Taip | Veiklos data ir laikas UTC formatu. Jei veikla turi ir pradžios, ir pabaigos laiką, programa turi nustatyti, kurį laiką rodyti. Formatas atitinka OpenAPI specifikaciją. Štai pavyzdys: 2017-07-21T17:32:28Z. | Ši išvestis nurodo laiką, susietą su įžvalga. |
| URL | Eilutės | Ne | Tinkamas URL, skirtas veiklai partnerio programoje atidaryti. | Ši išvestis nurodo URL, kad atidarytumėte įžvalgą. |
| papildomosYpatybės | Objektas, turintis eilutės tipo ypatybės pavadinimo ir ypatybės reikšmės | Ne | Papildomos ypatybės, rodomos išsamiame rodinyje. Ypatybių pavadinimai ir reikšmės yra natūralia kalba ta kalba, kuri nurodyta antraštėje { |
Ši išvestis nurodo papildomas ypatybes, rodomas išsamiame įžvalgos rodinyje. |
Pastaba.
Nors API reikalavimai, skirti el. pašto suvestinės galimybėms ir įrašų suvestinės galimybėms išplėsti, gali atrodyti panašiai, juos reikia įtraukti kaip atskirus jungties veiksmus.
Pavyzdžiui
{
"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
}
Toliau pateiktame paveikslėlyje pateiktame pavyzdyje parodyta, kaip API išvestis susiejama su įrašo suvestine.
Legenda:
- Skyrius, kuriame pateikiamos įžvalgos iš partnerio programos. Skyriaus pavadinimas kilęs iš jungties pavadinimo Microsoft Power Platform .
- API atsakymo įžvalgos aprašai.
- Citatų numeriai, kuriuos galima pasirinkti norint peržiūrėti išsamią įžvalgos informaciją.
- Citatos kortelė, kurioje rodoma išsami įžvalgos informacija.
- Įžvalgos piktograma ir pavadinimas. Piktograma nuskaitoma iš Microsoft Power Platform jungties metaduomenų. Pavadinimo tekstas yra API atsakymo įžvalgos pavadinimas.
- Papildomos įžvalgos iš API atsakymo ypatybės.
- Partnerio paraiškos pavadinimas. Rodomas pavadinimas yra jungties Microsoft Power Platform pavadinimas.
- Saitas, kurį galima pasirinkti norint peržiūrėti išsamią įžvalgos informaciją partnerio programoje. Jis pagrįstas API atsakymo įžvalgos URL.
Susijusi informacija
Peržiūrėti įrašo suvestinę
Praturtinkite el. laiškų suvestines įžvalgomis iš savo programos
Praturtinkite el. laiškų juodraščius failų nuorodomis iš savo programos
Galimybių įžvalgų praturtinimas programos duomenimis
Praturtinkite CRM įrašo informaciją įžvalgomis iš savo programos
Išplėskite pardavimus "Microsoft 365 Copilot" naudodami partnerių programas
"Sales" plėtinių kūrimas "Microsoft 365 Copilot"