Konfigurer SIP X-headere til stemmeaktiverede agenter

Denne artikel forklarer, hvordan man konfigurerer Session Initiation Protocol (SIP) X-headere til 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 indkommende 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 passende tilladelser

• Direkte routing til telefonikonfiguration

• Grundlæggende forståelse af Copilot Studio-emneoprettelse og variabelstyring

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ærk

  I Copilot Studio skal alle indkommende X-headere starte med små bogstaver x-, selv hvis det eksterne system, der sender X-headeren, bruger et stort bogstav X-. Den udgående X-header, der defineres i Copilot Studio, kan være enten små eller store bogstaver, afhængigt af hvilken bokst 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.

Add Variable Management - Parse Value-node

1. Navigér til din stemmeaktiverede agents emne.

2. Tilføj en ny emne-node.

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

   

Configure the Parse Value-noden

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.

Vigtigt!

Dynamics 365 Contact Center-platformen normaliserer altid X-headernavne til at bruge et lille præfiks x- , uanset hvordan det eksterne system sender dem. Det betyder:

• Hvis det eksterne system sender X-CallID, skal du definere det som x-CallID i dit skema.

• Hvis det eksterne system sender X-AAI-Incoming, skal du definere det som x-AAI-Incoming i dit skema.

Selvom det eksterne system måske bruger store bogstaver X-, skal dit skema altid bruge små bogstaver x- , så platformen korrekt kan kortlægge og behandle headerne.

Eksempel på JSON for X-headere

{

"x-CallID": "",

"x-AAI-Incoming": ""  
}

Gem de parsede 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-headers sendt af det eksterne system.

• Copilot Studio udfylder automatisk posten med X-header-værdier, når navnene matcher 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ærk

  I Copilot Studio skal alle indkommende X-headere starte med små bogstaver x-, selv hvis det eksterne system, der sender X-headeren, bruger et stort bogstav X-. Den udgående X-header, der defineres i Copilot Studio, kan være enten små eller store bogstaver, afhængigt af hvilken bokst 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 overførselskonversionsnoden

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 praksis

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

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 sat til global scope, hvis den tilgås 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

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 fejler med 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

Opdatering af X-header-skema

• For at modtage nye X-headers, opdater JSON-eksemplet i Define JSON schema for X-headers.

• Bekræft og gem det opdaterede skema.

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