> For the complete documentation index, see [llms.txt](https://docs.flw.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flw.chat/guide/documentacao/apps/pesquisa-csat/como-configurar.md).
# Como Configurar
Depois de habilitar o aplicativo Pesquisa CSAT, o próximo passo é definir a pesquisa para cada canal de atendimento da sua conta. Este artigo mostra como criar, editar e excluir pesquisas, além de explicar as particularidades de cada tipo de canal.
## **Passo 1: Acessar a Configuração de Canais**
1. Em **Apps > Mais apps**, clique em **Configurar** no aplicativo **Pesquisa CSAT**.
2. No modal **Configuração – Pesquisa CSAT**, você verá a lista de todos os canais de atendimento cadastrados na conta.
3. Use o **campo de pesquisa** para localizar um canal específico pelo nome ou número.
4. Use o **filtro por tipo** para exibir apenas canais de um tipo específico: Todos, Dialog360, WhatsApp Cloud API, WhatsApp Z-API, WhatsApp EvolutionAPI, Instagram ou Messenger.
{% hint style="info" %}
As opções exibidas no filtro dependem dos canais efetivamente cadastrados na sua conta.
{% endhint %}
## **Passo 2: Entender os Status da Pesquisa**
Cada canal com pesquisa definida exibe um dos seguintes status:
| Status | O que significa |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| 🟢 **Ativo** | A pesquisa está habilitada e disponível para envio. Em canais oficiais, indica que o modelo de mensagem foi aprovado pela Meta. |
| ⚪ **Inativo** | A pesquisa foi desabilitada manualmente e não será mais enviada aos contatos. |
| 🟡 **Pendente** | A pesquisa foi enviada para aprovação da Meta e aguarda retorno. *(Apenas canais de API Oficial)* |
| 🔴 **Reprovado** | A pesquisa foi reprovada no processo de aprovação da Meta e precisa ser corrigida. *(Apenas canais de API Oficial)* |
{% hint style="info" %}
API Oficial: Quando uma pesquisa já **Ativa** recebe uma edição, um tooltip aparece ao lado do status: amarelo se a edição estiver **pendente** de aprovação, ou vermelho se tiver sido **reprovada**. Assim que a edição for aprovada, o tooltip desaparece e o status permanece Ativo.
{% endhint %}
## **Criando uma Pesquisa — Canais de API Oficial**
1. No modal de Configuração, clique no ícone de edição de um canal sem pesquisa definida.
2. Preencha os campos do modal **CSAT**:
* **Nome da pesquisa** (obrigatório)
* Flag **Situação** (ativada por padrão)
* **Equipes**: define em quais equipes o envio da pesquisa será considerado. O contato só recebe a pesquisa quando o atendimento for finalizado por uma das equipes selecionadas. Por padrão, vem selecionada a opção **"Todas as equipes"**.
* **Mensagem** (obrigatória, já vem preenchida com uma sugestão editável)
* **Mensagem de rodapé** (opcional)
* **Mensagem do botão** (obrigatória, já preenchida com **"Responder pesquisa"**)
* Tipo de representação da avaliação: **Humor** (padrão), **Emoji** ou **Estrelas**
3. Acompanhe a **prévia da mensagem** no lado direito do modal, que mostra exatamente como o contato receberá a pesquisa.
4. Clique em **Salvar**.
{% hint style="warning" %}
Como o envio em canais oficiais depende de um modelo de mensagem, ao salvar você verá um aviso informando que o modelo será enviado para aprovação da Meta. Até a aprovação, a pesquisa fica com status **Pendente**.
{% endhint %}
## **Editando uma Pesquisa — Canais de API Oficial**
1. No modal de Configuração, clique no ícone de edição de um canal que já possui pesquisa.
2. Você verá o canal, o nome da pesquisa, a situação, equipes e a mensagem atual com seu status.
3. Clique em **Editar detalhes** para alterar os campos (nome, situação, mensagem, rodapé, texto do botão e representação visual).
4. Ao salvar, o modelo também é enviado para nova aprovação da Meta.
Enquanto a edição estiver pendente, o modal exibe **as duas versões** (a original aprovada e a editada, com seu status) e o aviso: *"Enquanto a alteração estiver pendente, a pesquisa aprovada continuará sendo utilizada até que a nova versão seja aprovada."* Após a aprovação, apenas a versão final permanece visível.
## **Criando uma Pesquisa — Instagram e Messenger**
Esses canais não dependem de aprovação da Meta, então a pesquisa fica disponível para envio imediatamente após salvar.
1. No modal de Configuração, clique no ícone de edição de um canal Instagram ou Messenger sem pesquisa definida.
2. Preencha os campos do modal **CSAT**:
* **Nome da pesquisa** (obrigatório)
* Flag **Situação** (ativada por padrão)
* **Equipes**: define em quais equipes o envio da pesquisa será considerado. O contato só recebe a pesquisa quando o atendimento for finalizado por uma das equipes selecionadas. Por padrão, vem selecionada a opção **"Todas as equipes"**.
* **Mensagem** (obrigatória)
* Tipo de representação da avaliação: **Humor** (padrão), **Emoji** ou **Estrelas**
3. Acompanhe a **prévia da mensagem** no lado direito do modal.
4. Clique em **Salvar**. O botão só é habilitado depois que todos os campos obrigatórios forem preenchidos.
Como não há aprovação externa envolvida, a pesquisa fica com status **Ativo** imediatamente após salvar.
## **Editando uma Pesquisa — Instagram e Messenger**
1. No modal de Configuração, clique no ícone de edição de um canal Instagram ou Messenger que já possui pesquisa.
2. Você verá o canal, o nome da pesquisa, a situação, as equipes e a representação da pesquisa com seu status.
3. Clique em **Editar detalhes** para alterar os campos (nome, situação, equipes, mensagem e representação visual).
4. Os campos vêm carregados com os dados atualmente cadastrados e podem ser alterados livremente.
5. Clique em **Salvar** para concluir a edição.
## **Criando uma Pesquisa — Z-API, 360 Dialog e Evolution API**
Esses canais não dependem de aprovação da Meta, então a pesquisa fica disponível para envio imediatamente após salvar.
1. No modal de Configuração, clique no ícone de edição de um canal Z-API, 360 Dialog ou Evolution API sem pesquisa definida.
2. Preencha os campos do modal **CSAT**:
* **Nome da pesquisa** (obrigatório)
* Flag **Situação** (ativada por padrão)
* **Equipes**: define em quais equipes o envio da pesquisa será considerado. O contato só recebe a pesquisa quando o atendimento for finalizado por uma das equipes selecionadas. Por padrão, vem selecionada a opção **"Todas as equipes"**.
* **Mensagem** (obrigatória)
* **Mensagem de rodapé** (opcional)
* Tipo de representação da avaliação: **Humor** (padrão), **Emoji** ou **Estrelas**
3. Acompanhe a **prévia da mensagem** no lado direito do modal.
4. Clique em **Salvar**. O botão só é habilitado depois que todos os campos obrigatórios forem preenchidos.
A pesquisa fica com status **Ativo** imediatamente após salvar, sem necessidade de aprovação.
## **Editando uma Pesquisa — Z-API, 360 Dialog e Evolution API**
1. No modal de Configuração, clique no ícone de edição de um canal Z-API, 360 Dialog ou Evolution API que já possui pesquisa.
2. Você verá o canal, o nome da pesquisa, a situação, equipes e a representação da pesquisa com seu status.
3. Clique em **Editar detalhes** para alterar os campos (nome, situação, equipes, mensagem, mensagem de rodapé e representação visual).
4. Os campos vêm carregados com os dados atualmente cadastrados e podem ser alterados livremente.
5. Clique em **Salvar** para concluir a edição.
## **Excluindo uma Pesquisa**
1. No modal **CSAT** de um canal com pesquisa já definida, clique em **Excluir**.
2. Confirme a exclusão no modal de confirmação.
3. Informe o **código OTP** solicitado e clique em **Continuar**.
4. A pesquisa será excluída e o canal voltará a exibir a opção **"Definir pesquisa"**.
{% hint style="warning" %}
Ao excluir uma pesquisa, o modelo de mensagem associado também é excluído automaticamente e deixa de aparecer na tela de **Modelos de Mensagem**.
{% endhint %}
Se você clicar em **Cancelar** durante a confirmação, a exclusão é abortada e nenhuma alteração é feita na pesquisa.
{% hint style="info" %}
Assim como na habilitação do aplicativo, a exclusão de uma pesquisa gera um registro de auditoria em **Auditoria > Histórico de Alterações**, associado à entidade **OTP de Validação**.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.flw.chat/guide/documentacao/apps/pesquisa-csat/como-configurar.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.