Delen via

Het einde van de oproepenquête gebruiken om feedback van gebruikers te verzamelen

  • Artikel

In deze zelfstudie leert u hoe u het einde van de gespreksenquête van Azure Communication Services gebruikt.

Vereisten

Belangrijk

Het einde van de oproepenquête is beschikbaar vanaf versie 1.13.1 van de Calling SDK. Zorg ervoor dat u die versie of hoger gebruikt wanneer u de instructies probeert.

  • Node.js actieve LTS-versies (Long Term Support) worden aanbevolen.

Voorbeeld van API-gebruik

De functie Gespreksenquête einde moet worden gebruikt nadat de oproep is beëindigd. Gebruikers kunnen elk type VoIP-oproep beoordelen, 1:1, groep, vergadering, uitgaande en inkomende e-mail. Zodra de oproep van een gebruiker is beëindigd, kan uw toepassing een gebruikersinterface weergeven aan de eindgebruiker, zodat ze een beoordelingsscore kunnen kiezen en, indien nodig, problemen kunnen kiezen die ze hebben aangetroffen tijdens het gesprek vanuit onze vooraf gedefinieerde lijst.

In de volgende codefragmenten ziet u een voorbeeld van een-op-een-aanroep. Na het einde van de aanroep kan uw toepassing een enquête-gebruikersinterface weergeven en zodra de gebruiker een beoordeling heeft gekozen, moet uw toepassing de functie-API aanroepen om de enquête in te dienen met de gebruikerskeuzen.

We raden u aan om de standaardclassificatieschaal te gebruiken. U kunt echter een enquête indienen met aangepaste beoordelingsschaal. U kunt de voorbeeldtoepassing uitchecken voor het gebruik van de voorbeeld-API.

Alleen gesprek beoordelen - geen aangepaste schaal

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: { score: 5 }, // issues are optional
}).then(() => console.log('survey submitted successfully'));

OverallRating is een vereiste categorie voor alle enquêtes.

Alleen gesprek beoordelen - met aangepaste schaal en problemen

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: {
        score: 1, // my score
        scale: { // my custom scale
            lowerBound: 0,
            upperBound: 1,
            lowScoreThreshold: 0
        },
        issues: ['HadToRejoin'] // my issues, check the table below for all available issues
    }
}).then(() => console.log('survey submitted successfully'));

Algemeen, audio en video beoordelen met een voorbeeldprobleem

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: { score: 3 },
    audioRating: { score: 4 },
    videoRating: { score: 3, issues: ['Freezes'] }
}).then(() => console.log('survey submitted successfully'))

Fouten verwerken die de SDK kan verzenden

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: { score: 3 }
}).catch((e) => console.log('error when submitting survey: ' + e))

Verschillende typen fouten zoeken

Fouten tijdens het indienen van enquête

De API retourneert de volgende foutberichten als de gegevensvalidatie mislukt of de enquête niet kan worden verzonden.

  • Er is ten minste één enquêteclassificatie vereist.

  • In de standaardschaal X moet 1 tot 5 zijn. - waarbij X een van de volgende is:

    • overallRating.score
    • audioRating.score
    • videoRating.score
    • ScreenshareRating.score

  • {propertyName}: {rating.score} moet liggen tussen {rating.scale?. lowerBound} en {rating.scale?. upperBound}.

  • {propertyName}: {rating.scale?. lowScoreThreshold} moet liggen tussen {rating.scale?. lowerBound} en {rating.scale?. upperBound}.

  • {propertyName} lowerBound: {rating.scale?. lowerBound} en upperBound: {rating.scale?. upperBound} moet tussen 0 en 100 liggen.

  • Probeer het opnieuw [ACS kan enquête niet indienen vanwege een netwerkfout of een andere fout].

We retourneren eventuele foutcodes met een bericht.

  • Foutcode 400 (ongeldige aanvraag) voor alle foutberichten behalve één.
{ message: validationErrorMessage, code: 400 }
  • Eén 408 (time-out) wanneer de gebeurtenis is verwijderd:
{ message: "Please try again.", code: 408 }

Alle mogelijke waarden

Standaardconfiguratie van enquête-API

API-classificatiecategorieën Grenswaarde* Invoerbereik Opmerkingen
Algemeen gesprek 2 1 - 5 Enquêtes over de algehele kwaliteit van een deelnemer op schaal van 1-5. Een antwoord van 1 geeft een onvolkomen gesprekservaring aan en 5 geeft een perfecte oproep aan. De grenswaarde van 2 betekent dat een klantreactie van 1 of 2 een minder dan perfecte gesprekservaring aangeeft.
Audio 2 1 - 5 Een antwoord van 1 geeft een onvolkomen audio-ervaring aan en 5 geeft aan dat er geen audioproblemen zijn opgetreden.
Video’s 2 1 - 5 Een reactie van 1 geeft een onvolkomen video-ervaring aan en 5 geeft aan dat er geen videoproblemen zijn opgetreden.
Schermshare 2 1 - 5 Een antwoord van 1 geeft een onvolkomen schermshare-ervaring aan en 5 geeft aan dat er geen problemen zijn opgetreden bij het delen van het scherm.

Notitie

De aangegeven grenswaarde van een vraag in de API is de drempelwaarde die Microsoft gebruikt bij het analyseren van uw enquêtegegevens. Wanneer u de grenswaarde of het invoerbereik aanpast, analyseert Microsoft uw enquêtegegevens op basis van uw aanpassing.

Meer enquêtetags

Classificatiecategorieën Optionele tags
Algemeen gesprek CallCannotJoin CallCannotInvite HadToRejoin CallEndedUnexpectedly OtherIssues
Audio NoLocalAudio NoRemoteAudio Echo AudioNoise LowVolume AudioStoppedUnexpectedly DistortedSpeech AudioInterruption OtherIssues
Video’s NoVideoReceived NoVideoSent LowQuality Freezes StoppedUnexpectedly DarkVideoReceived AudioVideoOutOfSync OtherIssues
Schermshare NoContentLocal NoContentRemote CannotPresent LowQuality Freezes StoppedUnexpectedly LargeDelay OtherIssues

Aanpassingsopties

U kunt ervoor kiezen om elk van de vier API-waarden te verzamelen of alleen de waarden die u het belangrijkst vindt. U kunt er bijvoorbeeld voor kiezen om alleen klanten te vragen over hun algehele gesprekservaring in plaats van hen te vragen over hun audio-, video- en schermervaring. U kunt ook invoerbereiken aanpassen aan uw behoeften. Het standaardinvoerbereik is 1 tot 5 voor algemeen gesprek, audio, video en schermshare. Elke API-waarde kan echter worden aangepast van minimaal 0 tot maximaal 100.

Voorbeelden van aanpassingen

API-classificatiecategorieën Grenswaarde* Invoerbereik
Algemeen gesprek 0 - 100 0 - 100
Audio 0 - 100 0 - 100
Video’s 0 - 100 0 - 100
Schermshare 0 - 100 0 - 100

Notitie

De aangegeven grenswaarde van een vraag in de API is de drempelwaarde die Microsoft gebruikt bij het analyseren van uw enquêtegegevens. Wanneer u de grenswaarde of het invoerbereik aanpast, analyseert Microsoft uw enquêtegegevens op basis van uw aanpassing.

Aangepaste vragen

Naast het gebruik van de API voor het einde van de gespreksenquête, kunt u uw eigen enquêtevragen maken en opnemen met de resultaten van de enquête beëindigen. Hieronder vindt u stappen voor het opnemen van uw eigen klantvragen in een enquête en het opvragen van de resultaten van de Api voor het einde van de aanroepen en uw eigen enquêtevragen.

Gebruikersantwoorden die zijn verzonden met Behulp van AppInsights, zijn beschikbaar in uw App Insights-werkruimte. U kunt Werkmappen gebruiken om query's uit te voeren tussen meerdere resources, oproepbeoordelingen en aangepaste enquêtegegevens te correleren. Stappen voor het correleren van de gespreksclassificaties en aangepaste enquêtegegevens:

  • Maak nieuwe werkmappen (uw ACS-resource -> Bewaking -> Werkmappen -> Nieuw) en voer een query uit op enquêtegegevens uit uw ACS-resource.
  • Nieuwe query toevoegen (+Toevoegen -> Query toevoegen)
  • Zorg ervoor dat Data source dit het geval is Logs en Resource type is Communication
  • U kunt de naam van de query wijzigen (Geavanceerde instellingen -> Stapnaam [voorbeeld: call-survey])
  • Houd er rekening mee dat het maximaal 2 uur kan duren voordat de enquêtegegevens zichtbaar zijn in Azure Portal. Query's uitvoeren op de gespreksclassificatiegegevens- 
    ACSCallSurvey
| where TimeGenerated > now(-24h)
  • Een andere query toevoegen om gegevens op te halen uit App Insights (+Toevoegen -> Query toevoegen)
  • Zorg ervoor dat Data source dit het geval is Logs en Resource type is Application Insights
  • Query's uitvoeren op de aangepaste gebeurtenissen- 
    customEvents
| where timestamp > now(-24h)
| where name == 'CallSurvey'
| extend d=parse_json(customDimensions)
| project SurveyId = d.id, ImprovementSuggestion = d.improvementSuggestion
  • U kunt de naam van de query wijzigen (Geavanceerde instellingen -> Stapnaam [voorbeeld: custom-call-survey])
  • Voeg tot slot deze twee query's samen op surveyId. Nieuwe query maken (+Toevoegen -> Query toevoegen).
  • Zorg ervoor dat samenvoegen Data source is en selecteer Merge type indien nodig

titel: Einde van gespreksenquêtetitelSuffix van Azure Communication Services: een documentbeschrijving van de zelfstudie over Azure Communication Services: informatie over het gebruik van de enquête einde van de oproep om feedback van gebruikers te verzamelen. auteur: viniciusl-msft ms.author: viniciusl manager: gaobob services: azure-communication-services ms.date: 7/30/2024 ms.topic: tutorial ms.service: azure-communication-services ms.subservice: calling

Belangrijk

Het einde van de oproepenquête is beschikbaar vanaf versie 2.10.0 van de Android Calling SDK. Zorg ervoor dat u die versie of hoger gebruikt wanneer u de instructies probeert.

Voorbeeld van API-gebruik

De functie Gespreksenquête einde moet worden gebruikt nadat de oproep is beëindigd. Gebruikers kunnen elk type VoIP-oproep beoordelen, 1:1, groep, vergadering, uitgaande en inkomende e-mail. Zodra de oproep van een gebruiker is beëindigd, kan uw toepassing een gebruikersinterface weergeven aan de eindgebruiker, zodat ze een beoordelingsscore kunnen kiezen en, indien nodig, problemen kunnen kiezen die ze hebben aangetroffen tijdens het gesprek vanuit onze vooraf gedefinieerde lijst.

In de volgende codefragmenten ziet u een voorbeeld van een-op-een-aanroep. Na het einde van de aanroep kan uw toepassing een enquête-gebruikersinterface weergeven en zodra de gebruiker een beoordeling heeft gekozen, moet uw toepassing de functie-API aanroepen om de enquête in te dienen met de gebruikerskeuzen.

We raden u aan om de standaardclassificatieschaal te gebruiken. Dit is de vijf sterrenclassificatie (tussen 1 en 5). U kunt echter een enquête indienen met aangepaste beoordelingsschaal.

Een enquête starten

U maakt een CallSurvey object door een enquête te starten. Hiermee wordt een enquête-intentie vastgelegd. Als dit specifieke CallSurvey object later niet wordt ingediend, betekent dit dat de enquête is overgeslagen of genegeerd door de eindklant.

SurveyCallFeature surveyCallFeature = call.feature(Features.SURVEY);
try {
    CallSurvey survey = surveyCallFeature.startSurvey().get();
} catch (InterruptedException | ExecutionException e) {
    // failure to start survey
}

Algemeen gebruik

Wanneer classificatieoproepen worden aanroepen, moet u waarden respecteren die zijn gedefinieerd in het schaalveld. De lagere waarde Voor uitgaand verkeer geeft de slechtste ervaring aan, terwijl de bovenste uitgaande waarde de perfecte ervaring betekent. Beide waarden zijn inclusief.

OverallRating is een vereiste categorie voor alle enquêtes.

Notitie

De aangegeven grenswaarde van een vraag in de API is de drempelwaarde die Microsoft gebruikt bij het analyseren van uw enquêtegegevens. Wanneer u de grenswaarde of het invoerbereik aanpast, analyseert Microsoft uw enquêtegegevens op basis van uw aanpassing.

Zie Enquêteconcepten voor meer informatie over het gebruik van voorgestelde enquête

Alleen gesprek beoordelen - geen aangepaste schaal

SurveyScore overall = new SurveyScore();
overall.setScore(5);
callSurvey.setOverallScore(overall);

Alleen gesprek beoordelen - met aangepaste schaal en problemen

// configuring scale
CallSurveyRatingScale ratingScale = new CallSurveyRatingScale();
ratingScale.setLowerBound(0);
ratingScale.setLowerBound(1);
ratingScale.setLowScoreThreshold(0);
SurveyScore overall = new SurveyScore();
overall.setScale(ratingScale);

// setting score according to scale
overall.setScore(1);
callSurvey.setOverallScore(overall);
// reporting one or more issues
callSurvey.setCallIssues(CallIssues.HAD_TO_REJOIN);

Algemeen, audio en video beoordelen met een voorbeeldprobleem

SurveyScore overall = new SurveyScore();
overall.setScore(3);
SurveyScore audio = new SurveyScore();
audio.setScore(4);
SurveyScore video = new SurveyScore();
video.setScore(3);
callSurvey.setOverallScore(overall);
callSurvey.setAudioScore(audio);
callSurvey.setVideoScore(video);
callSurvey.setVideoIssues(VideoIssues.FREEZES);

Enquête verzenden en fouten verwerken die de SDK kan verzenden

try {
    CallSurveyResult survey = surveyCallFeature.submitSurvey(survey).get();
} catch (InterruptedException e) {
    // Threading error
} catch (ExecutionException e) {
    Log.e("SURVEY", e.getCause().getMessage());
}

Verschillende typen fouten zoeken

Fouten tijdens het indienen van enquête:

De submitSurvey-API kan een fout retourneren in de volgende scenario's:

  • De algehele beoordeling van de enquête is vereist.

  • CallSurveyRatingScale de grenzen moeten binnen 0 en 100 vallen. LowerBound moet kleiner zijn dan UpperBound. LowScoreThreshold moet binnen grenzen vallen.

  • Alle scores moeten de grenzen respecteren die zijn gedefinieerd door de CallSurveyRatingScale. Alle waarden in het CallSurveyRatingScale object zijn inclusief. Met de standaardschaal moet de scorewaarde tussen 1 en 5 zijn.

  • De enquête kan niet worden verzonden vanwege een netwerk-/servicefout.

Beschikbare enquêtetags

Algemene oproep

Code Beschrijving
CannotJoin Klant kon niet deelnemen aan een gesprek
CannotInvite De klant kon geen nieuwe deelnemer aan het gesprek toevoegen
HadToRejoin Klant heeft de oproep verlaten en opnieuw toegevoegd als tijdelijke oplossing voor een probleem
CallEndedUnexpectedly De oproep van de klant is beëindigd zonder duidelijke reden
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Audioproblemen

Code Beschrijving
NoLocalAudio Geen audio op de klantcomputer tijdens het gesprek, niet in staat om iemand in het gesprek te horen
NoRemoteAudio Ontbrekende audio van een specifieke deelnemer
Echo Echo die in de oproep wordt waargenomen
AudioNoise Audio ontvangen met onbedoeld geluid
LowVolume Audio is te laag
AudioStoppedUnexpectedly Audio is gestopt zonder duidelijke reden (bijvoorbeeld niemand is gedempt)
DistortedSpeech De stem van een deelnemer wordt vervormd, anders dan de verwachte stem
AudioInterruption Klantervaringen van audioonderbrekingen, spraakonderbrekingen, enzovoort.
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Videoproblemen

Code Beschrijving
NoVideoReceived Klant ontvangt geen video van een deelnemer
NoVideoSent Klant start video, maar niemand in het gesprek kan het zien
LowQuality Video met lage kwaliteit
Freezes Video loopt vast
StoppedUnexpectedly Scherm delen stopt zonder duidelijke reden (bijvoorbeeld camera is ingeschakeld en videogesprekken zijn ingeschakeld)
DarkVideoReceived Video wordt verzonden, maar de deelnemer ziet slechts een donker vak (of een andere kleur)
AudioVideoOutOfSync Video en audio lijken niet synchroon te zijn
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Problemen met het delen van het scherm

Code Beschrijving
NoContentLocal De klant ontvangt geen schermshare van een deelnemer die deelt
NoContentRemote De klant deelt het scherm, maar andere deelnemers kunnen het niet zien
CannotPresent Kan schermshare niet starten
LowQuality Lage kwaliteit op het scherm delen video, bijvoorbeeld niet lezen
Freezes Schermshare blokkeert tijdens de presentatie
StoppedUnexpectedly Scherm delen stopt zonder duidelijke reden (bijvoorbeeld het delen van het scherm is niet gestopt door de klant)
LargeDelay Waargenomen vertraging tussen wat wordt weergegeven en wat wordt gezien
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Aanpassingsopties

U kunt ervoor kiezen om elk van de vier API-waarden te verzamelen of alleen de waarden die u het belangrijkst vindt. U kunt er bijvoorbeeld voor kiezen om alleen klanten te vragen over hun algehele gesprekservaring in plaats van hen te vragen over hun audio-, video- en schermervaring. U kunt ook invoerbereiken aanpassen aan uw behoeften. Het standaardinvoerbereik is 1 tot 5 voor het delen van algemene oproepen, audio, video en scherm. Elke API-waarde kan echter worden aangepast van minimaal 0 tot maximaal 100.

Notitie

De aangegeven grenswaarde van een vraag in de API is de drempelwaarde die Microsoft gebruikt bij het analyseren van uw enquêtegegevens. Wanneer u de grenswaarde of het invoerbereik aanpast, analyseert Microsoft uw enquêtegegevens op basis van uw aanpassing.

Aangepaste vragen

Naast het gebruik van de API voor het einde van de gespreksenquête, kunt u uw eigen enquêtevragen maken en opnemen met de resultaten van de enquête beëindigen.

De nettolading van SubmitSurvey de bewerking levert gegevens op die u kunt gebruiken om ACS-enquêtegegevens te correleren met uw eigen aangepaste gegevens en opslag. CallSurveyResult de klasse heeft het SurveyId veld dat een unieke id aangeeft voor de enquête en CallId een id aangeeft voor de aanroep waar de enquête is gegenereerd. Door deze id's samen met uw aangepaste gegevens op te slaan, kunnen gegevens uniek worden gekoppeld.

Belangrijk

Het einde van de oproepenquête is beschikbaar vanaf versie 2.10.0 van de iOS Calling SDK. Zorg ervoor dat u die versie of hoger gebruikt wanneer u de instructies probeert.

Voorbeeld van API-gebruik

De functie Gespreksenquête einde moet worden gebruikt nadat de oproep is beëindigd. Gebruikers kunnen elk type VoIP-oproep beoordelen, 1:1, groep, vergadering, uitgaande en inkomende e-mail. Zodra de oproep van een gebruiker is beëindigd, kan uw toepassing een gebruikersinterface weergeven aan de eindgebruiker, zodat ze een beoordelingsscore kunnen kiezen en, indien nodig, problemen kunnen kiezen die ze hebben aangetroffen tijdens het gesprek vanuit onze vooraf gedefinieerde lijst.

In de volgende codefragmenten ziet u een voorbeeld van een-op-een-aanroep. Na het einde van de aanroep kan uw toepassing een enquête-gebruikersinterface weergeven en zodra de gebruiker een beoordeling heeft gekozen, moet uw toepassing de functie-API aanroepen om de enquête in te dienen met de gebruikerskeuzen.

We raden u aan om de standaardclassificatieschaal te gebruiken. Dit is de vijf sterrenclassificatie (tussen 1 en 5). U kunt echter een enquête indienen met aangepaste beoordelingsschaal.

Een enquête starten

U maakt een CallSurvey object door een enquête te starten. Hiermee wordt een enquête-intentie vastgelegd. Als dit specifieke CallSurvey object later niet wordt ingediend, betekent dit dat de enquête is overgeslagen of genegeerd door de eindklant.

var surveyCallFeature = self.call.feature(Features.survey)
do {
    try self.callSurvey = await surveyFeature.startSurvey()
} catch {
    print("Failure to start survey")
}

Algemeen gebruik

Wanneer classificatieoproepen worden aanroepen, moet u waarden respecteren die zijn gedefinieerd in het schaalveld. De lagere waarde Voor uitgaand verkeer geeft de slechtste ervaring aan, terwijl de bovenste uitgaande waarde de perfecte ervaring betekent. Beide waarden zijn inclusief.

OverallRating is een vereiste categorie voor alle enquêtes.

Zie Enquêteconcepten voor meer informatie over het gebruik van voorgestelde enquête

Notitie

De aangegeven grenswaarde van een vraag in de API is de drempelwaarde die Microsoft gebruikt bij het analyseren van uw enquêtegegevens. Wanneer u de grenswaarde of het invoerbereik aanpast, analyseert Microsoft uw enquêtegegevens op basis van uw aanpassing.

Alleen gesprek beoordelen - geen aangepaste schaal

let overallScore = SurveyScore()
overallScore.score = Int32(5)
callSurvey.overallScore = overallScore

Alleen gesprek beoordelen - met aangepaste schaal en problemen

// configuring scale
var ratingScale = new CallSurveyRatingScale()
ratingScale.lowerBound = 0;
ratingScale.upperBound = 1;
ratingScale.lowScoreThreshold = 0;
SurveyScore overall = new SurveyScore();
overall.scale = ratingScale;
// setting score according to scale
overall.score = 1;

callSurvey.overallScore = overall;

// reporting one or more issues
callSurvey.callIssues = [ CallIssues.hadToRejoin ];

Algemeen, audio en video beoordelen met een voorbeeldprobleem

let overall = SurveyScore();
overall.score  = 3;

let audio = SurveyScore();
audio.score = 4;

let video = SurveyScore();
video.score = 3;

callSurvey.overallScore = overall;
callSurvey.audioScore = audio;
callSurvey.videoScore = video;
callSurvey.videoIssues = [ VideoIssues.freezes ];

Enquête verzenden en fouten verwerken die de SDK kan verzenden

do {
    var result =  try await self.surveyFeature!.submit(survey: callSurvey)
} catch let error as NSError {
    print("==> Survey Not Submitted " + error.localizedDescription)
}

Verschillende typen fouten zoeken

Fouten tijdens het indienen van enquête:

De submitSurvey-API kan een fout retourneren in de volgende scenario's:

  • De algehele beoordeling van de enquête is vereist.

  • CallSurveyRatingScale de grenzen moeten binnen 0 en 100 vallen. LowerBound moet kleiner zijn dan UpperBound. LowScoreThreshold moet binnen grenzen vallen.

  • Alle scores moeten de grenzen respecteren die zijn gedefinieerd door de CallSurveyRatingScale. Alle waarden in het CallSurveyRatingScale object zijn inclusief. Met de standaardschaal moet de scorewaarde tussen 1 en 5 zijn.

  • De enquête kan niet worden verzonden vanwege een netwerk-/servicefout.

Beschikbare enquêtetags

Algemeen gesprek

Code Beschrijving
CannotJoin Klant kon niet deelnemen aan een gesprek
CannotInvite De klant kon geen nieuwe deelnemer aan het gesprek toevoegen
HadToRejoin Klant heeft de oproep verlaten en opnieuw toegevoegd als tijdelijke oplossing voor een probleem
CallEndedUnexpectedly De oproep van de klant is beëindigd zonder duidelijke reden
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Audioproblemen

Code Beschrijving
NoLocalAudio Geen audio op de klantcomputer tijdens het gesprek, niet in staat om iemand in het gesprek te horen
NoRemoteAudio Ontbrekende audio van een specifieke deelnemer
Echo Echo die in de oproep wordt waargenomen
AudioNoise Audio ontvangen met onbedoeld geluid
LowVolume Audio is te laag
AudioStoppedUnexpectedly Audio is gestopt zonder duidelijke reden (bijvoorbeeld niemand is gedempt)
DistortedSpeech De stem van een deelnemer wordt vervormd, anders dan de verwachte stem
AudioInterruption Klantervaringen van audioonderbrekingen, spraakonderbrekingen, enzovoort.
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Videoproblemen

Code Beschrijving
NoVideoReceived Klant ontvangt geen video van een deelnemer
NoVideoSent Klant start video, maar niemand in het gesprek kan het zien
LowQuality Video met lage kwaliteit
Freezes Video loopt vast
StoppedUnexpectedly Scherm delen stopt zonder duidelijke reden (bijvoorbeeld camera is ingeschakeld en videogesprekken zijn ingeschakeld)
DarkVideoReceived Video wordt verzonden, maar de deelnemer ziet slechts een donker vak (of een andere kleur)
AudioVideoOutOfSync Video en audio lijken niet synchroon te zijn
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Problemen met het delen van het scherm

Code Beschrijving
NoContentLocal De klant ontvangt geen schermshare van een deelnemer die deelt
NoContentRemote De klant deelt het scherm, maar andere deelnemers kunnen het niet zien
CannotPresent Kan schermshare niet starten
LowQuality Lage kwaliteit op het scherm delen video, bijvoorbeeld niet lezen
Freezes Schermshare blokkeert tijdens de presentatie
StoppedUnexpectedly Scherm delen stopt zonder duidelijke reden (bijvoorbeeld het delen van het scherm is niet gestopt door de klant)
LargeDelay Waargenomen vertraging tussen wat wordt weergegeven en wat wordt gezien
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Aanpassingsopties

U kunt ervoor kiezen om elk van de vier API-waarden te verzamelen of alleen de waarden die u het belangrijkst vindt. U kunt er bijvoorbeeld voor kiezen om alleen klanten te vragen over hun algehele gesprekservaring in plaats van hen te vragen over hun audio-, video- en schermervaring. U kunt ook invoerbereiken aanpassen aan uw behoeften. Het standaardinvoerbereik is 1 tot 5 voor het delen van algemene oproepen, audio, video en scherm. Elke API-waarde kan echter worden aangepast van minimaal 0 tot maximaal 100.

Notitie

De aangegeven grenswaarde van een vraag in de API is de drempelwaarde die Microsoft gebruikt bij het analyseren van uw enquêtegegevens. Wanneer u de grenswaarde of het invoerbereik aanpast, analyseert Microsoft uw enquêtegegevens op basis van uw aanpassing.

Aangepaste vragen

Naast het gebruik van de API voor het einde van de gespreksenquête, kunt u uw eigen enquêtevragen maken en opnemen met de resultaten van de enquête beëindigen.

De nettolading van SubmitSurvey de bewerking levert echter gegevens op die u kunt gebruiken om ACS-enquêtegegevens te correleren met uw eigen aangepaste gegevens en opslag. CallSurveyResult de klasse heeft het SurveyId veld dat een unieke id aangeeft voor de enquête en CallId een id aangeeft voor de aanroep waar de enquête is gegenereerd. Door deze id's samen met uw aangepaste gegevens op te slaan, kunnen gegevens uniek worden gekoppeld.

Belangrijk

Het einde van de oproepenquête is beschikbaar vanaf versie 1.8.0 van de Windows Calling SDK. Zorg ervoor dat u die versie of hoger gebruikt wanneer u de instructies probeert.

Voorbeeld van API-gebruik

De functie Gespreksenquête einde moet worden gebruikt nadat de oproep is beëindigd. Gebruikers kunnen elk type VoIP-oproep beoordelen, 1:1, groep, vergadering, uitgaande en inkomende e-mail. Zodra de oproep van een gebruiker is beëindigd, kan uw toepassing een gebruikersinterface weergeven aan de eindgebruiker, zodat ze een beoordelingsscore kunnen kiezen en, indien nodig, problemen kunnen kiezen die ze hebben aangetroffen tijdens het gesprek vanuit onze vooraf gedefinieerde lijst.

In de volgende codefragmenten ziet u een voorbeeld van een-op-een-aanroep. Na het einde van de aanroep kan uw toepassing een enquête-gebruikersinterface weergeven en zodra de gebruiker een beoordeling heeft gekozen, moet uw toepassing de functie-API aanroepen om de enquête in te dienen met de gebruikerskeuzen.

We raden u aan om de standaardclassificatieschaal te gebruiken. Dit is de vijf sterrenclassificatie (tussen 1 en 5). U kunt echter een enquête indienen met aangepaste beoordelingsschaal.

Een enquête starten

U maakt een CallSurvey object door een enquête te starten. Hiermee wordt een enquête-intentie vastgelegd. Als dit specifieke CallSurvey object later niet wordt ingediend, betekent dit dat de enquête is overgeslagen of genegeerd door de eindklant.

var surveyCallFeature = call.Features.Survey;
var survey = await surveyCallFeature.StartSurveyAsync();

Algemeen gebruik

Wanneer classificatieoproepen worden aanroepen, moet u waarden respecteren die zijn gedefinieerd in het schaalveld. De lagere waarde Voor uitgaand verkeer geeft de slechtste ervaring aan, terwijl de bovenste uitgaande waarde de perfecte ervaring betekent. Beide waarden zijn inclusief.

OverallRating is een vereiste categorie voor alle enquêtes.

Zie Enquêteconcepten voor meer informatie over het gebruik van voorgestelde enquête

Notitie

De aangegeven grenswaarde van een vraag in de API is de drempelwaarde die Microsoft gebruikt bij het analyseren van uw enquêtegegevens. Wanneer u de grenswaarde of het invoerbereik aanpast, analyseert Microsoft uw enquêtegegevens op basis van uw aanpassing.

Alleen gesprek beoordelen - geen aangepaste schaal

survey.OverallScore = new CallSurveyScore() { Score = 5 };

Alleen gesprek beoordelen - met aangepaste schaal en problemen

// configuring scale and score
survey.OverallScore = new CallSurveyScore() { 
    Scale = new CallSurveyRatingScale() { 
                LowerBound = 0,
                UpperBound = 1,
                LowScoreThreshold = 1,
            }, 
            Score = 1 
};

// reporting one or more issues
survey.OverallIssues = CallIssues.HadToRejoin;

Algemeen, audio en video beoordelen met een voorbeeldprobleem

survey.OverallScore = new CallSurveyScore() { 
    Score = 5 
};
survey.AudioScore = new CallSurveyScore() { 
    Score = 4
};
survey.VideoScore = new CallSurveyScore() { 
    Score = 3
};

survey.videoIssues = VideoIssues.Freezes;

Enquête verzenden en fouten verwerken die de SDK kan verzenden

try
{
    CallSurveyResult result = await surveyCallFeature.SubmitSurveyAsync(survey);
    Console.WriteLine("Survey submitted" + result.SurveyId);
} catch (Exception ex)
{
   Console.WriteLine(ex.Message);
}

Verschillende typen fouten zoeken

Fouten tijdens het indienen van enquête:

De submitSurvey-API kan een fout retourneren in de volgende scenario's:

  • De algehele beoordeling van de enquête is vereist.

  • CallSurveyRatingScale de grenzen moeten binnen 0 en 100 vallen. LowerBound moet kleiner zijn dan UpperBound. LowScoreThreshold moet binnen grenzen vallen.

  • Alle scores moeten de grenzen respecteren die zijn gedefinieerd door de CallSurveyRatingScale. Alle waarden in het CallSurveyRatingScale object zijn inclusief. Met de standaardschaal moet de scorewaarde tussen 1 en 5 zijn.

  • De enquête kan niet worden verzonden vanwege een netwerk-/servicefout.

Beschikbare enquêtetags

Algemeen gesprek

Code Beschrijving
CannotJoin Klant kon niet deelnemen aan een gesprek
CannotInvite De klant kon geen nieuwe deelnemer aan het gesprek toevoegen
HadToRejoin Klant heeft de oproep verlaten en opnieuw toegevoegd als tijdelijke oplossing voor een probleem
EndedUnexpectedly De oproep van de klant is beëindigd zonder duidelijke reden
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Audioproblemen

Code Beschrijving
NoLocalAudio Geen audio op de klantcomputer tijdens het gesprek, niet in staat om iemand in het gesprek te horen
NoRemoteAudio Ontbrekende audio van een specifieke deelnemer
Echo Echo die in de oproep wordt waargenomen
AudioNoise Audio ontvangen met onbedoeld geluid
LowVolume Audio is te laag
AudioStoppedUnexpectedly Audio is gestopt zonder duidelijke reden (bijvoorbeeld niemand is gedempt)
DistortedSpeech De stem van een deelnemer wordt vervormd, anders dan de verwachte stem
AudioInterruption Klantervaringen van audioonderbrekingen, spraakonderbrekingen, enzovoort.
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Videoproblemen

Code Beschrijving
NoVideoReceived Klant ontvangt geen video van een deelnemer
NoVideoSent Klant start video, maar niemand in het gesprek kan het zien
LowQuality Video met lage kwaliteit
Freezes Video loopt vast
StoppedUnexpectedly Scherm delen stopt zonder duidelijke reden (bijvoorbeeld camera is ingeschakeld en videogesprekken zijn ingeschakeld)
DarkVideoReceived Video wordt verzonden, maar de deelnemer ziet slechts een donker vak (of een andere kleur)
AudioVideoOutOfSync Video en audio lijken niet synchroon te zijn
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Problemen met het delen van het scherm

Code Beschrijving
NoContentLocal De klant ontvangt geen schermshare van een deelnemer die deelt
NoContentRemote De klant deelt het scherm, maar andere deelnemers kunnen het niet zien
CannotPresent Kan schermshare niet starten
LowQuality Lage kwaliteit op het scherm delen video, bijvoorbeeld niet lezen
Freezes Schermshare blokkeert tijdens de presentatie
StoppedUnexpectedly Scherm delen stopt zonder duidelijke reden (bijvoorbeeld het delen van het scherm is niet gestopt door de klant)
LargeDelay Waargenomen vertraging tussen wat wordt weergegeven en wat wordt gezien
OtherIssues Elk probleem dat niet past bij eerdere beschrijvingen

Aanpassingsopties

U kunt ervoor kiezen om elk van de vier API-waarden te verzamelen of alleen de waarden die u het belangrijkst vindt. U kunt er bijvoorbeeld voor kiezen om alleen klanten te vragen over hun algehele gesprekservaring in plaats van hen te vragen over hun audio-, video- en schermervaring. U kunt ook invoerbereiken aanpassen aan uw behoeften. Het standaardinvoerbereik is 1 tot 5 voor het delen van algemene oproepen, audio, video en scherm. Elke API-waarde kan echter worden aangepast van minimaal 0 tot maximaal 100.

Notitie

De aangegeven grenswaarde van een vraag in de API is de drempelwaarde die Microsoft gebruikt bij het analyseren van uw enquêtegegevens. Wanneer u de grenswaarde of het invoerbereik aanpast, analyseert Microsoft uw enquêtegegevens op basis van uw aanpassing.

Aangepaste vragen

Naast het gebruik van de API voor het einde van de gespreksenquête, kunt u uw eigen enquêtevragen maken en opnemen met de resultaten van de enquête beëindigen.

De nettolading van SubmitSurvey de bewerking levert echter gegevens op die u kunt gebruiken om ACS-enquêtegegevens te correleren met uw eigen aangepaste gegevens en opslag. CallSurveyResult de klasse heeft het SurveyId veld dat een unieke id aangeeft voor de enquête en CallId een id aangeeft voor de aanroep waar de enquête is gegenereerd. Door deze id's samen met uw aangepaste gegevens op te slaan, kunnen gegevens uniek worden gekoppeld.

Enquêtegegevens verzamelen

Belangrijk

U moet een diagnostische instelling in Azure Monitor inschakelen om de logboekgegevens van uw enquêtes te verzenden naar een Log Analytics-werkruimte, Event Hubs of een Azure-opslagaccount om uw enquêtegegevens te ontvangen en te analyseren. Als u geen enquêtegegevens naar een van deze opties verzendt, worden uw enquêtegegevens niet opgeslagen en gaan ze verloren. Als u deze logboeken voor uw Communications Services wilt inschakelen, raadpleegt u: Einde van oproepenquêtelogboeken

Enquêtegegevens weergeven met een Log Analytics-werkruimte

U moet een Log Analytics-werkruimte inschakelen om zowel de logboekgegevens van uw enquêtes op te slaan als toegang te krijgen tot enquêteresultaten. Als u deze logboeken voor uw communicatieservice wilt inschakelen, raadpleegt u: Einde van oproepenquêtelogboeken.

Aanbevolen procedures

Hier volgen onze aanbevolen enquêtestromen en voorgestelde vragen om overwegingen. Uw ontwikkeling kan onze aanbeveling gebruiken of aangepaste vraagprompts en stromen gebruiken voor uw visuele interface.

Vraag 1: Hoe ervaren de gebruikers hun algehele ervaring met de kwaliteit van oproepen? U wordt aangeraden de enquête te starten door alleen te vragen naar de algehele kwaliteit van de deelnemers. Als u de eerste en tweede vraag scheidt, kunt u alleen antwoorden verzamelen op problemen met audio, video en scherm delen als een deelnemer aan een enquête aangeeft dat deze problemen met de gesprekskwaliteit heeft ondervonden.

  • Voorgestelde prompt: "Hoe was de gesprekskwaliteit?"
  • API-vraagwaarden: Algemene aanroep

Vraag 2: Heeft de gebruiker problemen met audio, video of scherm delen in het gesprek waargenomen? Als een deelnemer aan een enquête heeft gereageerd op vraag 1 met een score op of onder de grenswaarde voor het totale gesprek, presenteert u de tweede vraag.

  • Voorgestelde prompt: "Wat zou er beter kunnen zijn geweest?"
  • API-vraagwaarden: Audio, Video en Screenshare

Richtlijnen voor enquêtes

  • Vermijd burn-out van enquête, niet alle deelnemers aan het gesprek.
  • De volgorde van uw vragen is belangrijk. We raden u aan om de volgorde van optionele tags in vraag 2 te randomiseren voor het geval respondenten de meeste feedback richten op de eerste prompt die ze visueel zien.
  • Overweeg enquêtes te gebruiken voor afzonderlijke Azure Communication Services-resources in gecontroleerde experimenten om release-effecten te identificeren.

Volgende stappen