Arricchire i riepiloghi dei record CRM con informazioni dettagliate dell'applicazione (anteprima)
Importante
- Questa è una funzionalità di anteprima pronta per la produzione.
- Le anteprime pronte per la produzione sono soggette a condizioni per l'utilizzo supplementari.
[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]
Per comprendere meglio il contesto di una riunione per la quale si stanno preparando o di un'e-mail che stanno leggendo, i venditori desiderano informazioni pertinenti sulla gestione delle relazioni con i clienti (CRM), come domande, dubbi e note dei clienti. Copilot per le vendite utilizza l'intelligenza artificiale per generare un riepilogo di ogni record CRM. Questo riepilogo evidenzia dettagli cruciali, come la fase di vendita, il budget e la data di chiusura prevista. Puoi estendere la funzionalità di riepilogo record CRM fornita da Copilot per le vendite con informazioni dettagliate sull'applicazione.
Descrizione API
Devi aggiungere la seguente descrizione dell'API all'azione. In questo modo, Copilot per le vendite può identificare l'API corretta che deve essere richiamata per arricchire la funzionalità.
Questa azione consente di ottenere ulteriori informazioni dettagliate sulle vendite correlate a un record CRM che verranno visualizzate nella scheda di riepilogo dei record C4S. L'azione migliora le competenze esistenti del Copilot per le vendite.
Operazione API
Questa API utilizza il tipo di operazione: GET
Parametri di input
Copilot per le vendite è progettato per fornire i seguenti parametri di input alle tue API.
| Name | Formato/tipo di dati | Obbligatorio | Details | Descrizione da aggiungere nell'azione |
|---|---|---|---|---|
| recordType | String | Sì | Tipo di entità oppure oggetto in CRM per il quale sono richieste informazioni dettagliate correlate come gli impegni. Il valore include il nome univoco indipendente dalla lingua dell'entità o del tipo di oggetto, non il nome visualizzato che può essere localizzato. Gli esempi includono l'account e l'opportunità. | Questo input indica il tipo di entità o oggetto in CRM per il quale sono richieste informazioni dettagliate. |
| recordId | String | Sì | Identificatore univoco del record CRM. | Questo input indica l'identificatore univoco del record CRM per il quale sono richieste informazioni dettagliate. |
| startDateTime | Stringa in formato "date-time" | No | La data e l'ora di inizio per cercare informazioni dettagliate. Il formato segue le specifiche OpenAPI. Di seguito è riportato un esempio: 2017-07-21T17:32:28Z. | Questo input indica la data e l'ora di inizio per le informazioni dettagliate richieste. |
| endDateTime | Stringa in formato "date-time" | No | La data e l'ora di fine per cercare informazioni dettagliate. Il formato segue le specifiche OpenAPI. Di seguito è riportato un esempio: 2017-07-21T17:32:28Z. | Questo input indica la data e l'ora di fine per le informazioni dettagliate richieste. |
| migliori | Intero | No | Numero di informazioni dettagliate da recuperare. | Questo input indica il numero di informazioni dettagliate da recuperare. |
| skip | Intero | No | Il numero di informazioni dettagliate da ignorare. | Questo input indica il numero di informazioni dettagliate da ignorare. |
| crmType | String | No | I valori validi sono Dynamics 365 e Salesforce. | Questo input indica il tipo di CRM in cui esiste il record CRM, per il quale sono richieste informazioni dettagliate. |
| crmOrgUrl | String | No | Il nome host dell'organizzazione CRM, ad esempio contoso.crm.dynamics.com. | Questo input indica l'URL dell'ambiente CRM in cui esiste il record CRM, per il quale sono richieste informazioni dettagliate. |
Parametri di output
Copilot per le vendite prevede di ricevere un elenco di informazioni dettagliate (oggetti) dalle API e si aspetta che ogni informazione dettagliata contenga parametri specifici. Per garantire che Copilot per le vendite possa analizzare correttamente l'output, è necessario seguire le linee guida nella seguenet tabella.
| Parametro | Tipo di dati | Obbligatorio | Details |
|---|---|---|---|
| value | Matrice | Sì | Elenco di informazioni dettagliate (oggetti) definite come descritto nella sezione Schema per informazioni dettagliate. |
| hasMoreResults | Boolean | No | Un valore che indica se sono disponibili più risultati. |
Schema per informazioni dettagliate
| Name | Formato/tipo di dati | Obbligatorio | Details | Descrizione da aggiungere nell'azione |
|---|---|---|---|---|
| titolo. | String | Sì | Il titolo delle informazioni dettagliate nella scheda di citazione. È il titolo in linguaggio naturale delle informazioni dettagliate nella lingua specificata nell'intestazione della richiesta Accept-Language. Ecco un esempio: Contratto firmato. |
Questo output indica il titolo dell'impegno nella scheda di citazione. |
| description | String | Sì | La descrizione delle informazioni dettagliate. Viene visualizzata come elenco puntato nel riepilogo dei record ed è la descrizione in linguaggio naturale delle informazioni dettagliate nella lingua specificata tramite l'intestazione Accept-Language. Ecco un esempio: Kenny, Logan e altri due hanno firmato il contratto di rinnovo Contoso 2023 il 7/9/2023. |
Questo output indica la descrizione dell'informazione dettagliata. |
| dateTime | Stringa in formato "date-time" | Sì | La data e l'ora dell'attività in formato UTC. Se l'attività ha un'ora di inizio e un'ora di fine, l'applicazione deve determinare quale ora visualizzare. Il formato segue le specifiche OpenAPI. Di seguito è riportato un esempio: 2017-07-21T17:32:28Z. | Questo output indica il tempo associato all'informazione dettagliata. |
| URL. | String | No | Un URL valido per aprire l'attività dettagliata nell'applicazione partner. | Questo output indica l'URL per aprire l'informazione dettagliata. |
| additionalProperties | Un oggetto con i valori Nome proprietà e Valore proprietà di tipo Stringa | No | Proprietà aggiuntive mostrate nella visualizzazione dettagliata. I nomi e i valori delle proprietà sono in linguaggio naturale nella lingua specificata tramite l'intestazione { |
Questo output indica proprietà aggiuntive visualizzate nella vista dettagliata dell'informazione dettagliata. |
Nota
Sebbene i requisiti API per estendere le funzionalità di riepilogo messaggio e-mail e riepilogo record possano sembrare simili, devono essere aggiunti come azioni separate nel connettore.
Esempio
{
"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'esempio nell'immagine seguente mostra come l'output dell'API viene mappata al riepilogo record.
Legenda:
- Sezione che mostra le informazioni dettagliare dell'applicazione partner. Il titolo della sezione deriva dal nome del connettore Microsoft Power Platform.
- Descrizioni delle informazioni dettagliate della risposta API.
- Numeri di citazione che possono essere selezionati per visualizzare i dettagli sulle informazioni dettagliate.
- Scheda di citazione che mostra i dettagli sulle informazioni dettagliate.
- Icona e titolo dell'informazione dettagliata. L'icona viene recuperata dai metadati del connettore Microsoft Power Platform. Il testo del titolo è il titolo delle informazioni dettagliate della risposta API.
- Proprietà aggiuntive delle informazioni della risposta API.
- Nome dell'applicazione partner. Il nome visualizzato è il nome del connettore Microsoft Power Platform.
- Il collegamento può essere selezionato per visualizzare i dettagli delle informazioni dettagliate nell'applicazione partner. Si basa sull'URL delle informazioni dettagliate nella risposta API.
Informazioni correlate
Visualizza riepilogo record
Arricchire il riepilogo messaggio e-mail con informazioni dettagliate dell'applicazione
Arricchire le bozze di messaggi e-mail con collegamenti ai file dell'applicazione
Arricchisci le informazioni chiave sulle vendite con informazioni dettagliate della tua applicazione
Arricchire i dettagli dei record CRM con informazioni dettagliate della tua applicazione
Estendere Microsoft 365 Copilot per le vendite con applicazioni partner
Creare estensioni di Copilot per le vendite