> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Avaliações

> Micro-pesquisas no seu site: NPS, nota, escolha e texto livre, com resultados por segmento e leitura das respostas por IA

O módulo **Avaliações** mostra micro-pesquisas no seu site, num card pequeno que abre na hora em que a pessoa está navegando: ao entrar numa página, ao clicar num botão ou quando ela está de saída. Você monta as perguntas no painel, escolhe onde e quando o card aparece e acompanha as respostas numa tela de resultados, com NPS, médias, distribuição por opção, filtro por perfil de quem respondeu e uma leitura das respostas feita por IA.

> [!NOTE]
>
> Módulo opcional — fale com a OctaSend para ativar. Sem ele, o item **Avaliações** não aparece no menu e o endereço da tela mostra "Módulo não liberado".

> [!TIP]
>
> Não confunda com as [Avaliações de produtos](https://docs.octasend.com.br/plataforma/avaliacoes-de-produtos.md), que são as notas e comentários dos seus clientes sobre os produtos da loja. Aqui são pesquisas que você faz com quem visita o site.

## Antes de começar

* **Tag instalada.** O card aparece no site pela tag do OctaSend, a mesma que carrega os Tours e os outros módulos. Para as Avaliações, a tag basta: não há nenhum outro código para colar. Veja [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md) ou **Configurações → Instalação**.
* **Domínios autorizados.** Se a conta tem uma lista de domínios autorizados, o card só aparece nos domínios dela. Com a lista vazia, aparece em qualquer site. A lista é a mesma de todos os widgets e fica em **Configurações → Instalação**.
* **Onde fica.** Menu lateral **Avaliações**. A tela se chama **Pesquisas**.
* **Quem pode usar.** Qualquer usuário com acesso ao painel da conta pode criar, editar, publicar e analisar pesquisas.

## Do rascunho ao site

**1. Criar a pesquisa**

Em **Avaliações**, clique em **Nova pesquisa**, dê um título, diga em quais páginas ela aparece e quando o card abre. A pesquisa nasce como **Rascunho**.

**2. Montar as perguntas**

Na aba **Perguntas** do editor, adicione as perguntas, escolha o tipo de cada uma e clique em **Salvar**.

**3. Ajustar o gatilho**

Na aba **Gatilho**, refine as páginas, a espera, a frequência, a posição do card e, se quiser, os campos de contexto.

**4. Marcar como publicada**

Em **Dados da pesquisa**, mude a **Situação** para **Publicada** e clique em **Salvar**.

**5. Publicar**

Volte para a lista e clique em **Publicar**. Só a partir daqui a pesquisa vai para o site.

**6. Acompanhar**

Abra a aba **Resultados** da pesquisa para ver os números, as respostas e a análise por IA.

## A lista de pesquisas

O topo da tela mostra o que está no ar: **"No ar: versão N, publicada em …"**, ou **"Nada no ar ainda"** se a conta nunca publicou. Cada linha da tabela abre o editor da pesquisa.

| Coluna | O que mostra |
| - | - |
| **Título** | Nome da pesquisa. |
| **Quando abre** | Ao abrir a página, Ao clicar ou Ao sair da página. |
| **Repetição** | Uma vez por pessoa, Toda visita ou "Com intervalo de N dias". |
| **Páginas** | O padrão de páginas onde a pesquisa aparece. |
| **Respostas** | Total de respostas recebidas. |
| **Situação** | Rascunho, Publicada ou Arquivada. |
| **No ar** | **Em dia** quando a última publicação já inclui as alterações da pesquisa; **Alterações não publicadas** quando ela foi editada depois disso. |
| **Ações** | Ícones de **Editar** e **Resultados**. |

## Criar uma pesquisa

Em **Avaliações → Nova pesquisa**:

* **Título** — obrigatório. Identifica a pesquisa no painel. No card, quem responde vê o título de cada pergunta.
* **Páginas onde aparece** — caminho da página, sem o domínio. Vem preenchido com `*`, que vale para o site inteiro. As regras estão em *Páginas*, mais abaixo.
* **Quando o card abre** — **Ao abrir a página**, **Ao clicar em um elemento** ou **Ao sair da página**.
* **Elemento que abre a pesquisa** — só no gatilho por clique, e aí é obrigatório: o seletor CSS do botão ou link do seu site (ex.: `#finalizar-compra`).

O botão **Criar pesquisa** só fica ativo com título preenchido, padrão de páginas válido e, no gatilho por clique, o elemento informado. Ao criar, o editor abre para você montar as perguntas.

## O editor

No topo ficam o botão **Salvar** e o bloco **Dados da pesquisa**, com o **Título** e a **Situação**. Abaixo, três abas: **Perguntas**, **Gatilho** e **Resultados**.

**Salvar** grava tudo de uma vez — dados da pesquisa, gatilho, campos de contexto e todas as perguntas. Ou grava tudo, ou não grava nada e a tela avisa; não existe pesquisa salva pela metade.

Enquanto você edita, o quadro **Corrija antes de publicar** lista o que impediria a publicação (título vazio, opção faltando, número fora da faixa etc.). Você pode salvar com a maioria dos avisos pendentes, e a publicação recusa a pesquisa até que eles sejam resolvidos. Duas exceções: no gatilho por clique, o **Salvar** só funciona com o elemento que dispara preenchido; e uma espera ou um intervalo fora da faixa não é gravado (fica valendo o valor anterior) até ser corrigido.

## Perguntas

Na aba **Perguntas**, a coluna da esquerda lista as perguntas na ordem em que aparecem no card, com botões para subir, descer e remover. Clique numa pergunta para editá-la à direita. **Adicionar pergunta** cria uma nova no fim da lista, do tipo **Nota por estrelas**, com o título "Nova pergunta" e marcada como obrigatória.

> [!WARNING]
>
> **Adicionar, remover e reordenar perguntas é gravado na hora** e recarrega a lista — edições ainda não salvas nas perguntas se perdem. Salve antes. Remover uma pergunta é imediato, sem confirmação, e **apaga também as respostas que ela já recebeu**.

Toda pergunta tem:

* **Tipo** — veja a tabela abaixo.
* **Título** — obrigatório, até 500 caracteres. É o texto em destaque no card.
* **Descrição (opcional)** — até 500 caracteres, aparece abaixo do título.
* **Resposta obrigatória** — o botão de avançar só libera depois que a pessoa responde.

Título e descrição aceitam `**negrito**` e `*itálico*`.

### Tipos de pergunta

| Tipo | Como aparece no card | O que você configura |
| - | - | - |
| **Nota por estrelas** | Uma estrela por ponto da escala. Com a aparência **Carinhas**, cinco carinhas, da mais triste à mais feliz. | **Aparência da nota** (Estrelas ou Carinhas), **Menor valor da escala** e **Maior valor da escala**. Em branco: 1 a 5. Com Carinhas, a escala fica travada em 1 a 5. |
| **NPS, de 0 a 10** | Um botão numerado por ponto da escala, com os rótulos das pontas embaixo. | Escala (em branco: 0 a 10), **Rótulo do menor valor** e **Rótulo do maior valor** (ex.: "Nada provável" e "Muito provável"), até 200 caracteres cada. |
| **Escolha única** | Um botão por opção; a pessoa marca uma. | **Opções**: pelo menos uma preenchida, no máximo 50, até 200 caracteres cada. |
| **Múltipla escolha** | Uma caixa de seleção por opção; a pessoa marca várias. | **Opções**, com as mesmas regras da escolha única. |
| **Texto livre** | Um campo de texto. | **Texto de ajuda no campo** (o texto de exemplo dentro da caixa), até 200 caracteres. |

A escala de estrelas e de NPS aceita valores inteiros de 0 a 100, e o menor valor precisa ser menor que o maior.

> [!WARNING]
>
> Mantenha a escala padrão de 0 a 10 nas perguntas de NPS. O score da tela de resultados usa sempre as faixas clássicas — detratores de 0 a 6, neutros 7 e 8, promotores 9 e 10 — e deixa de fazer sentido numa escala diferente.

> [!TIP]
>
> Cada resposta guarda o valor escolhido naquele momento — no caso das escolhas, o texto da opção. Se você renomear uma opção depois que a pesquisa já recebeu respostas, as antigas continuam contadas com o nome antigo.

## Gatilho: onde e quando o card aparece

A aba **Gatilho** tem dois blocos: **Onde e quando aparece** e **Campos de contexto**.

### Páginas

**Páginas onde aparece** compara só o caminho da página — sem domínio, sem parâmetros (`?…`) e sem âncora (`#…`). A barra no fim é ignorada.

| Padrão | Vale para |
| - | - |
| `*` | O site inteiro. |
| `/checkout` | Só `/checkout`. |
| `/checkout/*` | `/checkout` e tudo abaixo dele: `/checkout/pagamento`, `/checkout/a/b`. |
| `/produtos/*/avaliar` | `/produtos/camiseta/avaliar`, mas não `/produtos/a/b/avaliar` — o `*` no meio vale para um único trecho entre barras. |

O padrão aceita no máximo 5 asteriscos e 200 caracteres.

### Nome da rota (opcional)

Se preenchido, **tem prioridade sobre as páginas**: a pesquisa só aparece quando o seu site avisar esse nome exato, com `window.octasendTours.setRoute('nome')`. É o mesmo recurso usado nos [Tours](https://docs.octasend.com.br/plataforma/tours.md), útil quando a tela muda sem o endereço mudar. Até 200 caracteres. Em branco, vale o padrão de páginas.

### Quando o card abre

| Gatilho | Quando abre |
| - | - |
| **Ao abrir a página** | Assim que a página que casa com o padrão carrega. Em sites de página única (SPA), a troca de rota também conta. |
| **Ao clicar num elemento** | Quando a pessoa clica no elemento indicado em **Elemento que dispara** (seletor CSS) ou em algo dentro dele. O clique continua funcionando normalmente no seu site. |
| **Quando a pessoa vai sair** | Quando o ponteiro do mouse sai pelo topo da janela, em direção às abas ou à barra de endereço, ou quando a pessoa troca de aba ou minimiza o navegador. |

**Espera antes de aparecer (ms)** atrasa a abertura em qualquer gatilho, de 0 a 60.000 milissegundos (até 1 minuto). Ao fim da espera, a pesquisa confere de novo se ainda pode aparecer — se a pessoa mudou de página ou um tour abriu nesse meio-tempo, o card não abre.

> [!TIP]
>
> No gatilho por clique, prefira elementos que não levam para outra página. Se o clique navegar para um endereço fora do padrão da pesquisa, o card fecha junto com a navegação.

### Frequência

Em **Com que frequência**:

| Opção | Comportamento |
| - | - |
| **Uma vez por pessoa** | Depois que a pessoa responde ou fecha o card, ele não aparece mais para ela. |
| **Toda visita** | Aparece sempre que o gatilho acontece, mesmo para quem já respondeu. |
| **Com intervalo entre convites** | Quem respondeu não é convidado de novo. Quem fechou sem responder volta a ver depois do intervalo definido em **Intervalo entre convites (dias)**, de 1 a 3.650 dias (padrão: 30). |

Conta como **fechar sem responder**: clicar no X do card; em sites de página única (SPA), trocar para uma rota fora do padrão da pesquisa com o card aberto; ou clicar em **Enviar** sem ter respondido nenhuma pergunta (quando todas são opcionais).

> [!NOTE]
>
> A frequência é controlada no navegador de quem visita. A mesma pessoa em outro aparelho, em outro navegador ou depois de limpar os dados de navegação pode ver a pesquisa de novo.

### Posição e convivência com os Tours

**Onde o card abre**: canto inferior direito (padrão), inferior esquerdo, superior direito, superior esquerdo ou centro da tela.

* Só um card de pesquisa fica na tela por vez.
* O card não abre enquanto um [tour](https://docs.octasend.com.br/plataforma/tours.md) nos formatos Passo a passo, Destaque único ou Boas-vindas estiver aberto na página, e esses tours não abrem sozinhos enquanto o card estiver na tela.

## Campos de contexto

Campos de contexto anexam a cada resposta informações sobre quem respondeu — plano, tipo de conta, e-mail, SKU do produto. O valor aparece junto de cada resposta e vira **filtro** na tela de resultados.

Na aba **Gatilho → Campos de contexto**, clique em **Adicionar campo de contexto** e preencha:

* **Nome** — letras, números e `_`, começando por letra ou `_` (ex.: `plano`, `tipo_conta`). Sem repetição na mesma pesquisa.
* **Seletor (opcional)** — define de onde vem o valor:
  * **Sem seletor**: o valor é lido do objeto `window.OCTASEND_CONTEXT`, que o seu site declara, no momento em que o card abre.
  * **Com seletor**: o valor é lido da própria tela — o texto do elemento, ou o conteúdo dele, se for um campo de formulário. O valor lido fica guardado enquanto a pessoa navega, então um dado que aparece numa página pode ir junto com a resposta dada em outra. Entre carregamentos completos de página, isso só acontece quando o site identifica quem está navegando (veja *Identificar quem está navegando* em [Tours](https://docs.octasend.com.br/plataforma/tours.md)); sem identificação, o valor se perde a cada carregamento completo de página. Se o elemento não for encontrado, vale o que estiver em `window.OCTASEND_CONTEXT` com o mesmo nome.

Exemplo de como o site declara o objeto, antes de a pesquisa abrir:

```html theme={null}
<script>
  window.OCTASEND_CONTEXT = {
    plano: 'pro',
    tipo_conta: 'empresa'
  };
</script>
```

Regras:

* No máximo 20 campos por pesquisa.
* Só entram textos e números; valores vazios, verdadeiro/falso, listas e objetos são ignorados. Cada valor é cortado em 500 caracteres.
* Só os nomes configurados na pesquisa são gravados — o resto do objeto é descartado.

> [!WARNING]
>
> Campos de contexto podem conter dados pessoais de quem responde (como e-mail). Eles ficam guardados com a resposta e aparecem para quem tem acesso ao painel, mas **nunca são enviados para a análise por IA**. Colete só o que você realmente vai usar para segmentar.

### Descobrir os campos sem sair do editor

Cada linha de campo tem dois botões que buscam a informação direto no seu site:

* **Descobrir chaves** — traz os **nomes** dos campos que o seu site declara em `window.OCTASEND_CONTEXT` (até 50). Só os nomes voltam para o painel, nunca os valores. Você escolhe qual nome vai naquela linha.
* **Escolher na tela** — você clica no elemento que mostra o valor e o seletor dele volta para o campo **Seletor**. Precisa do **Nome** preenchido antes.

**1. Gerar o link**

Clique no botão e informe o **Endereço do seu site** — uma página onde a pesquisa aparece (ex.: `minhaloja.com.br/checkout`). O painel monta o link; use **Copiar link**.

**2. Abrir no seu site**

Abra o link numa aba. Em **Descobrir chaves**, os nomes são enviados sozinhos; em **Escolher na tela**, clique no elemento desejado.

**3. Aplicar e salvar**

Volte ao painel: o resultado aparece na linha. Escolha a chave ou clique em **Usar este seletor** e depois em **Salvar** — o campo só é gravado quando você salva a pesquisa.

* O link vale por **15 minutos** e funciona **uma única vez**. Expirou ou não trouxe nada? Use **Gerar novo link**.
* Só uma busca por vez na tela; **Cancelar captura** encerra a que está em andamento.
* A tag do OctaSend precisa estar instalada na página que você abrir. Se nada voltar, ou a tag não está naquela página, ou o objeto `window.OCTASEND_CONTEXT` está vazio, ou — em **Escolher na tela** — não foi possível montar um seletor estável para o elemento (prefira um que tenha identificador próprio).

## Situação e publicação

| Situação | Significado |
| - | - |
| **Rascunho** | Em construção. Não vai para o site. |
| **Publicada** | Entra na próxima publicação. |
| **Arquivada** | Fora de uso. Não vai para o site. |

Salvar a pesquisa **não muda o site**. O que vai ao ar é definido pelo botão **Publicar**, na lista de pesquisas:

* Cada publicação gera uma **versão** numerada ("Versão N publicada"), e o site passa a receber a mais recente.
* Publicar leva ao site **todas** as pesquisas com Situação **Publicada** e, se a conta também usa o módulo, todos os [tours](https://docs.octasend.com.br/plataforma/tours.md) publicados — juntos, numa versão só.
* A publicação é tudo ou nada: se uma pesquisa ou um tour tiver problema, **nada** é publicado e a lista aparece na tela em **Corrija antes de publicar**. Um tour com erro também segura a publicação das pesquisas.
* Rascunhos e arquivadas não são conferidos nem publicados.

> [accordion] O que impede a publicação de uma pesquisa
>
> * Padrão de páginas vazio, com mais de 5 asteriscos ou com mais de 200 caracteres.
> * Nome da rota com mais de 200 caracteres.
> * Gatilho por clique sem o elemento que dispara.
> * Espera fora de 0 a 60.000 ms, ou intervalo entre convites fora de 1 a 3.650 dias.
> * Campo de contexto sem nome, com nome inválido ou repetido, ou mais de 20 campos.
> * Pesquisa sem nenhuma pergunta.
> * Pergunta sem título, ou com título ou descrição acima de 500 caracteres.
> * Opção, rótulo da escala ou texto de ajuda acima de 200 caracteres.
> * Pergunta de escolha sem nenhuma opção preenchida, ou com mais de 50 opções.
> * Escala com valor que não é inteiro entre 0 e 100, ou com o menor valor igual ou maior que o maior.
> * Tudo o que é publicado (tours e pesquisas da conta) acima de 300 KB.

> [accordion] Mensagens de erro ao publicar
>
> * **Há itens a corrigir antes de publicar** — a lista aparece na tela, em *Corrija antes de publicar*.
> * **Outra publicação aconteceu ao mesmo tempo. Publique de novo.** — duas publicações simultâneas; basta publicar outra vez.
> * **Esta conta não tem acesso às Avaliações.** — o módulo não está ativo na conta.
> * **Não foi possível publicar. Tente novamente.** — falha temporária.

### Tirar uma pesquisa do ar

Mude a **Situação** para **Rascunho** ou **Arquivada**, clique em **Salvar** e depois em **Publicar** na lista. Só salvar não tira a pesquisa do site. O painel não tem botão de excluir pesquisa — use **Arquivada** para as que não vai mais usar. As respostas já recebidas continuam na aba **Resultados**.

## O que o visitante vê

* Um card com **uma pergunta por vez**, o título e a descrição da pergunta e, quando há mais de uma, o contador ("1 de 3").
* O botão **Avançar** entre as perguntas e **Enviar** na última. Em pergunta obrigatória, o botão só libera depois da resposta.
* Um **X** para fechar sem responder.
* Ao enviar, o card fecha. Perguntas opcionais que a pessoa pulou ficam sem resposta.

### Aparência

O card tem visual próprio, que não interfere no do seu site. Se a sua conta também tem o módulo Tours, ele herda parte da aparência definida em **Tours → Configuração → Aparência padrão**:

| Campo da aparência dos Tours | No card da pesquisa |
| - | - |
| **Fundo do balão** | Cor de fundo do card. |
| **Título do balão** (ou **Texto do balão**, se o título estiver em branco) | Cor do texto do card. |
| **Arredondamento do recorte** | Arredondamento dos cantos do card. |
| **Texto do botão Próximo** | Substitui "Avançar". |
| **Texto do botão Concluir** | Substitui "Enviar". |

A aparência entra no site na próxima publicação: depois de mudá-la, clique em **Publicar**.

## Resultados

Abra pelo ícone **Resultados** na lista ou pela aba **Resultados** do editor.

### Números do topo

| Indicador | O que mede |
| - | - |
| **Visualizações** | Visitantes diferentes que viram o card — contados por navegador ou, quando o site identifica quem está navegando, por pessoa. |
| **Respostas** | Total de respostas enviadas. |
| **Taxa de resposta** | Respostas divididas por visualizações, em %. |
| **Última resposta** | Data e hora da resposta mais recente. |

### Filtrar por contexto

Se a pesquisa tem campos de contexto, aparece **Filtrar respostas por contexto**: escolha o campo, digite o **valor exato** e clique em **Filtrar**. O filtro vale para a página inteira — números do topo, distribuição de cada pergunta e lista de respostas. **Limpar filtro** volta a mostrar tudo.

Com filtro ativo, **Visualizações** continua mostrando o total (visualização não tem contexto) e a **Taxa de resposta** sai da tela, porque não haveria como calculá-la só para o segmento.

### Por pergunta

| Tipo | O que aparece |
| - | - |
| **NPS** | O **Score NPS** (percentual de promotores menos percentual de detratores) e as barras de **Promotores (9–10)**, **Neutros (7–8)** e **Detratores (0–6)**, com quantidade e percentual. |
| **Nota** | A **Média**, com uma casa decimal, e a distribuição da maior nota para a menor. |
| **Escolha única** e **Escolha múltipla** | Uma barra por opção, da mais escolhida para a menos. Na múltipla, o percentual é sobre o total de marcações. |
| **Texto livre** | Os textos escritos, com data e hora, das respostas já carregadas na lista abaixo. |

Pergunta que ninguém respondeu mostra "Ninguém respondeu esta pergunta ainda."

### Lista de respostas

A seção **Respostas** mostra cada resposta individual, da mais recente para a mais antiga, 50 por vez (**Carregar mais respostas** traz as seguintes). Cada uma traz:

* data e hora do envio e o idioma detectado para quem respondeu (pt, en ou es);
* os campos de contexto e o endereço da página onde a pessoa respondeu;
* a resposta de cada pergunta — "—" quando ela pulou a pergunta ou quando a pergunta foi criada depois daquela resposta.

Sem nenhuma resposta, a tela avisa: com a pesquisa publicada, que os números aparecem assim que alguém responder; nas demais situações, que é preciso publicá-la.

## Análise por IA

O bloco **Análise** lê as respostas da pesquisa e escreve, em português, o que elas estão dizendo: um resumo geral e uma **Leitura da IA** curta embaixo de cada pergunta.

* Clique em **Analisar com IA**. A análise leva alguns segundos; a tela mostra "Lendo as respostas e escrevendo a análise".
* A análise **consome tokens de IA da conta**. O limite de tokens é conferido antes de chamar a IA.
* Há **uma análise por pesquisa**. **Analisar de novo** substitui a anterior.
* O cabeçalho mostra o modelo usado, a data e quantas respostas foram lidas. Se chegaram respostas depois, a tela avisa "Chegaram N respostas depois desta análise".
* A análise lê **todas** as respostas da pesquisa, mesmo com filtro ativo na tela.
* Entram na análise as contagens de cada pergunta e, nas perguntas de texto livre, até os 300 textos mais recentes. Campos de contexto, endereço da página e identificação do visitante **não** são enviados.
* O bloco aparece quando a pesquisa já tem respostas ou uma análise anterior.

| Mensagem | O que fazer |
| - | - |
| Ainda não há respostas para analisar. | Espere as primeiras respostas. |
| A conta chegou ao limite de tokens de IA. A análise volta a funcionar quando o limite for renovado ou ampliado. | Aguarde a renovação ou fale com a OctaSend para ampliar o limite. |
| O provedor de IA não respondeu. Tente de novo em instantes. | Tente de novo. |

## Como as respostas são registradas

* Só são aceitas respostas de pesquisas que estão na **versão publicada atual**. Depois que uma pesquisa sai do ar, respostas de visitantes com a página antiga aberta são descartadas.
* Cada resposta é conferida contra a pesquisa publicada: nota fora da escala, opção que não existe e texto vazio são descartados; o resto da resposta é gravado. Um envio sem nenhuma resposta válida não é registrado.
* Texto livre é gravado com até 2.000 caracteres; o excedente é cortado. Na múltipla escolha, valem até 20 marcações.
* A mesma pessoa pode responder mais de uma vez quando a frequência permite — cada envio conta como uma resposta.
* Há um limite de envios por minuto, como proteção contra abuso. Envios acima dele são descartados sem aviso para o visitante.
* Se o módulo for desativado na conta, as pesquisas deixam de aparecer no site e novas respostas não são registradas.

## Limites

| Item | Limite |
| - | - |
| Padrão de páginas | 5 asteriscos e 200 caracteres |
| Nome da rota | 200 caracteres |
| Espera antes de aparecer | 0 a 60.000 ms |
| Intervalo entre convites | 1 a 3.650 dias (padrão: 30) |
| Campos de contexto por pesquisa | 20 |
| Valor de um campo de contexto | 500 caracteres |
| Título e descrição da pergunta | 500 caracteres cada |
| Opção, rótulo da escala e texto de ajuda | 200 caracteres cada |
| Opções por pergunta de escolha | 50 |
| Escala de nota e NPS | Inteiros de 0 a 100 |
| Resposta de texto livre | 2.000 caracteres |
| Marcações gravadas na múltipla escolha | 20 |
| Tudo o que é publicado (tours e pesquisas da conta) | 300 KB |
| Link de descoberta de campos | 15 minutos, uso único |
| Nomes trazidos por "Descobrir chaves" | 50 |
| Textos por pergunta lidos pela análise por IA | 300 mais recentes |

## Problemas comuns

> [accordion] A pesquisa não aparece no site
>
> * Confira se a Situação é **Publicada** e se a coluna **No ar** mostra **Em dia**. Se mostra **Alterações não publicadas**, clique em **Publicar**.
> * Confira **Páginas onde aparece**: o padrão compara só o caminho, sem domínio. Se há **Nome da rota**, a pesquisa só aparece quando o site chamar `setRoute` com esse nome.
> * Com **Uma vez por pessoa**, quem já viu o card não o vê de novo naquele navegador — teste numa janela anônima.
> * Um tour Passo a passo, Destaque único ou Boas-vindas aberto na página segura o card até terminar.
> * Confira se a tag do OctaSend está instalada naquela página e se o domínio está na lista de domínios autorizados (ou se a lista está vazia).

> [accordion] O gatilho por clique não dispara
>
> O seletor em **Elemento que dispara** precisa corresponder ao elemento clicado ou a um que o contenha. Um seletor inválido não quebra o site: a pesquisa apenas nunca dispara.

> [accordion] Os campos de contexto chegam vazios
>
> Sem seletor, o site precisa declarar `window.OCTASEND_CONTEXT` com aquele nome antes de o card abrir. Com seletor, o elemento precisa existir e ter texto em alguma página visitada. Valores que não são texto nem número são ignorados.

> [accordion] Perdi as edições de uma pergunta
>
> Adicionar, remover ou reordenar perguntas recarrega a lista e descarta o que não foi salvo. Clique em **Salvar** antes de mexer na lista.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.