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.

Dette API understøtter ikke proaktive engagementfunktioner som genforsøg og frekvensbegrænsning. Brug CCaaS_CreateProactiveDelivery API'en til disse funktioner.

Vigtig

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.

Start proaktive udgående opkald

Proaktivt engagement gør det muligt for organisationer at forbedre kundeinteraktioner ved at starte udgående kommunikation via talekanalen. Du kan konfigurere proaktivt engagement ved hjælp af et Customer Insights-kampagneforløb eller .CCaaS_CreateProactiveVoiceDelivery

API'en CCaaS_CreateProactiveVoiceDelivery gør det muligt for organisationer at starte proaktive udgående taleopkald til kunder via Proactive Engagement Service. API'en udløser udgående taleopkald via Voice Runtime-systemet. Opkald foretages i henhold til den konfigurerede opkaldstilstand enten med det samme (hvis der ikke er angivet nogen tidsvinduer) eller i de angivne tidsvinduer, du angiver.

Denne API giver kontaktcentre mulighed for at nå ud til kunder på det rigtige tidspunkt med relevant information, påmindelser eller meddelelser, hvilket forbedrer kundeoplevelsen og optimerer driftseffektiviteten.

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.

Overskrifter til anmodning

Nøgle Slags Beskrivelse
ApiVersion Streng CCaaS API-versionen.
ProactiveEngagementConfigId Streng 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 Streng Telefonnummer på den kunde, der skal ringes til.
Kontakt-id Streng 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 Valgfrit. 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 Slags Beskrivelse
Begynde Streng Starttidsstemplet for dette vindue. Skal angives i UTC i formatet yyyy-MM-ddTHH:mm:ss.fffZ .
Ende Streng Sluttidsstemplet for dette vindue. Skal angives i UTC i formatet yyyy-MM-ddTHH:mm:ss.fffZ .

Vigtig

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