Verwenden Sie die CCaaS_CreateProactiveDelivery-API

Sie können die CCaaS_CreateProactiveDelivery API nutzen, um proaktive ausgehende Sprachanrufe mit Kunden über den Proactive Engagement-Service zu initiieren.

Important

  • Wenn eine Organisation die CCaaS_CreateProactiveDelivery API nutzt, um einen ausgehenden Sprachanruf zu initiieren, ist die Organisation für das Einwilligungsmanagement verantwortlich, einschließlich der manuellen Aktualisierung von "Nicht anrufen"-Listen zur Festlegung von Ruhezeiten für Kundenkontakt. Stellen Sie sicher, dass die folgenden Bedingungen erfüllt sind:
    • Die Zustimmung wird eingeholt, bevor 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.

Anfragedetails

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

Anforderungsheader

Key Typ Description
ApiVersion String Die CCaaS-API-Version.
ProactiveEngagementConfigId String ID der Proactive Engagement Configuration zu verwenden. Er legt außerdem den Wählmodustyp, den Arbeitsstrom und das ausgehende Profil fest. Um diese ID zu erhalten, führen Sie folgende Schritte aus:
  1. Gehe zu Power Apps und wähle die erforderliche Umgebung aus.
  2. Auswählen Tabellen>Konfiguration für proaktives Engagement.
  3. Wählen Sie die ID des gewünschten Datensatzes aus.
RequestId String Wahlfrei. Attribut zu übergeben, um die Anfrage von einem Quellsystem zu verfolgen.
Priorität String Wahlfrei. Definiert den Prioritätswert der Anfrage.
Kontakte JSON-Array von Kontaktobjekten Spezifiziert einen oder mehrere Kontakte (bis zu 5) auf dieser Anfrage. Mindestens eine Telefonnummer pro Kontakt ist erforderlich.
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).

Kontaktobjekt

Key Typ Description
uniqueIdentifier (eindeutiger Bezeichner) String Eindeutiger Bezeichner des Kontakts. Es kann eine ContactId oder eine externe ID sein.
firstName String Vorname des Kontakts.
lastName String Nachname des Kontakts.
mobilePhoneNumber String Mobiltelefonnummer des Kontakts.
Geschäftstelefonnummer String Geschäftstelefonnummer des Kontakts.
homePhoneNumber String Festnetznummer des Kontakts.
E-Mail String Wahlfrei. E-Mail-Adresse des Kontakts.
postalcode String Wahlfrei. Postleitzahl des Kontakts.
state String Wahlfrei. Zustand des Kontakts.
country String Wahlfrei. Land/Region des Kontakts.
addressline String Wahlfrei. Adressnummer des Kontakts.
Stadt String Wahlfrei. Stadt des Kontakts.
timezone String Wahlfrei. Zeitzone des Kontakts. Muss ein Wert aus der von Dynamics 365 genehmigten Liste sein.
inputAttribute 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.
Fenster JSON-Array von Window-Objekten Wahlfrei. Die Kontaktzeitebene windows die die oberste Windows für diesen speziellen Kontakt überschreibt.

Note

Mindestens eine von mobilePhoneNumber, businessPhoneNumber, oder homePhoneNumber ist pro Kontakt erforderlich.

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.

Musteranforderung

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

Verwenden CCaaS_CreateProactiveVoiceDelivery-API
Verwende CCaaS_CreateOperation API
Verwenden von proaktiven Engagement-Tabellen für die Berichterstellung

  • Last updated on