Enriquir els resums de registres del CRM amb informació de l'aplicació (versió preliminar)
Important
- Aquesta és una funció en versió preliminar llesta per a la producció.
- Les previsualitzacions preparades per a la producció estan subjectes a condicions d'ús addicionals.
[Aquest article forma part de la documentació preliminar i està subjecte a canvis.]
Per entendre millor el context d'una reunió per a la qual es preparen o d'un correu electrònic que estan llegint, els venedors volen informació rellevant sobre la gestió de relacions amb els clients (CRM), com ara consultes, preocupacions i notes dels clients. Copilot for Sales utilitza IA per generar un resum de cada registre CRM. Aquest resum destaca detalls crucials, com ara l'etapa de vendes, el pressupost i la data de tancament prevista. Podeu ampliar la capacitat de resum de registres del CRM que proporciona el Copilot for Sales amb informació de la vostra pròpia aplicació.
Descripció de l'API
Heu d'afegir la següent descripció de l'API a l'acció. D'aquesta manera, Copilot for Sales pot identificar l'API correcta que s'ha d'invocar per enriquir la capacitat.
Aquesta acció obté informació addicional de vendes relacionada amb un registre del CRM que es mostrarà a la targeta de resum del registre C4S. L'acció potencia les habilitats existents de copilot per a les vendes.
Funcionament de l'API
Aquesta API utilitza el tipus d'operació: GET
Paràmetres d’entrada
Copilot for Sales està dissenyat per proporcionar els paràmetres d'entrada següents a les vostres API.
| Nom | Tipus/format de dades | Necessari | Detalles | Descripció per afegir a l'acció |
|---|---|---|---|---|
| recordType | String | Sí | Tipus d'entitat o objecte del CRM per al qual es sol·liciten informació relacionada, com ara activitats. El valor inclou el nom únic independent de l'idioma de l'entitat o del tipus d'objecte, no el nom de visualització que es pot localitzar. Alguns exemples inclouen el compte i l'oportunitat. | Aquesta entrada indica el tipus d'entitat o d'objecte del CRM per al qual es sol·licita la informació. |
| registreId | String | Sí | L'identificador únic del registre del CRM. | Aquesta entrada indica l'identificador únic del registre CRM per al qual se sol·licita la informació. |
| iniciDateTime | Cadena en format "data-hora" | No | La data i l'hora d'inici per cercar estadístiques. El format segueix l'especificació OpenAPI . Aquí hi ha un exemple: 2017-07-21T17:32:28Z. | Aquesta entrada indica la data i l'hora d'inici de les estadístiques sol·licitades. |
| endDateTime | Cadena en format "data-hora" | No | La data i l'hora d'acabament per cercar estadístiques. El format segueix l'especificació OpenAPI . Aquí hi ha un exemple: 2017-07-21T17:32:28Z. | Aquesta entrada indica la data i l'hora de finalització de les estadístiques sol·licitades. |
| principal | Integer | No | El nombre d'estadístiques que cal obtenir. | Aquesta entrada indica el nombre d'estadístiques que s'han de recuperar. |
| omet | Integer | No | El nombre d'estadístiques que s'han de saltar. | Aquesta entrada indica el nombre d'estadístiques que s'han d'ometre. |
| Tipus de crm | String | No | Els valors vàlids són Dynamics 365 i Salesforce. | Aquesta entrada indica el tipus de CRM en què existeix el registre del CRM, per al qual se sol·liciten estadístiques. |
| crmOrgUrl | String | No | El nom d'amfitrió de l'organització del CRM, com ara contoso.crm.dynamics.com. | Aquesta entrada indica l'adreça URL de l'entorn CRM en què existeix el registre CRM, per al qual se sol·licita informació. |
Paràmetres de sortida
Copilot for Sales espera rebre una llista d'informació (objectes) de les vostres API i espera que cada informació tingui paràmetres específics. Per garantir que Copilot for Sales pugui analitzar correctament la sortida, l'estructura de resposta ha de complir les directrius de la taula següent.
| Paràmetre | Tipus de dades | Necessari | Detalles |
|---|---|---|---|
| valor | Matriu | Sí | Llista d'estadístiques (objectes) que es defineixen tal com es descriu a la secció Esquema per a les estadístiques . |
| hasMoreResults | Boolean | No | Valor que indica si hi ha més resultats disponibles. |
Esquema per a estadístiques
| Nom | Tipus de dades/Format | Necessari | Detalles | Descripció que s'ha d'afegir en acció |
|---|---|---|---|---|
| títol | String | Sí | El títol de la informació a la targeta de citació. És el títol en llenguatge natural de la informació en el llenguatge que s'especifica a través de la capçalera de la Accept-Language sol·licitud. Aquí teniu un exemple: Contracte signat. |
Aquesta sortida indica el títol de l'activitat a la targeta de citació. |
| descripció | String | Sí | La descripció de la informació. Es mostra com a vinyetes al resum del registre i és la descripció en llenguatge natural de la informació en l'idioma que s'especifica a través de la capçalera Accept-Language . Aquí teniu un exemple: Kenny, Logan i dos altres van signar el contracte de renovació de Contoso 2023 el 9/7/2023. |
Aquesta sortida indica la descripció de la informació. |
| dateTime | Cadena en format "data-hora" | Sí | La data i l'hora de l'activitat en format UTC. Si l'activitat té una hora d'inici i una hora de finalització, l'aplicació ha de determinar quina hora mostrar. El format segueix l'especificació OpenAPI . Aquí hi ha un exemple: 2017-07-21T17:32:28Z. | Aquesta sortida indica el temps associat amb la informació. |
| url | String | No | Una adreça URL vàlida per obrir l'activitat a l'aplicació de socis. | Aquesta sortida indica l'adreça URL per obrir la informació. |
| Propietats addicionals | Un objecte que té valors Nom de propietat i Valor de propietat del tipus Cadena | No | Propietats addicionals que es mostren a la visualització detallada. Els noms i valors de les propietats estan en llenguatge natural en el llenguatge que s'especifica a través de la capçalera { |
Aquesta sortida indica propietats addicionals que es mostren a la visualització detallada de la informació. |
Nota
Tot i que els requisits de l'API per ampliar les capacitats de resum de correu electrònic i les capacitats de resum de registres poden semblar similars, s'han d'afegir com a accions separades al connector.
Exemple
{
"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
}
L'exemple de la imatge següent mostra com s'assigna la sortida de l'API al resum del registre.
Llegenda:
- Secció que mostra les estadístiques de l'aplicació de soci. El títol de la secció es deriva del nom del Microsoft Power Platform connector.
- Descripcions de la informació de la resposta de l'API.
- Números de citació que es poden seleccionar per veure detalls sobre la informació.
- Targeta de citació que mostra detalls sobre la informació.
- Icona i títol de la informació. La icona es recupera de les metadades del Microsoft Power Platform connector. El text del títol és el títol de la informació de la resposta de l'API.
- Propietats addicionals de la informació de la resposta de l'API.
- Nom de la sol·licitud de soci. El nom que es mostra és el nom del Microsoft Power Platform connector.
- Enllaç que es pot seleccionar per visualitzar els detalls de la informació a l'aplicació de soci. Es basa en l'URL de la informació de la resposta de l'API.
Informació relacionada
Visualitza el resum del registre
Enriqueix els resums de correu electrònic amb informació de la teva aplicació
Enriqueix els esborranys de correu electrònic amb enllaços de fitxers de la teva aplicació
Enriqueix la informació clau de vendes amb informació de la teva aplicació
Enriqueix els detalls dels registres del CRM amb la informació de l'aplicació
Ampliar Microsoft 365 Copilot for Sales amb aplicacions de partners
Crear extensions de Copilot per al Sales