Verwenden CCaaS_CreateProactiveVoiceDelivery-API

Sie können die CCaaS_CreateProactiveVoiceDelivery API verwenden, um proaktive ausgehende Sprachanrufe an Kunden zu initiieren oder Kunden zu ermöglichen, Rückrufe über den Proactive Engagement Service zu planen.

Diese API unterstützt keine proaktiven Engagement-Funktionen wie Wiederholungen und Frequenzbegrenzungen. Nutze die CCaaS_CreateProactiveDelivery API für diese Funktionen.

Important

Wenn eine Organisation die CCaaS_CreateProactiveVoiceDelivery API verwendet, um einen ausgehenden Sprachanruf zu initiieren, ist die Organisation für die Einwilligungsverwaltung verantwortlich, einschließlich der manuellen Aktualisierung von "Nicht-Anruflisten" zum Festlegen von Ruhezeiten für den Kundenkontakt. Stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind:

  • Die Zustimmung wird eingeholt, bevor die Kunden kontaktiert werden.
  • Kunden werden nur zu den zulässigen Zeiten kontaktiert.

Voraussetzungen

  • Du musst die Rolle des Omnichannel-Agenten oder Omnichannel-Supervisors haben, um diese API aufrufen zu können.
  • Proaktives Engagement ist konfiguriert. Erfahren Sie mehr unter Configure proactive engagement.

Initiieren Sie proaktive ausgehende Anrufe

Proaktives Engagement ermöglicht es Unternehmen, Kundeninteraktionen zu verbessern, indem sie ausgehende Kommunikation über den Sprachkanal initiieren. Sie können die proaktive Interaktion mithilfe einer Customer Insights-Journey oder der CCaaS_CreateProactiveVoiceDelivery.

Die CCaaS_CreateProactiveVoiceDelivery API ermöglicht es Organisationen, proaktive ausgehende Sprachanrufe an Kunden über den Proactive Engagement Service zu initiieren. Die API löst ausgehende Sprachanrufe über das Voice Runtime-System aus. Anrufe werden gemäß dem konfigurierten Wählmodus entweder sofort (wenn keine Zeitfenster angegeben sind) oder während der von Ihnen angegebenen Zeitfenster getätigt.

Diese API ermöglicht es Contact Centern, Kunden zur richtigen Zeit mit relevanten Informationen, Erinnerungen oder Benachrichtigungen zu erreichen, was das Kundenerlebnis verbessert und gleichzeitig die betriebliche Effizienz optimiert.

Anforderungsdetails

  • URL:https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveVoiceDelivery
  • Methode: POST
  • Version: 1.0
  • OData-Vorgang: Aktion
  • OData-Typ: Unbegrenzt
  • Autorisierung anfordern: Erforderlich. Muss ein gültiges Azure AD Bearer-Token enthalten, damit der Benutzer den API-Aufruf tätigt. Dieses Token muss vom selben Azure AD-Tenant wie die Kundenservice-Instanz ausgegeben werden.

Anforderungsheader

Key Typ Description
ApiVersion String Die CCaaS-API-Version.
ProactiveEngagementConfigId String ID der zu verwendenden Proactive Engagement-Konfiguration. Dies gibt den Wählmodustyp, den Arbeitsstream und das zu verwendende ausgehende Profil an. Gehen Sie folgendermaßen vor, um diese ID abzurufen:
  1. Gehe zu Power Apps und wähle die erforderliche Umgebung aus.
  2. Konfiguration der proaktiven Interaktion>
  3. Wählen Sie die ID des gewünschten Datensatzes aus.
Zieltelefonnummer String Telefonnummer des Kunden, den Sie anrufen möchten.
Kontakt-ID String ID des Kundenkontakts in Dynamics CRM.
Windows JSON-Array von Window-Objekten Gibt die gültigen Zeiträume an, in denen der ausgehende Anruf getätigt werden kann. Wenn nicht angegeben, verwendet das System standardmäßig ein 24-Stunden-Fenster, das sofort beginnt (von der aktuellen Uhrzeit bis 24 Stunden später).
Eingabe-Attribute JSON-Objekt von Schlüssel-Wert-Zeichenfolgen Wahlfrei. Variablen, die innerhalb von Copilot-Agent-Flows referenziert werden können, um das Verhalten anzupassen, bedingte Logik zu steuern oder personalisierte Informationen aus Dataverse-Datensätzen abzurufen.

Windows-Objekt

Key Typ Description
Start String Der Anfangszeitstempel für dieses Fenster. Muss in UTC im yyyy-MM-ddTHH:mm:ss.fffZ Format angegeben werden.
Beenden String Der Endzeitstempel für dieses Fenster. Muss in UTC im yyyy-MM-ddTHH:mm:ss.fffZ Format angegeben werden.

Important

Einige Clients benötigen ein bestimmtes Format wie "Windows": "[{\"Start\":\"2025-01-30T16:32:45.930Z\",\"End\":\"2025-06-25T16:32:45.930Z\"}]". Wir empfehlen Ihnen, entsprechend zu testen.

Musteranforderung

{
  "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"
  }
}

Details zur Antwort

Bei erfolgreicher Ausführung gibt die Methode zurück DeliveryId. Die Übermittlungs-ID ist eine eindeutige Kennung, die jeder proaktiven Interaktionsanforderung zugewiesen wird, die über die API akzeptiert und in der msdyn_proactive_delivery Tabelle gespeichert wird.

Die Beispielantwort lautet wie folgt:

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

Verwenden von proaktiven Engagement-Tabellen für die Berichterstellung

  • Last updated on