Brug CCaaS_CreateProactiveDelivery API

Du kan bruge API'et CCaaS_CreateProactiveDelivery til at initiere proaktive udgående taleopkald til kunder via Proactive Engagement-tjenesten.

Vigtigt!

  • Hvis en organisation bruger API'et CCaaS_CreateProactiveDelivery til at starte et udgående taleopkald, er organisationen ansvarlig for samtykkehåndtering, herunder manuel opdatering af "don't call-lister" til at fastsætte stille timer for kundekontakt. Sørg for, at følgende betingelser er opfyldt:
    • Samtykke indhentes, før kunderne kontaktes.
    • Kunder kontaktes kun på tilladte tidspunkter.

Forudsætninger

  • Du skal have rollen som Omnichannel-agent eller Omnichannel-supervisor for at kunne kalde dette API.
  • Proaktivt engagement er konfigureret. Lær mere i Konfigurér proaktivt engagement.

Detaljer om anmodning

  • URL-adresse: https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveDelivery
  • Metode: POST
  • Version: 1.0
  • OData-operation: Handling
  • OData-type: Ubegrænset
  • Anmod om autorisation: Påkrævet. Skal indeholde et gyldigt Microsoft Entra ID Bearer-token for brugeren, der foretager API-kaldet. Dette token skal udstedes fra samme Microsoft Entra ID-lejer som kundeserviceinstansen.

Overskrifter til anmodning

Nøgle Type Beskrivelse
ApiVersion String CCaaS API-versionen.
ProactiveEngagementConfigId String ID for den proaktive engagement-konfiguration, der skal bruges. Den specificerer også dial-tilstandstype, arbejdsstrøm og udgående profil, der skal bruges. For at få dette ID skal du udføre følgende trin:
  1. Gå til Power Apps og vælg det ønskede miljø.
  2. Vælg tabeller>proaktiv engagement-konfiguration.
  3. Vælg id'et for den påkrævede post.
RequestId String Valgfrit. Attribut til at sende for at spore forespørgslen fra et kildesystem.
Prioritet String Valgfrit. Definerer prioritetsværdien af anmodningen.
Kontaktpersoner JSON-array af kontaktobjekter Specificerer en eller flere kontakter (op til 5) på denne anmodning. Mindst ét telefonnummer pr. kontakt er påkrævet.
Windows JSON-matrix af vinduesobjekter Angiver de gyldige tidsperioder, hvor det udgående opkald kan foretages. Hvis det ikke er angivet, har systemet som standard et 24-timers vindue, der starter med det samme (fra det aktuelle tidspunkt til 24 timer senere).

Kontaktobjekt

Nøgle Type Beskrivelse
uniqueIdentifier String Unik identifikator for kontakten. Det kan være et ContactId eller et eksternt ID.
førstenavn String Kontaktens fornavn.
efternavn String Kontaktens efternavn.
mobilTelefonnummer String Mobiltelefonnummeret på kontakten.
businessTelefonnummer String Forretningstelefonnummeret på kontakten.
hjemTelefonnummer String Kontaktens hjemmetelefonnummer.
email String Valgfrit. Kontaktens e-mailadresse.
postalcode String Valgfrit. Postnummeret til kontakten.
stat String Valgfrit. Kontaktens tilstand.
country String Valgfrit. Kontaktens land/region.
addressline String Valgfrit. Kontaktens adresselinje.
by String Valgfrit. Kontaktens by.
tidszone String Valgfrit. Kontaktens tidszone. Skal være en værdi fra Dynamics 365-godkendte listen.
inputAttributter JSON-objekt for nøgle/værdi-strenge Valgfrit. Variabler, der kan refereres i Copilot-agent-flows for at tilpasse adfærd, styre betinget logik eller hente personlige oplysninger fra Dataverse-poster.
Vinduer JSON-matrix af vinduesobjekter Valgfrit. Kontaktniveau-tids-windows, der tilsidesætter topniveau-Windows for denne specifikke kontakt.

Bemærkning

Mindst én af mobilePhoneNumber, businessPhoneNumber, eller homePhoneNumber er påkrævet pr. kontakt.

Windows-objekt

Nøgle Type Beskrivelse
Begynde String Starttidsstemplet for dette vindue. Skal angives i UTC i formatet yyyy-MM-ddTHH:mm:ss.fffZ .
Afslut String Sluttidsstemplet for dette vindue. Skal angives i UTC i formatet yyyy-MM-ddTHH:mm:ss.fffZ .

Eksempelanmodning

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

Brug CCaaS_CreateProactiveVoiceDelivery API
Brug CCaaS_CreateOperation API
Brug proaktive engagementstabeller til rapportering

  • Last updated on