Condividi tramite

Arricchire i dettagli dei record CRM con informazioni dettagliate della tua applicazione (anteprima)

  • Articolo

Importante

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

I venditori possono visualizzare i dettagli di un contatto salvato, insieme ai relativi record associati come account e opportunità. Puoi estendere la funzionalità dei dettagli dei record di gestione delle relazioni con i clienti (CRM) fornita da Copilot per le vendite con informazioni dettagliate dalla 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 recupera i record correlati a un record del CRM. L'azione migliora le competenze esistenti di Copilot per le vendite.

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 richiesti i record. 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 identifica il tipo di record in CRM per il quale sono richiesti record correlati.
recordId String Sì Identificatore univoco del record CRM. Questo input fornisce l'identificatore univoco del record CRM per il quale sono richiesti record correlati.
migliori Intero No Il numero di attività da restituire. Questo input indica il numero di record correlati da recuperare.
skip Intero No Il numero di attività da ignorare. Questo input indica il numero di record da ignorare quando si recuperano record correlati.
crmType String No Il tipo di sistema CRM. I valori validi sono Dynamics 365 e Salesforce. Questo input indica il tipo di CRM da cui vengono recuperati i record correlati.
crmOrgUrl String No Il nome host dell'organizzazione CRM, ad esempio contoso.crm.dynamics.com. Questo input indica l'URL dell'ambiente CRM da cui vengono recuperati i record correlati.

Nota

Questo punto di estensione supporta il rendering di informazioni dettagliate da fino a cinque estensioni del connettore nel sidecar di Outlook.

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
recordId String Sì Identificatore univoco del record. Questo output identifica in modo univoco ciascun record correlato restituito dall'azione.
recordTypeDisplayName String Sì Nome visualizzato del tipo di record, ad esempio Contratto. Deve essere localizzato nella lingua specificata nell'intestazione Accept-Language. Questo output indica il nome visualizzato del tipo di record di ogni record correlato restituito dall'azione.
recordTypePluralDisplayName String Sì Nome visualizzato plurale del tipo di record, ad esempio Contratti. Deve essere localizzato nella lingua specificata nell'intestazione Accept-Language. Questo output indica il nome visualizzato plurale del tipo di record di ogni record correlato restituito dall'azione.
recordType String Sì Nome di sistema del tipo di record, ad esempio contratto. Questo output indica il tipo di ogni record correlato restituito dall'azione.
recordTitle String Sì Nome del record, ad esempio Contratto di rinnovo Contoso 2023. Questo output indica il titolo di ogni record correlato restituito dall'azione.
URL. String No Un URL valido per aprire il record nell'applicazione partner. Questo output indica l'URL di ogni record correlato restituito dall'azione.
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 Accept-Language . Di seguito è riportato un esempio.

{
 "Motivo stato": "Approvato",
 "Proprietario": "Kenny Smith"
}
 Questo output indica proprietà aggiuntive come coppie nome-valore di ogni record correlato restituito dall'azione.

Esempio

{
    "value": [
        {
            "recordId": "ID1",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "50 Cafe A-100 Automatic Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id1",
            "additionalProperties": {
                "Status": "Signed",
                "Date": "9/7/23",
                "Signed by": "Alberto Burgos, Tony [last name]"
            }
        },
        {
            "recordId": "ID2",
            "recordTypeDisplayName": "Contract",
            "recordTitle": "ABC Company 2023 Renewal Contract",
            "recordTypePluralDisplayName": "Documents",
            "recordType": "contract",
            "url": "https://contosohub.com/contract/id2",
            "additionalProperties": {
                "Status": "Delivered",
                "Date": "9/3/23",
                 "Signed by": "Alberto Burgos"
            }
        }
    ],
    "hasMoreResults": false
}

L'esempio nell'immagine seguente mostra come l'output dell'API viene mappato ai record relativi.

Screenshot che mostra l'anatomia dei record relativi da un'applicazione partner.

Legenda:

  1. Scheda che mostra i record correlati dall'applicazione partner.
  2. Titolo e icona della scheda. L'icona viene recuperata dai metadati del connettore Microsoft Power Platform. Il titolo è il nome del connettore Microsoft Power Platform.
  3. Titoli di record correlati dalla risposta API. Il rendering di due proprietà aggiuntive della risposta API viene eseguito come campi chiave di ogni record correlato.
  4. Pulsante "Altre azioni" che può essere utilizzato per copiare un collegamento al record o per visualizzare i dettagli del record nell'applicazione partner. Il collegamento si basa sull'URL del record correlato nella risposta API.
  5. Proprietà aggiuntive del record relativo dalla risposta API.

Visualizzare i dettagli del 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 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