Usare l'API CCaaS_CreateProactiveVoiceDelivery

È possibile utilizzare l'API CCaaS_CreateProactiveVoiceDelivery per avviare chiamate vocali in uscita proattive ai clienti o consentire ai clienti di pianificare le richiamate tramite il servizio Proactive Engagement.

Questa API non supporta funzionalità di coinvolgimento proattivo come i ritentativi e il limite di frequenza. Usa l'API CCaaS_CreateProactiveDelivery per queste funzionalità.

Importante

Se un'organizzazione utilizza l'API CCaaS_CreateProactiveVoiceDelivery per avviare una chiamata vocale in uscita, l'organizzazione è responsabile della gestione del consenso, incluso l'aggiornamento manuale degli elenchi "Do not call" per l'impostazione delle ore di silenzio per il contatto con i clienti. Assicurarsi che siano soddisfatte le seguenti condizioni:

  • Il consenso viene ottenuto prima che i clienti vengano contattati.
  • I clienti vengono contattati solo negli orari consentiti.

Prerequisiti

  • Devi avere il ruolo di agente Omnicanale o supervisore Omnicanale per chiamare questa API.
  • Il coinvolgimento proattivo è configurato. Scopri di più in Configura l'impegno proattivo.

Avviare chiamate in uscita proattive

Il coinvolgimento proattivo consente alle organizzazioni di migliorare le interazioni con i clienti avviando le comunicazioni in uscita attraverso il canale vocale. È possibile configurare l'interazione proattiva utilizzando un percorso di Customer Insights o .CCaaS_CreateProactiveVoiceDelivery

L'API CCaaS_CreateProactiveVoiceDelivery consente alle organizzazioni di avviare chiamate vocali in uscita proattive ai clienti tramite il servizio Proactive Engagement. L'API attiva le chiamate vocali in uscita tramite il sistema Voice Runtime. Le chiamate vengono effettuate in base alla modalità di composizione configurata immediatamente (se non è specificato alcun intervallo orario) o durante gli intervalli di tempo designati forniti.

Questa API consente ai contact center di raggiungere i clienti al momento giusto con informazioni, promemoria o notifiche pertinenti, migliorando l'esperienza del cliente e ottimizzando l'efficienza operativa.

Dettagli richiesta

  • URL:https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery
  • Metodo: POST
  • Versione: 1.0
  • Operazione OData: Azione
  • Tipo OData: Non limitato
  • Richiesta di autorizzazione: obbligatoria. Deve contenere un token Azure AD Bearer valido per l'utente che effettua la chiamata API. Questo token deve essere emesso dallo stesso tenant Azure AD dell'istanza del Servizio Clienti.

Header di richiesta

Chiave TIPO Descrizione
Versione API Stringa La versione dell'API CCaaS.
ProactiveEngagementConfigId Stringa ID della configurazione di Proactive Engagement da utilizzare. Specifica il tipo di modalità di composizione, il flusso di lavoro e il profilo in uscita da utilizzare. Per ottenere questo ID, procedi come segue:
  1. Vai su Power Apps e seleziona l'ambiente richiesto.
  2. Seleziona tabelle>Configurazione coinvolgimento proattivo
  3. Selezionare l'ID del record richiesto.
Numero di telefono di destinazione Stringa Numero di telefono del cliente da chiamare.
ContactId Stringa ID del contatto cliente in Dynamics CRM.
Windows Array JSON di oggetti Window Specifica i periodi di tempo validi in cui può essere effettuata la chiamata in uscita. Se non viene fornito, per impostazione predefinita il sistema utilizza una finestra di 24 ore a partire da immediatamente (dall'ora corrente fino a 24 ore dopo).
InputAttributes Oggetto JSON delle stringhe chiave-valore Opzionale. Variabili che possono essere riferite all'interno dei flussi agente Copilot per personalizzare il comportamento, guidare la logica condizionale o recuperare informazioni personalizzate dai record Dataverse.

Oggetto Windows

Chiave TIPO Descrizione
Inizio Stringa Timestamp iniziale per questa finestra. Deve essere specificato in UTC nel yyyy-MM-ddTHH:mm:ss.fffZ formato.
Fine Stringa Timestamp di fine per questa finestra. Deve essere specificato in UTC nel yyyy-MM-ddTHH:mm:ss.fffZ formato.

Importante

Alcuni client richiedono un formato specifico come "Windows": "[{\"Start\":\"2025-01-30T16:32:45.930Z\",\"End\":\"2025-06-25T16:32:45.930Z\"}]". Si consiglia di eseguire il test di conseguenza.

Esempio di richiesta

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "cbbac510-3e66-ef11-a671-6045bd03d9d8",
  "DestinationPhoneNumber": "+123456798",
  "ContactId": "761e062f-c734-ef11-8e4f-00224808a166",
  "Windows": [
    {
      "Start": "2024-09-10T13:00:00.000Z",
      "End": "2024-09-10T15:59:59.999Z"
    },
    {
      "Start": "2024-09-11T13:00:00.000Z",
      "End": "2024-09-11T15:59:59.999Z"
    }
  ],
  "InputAttributes": {
    "orderNumber": "ORD123456789",
    "type": "callback",
    "isFinalAttempt": "false"
  }
}

Dettagli della risposta

In caso di esito positivo, questo metodo restituisce DeliveryId. L'ID recapito è un identificatore univoco assegnato a ogni richiesta di coinvolgimento proattivo che viene accettata tramite l'API e memorizzata nella tabella msdyn_proactive_delivery.

La risposta di esempio è la seguente:

{
  "@odata.context": "[Organization URI]api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.CCaaS_CreateProactiveVoiceDeliveryResponse",
  "DeliveryId": "9838deee-0b4e-4116-bf73-ecb80474568d"
}

Utilizzare le tabelle di coinvolgimento proattive per la reportistica

  • Last updated on