Use a Pesquisa de Fim de Chamada para coletar comentários dos usuários

• Node.js versões ativas de Suporte de Longo Prazo (LTS) são recomendadas.

Exemplo de uso da API

O recurso Pesquisa de fim de chamada deve ser usado após o término da chamada. Os usuários podem classificar qualquer tipo de chamada VoIP, 1:1, grupo, reunião, saída e entrada. Quando a chamada de um usuário termina, seu aplicativo pode mostrar uma interface do usuário para o usuário final, permitindo que ele escolha uma pontuação de classificação e, se necessário, escolha problemas encontrados durante a chamada em nossa lista predefinida.

Os trechos de código a seguir mostram um exemplo de chamada um-para-um. Após o término da chamada, seu aplicativo pode mostrar uma interface do usuário de pesquisa e, uma vez que o usuário escolhe uma classificação, seu aplicativo deve chamar a API de recurso para enviar a pesquisa com as opções do usuário.

Recomendamos que você use a escala de classificação padrão. No entanto, você pode enviar uma pesquisa com uma escala de classificação personalizada. Você pode verificar o aplicativo de exemplo para o uso da API de exemplo.

Classifique apenas chamadas - sem escala personalizada

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

OverallRating é uma categoria obrigatória para todos os inquéritos.

Classifique apenas chamadas - com escala e problemas personalizados

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'));

Classifique geral, áudio e vídeo com um problema de amostra

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

Manipular erros que o SDK pode enviar

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

Encontrar diferentes tipos de erros

Falhas ao enviar pesquisa

A API retorna as seguintes mensagens de erro se a validação de dados falhar ou a pesquisa não puder ser enviada.

• É necessária pelo menos uma classificação no inquérito.

• Por defeito, a escala X deve ser de 1 a 5. - em que X é uma das seguintes opções:

  • geralRating.score
  • audioRating.score
  • videoRating.score
  • ScreenshareRating.score

• {propertyName}: {rating.score} deve estar entre {rating.scale?. lowerBound} e {rating.scale?. upperBound}.

• {propertyName}: {rating.scale?. lowScoreThreshold} deve estar entre {rating.scale?. lowerBound} e {rating.scale?. upperBound}.

• {propertyName} lowerBound: {rating.scale?. lowerBound} e upperBound: {rating.scale?. upperBound} deve estar entre 0 e 100.

• Tente novamente [O ACS não conseguiu enviar a pesquisa devido a um erro de rede ou outro].

Retornaremos todos os códigos de erro com uma mensagem.

• Código de erro 400 (solicitação incorreta) para todas as mensagens de erro, exceto uma.

{ message: validationErrorMessage, code: 400 }

• Um 408 (tempo limite) quando o evento foi descartado:

{ message: "Please try again.", code: 408 }

Todos os valores possíveis

Configuração padrão da API de pesquisa

Mais tags de pesquisa

Opções de personalização

Você pode optar por coletar cada um dos quatro valores de API ou apenas os que achar mais importantes. Por exemplo, você pode optar por perguntar apenas aos clientes sobre a experiência geral de chamada em vez de perguntar sobre a experiência de compartilhamento de áudio, vídeo e tela. Você também pode personalizar intervalos de entrada para atender às suas necessidades. O intervalo de entrada padrão é de 1 a 5 para Chamada Geral, Áudio, Vídeo e Compartilhamento de Tela. No entanto, cada valor de API pode ser personalizado de um mínimo de 0 a um máximo de 100.

Exemplos de personalização

Perguntas personalizadas

Além de usar a API de pesquisa de fim de chamada, você pode criar suas próprias perguntas de pesquisa e incorporá-las aos resultados da pesquisa de fim de chamada. Abaixo, você encontra etapas para incorporar suas próprias perguntas de clientes em uma pesquisa e consultar os resultados da API de pesquisa de fim de chamada e suas próprias perguntas de pesquisa.

• Crie o recurso App Insight.

• Incorporar o Azure AppInsights em seu aplicativo Clique aqui para saber mais sobre a inicialização do App Insight usando JavaScript simples. Como alternativa, você pode usar o NPM para obter as dependências do App Insights. Clique aqui para saber mais sobre a inicialização do App Insight usando o NPM.

• Crie uma interface do usuário em seu aplicativo que sirva perguntas personalizadas para o usuário e reúna suas entradas, vamos supor que seu aplicativo reuniu respostas como uma cadeia de caracteres na improvementSuggestion variável

• Envie os resultados da pesquisa para o ACS e envie a resposta do usuário usando o App Insights:

  currentCall.feature(SDK.Features.CallSurvey).submitSurvey(survey).then(res => {
  // `improvementSuggesstion` 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();
  

As respostas dos usuários que foram enviadas usando o AppInsights estão disponíveis em seu espaço de trabalho do App Insights. Você pode usar Pastas de trabalho para consultar entre vários recursos, correlacionar classificações de chamadas e dados de pesquisa personalizados. Etapas para correlacionar as classificações de chamadas e os dados personalizados da pesquisa:

• Crie novas pastas de trabalho (seu recurso ACS -> Monitoramento -> Pastas de trabalho -> Nova) e consulte os dados do Call Survey a partir do recurso ACS.
• Adicionar nova consulta (+Adicionar -> Adicionar consulta)
• Certifique-se de que Data source é Logs e Resource type é Communication
• Você pode renomear a consulta (Configurações avançadas -> Nome da etapa [exemplo: pesquisa de chamada])
• Lembre-se de que pode ser necessário um máximo de 2 horas para que os dados da pesquisa fiquem visíveis no portal do Azure. Consultar os dados de classificação de chamadas-

  ACSCallSurvey
  | where TimeGenerated > now(-24h)
  

• Adicionar outra consulta para obter dados do App Insights (+Adicionar -> Adicionar consulta)
• Certifique-se de que Data source é Logs e Resource type é Application Insights
• Consultar os eventos personalizados-

  customEvents
  | where timestamp > now(-24h)
  | where name == 'CallSurvey'
  | extend d=parse_json(customDimensions)
  | project SurveyId = d.id, ImprovementSuggestion = d.improvementSuggestion
  

• Você pode renomear a consulta (Configurações avançadas -> Nome da etapa [exemplo: custom-call-survey])
• Finalmente, mescle essas duas consultas por surveyId. Criar nova consulta (+Adicionar -> Adicionar consulta).
• Certifique-se de que é Data source Mesclar e selecione Merge type conforme necessário

title: Azure Communication Services End of Call Survey titleSufixo: Descrição do documento tutorial dos Serviços de Comunicação do Azure: Saiba como usar a Pesquisa de Fim de Chamada para coletar comentários dos usuários. autor: viniciusl-msft ms.autor: viniciusl gerente: gaobob serviços: azure-communication-services ms.date: 30/07/2024 ms.topic: tutorial ms.service: azure-communication-services ms.subservice: calling

Exemplo de uso da API

O recurso Pesquisa de fim de chamada deve ser usado após o término da chamada. Os usuários podem classificar qualquer tipo de chamada VoIP, 1:1, grupo, reunião, saída e entrada. Quando a chamada de um usuário termina, seu aplicativo pode mostrar uma interface do usuário para o usuário final, permitindo que ele escolha uma pontuação de classificação e, se necessário, escolha problemas encontrados durante a chamada em nossa lista predefinida.

Os trechos de código a seguir mostram um exemplo de chamada um-para-um. Após o término da chamada, seu aplicativo pode mostrar uma interface do usuário de pesquisa e, uma vez que o usuário escolhe uma classificação, seu aplicativo deve chamar a API de recurso para enviar a pesquisa com as opções do usuário.

Recomendamos que você use a escala de classificação padrão, que é a classificação de cinco estrelas (entre 1-5). No entanto, você pode enviar uma pesquisa com uma escala de classificação personalizada.

Iniciar um inquérito

Você cria um CallSurvey objeto iniciando uma pesquisa. Isso registra uma intenção de pesquisa. Caso esse objeto específico CallSurvey não seja enviado posteriormente, isso significa que a pesquisa foi ignorada ou ignorada pelo cliente final.

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

Utilização geral

Ao classificar chamadas, você deve respeitar os valores definidos no campo de escala. O valor lowerBound denota a pior experiência possível, enquanto o valor upperBound significa a experiência perfeita. Ambos os valores são inclusivos.

OverallRating é uma categoria obrigatória para todos os inquéritos.

Para obter mais informações sobre o uso sugerido da pesquisa, consulte Conceitos da pesquisa

Classifique apenas chamadas - sem escala personalizada

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

Classifique apenas chamadas - com escala e problemas personalizados

// 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);

Classifique geral, áudio e vídeo com um problema de amostra

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);

Enviar pesquisa e lidar com erros que o SDK pode enviar

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

Encontrar diferentes tipos de erros

Falhas durante o envio da pesquisa:

A API submitSurvey pode retornar um erro nos seguintes cenários:

• É necessária uma classificação geral do inquérito.

• CallSurveyRatingScale os limites devem estar entre 0 e 100. LowerBound deve ser menor que UpperBound. LowScoreThreshold deve estar dentro dos limites.

• Qualquer uma das pontuações deve respeitar os limites definidos pelo CallSurveyRatingScale. Todos os CallSurveyRatingScale valores no objeto são inclusivos. Usando a escala padrão, o valor da pontuação deve estar entre 1 e 5.

• A pesquisa não pode ser enviada devido a um erro de rede/serviço.

Tags de pesquisa disponíveis

Apelo global

Problemas de áudio

Problemas de vídeo

Problemas de compartilhamento de tela

Opções de personalização

Você pode optar por coletar cada um dos quatro valores de API ou apenas os que achar mais importantes. Por exemplo, você pode optar por perguntar apenas aos clientes sobre a experiência geral de chamada em vez de perguntar sobre a experiência de compartilhamento de áudio, vídeo e tela. Você também pode personalizar intervalos de entrada para atender às suas necessidades. O intervalo de entrada padrão é de 1 a 5 para Chamada Geral, Áudio, Vídeo e Compartilhamento de tela. No entanto, cada valor de API pode ser personalizado de um mínimo de 0 a um máximo de 100.

Perguntas personalizadas

Além de usar a API de pesquisa de fim de chamada, você pode criar suas próprias perguntas de pesquisa e incorporá-las aos resultados da pesquisa de fim de chamada.

A carga útil resultante da operação fornece dados que você pode usar para correlacionar os dados do SubmitSurvey ACS Survey com seus próprios dados e armazenamento personalizados. CallSurveyResult class tem o SurveyId campo que denota um identificador exclusivo para a pesquisa e CallId indica um identificador para a chamada onde a pesquisa foi gerada. Salvar esses identificadores junto com seus dados personalizados permite que os dados sejam associados exclusivamente.

Exemplo de uso da API

O recurso Pesquisa de fim de chamada deve ser usado após o término da chamada. Os usuários podem classificar qualquer tipo de chamada VoIP, 1:1, grupo, reunião, saída e entrada. Quando a chamada de um usuário termina, seu aplicativo pode mostrar uma interface do usuário para o usuário final, permitindo que ele escolha uma pontuação de classificação e, se necessário, escolha problemas encontrados durante a chamada em nossa lista predefinida.

Os trechos de código a seguir mostram um exemplo de chamada um-para-um. Após o término da chamada, seu aplicativo pode mostrar uma interface do usuário de pesquisa e, uma vez que o usuário escolhe uma classificação, seu aplicativo deve chamar a API de recurso para enviar a pesquisa com as opções do usuário.

Recomendamos que você use a escala de classificação padrão, que é a classificação de cinco estrelas (entre 1-5). No entanto, você pode enviar uma pesquisa com uma escala de classificação personalizada.

Iniciar um inquérito

Você cria um CallSurvey objeto iniciando uma pesquisa. Isso registra uma intenção de pesquisa. Caso esse objeto específico CallSurvey não seja enviado posteriormente, isso significa que a pesquisa foi ignorada ou ignorada pelo cliente final.

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

Utilização geral

Ao classificar chamadas, você deve respeitar os valores definidos no campo de escala. O valor lowerBound denota a pior experiência possível, enquanto o valor upperBound significa a experiência perfeita. Ambos os valores são inclusivos.

OverallRating é uma categoria obrigatória para todos os inquéritos.

Para obter mais informações sobre o uso sugerido da pesquisa, consulte Conceitos da pesquisa

Classifique apenas chamadas - sem escala personalizada

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

Classifique apenas chamadas - com escala e problemas personalizados

// 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 ];

Classifique geral, áudio e vídeo com um problema de amostra

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 ];

Enviar pesquisa e lidar com erros que o SDK pode enviar

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

Encontrar diferentes tipos de erros

Falhas durante o envio da pesquisa:

A API submitSurvey pode retornar um erro nos seguintes cenários:

• É necessária uma classificação geral do inquérito.

• CallSurveyRatingScale os limites devem estar entre 0 e 100. LowerBound deve ser menor que UpperBound. LowScoreThreshold deve estar dentro dos limites.

• Qualquer uma das pontuações deve respeitar os limites definidos pelo CallSurveyRatingScale. Todos os CallSurveyRatingScale valores no objeto são inclusivos. Usando a escala padrão, o valor da pontuação deve estar entre 1 e 5.

• A pesquisa não pode ser enviada devido a um erro de rede/serviço.

Tags de pesquisa disponíveis

Chamada Geral

Problemas de áudio

Problemas de vídeo

Problemas de compartilhamento de tela

Opções de personalização

Você pode optar por coletar cada um dos quatro valores de API ou apenas os que achar mais importantes. Por exemplo, você pode optar por perguntar apenas aos clientes sobre a experiência geral de chamada em vez de perguntar sobre a experiência de compartilhamento de áudio, vídeo e tela. Você também pode personalizar intervalos de entrada para atender às suas necessidades. O intervalo de entrada padrão é de 1 a 5 para Chamada Geral, Áudio, Vídeo e Compartilhamento de tela. No entanto, cada valor de API pode ser personalizado de um mínimo de 0 a um máximo de 100.

Perguntas personalizadas

Além de usar a API de pesquisa de fim de chamada, você pode criar suas próprias perguntas de pesquisa e incorporá-las aos resultados da pesquisa de fim de chamada.

No entanto, a carga útil resultante da operação fornece dados que você pode usar para correlacionar os dados do SubmitSurvey ACS Survey com seus próprios dados personalizados e armazenamento. CallSurveyResult class tem o SurveyId campo que denota um identificador exclusivo para a pesquisa e CallId indica um identificador para a chamada onde a pesquisa foi gerada. Salvar esses identificadores junto com seus dados personalizados permite que os dados sejam associados exclusivamente.

Exemplo de uso da API

O recurso Pesquisa de fim de chamada deve ser usado após o término da chamada. Os usuários podem classificar qualquer tipo de chamada VoIP, 1:1, grupo, reunião, saída e entrada. Quando a chamada de um usuário termina, seu aplicativo pode mostrar uma interface do usuário para o usuário final, permitindo que ele escolha uma pontuação de classificação e, se necessário, escolha problemas encontrados durante a chamada em nossa lista predefinida.

Os trechos de código a seguir mostram um exemplo de chamada um-para-um. Após o término da chamada, seu aplicativo pode mostrar uma interface do usuário de pesquisa e, uma vez que o usuário escolhe uma classificação, seu aplicativo deve chamar a API de recurso para enviar a pesquisa com as opções do usuário.

Recomendamos que você use a escala de classificação padrão, que é a classificação de cinco estrelas (entre 1-5). No entanto, você pode enviar uma pesquisa com uma escala de classificação personalizada.

Iniciar um inquérito

Você cria um CallSurvey objeto iniciando uma pesquisa. Isso registra uma intenção de pesquisa. Caso esse objeto específico CallSurvey não seja enviado posteriormente, isso significa que a pesquisa foi ignorada ou ignorada pelo cliente final.

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

Utilização geral

Ao classificar chamadas, você deve respeitar os valores definidos no campo de escala. O valor lowerBound denota a pior experiência possível, enquanto o valor upperBound significa a experiência perfeita. Ambos os valores são inclusivos.

OverallRating é uma categoria obrigatória para todos os inquéritos.

Para obter mais informações sobre o uso sugerido da pesquisa, consulte Conceitos da pesquisa

Classifique apenas chamadas - sem escala personalizada

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

Classifique apenas chamadas - com escala e problemas personalizados

// 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;

Classifique geral, áudio e vídeo com um problema de amostra

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

survey.videoIssues = VideoIssues.Freezes;

Enviar pesquisa e lidar com erros que o SDK pode enviar

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

Encontrar diferentes tipos de erros

Falhas durante o envio da pesquisa:

A API submitSurvey pode retornar um erro nos seguintes cenários:

• É necessária uma classificação geral do inquérito.

• CallSurveyRatingScale os limites devem estar entre 0 e 100. LowerBound deve ser menor que UpperBound. LowScoreThreshold deve estar dentro dos limites.

• Qualquer uma das pontuações deve respeitar os limites definidos pelo CallSurveyRatingScale. Todos os CallSurveyRatingScale valores no objeto são inclusivos. Usando a escala padrão, o valor da pontuação deve estar entre 1 e 5.

• A pesquisa não pode ser enviada devido a um erro de rede/serviço.

Tags de pesquisa disponíveis

Chamada Geral

Problemas de áudio

Problemas de vídeo

Problemas de compartilhamento de tela

Opções de personalização

Você pode optar por coletar cada um dos quatro valores de API ou apenas os que achar mais importantes. Por exemplo, você pode optar por perguntar apenas aos clientes sobre a experiência geral de chamada em vez de perguntar sobre a experiência de compartilhamento de áudio, vídeo e tela. Você também pode personalizar intervalos de entrada para atender às suas necessidades. O intervalo de entrada padrão é de 1 a 5 para Chamada Geral, Áudio, Vídeo e Compartilhamento de tela. No entanto, cada valor de API pode ser personalizado de um mínimo de 0 a um máximo de 100.

Perguntas personalizadas

Além de usar a API de pesquisa de fim de chamada, você pode criar suas próprias perguntas de pesquisa e incorporá-las aos resultados da pesquisa de fim de chamada.

No entanto, a carga útil resultante da operação fornece dados que você pode usar para correlacionar os dados do SubmitSurvey ACS Survey com seus próprios dados personalizados e armazenamento. CallSurveyResult class tem o SurveyId campo que denota um identificador exclusivo para a pesquisa e CallId indica um identificador para a chamada onde a pesquisa foi gerada. Salvar esses identificadores junto com seus dados personalizados permite que os dados sejam associados exclusivamente.