Utilizza l'API CCaaS_CreateProactiveDelivery

Puoi utilizzare l'API CCaaS_CreateProactiveDelivery per avviare chiamate vocali in uscita proattive ai clienti tramite il servizio di Coinvolgimento Proattivo.

Importante

  • Se un'organizzazione utilizza l'API CCaaS_CreateProactiveDelivery per avviare una chiamata vocale in uscita, è responsabile della gestione del consenso, incluso l'aggiornamento manuale delle "liste di chiamate non chiamate" per impostare orari di silenzio per i contatti con i clienti. Assicurati che le seguenti condizioni siano soddisfatte:
    • Il consenso viene ottenuto prima di contattare i clienti.
    • 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.

Dettagli della richiesta

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

Intestazioni richieste

Key Tipo Descrizione
ApiVersion String La versione dell'API CCaaS.
ProactiveEngagementConfigId String ID della Configurazione di Engagement Proattivo da utilizzare. Specifica anche il tipo di modalità di manopolazione, il flusso di lavoro e il profilo in uscita da utilizzare. Per ottenere questo ID, esegui i seguenti passaggi:
  1. Vai su Power Apps e seleziona l'ambiente richiesto.
  2. Seleziona tabelle>Configurazione di coinvolgimento proattivo.
  3. Selezionare l'ID del record richiesto.
RequestId String Optional. Attribue to pass per tracciare la richiesta da un sistema sorgente.
Priorità String Optional. Definisce il valore di priorità della richiesta.
Contatti Array JSON degli oggetti Contact Specifica uno o più contatti (fino a 5) su questa richiesta. È richiesto almeno un numero di telefono per ogni contatto.
Windows Array JSON di oggetti Window Specifica i periodi di tempo validi in cui la chiamata in uscita può essere effettuata. 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).

Contatto oggetto

Key Tipo Descrizione
uniqueIdentifier String Identificatore univoco del contatto. Può essere un ContactId o un ID esterno.
firstName String Nome del contatto.
lastName String Cognome del contatto.
Numero di telefono mobile String Numero di telefono cellulare del contatto.
numero di telefono aziendale String Numero di telefono aziendale del contatto.
homePhoneNumber String Numero di telefono di casa del contatto.
posta elettronica String Optional. Indirizzo di posta elettronica del contatto.
postalcode String Optional. Codice postale del contatto.
state String Optional. Stato del contatto.
country String Optional. Paese/Regione del contatto.
addressline String Optional. Linea di indirizzo del contatto.
city String Optional. Città del contatto.
timezone String Optional. Fuso orario del contatto. Deve essere un valore dalla lista approvata da Dynamics 365.
inputAttributi Oggetto JSON delle stringhe chiave-valore Optional. 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.
finestre Array JSON di oggetti Window Optional. Windows temporali a livello di contatto che sovrascrivono le Windows di livello superiore per questo specifico contatto.

Annotazioni

Almeno uno di mobilePhoneNumber, businessPhoneNumber, o homePhoneNumber è necessario per contatto.

Oggetto Windows

Key Tipo Descrizione
Start String Timestamp iniziale per questa finestra. Deve essere specificato in UTC nel yyyy-MM-ddTHH:mm:ss.fffZ formato.
Fine periodo String Timestamp di fine per questa finestra. Deve essere specificato in UTC nel yyyy-MM-ddTHH:mm:ss.fffZ formato.

Esempio di richiesta

{
  "ApiVersion": "1.0",
  "ProactiveEngagementConfigId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "RequestId": "e1f2a3b4-c5d6-7890-abcd-ef1234567890",
  "Priority": "1",
  "Contacts": "[{\"uniqueIdentifier\":\"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\"firstName\":\"John\",\"lastName\":\"Doe\",\"mobilePhoneNumber\":\"+15550100\",\"businessPhoneNumber\":\"+15550101\",\"homePhoneNumber\":\"+15550102\",\"email\":\"text@a.com\",\"postalcode\":\"25642\",\"state\":\"WA\",\"country\":\"USA\",\"addressline\":\"1234 227th PL SE\",\"city\":\"Seattle\",\"timezone\":\"(GMT-03:00) Brasilia\",\"inputAttributes\":{\"AppointmentTime\":\"10:00 AM\",\"CustomerNumber\":\"1234567\"},\"windows\":[{\"start\":\"2025-12-10T09:00:00Z\",\"end\":\"2025-12-10T17:00:00Z\"}]}]"
}

Utilizzare l'API CCaaS_CreateProactiveVoiceDelivery
Usa CCaaS_CreateOperation API
Utilizzare le tabelle di coinvolgimento proattive per la reportistica

  • Last updated on