Bruk CCaaS_CreateProactiveDelivery API

Du kan bruke API-et CCaaS_CreateProactiveDelivery til å initiere proaktive utgående talesamtaler til kunder gjennom Proactive Engagement-tjenesten.

Viktig!

  • Hvis en organisasjon bruker API-et CCaaS_CreateProactiveDelivery for å starte en utgående talesamtale, er organisasjonen ansvarlig for samtykkehåndtering, inkludert manuell oppdatering av "ikke ring-lister" for å sette stille timer for kundekontakt. Sørg for at følgende betingelser er oppfylt:
    • Samtykke innhentes før man kontakter kundene.
    • Kunder kontaktes kun i tillatte timer.

Forutsetninger

  • Du må ha rollen som Omnichannel-agent eller Omnichannel-supervisor for å kalle dette API-et.
  • Proaktivt engasjement er konfigurert. Lær mer i Konfigurer proaktivt engasjement.

Forespørselsdetaljer

  • URL-adresse: https://<orgurl>/api/data/v9.2/CCaaS_CreateProactiveDelivery
  • Metode: POST
  • Versjon: 1.0
  • OData-operasjon: Handling
  • OData-type: Ubegrenset
  • Be om autorisasjon: Obligatorisk. Må inneholde et gyldig Microsoft Entra ID Bearer-token for brukeren som utfører API-kallet. Dette tokenet må utstedes fra samme Microsoft Entra ID-leietaker som kundeserviceinstansen.

Forespørselshoder

Nøkkel Type Beskrivelse
ApiVersion Streng CCaaS API-versjonen.
ProactiveEngagementConfigId Streng ID for den proaktive engasjementskonfigurasjonen som skal brukes. Den spesifiserer også skivemodustype, arbeidsstrøm og utgående profil som skal brukes. For å få denne ID-en, gjør følgende steg:
  1. Gå til Power Apps og velg det nødvendige miljøet.
  2. Velg tabeller>for proaktiv engasjementskonfigurasjon.
  3. Velg ID-en for den nødvendige posten.
RequestId Streng Valgfritt. Attributt for å sende for å spore forespørselen fra et kildesystem.
Prioritet Streng Valgfritt. Definerer prioritetsverdien til forespørselen.
Kontakter JSON-array av Kontaktobjekter Spesifiserer én eller flere kontakter (opptil 5) på denne forespørselen. Minst ett telefonnummer per kontakt kreves.
Windows JSON-matrise med vindusobjekter Spesifiserer gyldige tidsperioder når utgående samtale kan plasseres. Hvis det ikke er oppgitt, har systemet som standard et 24-timers vindu som starter umiddelbart (fra gjeldende tid til 24 timer senere).

Kontaktobjekt

Nøkkel Type Beskrivelse
uniqueIdentifier Streng Unik identifikator for kontakten. Det kan være en ContactId eller en ekstern ID.
førstenavn Streng Fornavn på kontakten.
Etternavn Streng Etternavnet til kontakten.
mobilTelefonnummer Streng Mobiltelefonnummeret til kontakten.
businessTelefonnummer Streng Forretningstelefonnummeret til kontakten.
hjemTelefonnummer Streng Hjemmetelefonnummeret til kontakten.
e-post Streng Valgfritt. E-postadressen til kontakten.
postalcode Streng Valgfritt. Postnummeret til kontakten.
Staten Streng Valgfritt. Tilstanden til kontakten.
country Streng Valgfritt. Land/region for kontakten.
addressline Streng Valgfritt. Adresselinjen til kontakten.
city Streng Valgfritt. Byen til kontakten.
tidssone Streng Valgfritt. Tidssonen til kontakten. Må være en verdi fra Dynamics 365-godkjente listen.
inputAttributter JSON-objekt for nøkkelverdi-strenger Valgfritt. Variabler som kan refereres til i Copilot-agent-flyter for å tilpasse atferd, styre betinget logikk eller hente personlig informasjon fra Dataverse-poster.
Vinduer JSON-matrise med vindusobjekter Valgfritt. Kontaktnivå-tids-windows som overstyrer toppnivå-Windows for denne spesifikke kontakten.

Notat

Minst én av mobilePhoneNumber, businessPhoneNumber, eller homePhoneNumber er påkrevd per kontakt.

Windows-objektet

Nøkkel Type Beskrivelse
Start Streng Starttidsstempelet for dette vinduet. Må spesifiseres i UTC i formatet yyyy-MM-ddTHH:mm:ss.fffZ .
Slutt Streng Slutttidsstempelet for dette vinduet. Må spesifiseres i UTC i formatet yyyy-MM-ddTHH:mm:ss.fffZ .

Eksempelforespørsel

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

Bruk CCaaS_CreateProactiveVoiceDelivery API
Bruk CCaaS_CreateOperation API
Bruke proaktive engasjementstabeller for rapportering

  • Last updated on