Ir para conteúdo principal

Conectando o Microsoft Teams ao Reviewflowz

Receba novas avaliações diretamente no seu canal do Microsoft Teams, e a partir daí, responda, marque, traduza e obtenha relatórios sem precisar sair do Teams. Tudo é configurado em cerca de cinco minutos.

A
Escrito por Axel Lavergne

Receba novas avaliações direto no seu canal do Microsoft Teams. Então, responda, marque e traduza tudo onde sua equipe já está. Configurar leva por volta de cinco minutos e envolve duas etapas: adicionar o app a um canal e depois vincular sua conta do Reviewflowz. Após isso, as avaliações e relatórios chegam automaticamente, permitindo que sua equipe aja sem sair do Teams.

Um novo cartão de avaliação em um canal do Microsoft Teams com botões de Responder, Marcar, Traduzir e Revisão Completa

O que você vai precisar

  • Uma conta no Reviewflowz, conectada no app.reviewflowz.com através do seu navegador.

  • Um espaço de trabalho no Microsoft Teams e o canal onde as avaliações devem aparecer.

  • Permissão para adicionar um aplicativo ao time. Muitas organizações deixam isso para o administrador. Se você é o administrador, tudo certo. Se não, compartilhe este artigo e o FAQ abaixo aborda as dúvidas que seu administrador possa ter.

Não é necessário fazer download, colar nada ou gerar qualquer URL de webhook.

Passo 1: Encontre o Reviewflowz na loja de aplicativos do Microsoft Teams

Abra o Microsoft Teams e clique em Apps na barra lateral esquerda para acessar a loja de aplicativos do Teams. Procure por Reviewflowz. O app é publicado pela Reviewflowz e também está no Microsoft AppSource (ID do aplicativo WA200010592), garantindo que você está com o app oficial.

A listagem do Reviewflowz na loja de aplicativos do Microsoft Teams

Você também pode acessar a listagem de dentro do Reviewflowz. Vá até Automação, acesse a guia Alertas e clique em Conectar um canal do Teams ao criar um alerta. Isso abrirá a mesma listagem do Teams em uma nova aba.

Passo 2: Adicione o aplicativo ao seu canal

Adicione o app a partir da listagem, depois escolha o time e o canal específico onde as avaliações devem aparecer e confirme. Adicione a um canal, não apenas para você, para que toda a equipe veja as avaliações.

O Reviewflowz envia um cartão de boas-vindas nesse canal, confirmando que está no lugar certo:

  • Título: Bem-vindo ao Reviewflowz!

  • Corpo: "Receba notificações de avaliações, responda, marque e gere relatórios, tudo do Microsoft Teams."

  • Botão: Conectar sua conta

Você pode instalar o aplicativo em mais de um canal depois, um por local ou marca. Cada canal é configurado da mesma forma.

Passo 3: Conecte sua conta

No cartão de boas-vindas, clique em Conectar sua conta.

Seu navegador abre o app.reviewflowz.com para terminar a ligação. Você precisa estar logado no Reviewflowz. Caso não esteja, faça o login e clique no botão novamente. O Reviewflowz liga o canal à conta que estiver ativa, então tenha certeza de que é a correta.

Depois disso, tudo é automático. O Reviewflowz reconhece o canal e o conecta, facilitando o trabalho, sem necessidade de copiar ou colar IDs, tokens ou URLs. A Microsoft fornece os detalhes da conexão no momento da ligação. Você verá uma breve tela "Conectando seu canal do Teams..." enquanto finaliza.

Assim que tudo estiver pronto, o bot confirma no canal:

  • Título: Ei! Sua conta do Reviewflowz está conectada.

  • Corpo: "As notificações de avaliações serão enviadas para cá automaticamente. Digite ajuda para ver os comandos disponíveis."

  • Botão: Abrir Reviewflowz

O Reviewflowz então te guia para configurar seu primeiro alerta para este canal (próximo passo).

Você também pode iniciar esta etapa digitando link para o bot do Reviewflowz no canal. Isso vai repostar o botão Conectar sua conta.

Passo 4: Escolha o que é enviado

Logo após a conexão, você chegará ao criador de alertas. Você poderá acessá-lo novamente mais tarde em Automação, na guia Alertas. Escolha seu canal do Teams conectado como destino, depois configure o que ele envia:

  • Quais avaliações alimentam o alerta. Use o painel de Perfis de avaliação (marcado como Locais em planos baseados em localização). Escolha um, vários ou todos. Esta também é a forma de separar por plataforma: escolha apenas os perfis desejados.

  • Frequência (marcado como "Escolha uma frequência"): Imediatamente para cada nova avaliação conforme ela chega, Todo dia para um resumo diário, ou Toda semana para um resumo semanal. Para o resumo semanal, escolhe-se um dia (segunda a domingo) e um horário (hora cheia ou meia hora, com fuso horário).

  • Filtro de avaliação (linha Enviar): envie Todas as avaliações ou defina um limite de estrelas (de 5 a 1) combinado com e mais, exatamente ou ou menos. Por exemplo, "Enviar avaliações de 3 estrelas ou menos."

  • Tradução (linha Traduzir para): mantenha Não traduzir ou escolha um idioma para traduzir automaticamente as avaliações recebidas.

  • Permitir respostas (exibido em alertas em tempo real Imediatamente): um alternador Sim / Não, definido como Não por padrão. O texto auxiliar diz "para que qualquer um naquele canal possa postar respostas de volta na plataforma de avaliação." Ative para Sim para mostrar o botão Responder no cartão do Teams.

Dê um título ao alerta, verifique se está ativo e salve.

O criador de alertas do Reviewflowz, com filtro de envio, Para (um canal do Microsoft Teams), Permitir respostas, frequência, Perfis de avaliação e Traduzir para

Não há filtro de palavra-chave ou idioma separado, e os alertas não têm opção mensal. A frequência mensal fica nos Relatórios. Para enviar perfis ou locais diferentes para canais diferentes, repita isso para cada canal, um alerta por canal.

Como funciona no dia a dia

Novos cartões de avaliação mostram o nome do avaliador (ou Anônimo), o perfil de avaliação e plataforma, uma classificação por estrelas codificada por cores, o texto da avaliação (traduzido automaticamente se você habilitou), qualquer Prós e Contras, e a data da avaliação.

Cada cartão de avaliação tem uma linha de botões:

  • Responder permite escrever e enviar sua resposta diretamente do Teams. Sua resposta volta para a plataforma de avaliação e o cartão é atualizado para mostrar que há uma resposta. Responder do Teams funciona para Google Maps, App Store, Play Store, Trustpilot e Facebook, desde que a conexão esteja configurada no Reviewflowz. O botão aparece quando Permitir respostas está ativado e a plataforma suporta respostas.

  • Marcar aplica suas tags do Reviewflowz sem sair do Teams.

  • Traduzir lê a avaliação em Inglês, Francês, Espanhol, Alemão, Italiano ou Português.

  • Revisão Completa abre a avaliação na plataforma original.

Relatórios e resumos aparecem no mesmo canal. Você recebe Resumos Diários, Semanais e Mensais e relatórios agendados em uma frequência de Todo dia, Toda semana ou Todo mês. Relatórios agendados incluem tipos padronizados (Visão Geral, Divisão de Classificação, Divisão de Perfil, Velocidade de Avaliação, Visão Geral de Resposta, Avaliações Positivas/Negativas, Radar de Sentimentos, Contagens Semânticas) e seus próprios relatórios personalizados.

Quando uma avaliação é respondida ou removida, o Reviewflowz atualiza o cartão original no canal, garantindo que as informações sejam precisas.

Como a integração funciona

Aqui está um resumo para quem quer entender o processo por trás dos bastidores.

O Reviewflowz se conecta usando o próprio Bot Framework da Microsoft, que é a maneira padrão para os aplicativos do Teams enviarem e receberem mensagens, e constrói notificações com Cartões Adaptativos, o formato de cartão da Microsoft. A autenticação é feita através do fluxo OAuth 2.0 client-credentials. Os tokens de acesso são emitidos pela Microsoft e têm uma vida útil curta (renovados cerca de uma vez por hora), portanto, não há troca de senhas e nenhum URL de webhook para gerenciar ou vazar.

Cada mensagem vinda do Teams é verificada antes do Reviewflowz agir. Cada solicitação carrega um token emitido e assinado pela Microsoft, e o Reviewflowz verifica a assinatura, o emissor, o público-alvo e a autenticidade da solicitação. Qualquer coisa que não seja confirmada é rejeitada.

O escopo é reduzido por design. O aplicativo funciona apenas no canal em que você o adicionou. Ele posta notificações de avaliações e relatórios, e lê as respostas e tags que sua equipe submete nesses cards. A própria listagem de aplicativos da Microsoft confirma que não utiliza o Microsoft Graph e que não solicita acesso a emails, arquivos, chats ou ao seu diretório. De acordo com a mesma lista de conformidade de aplicativos, o app não processa ou armazena dados de clientes Microsoft, e não armazena credenciais em código.

Os identificadores de canal e conversas usados pelo Reviewflowz para alcançar seu canal são armazenados de forma criptografada, e cada ação realizada em seu canal é registrada em um log interno vinculado à sua conta e ao canal.

Você mantém o controle. Um administrador pode aprovar, restringir ou remover o app do centro de administração do Teams a qualquer momento, e qualquer pessoa pode desconectar um canal rapidamente. Remova o aplicativo e as notificações param imediatamente.

Perguntas que as equipes de TI fazem

Onde posso obter o aplicativo, e ele é oficial?

Na loja de aplicativos do Microsoft Teams, publicado pela Reviewflowz, e também no Microsoft AppSource (ID do aplicativo WA200010592). Possui uma listagem de conformidade de aplicativos Microsoft 365 disponível para revisão.

Ele precisa de aprovação do administrador?

O aplicativo instala-se como qualquer app do Teams. Se sua organização restringe instalações de apps, um administrador aprova no centro de administração do Teams, seja para um time específico ou para toda a organização.

O que o aplicativo pode ver e fazer?

Funciona apenas dentro do canal em que foi adicionado. Posta notificações de avaliações e relatórios, e lê as respostas e tags que sua equipe insere nesses cards. Não utiliza o Microsoft Graph e não tem acesso a emails, arquivos, chats ou ao diretório.

Ele armazena nossos dados do Microsoft ou Teams?

Não. A lista de conformidade de aplicativos da Microsoft confirma que o app não processa ou armazena dados de clientes Microsoft. O Reviewflowz armazena apenas o necessário para alcançar seu canal, como identificadores de canal e conversa, que são criptografados.

Como ele autentica?

Através do Bot Framework da Microsoft usando credenciais OAuth 2.0. Os tokens são emitidos pela Microsoft e têm curta duração. Solicitações vindas do Teams são verificadas criptograficamente antes do Reviewflowz agir sobre elas.

Precisamos colar um webhook ou compartilhar credenciais?

Não. Não há URL de webhook e nada para copiar. O vínculo acontece através da transferência de login.

Podemos removê-lo?

Sim, a qualquer momento. Digite desconectar para o bot, remova o aplicativo do canal ou remova-o em nível organizacional do centro de administração. As notificações param imediatamente.

Onde nossos dados são processados, e você é compatível com o GDPR?

O Reviewflowz é uma empresa sediada na França (UE) e opera de acordo com o GDPR. Publica uma política de privacidade e termos de serviço e pode excluir dados pessoais mediante solicitação. A integração não armazena conteúdo do Microsoft ou Teams. O tratamento de dados de avaliações está coberto pelo serviço principal do Reviewflowz e sua política de privacidade.

Canais diferentes podem receber avaliações diferentes?

Sim. Instale o aplicativo em cada canal e crie um alerta por canal. Os canais são mantidos separados.

Gerenciando e desconectando

Digite estes comandos no canal para o bot do Reviewflowz:

  • ajuda mostra o que o bot pode fazer.

  • link conecta, reconecta ou vincula uma conta diferente.

  • desconectar desvincula este canal da sua conta do Reviewflowz.

  • oi ou olá retorna o status da conexão.

Para parar as notificações, digite desconectar ou remova o aplicativo do canal. O bot confirma:

  • Título: Desconectado

  • Corpo: "Sua conta do Reviewflowz foi desconectada deste canal. Você não receberá mais notificações de avaliações aqui."

  • Sub-linha: "Para reconectar, digite link ou reinstale o aplicativo."

Para mudar o que é enviado, edite o alerta no Reviewflowz (perfis, frequência, filtro, tradução, respostas) a qualquer momento. Você não precisa mexer no Teams.

Resolução de problemas

  • Não consigo encontrar ou adicionar o aplicativo no Teams. Sua organização restringe instalações de aplicativos. Peça a um administrador para aprovar o aplicativo Reviewflowz e encaminhe este artigo para ele (o FAQ acima responde às perguntas deles).

  • Cliquei em Conectar sua conta, mas nada vinculou, ou ele me enviou para uma página de login. Você não estava logado no app.reviewflowz.com naquele navegador. Faça login, depois clique no botão novamente ou digite link para o bot para um novo botão.

  • Nenhum cartão de boas-vindas apareceu após a instalação. Certifique-se de que você adicionou o aplicativo a um canal, não apenas para você. Digite oi para o bot no canal para dar um empurrãozinho.

  • Conectado, mas nenhuma avaliação está chegando. Verifique se você criou e ativou um alerta com este canal do Teams como destino e pelo menos um perfil de avaliação selecionado.

  • O botão Responder ou Marcar está faltando. Responder aparece apenas quando Permitir respostas está em Sim no alerta e a plataforma suporta respostas (Google Maps, App Store, Play Store, Trustpilot, Facebook, com essa conexão configurada). Marcar aparece uma vez que você criou tags no Reviewflowz.

  • Ainda com problemas? Entre em contato com o suporte a partir do chat em seu painel do Reviewflowz.

Recursos relacionados

Isto respondeu à sua pergunta?