Deze browser wordt niet meer ondersteund.
Upgrade naar Microsoft Edge om te profiteren van de nieuwste functies, beveiligingsupdates en technische ondersteuning.
In deze zelfstudie leert u hoe u het einde van de gespreksenquête van Azure Communication Services gebruikt.
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.
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.
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.
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'));
call.feature(Features.CallSurvey).submitSurvey({
overallRating: { score: 3 },
audioRating: { score: 4 },
videoRating: { score: 3, issues: ['Freezes'] }
}).then(() => console.log('survey submitted successfully'))
call.feature(Features.CallSurvey).submitSurvey({
overallRating: { score: 3 }
}).catch((e) => console.log('error when submitting survey: ' + e))
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:
{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].
{ message: validationErrorMessage, code: 400 }
{ message: "Please try again.", code: 408 }
| 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.
| 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
|
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.
| 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.
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.
Een App Insight-resource maken.
Sluit Azure-app Insights in uw toepassing in. Klik hier voor meer informatie over de initialisatie van App Insight met behulp van gewone JavaScript. U kunt OOK NPM gebruiken om de App Insights-afhankelijkheden op te halen. Klik hier voor meer informatie over de initialisatie van App Insight met behulp van NPM.
Bouw een gebruikersinterface in uw toepassing die aangepaste vragen levert aan de gebruiker en hun invoer verzamelt. Stel dat uw toepassing antwoorden heeft verzameld als een tekenreeks in de improvementSuggestion variabele
Verzend enquêteresultaten naar ACS en verzend gebruikersantwoord met Behulp van App Insights:
currentCall.feature(SDK.Features.CallSurvey).submitSurvey(survey).then(res => {
// `improvementSuggestion` contains custom, user response
if (improvementSuggestion !== '') {
appInsights.trackEvent({
name: "CallSurvey", properties: {
// Survey ID to correlate the survey
id: res.id,
// Other custom properties as key value pair
improvementSuggestion: improvementSuggestion
}
});
}
});
appInsights.flush();
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:
Data source dit het geval is Logs en Resource type is CommunicationACSCallSurvey
| where TimeGenerated > now(-24h)
Data source dit het geval is Logs en Resource type is Application InsightscustomEvents
| where timestamp > now(-24h)
| where name == 'CallSurvey'
| extend d=parse_json(customDimensions)
| project SurveyId = d.id, ImprovementSuggestion = d.improvementSuggestion
Data source is en selecteer Merge type indien nodigBelangrijk
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.
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.
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
}
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
SurveyScore overall = new SurveyScore();
overall.setScore(5);
callSurvey.setOverallScore(overall);
// 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);
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);
try {
CallSurveyResult survey = surveyCallFeature.submitSurvey(survey).get();
} catch (InterruptedException e) {
// Threading error
} catch (ExecutionException e) {
Log.e("SURVEY", e.getCause().getMessage());
}
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.
| 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 |
| 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 |
| 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 |
| 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 |
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.
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.
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.
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")
}
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.
let overallScore = SurveyScore()
overallScore.score = Int32(5)
callSurvey.overallScore = overallScore
// 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 ];
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 ];
do {
var result = try await self.surveyFeature!.submit(survey: callSurvey)
} catch let error as NSError {
print("==> Survey Not Submitted " + error.localizedDescription)
}
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.
| 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 |
| 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 |
| 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 |
| 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 |
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.
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.
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.
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();
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.
survey.OverallScore = new CallSurveyScore() { Score = 5 };
// 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;
survey.OverallScore = new CallSurveyScore() {
Score = 5
};
survey.AudioScore = new CallSurveyScore() {
Score = 4
};
survey.VideoScore = new CallSurveyScore() {
Score = 3
};
survey.videoIssues = VideoIssues.Freezes;
try
{
CallSurveyResult result = await surveyCallFeature.SubmitSurveyAsync(survey);
Console.WriteLine("Survey submitted" + result.SurveyId);
} catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
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.
| 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 |
| 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 |
| 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 |
| 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 |
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.
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
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
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.
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.
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.
Analyseer uw enquêtegegevens, zie: Einde van oproepenquêtelogboeken
Meer informatie over het einde van de gespreksenquête, zie: Overzicht van enquête einde gesprek
Meer informatie over het gebruik van de Log Analytics-werkruimte, zie: Log Analytics-zelfstudie
Uw eigen query's maken in Log Analytics, zie: Aan de slag-query's
Training
Leertraject
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
Certificering
Microsoft 365 Certified: Collaboration Communications Systems Engineer Associate - Certifications
Demonstrate skills to configure, deploy, monitor, and manage Microsoft Teams Phone, meetings, and certified devices.
Documentatie
Beschrijvingen van gegevensvisualisaties die beschikbaar zijn voor Call Automation Communications Services via Werkmappen
Azure Communication Services - bekende problemen in systeemeigen SDK's
Meer informatie over bekende problemen met Azure Communication Services voor het aanroepen van SDK.
Meer informatie over het migreren van een aanroepend product van Twilio Video naar Azure Communication Services.