> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/atendimento/pesquisa-de-satisfacao.md).

# Pesquisa de satisfação

## ⭐ Pesquisa de Satisfação

O módulo **Pesquisa de Satisfação** envia, dentro do fluxo, uma pesquisa de satisfação (NPS) já cadastrada no Hyperflow Conversas, vinculada a um departamento e a um protocolo de atendimento. É útil para automatizar o envio da pesquisa logo após o fim de um atendimento, sem depender de uma ação manual do agente.

<figure><img src="/files/uIH8eM2FpFibco0HyD7H" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Pesquisa de Satisfação na área de trabalho do fluxo.</p></figcaption></figure>

***

### 🧭 Como acessar

1. No menu lateral, clique em **Gerenciamento de aplicativos**.
2. Em seguida, clique em **Fluxos**.
3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
4. No painel de módulos, localize a categoria **Atendimento** (identificada pela cor laranja).
5. Arraste o módulo **Pesquisa de Satisfação** para a área de trabalho do fluxo.

<figure><img src="/files/pD09kQD3g2BeDP9DeZ3H" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Atendimento expandida e o módulo Pesquisa de Satisfação visível.</p></figcaption></figure>

***

### 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

{% hint style="warning" %}
**Antes de usar este módulo:** é preciso ter uma conta do Hyperflow Conversas conectada a este aplicativo e já existir, nela, uma pesquisa de satisfação **ativa** cadastrada para o departamento que você vai usar. O cadastro da pesquisa é feito na tela de **Pesquisas**, dentro do Hyperflow Conversas — não é possível criar uma pesquisa a partir deste módulo. Cadastre a pesquisa por lá e depois volte a este módulo para selecioná-la.
{% endhint %}

<figure><img src="/files/06ZcTNrddOtdF5uqf0ES" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo Pesquisa de Satisfação aberto.</p></figcaption></figure>

***

#### 🏢 Departamento

No campo **Departamento**, selecione o departamento do Hyperflow Conversas ao qual a pesquisa está vinculada. A lista mostra os departamentos já cadastrados na sua conta.

Ao trocar o departamento selecionado, o campo **Pesquisa** (abaixo) é limpo automaticamente, já que as pesquisas disponíveis variam por departamento.

<figure><img src="/files/q7lSVPWGWP1xOaAHvWKe" alt=""><figcaption><p>Imagem 4 - Campo Departamento com a lista de departamentos disponíveis.</p></figcaption></figure>

***

#### 📋 Pesquisa

Depois de escolher o departamento, o campo **Pesquisa** exibe as pesquisas de satisfação ativas cadastradas para aquele departamento. Selecione a pesquisa que deve ser enviada.

{% hint style="info" %}
A lista mostra até 50 pesquisas ativas mais recentes do departamento selecionado. Se você não encontrar a pesquisa esperada, confirme na tela de **Pesquisas** do Hyperflow Conversas se ela está com o status **ativo**.
{% endhint %}

<figure><img src="/files/GJRs4geD8wb6v0qNMwG4" alt=""><figcaption><p>Imagem 5 - Campo Pesquisa preenchido após a seleção do departamento.</p></figcaption></figure>

***

#### 🔖 Protocolo

No campo **Protocolo**, informe o número do protocolo de atendimento ao qual a pesquisa será vinculada. Normalmente esse campo é preenchido com uma variável do fluxo que já contém o protocolo do atendimento em andamento (ex.: `{{attendance.protocol}}`).

<figure><img src="/files/rbiTPuIsr338J8S7wTFG" alt=""><figcaption><p>Imagem 6 - Campo Protocolo preenchido com uma variável do fluxo.</p></figcaption></figure>

***

#### 🔀 Saídas do módulo

O módulo tem uma saída para quando a pesquisa é enviada com sucesso, e outra usada quando ocorre algum erro no envio (por exemplo, se o departamento ou a pesquisa selecionada não existirem mais no Hyperflow Conversas no momento do envio). Conecte cada uma às próximas etapas do fluxo conforme o resultado esperado.

<figure><img src="/files/FYlW1c3EuVwW816EQbjM" alt=""><figcaption><p>Imagem 7 - Módulo na área de trabalho do fluxo mostrando as duas saídas disponíveis.</p></figcaption></figure>

***

### 💡 Caso de uso

**Cenário:** uma empresa quer enviar automaticamente uma pesquisa de satisfação para o cliente assim que um atendimento do departamento "Suporte" for finalizado.

**Configuração:**

1. No fluxo de finalização de atendimento, adicione o módulo **Pesquisa de Satisfação**.
2. No campo **Departamento**, selecione **Suporte**.
3. No campo **Pesquisa**, selecione a pesquisa de satisfação já cadastrada para esse departamento no Hyperflow Conversas.
4. No campo **Protocolo**, use a variável que contém o protocolo do atendimento atual, por exemplo `{{attendance.protocol}}`.
5. Conecte a saída de sucesso para uma mensagem de agradecimento, e a saída de erro para um aviso interno da equipe.

**Resultado:** ao final de cada atendimento do departamento Suporte, o cliente recebe automaticamente a pesquisa de satisfação vinculada ao protocolo daquele atendimento.

***

### 📌 Dicas úteis

* A pesquisa precisa ser cadastrada e ativada previamente na tela de **Pesquisas** do Hyperflow Conversas — o módulo só lista o que já existe lá.
* Sempre que trocar o departamento, confira se a pesquisa desejada continua selecionada, já que o campo é reiniciado automaticamente.
* Use uma variável de protocolo (em vez de digitar um valor fixo) para que a pesquisa seja sempre vinculada ao atendimento correto.
* Se a lista de pesquisas não mostrar o resultado esperado, verifique o status dela (precisa estar **ativa**) na tela de Pesquisas do Hyperflow Conversas.

***

### 📝 Resumo

* O módulo **Pesquisa de Satisfação** envia uma pesquisa de satisfação (NPS) já cadastrada no Hyperflow Conversas para um protocolo de atendimento.
* É obrigatório ter o Hyperflow Conversas conectado e uma pesquisa **ativa** cadastrada para o departamento escolhido — o cadastro é feito na tela de Pesquisas, fora do Hyperflow Integrações.
* Os campos principais são **Departamento**, **Pesquisa** e **Protocolo**.
* O módulo tem uma saída de sucesso e uma saída de erro, que podem ser conectadas a etapas diferentes do fluxo.