Konfigurer SIP X-headere til stemmeaktiverede agenter

I denne artikel forklares det, hvordan du konfigurerer X-headere (Session Initiation Protocol) for indgående og udgående opkald i Copilot Studio-stemmeaktiverede agenter til brug i Dynamics 365 Contact Center.

SIP X-headere gør det muligt for dig at sende brugerdefineret metadata mellem telefonisystemer og dine stemmeaktiverede agenter. Dynamics 365 Contact Center stemmeaktiverede agenter understøtter både indgående og udgående X-headere. Denne konfiguration muliggør problemfri dataudveksling under opkaldsoverførsler og routing.

Forudsætninger

• Dynamics 365 Contact Center med stemmeaktiverede agenter aktiveret

• Copilot Studio-adgang med de relevante tilladelser

• Direkte routing til telefonikonfiguration

• Grundlæggende forståelse af Copilot Studio topisk oprettelse og variabel administration

Konfigurer indkommende X-headere

Indkommende X-headere indeholder metadata, der sendes fra eksterne telefonisystemer til din stemmeaktiverede agent. For at modtage og bruge disse data skal du konfigurere en Parse Value-node til at udtrække X-header-information fra systemvariablen Conversation.SipXHeader .

Indkommende X-header-krav

• Maksimalt antal: Fem X-headere pr. indgående opkald.

• Navngivningskrav: Alle X-header-navne skal starte med x-.

  Bemærkning

  I Copilot Studio skal alle indgående X-headere starte med små bogstaver x-, selvom det eksterne system, der sender X-headeren, bruger store bogstaver X-. Den udgående X-header, der er defineret i Copilot Studio, kan være i enten lille eller stor bogstavform, afhængigt af hvad det eksterne system forventer.

• Navnelængde: Op til 64 tegn.

• Værdilængde: Op til 256 tegn.

• Et JSON-skema er påkrævet for alle forventede X-headere.

• Opdater JSON-skemaet, når X-header-navne ændres.

• Kanaldataafhængighed: X-headere skal være til stede i Conversation.SipXHeader.

Tilføj node for variabelstyring – parse værdi

1. Gå til emne for din stemmeaktiverede agent.

2. Tilføj en ny emne-node.

3. Vælg Variabelhåndtering og vælg Parseværdi.

   

Konfigurer Opdel værdi-node

1. Fra Systemmenuen sætter Parse-værdifeltet til Conversation.SipXHeader.

2. Sæt datatypen til From sample data.

3. Definér den forventede X-header-struktur ved at vælge Get schema fra eksempel-JSON.

   

Definér JSON-skema for X-headere

I dialogen Get schema from sample JSON skal du angive JSON-strukturen, der inkluderer de X-header-navne, du forventer at modtage. For eksempel, hvis du forventer headere som X-CallID og X-AAI-Incoming i et indgående opkald, så tilføj dem til dit JSON-skema.

Vælg Bekræft for at anvende skemaet.

Eksempel på JSON for X-headere

{

"x-CallID": "",

"x-AAI-Incoming": ""  
}

Gem de fortolkede data

1. Opret eller vælg en variabel i feltet Gem som (for eksempel, IncomingSipXHeader).

   

2. Sæt variablens scope til Global for at give adgang på tværs af flere emner i din agent.

Få adgang til X-header-værdier i dine emner

Når den er konfigureret, kan du få adgang til individuelle X-header-værdier ved hjælp af punktum, ligesom i følgende eksempler:

• Global.IncomingSipXHeader.'x-AAI-Incoming'

• IncomingSIPXHeaders.sipXHeader.'X-CallID'

Kørselsadfærd

• Copilot Studio modtager kun de første fem X-headere, der er sendt af det eksterne system.

• Copilot Studio udfylder automatisk posten med X-headerværdier, når navne stemmer overens med skemaet.

• Manglende X-headere har tomme strengværdier.

• Skemaopdateringer er nødvendige, når X-header-navne ændres, eller hvis du ønsker at modtage ekstra headers.

Konfigurer udgående X-headere

Du kan sende brugerdefinerede data, når du overfører opkald til eksterne telefonnumre ved hjælp af udgående X-headers. Konfigurer disse headers i Overførselssamtale-noden .

Krav til udgående X-header

• Maksimalt antal: Fem X-headers pr. overførsel.

• Navngivningskrav: Alle X-header-navne kan starte med X- eller x-, afhængigt af hvilket tilfælde det eksterne system forventer.

  Bemærkning

  I Copilot Studio skal alle indgående X-headere starte med små bogstaver x-, selvom det eksterne system, der sender X-headeren, bruger store bogstaver X-. Den udgående X-header, der er defineret i Copilot Studio, kan være i enten lille eller stor bogstavform, afhængigt af hvad det eksterne system forventer.

• Navnelængde: Op til 64 tegn.

• Værdilængde: Op til 256 tegn.

• Overførselstype: Kun tilgængelig for overførsel af eksterne telefonnummer.

Opsæt node for overførselsdialog

1. Tilføj en overførsels-samtalenode til dit emneflow.

2. Vælg Overfør til eksternt telefonnummer under Overførselstype, og angiv overførselsnummeret. For eksempel +18005551212.

Konfigurer X-headers i Overførselskonversationsnode-egenskaber

1. Vælg ikonet Flere (...) i noden, og vælg derefter Egenskaber.

2. Vælg + Tilføj for at tilføje X-header nøgle-værdi-par.

   

3. Definér X-header-indgangene. Udgående X-header-navne sendes præcis, som du definerer dem i Overførselssamtale-noden . Vælg det passende tilfælde baseret på, hvad modtagersystemet forventer.

   • Nøglenavn: Skal starte med X- eller x- (for eksempel X-AAI-Outgoing eller X-CallID)
   • Værdi: Indtast en statisk værdi eller tildel en variabel

   

Bedste fremgangsmåder

Følg disse retningslinjer for skemadesign, variabel administration, fejlhåndtering og ydeevne, når du arbejder med SIP X-headere i dine stemmeaktiverede agenter. Få mere at vide i Værktøjer, viden, MCP og API.

Skemadesign

• Brug beskrivende X-header-navne, der tydeligt angiver deres formål.

• Hold JSON-skemaet opdateret, når kravene til X-headeren ændres.

• Dokumentér dit X-header-skema til teamreference og fejlfinding.

Variabelstyring

• Brug globale variable til X-header-data, der skal tilgås på tværs af emner.

• Vælg meningsfulde variabelnavne (for eksempel IncomingSIPXHeaders eller CustomerXHeaders).

• Initialiser variabler tidligt i din samtaleproces.

Fejlhåndtering

• Tjek altid for tilstedeværelse af X-header, før du bruger værdier i din logik.

• Implementer fallback-adfærd for manglende eller ugyldige X-header-data.

• Test grundigt med forskellige X-header-scenarier.

Ydelsesovervejelser

• Parse X-headere tidligt i din samtaleproces.

• Cache brugte ofte værdier i separate variable, hvis det var nødvendigt.

• Undgå gentagen parsing af de samme kanaldata.

Almindelige problemer med indkommende X-headere

Hvis indgående X-headere ikke fungerer som forventet, skal du gennemse disse almindelige problemer og fejlfindingstrin.

X-header-værdier ikke modtaget

• Bekræft, at JSON-skemaet nøjagtigt matcher de forventede X-header-navne.

• Tjek at Parse Value-noden er konfigureret med Conversation.SipXHeader.

• Sørg for, at variablen er angivet til globalt omfang, hvis du får adgang til den fra flere emner.

• Sørg for, at der ikke forventes mere end fem X-headers, og at X-headers er de fem øverste X-headers sendt af det eksterne system.

Tomme eller nul X-header-værdier

• Bekræft, at det eksterne system sender X-headere med de forventede navne.

• Kontroller, at JSON-skemaet indeholder alle nødvendige X-header-navne med et lille præfiks x- .

Almindelige problemer med udgående X-headere

Hvis udgående X-headere ikke fungerer som forventet, skal du gennemse disse almindelige problemer og fejlfindingstrin.

X-headers sendes ikke under overførslen

• Tjek at alle X-header-navne starter med X- eller x-.

• Sørg for, at overførselstypen er sat til Ekstern telefonnummeroverførsel.

• Sørg for, at X-header-værdier er korrekt tildelt før Overførselssamtale-noden .

Overførsel mislykkes på grund af X-headers

• Bekræft, at X-header-navne og -værdier ikke overstiger længdegrænserne.

• Kontroller at modtagersystemet kan håndtere de X-headers, der sendes.

• Tjek for specialtegn, der kan give problemer med parsing.

Skemastyring

Hold dit X-headerskema organiseret og opdateret, når dine krav ændres.

Opdatering af X-header-skema

• Opdater JSON-eksemplet i DefineR JSON-skemaet for X-headere for at modtage nye X-headere.

• Bekræft og gem det opdaterede skema.

• Test skemaet med den nye X-header-konfiguration.