Arricchisci le informazioni chiave sulle vendite con informazioni dettagliate della tua 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.]
I venditori possono leggere e comporre e-mail in Outlook, possono usare Copilot per le vendite per visualizzare le principali informazioni di vendita su contatti, account e opportunità correlati al messaggio di posta elettronica. Le informazioni chiave sulle vendite si basano su una delle seguenti fonti:
- L'opportunità connessa all'e-mail
- L'opportunità più rilevante, in base ai contatti e agli account presenti nell'e-mail
Puoi estendere la funzionalità di riepilogo e-mail fornita da Copilot per le vendite con informazioni dettagliate della tua 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 ottiene ulteriori informazioni dettagliate sulle vendite visualizzate nella scheda informazioni vendite chiave C4S nel sidecar di Outlook. 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ì | Il tipo di record nel CRM (Customer Relationship Management). Il ercord può essere account, opportunità, lead o contatto correlato all'e-mail. | Questo input identifica il tipo di record in CRM per il quale sono richieste le informazioni chiave sulle vendite. |
| recordId | String | Sì | ID del record in CRM. | Questo input fornisce l'identificatore univoco del record CRM per il quale sono richieste le informazioni chiave sulle vendite. |
| crmType | String | No | Il tipo di sistema CRM. I valori validi sono Salesforce e Dynamics 365. | Questo input indica il tipo di CRM in cui esiste il record CRM, per il quale sono richieste le informazioni chiave sulle vendite. |
| crmOrgUrl | String | No | URL dell'organizzazione CRM. | Questo input indica l'URL dell'ambiente CRM in cui esiste il record CRM, per il quale sono richieste le informazioni chiave sulle vendite. |
| migliori | Intero | No | Numero di informazioni dettagliate da recuperare. | Questo input indica il numero di informazioni dettagliate sulle vendite da recuperare. |
| skip | Intero | No | Il numero di informazioni dettagliate da ignorare. | Questo input indica il numero di articoli da ignorare quando si recuperano informazioni dettagliate sulle vendite. |
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ì | Titolo della scheda di citazione delle informazioni dettagliate. Devi includere solo il nome del partner e può contenere fino a 20 caratteri. | Questo output indica il titolo della scheda di citazione dell'informazione dettagliata. |
| description | String | Sì | La descrizione delle informazioni dettagliate di vendita. Viene visualizzato come elenco puntato nel riquadro Informazioni chiave sulle vendite e può contenere fino a 130 caratteri. Di seguito è riportato un esempio: Convalida: Passaggi successivi: Allinearsi alla sequenza temporale e ai criteri di successo. | Questo output indica il testo dell'informazione dettagliata da includere nelle informazioni chiave sulle vendite. |
| URL. | String | No | Un URL valido per aprire l'informazione dettagliata nell'applicazione partner. | Questo output indica l'URL per ulteriori informazioni sull'informazione dettagliata. |
| dateTime | Data/Ora | No | 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. |
| additionalProperties | Un oggetto con i valori Nome proprietà e Valore proprietà di tipo Stringa | No | Un set di coppie nome-valore che indica le proprietà aggiuntive delle informazioni dettagliate relative ai resi delle azioni. Queste informazioni vengono visualizzate in una scheda popup quando gli utenti selezionano informazioni dettagliate nel riquadro Informazioni chiave sulle vendite. | Questo output indica proprietà aggiuntive come coppie nome-valore di ogni informazione dettagliata restituita dall'azione. |
Esempio
{
"value": [
{
"title": "Contract signed",
"description": "Kenny Smith sent Renewal Contract on 04/23/2023 related to 50 Cafe A-100 Automatic",
"dateTime": "2023-09-07T03:42:35.4662309Z",
"url": https://contosohub.com,
"additionalProperties": {
"Contract name": "Renewal contract for Fourth Coffee",
"Signed by": "Alberto Burgos, Tony Benis",
"Signed": "9/7/23",
"Related Opportunity": "50 CafeA-100 Automatic"
}
}
],
"hasMoreResults": false
}
L'esempio nell'immagine seguente mostra come l'output dell'API viene mappato alle informazioni di vendita chiave.
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 le informazioni chiave sulle vendite in Copilot per le vendite
Arricchire il riepilogo messaggio e-mail con informazioni dettagliate dell'applicazione
Arricchire le bozze di messaggi e-mail con collegamenti ai file dell'applicazione
Arricchire i dettagli dei record CRM con informazioni dettagliate della tua applicazione
Arricchire i riepiloghi 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