Brug CCaaS_CreateProactiveVoiceDelivery API

Du kan bruge API'en CCaaS_CreateProactiveVoiceDelivery til at starte proaktive udgående taleopkald til kunder eller give kunderne mulighed for at planlægge tilbagekald via Proactive Engagement Service.

Flere API'er er tilgængelige for at skabe proaktive leverancer. Brug følgende vejledning til at vælge den rigtige:

  • CCaaS_CreateProactiveBulkDelivery: Brug dette API til at sende flere poster i én forespørgsel (ca. 15.000 poster). Den understøtter ikke kontoopkald.
  • CCaaS_CreateProactiveDelivery: Dette API er det mest alsidige. Den understøtter alle funktioner og kanaler samt kontoopkald (flere kontakter som en del af samme anmodning). Brug dette API til de fleste scenarier.
  • CCaaS_CreateSimpleProactiveDelivery: Denne version kræver ikke kompleks JSON-nesting og egner sig bedst til overflader som Power Automate.
  • CCaaS_CreateProactiveVoiceDelivery: Dette API er en førstegenerations stemme-API, der ikke understøtter nyere funktioner. Selvom det understøttes, så migrer til CCaaS_CreateProactiveDelivery for de nyeste funktioner.
  • CCaaS_CreateProactiveSMSDelivery: Dette API er en førstegenerations SMS-API, der ikke understøtter nyere funktioner. Selvom det understøttes, så migrer til CCaaS_CreateProactiveDelivery for de nyeste funktioner.

Bemærk

Dette API understøtter ikke proaktive engagementfunktioner som genforsøg, kontaktvinduer, brugerdefineret prioritet og frekvensbegrænsning. Brug CCaaS_CreateProactiveDelivery API'en, hvis du vil udnytte disse funktioner.

Vigtigt!

Hvis en organisation bruger API'en CCaaS_CreateProactiveVoiceDelivery til at starte et udgående taleopkald, er organisationen ansvarlig for samtykkestyring, herunder manuel opdatering af "ring ikke til lister" for at indstille stilletid 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.

Anmodningsdetaljer

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

Headers til anmodninger

Nøgle Type Beskrivelse
ApiVersion String CCaaS API-versionen.
ProactiveEngagementConfigId String Id for den proaktive engagementskonfiguration, der skal bruges. Dette angiver opkaldstilstandstype, arbejdsstrøm og udgående profil, der skal bruges. Gør følgende for at få dette id:
  1. Gå til Power Apps og vælg det ønskede miljø.
  2. Vælg tabeller>Proaktivt engagementskonfiguration
  3. Vælg id'et for den påkrævede post.
DestinationTelefonnummer String Telefonnummer på den kunde, der skal ringes til.
ContactId String ID på kundekontakten i Dynamics CRM.
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).
InputAttributter JSON-objekt for nøgle/værdi-strenge Valgfri. Variabler, der kan refereres i Copilot-agent-flows for at tilpasse adfærd, styre betinget logik eller hente personlige oplysninger fra Dataverse-poster.

Windows-objekt

Nøgle Type Beskrivelse
Start 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 .

Vigtigt!

Nogle klienter kræver et specifikt format som "Windows": "[{\"Start\":\"2025-01-30T16:32:45.930Z\",\"End\":\"2025-06-25T16:32:45.930Z\"}]". Vi anbefaler, at du tester i overensstemmelse hermed.

Eksempelanmodning

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

Oplysninger om svar

Hvis det lykkes, returnerer DeliveryIddenne metode . Leverings-id er et entydigt id, der tildeles hver proaktiv engagementsanmodning, der accepteres via API'en og gemmes i tabellen msdyn_proactive_delivery.

Eksempelsvaret er som følger:

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

Brug proaktive engagementstabeller til rapportering

  • Last updated on