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

# Respostas Rápidas

A seção de **Respostas Rápidas** (Canned Responses) permite que você crie e gerencie respostas pré-definidas para acelerar o atendimento aos clientes. Com as respostas rápidas, você pode criar templates de mensagens que podem ser personalizadas com variáveis dinâmicas, como nome do contato, nome do agente e nome da conta.

Cada resposta rápida possui um código único identificador e um conteúdo que pode incluir variáveis dinâmicas que serão substituídas automaticamente quando a resposta for utilizada. As respostas rápidas também podem incluir anexos como imagens, áudios, vídeos e documentos.

## Acessando Respostas Rápidas

Para acessar a área de gerenciamento de respostas rápidas:

1. No menu lateral esquerdo, clique em **Settings** (Configurações).
2. Na lista de opções de configurações, selecione **Canned Responses** (Respostas Rápidas).

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/01-accessing-canned-responses.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=5c98bbdf341b013917176239fefb6b23" alt="Navegação para Respostas Rápidas - Item Canned Responses destacado no menu lateral e estado vazio" width="583" height="787" data-path="user-guides/settings/images/01-accessing-canned-responses.png" />

A tela principal de respostas rápidas será exibida, mostrando todas as respostas criadas ou uma mensagem indicando que nenhuma resposta foi criada ainda.

***

## Pesquisando Respostas Rápidas

A barra de pesquisa permite localizar respostas rápidas rapidamente pelo código ou pelo conteúdo.

### Como pesquisar

1. Na parte superior da tela, localize o campo **"Search by code or content..."** com o ícone de lupa
2. Digite o código ou parte do conteúdo da resposta desejada
3. A tabela de respostas será atualizada automaticamente conforme o termo digitado, mostrando apenas as respostas que correspondem à busca

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/04-canned-responses-search.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=7c74979742328ffa28b32593570a14fd" alt="Barra de pesquisa de respostas rápidas destacada com termo de busca digitado" width="700" height="327" data-path="user-guides/settings/images/04-canned-responses-search.png" />

A busca é realizada em tempo real, facilitando a localização de respostas específicas quando há muitas cadastradas.

***

## Criando uma Nova Resposta Rápida

Existem duas formas de iniciar a criação de uma nova resposta rápida:

### Opção 1: Botão no Cabeçalho

1. Clique no botão verde **"+ New Response"** localizado no canto superior direito da tela

### Opção 2: Botão no Estado Vazio

Quando não há respostas rápidas criadas, clique no botão verde **"New Response"** no centro da tela.

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/02-creating-canned-response.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=61d3b157d66eb3c65ecd3cddfe70d643" alt="Estado vazio de respostas rápidas com botões New Response destacados" width="1693" height="907" data-path="user-guides/settings/images/02-creating-canned-response.png" />

### Preenchendo o Formulário de Criação

Após clicar em qualquer um dos botões, um modal será exibido com fundo escuro contendo:

* **Título:** **"New Canned Response"** no topo do modal
* **Descrição:** "Create a new canned response to accelerate your customer's response." logo abaixo do título
* **Botão de Fechar:** Um ícone "X" no canto superior direito para fechar o modal sem salvar

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/03-canned-response-form.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=09d44cee8393acbc1f0bb51e8d32177f" alt="Modal de criação de nova resposta rápida com todos os campos destacados" width="700" height="722" data-path="user-guides/settings/images/03-canned-response-form.png" />

No formulário, preencha os seguintes campos:

#### 1. Código (Obrigatório)

* **Campo:** **Code** (marcado com asterisco `*` indicando campo obrigatório)
* **Tipo:** Campo de texto simples
* **Descrição:** Código único para identificar esta resposta
* **Texto de Ajuda:** "Unique code to identify this response. Use only letters, numbers, underscores and hyphens."
* **Regras:** Use apenas letras, números, underscores e hífens
* **Exemplo:** `ol_contactname_`, `greeting_message`, `follow-up-response`
* **Recomendação:** Use códigos descritivos e curtos que facilitem a identificação rápida da resposta
* **Localização:** Primeiro campo do formulário

#### 2. Conteúdo (Obrigatório)

* **Campo:** **Content** (marcado com asterisco `*` indicando campo obrigatório)
* **Tipo:** Área de texto (textarea) grande
* **Descrição:** Conteúdo da resposta que será enviada automaticamente
* **Texto de Ajuda:** "Content of the response that will be sent automatically."
* **Variáveis Dinâmicas:** Você pode usar variáveis entre chaves duplas `{{ }}` que serão substituídas automaticamente:
  * `{{contact.name}}` - Nome do contato
  * `{{agent.name}}` - Nome do agente
  * `{{account.name}}` - Nome da conta
  * `{{conversation.id}}` - ID da conversa
* **Exemplo:**
  ```
  Olá, {{contact.name}}!😊
  Sou {{agent.name}} da {{account.name}}.
  Recebemos sua mensagem e já vamos te ajudar.
  Pode me contar um pouco mais sobre o que você precisa?
  ```
* **Emojis:** Você pode incluir emojis no conteúdo da resposta
* **Localização:** Segundo campo do formulário, abaixo do campo Code

#### 3. Anexos (Opcional)

* **Campo:** **Attachments (Images, Audios, Videos, Documents)**
* **Tipo:** Upload de arquivos
* **Descrição:** Permite adicionar arquivos à resposta rápida
* **Botão:** **"Add File"** com ícone de clipe de papel
* **Limitações:**
  * Máximo de 10MB por arquivo
  * Formatos aceitos: imagens, áudios, vídeos, PDF, DOC
* **Uso:** Adicione arquivos que complementem a resposta, como imagens explicativas, documentos ou áudios
* **Localização:** Terceiro campo do formulário, abaixo do campo Content

#### 4. Variáveis Disponíveis

* **Seção:** **"Available Variables:"**
* **Tipo:** Caixa informativa com lista de variáveis
* **Descrição:** Lista todas as variáveis que podem ser usadas no campo Content
* **Variáveis Disponíveis:**
  * `{{contact.name}}` - Contact Name (Nome do Contato)
  * `{{agent.name}}` - Agent Name (Nome do Agente)
  * `{{conversation.id}}` - Conversation ID (ID da Conversa)
  * `{{account.name}}` - Account Name (Nome da Conta)
* **Uso:** Clique ou digite as variáveis diretamente no campo Content para personalizar a resposta
* **Localização:** Quarta seção do formulário, abaixo do campo de Anexos

### Finalizando a Criação

Na parte inferior do modal, há dois botões de ação:

* **Cancel:** Botão cinza escuro com texto branco, localizado à esquerda
* **Create:** Botão verde/turquesa brilhante com texto branco, localizado à direita

Após preencher os campos desejados:

1. Revise as informações inseridas, especialmente o código e o conteúdo
2. Verifique se as variáveis estão corretamente escritas (com chaves duplas `{{ }}`)
3. Se necessário, adicione anexos à resposta
4. Clique no botão verde **"Create"** para criar a resposta rápida
5. Ou clique em **"Cancel"** para fechar o modal sem salvar
6. Alternativamente, clique no ícone "X" no canto superior direito para fechar sem salvar

A resposta rápida será criada e aparecerá imediatamente na tabela de respostas rápidas.

***

## Visualizando Respostas Rápidas na Tabela

Após criar respostas rápidas, elas serão exibidas em uma tabela com as seguintes colunas:

### Colunas da Tabela

* **Checkbox:** Seleção individual ou em massa de respostas rápidas
* **Code:** Código único identificador da resposta rápida
  * Exibe o código definido durante a criação (ex: `ol_contactname_`)
  * O código pode ser clicável ou destacado visualmente
* **Content:** Conteúdo completo da resposta rápida
  * Exibe o texto completo da resposta, incluindo variáveis dinâmicas (ex: `Olá, {{contact.name}}!😊 Sou {{agent.name}} da {{account.name}}....`)
  * As variáveis são exibidas como estão escritas, com as chaves duplas
* **Created at:** Data de criação da resposta rápida
  * Exibe a data no formato DD/MM/AAAA (ex: "22/01/2026")
* **Actions:** Menu de ações para gerenciar a resposta rápida
  * Ícone de três pontos horizontais (`...`) que abre um menu dropdown com opções

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/04-canned-responses-table.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=f66c84f3072450ecf5fd5501b20b2f0c" alt="Tabela de respostas rápidas com menu de ações destacado - opções Edit e Delete" width="1441" height="378" data-path="user-guides/settings/images/04-canned-responses-table.png" />

### Funcionalidades da Tabela

* **Seleção Múltipla:** Use os checkboxes para selecionar múltiplas respostas rápidas e realizar ações em lote
* **Busca Integrada:** A barra de pesquisa acima da tabela filtra os resultados em tempo real por código ou conteúdo
* **Visualização Completa:** O conteúdo completo da resposta é exibido na tabela, facilitando a identificação rápida

***

## Editando uma Resposta Rápida

Para modificar uma resposta rápida existente:

1. Na tabela de respostas rápidas, localize a resposta que deseja editar
2. Na coluna **Actions**, clique no ícone de três pontos (`...`) correspondente à resposta
3. Um menu dropdown será exibido com as opções disponíveis

<img src="https://mintcdn.com/evoai-683d737d/bnShAIM0k-yuT_26/user-guides/settings/images/05-canned-response-actions-menu.png?fit=max&auto=format&n=bnShAIM0k-yuT_26&q=85&s=35d59d830e2102b3922742f90207f8a6" alt="Menu de ações da resposta rápida destacado - opções Edit e Delete" width="1435" height="420" data-path="user-guides/settings/images/05-canned-response-actions-menu.png" />

4. No menu dropdown, clique em **Edit** (acompanhado de um ícone de lápis)
5. Um modal semelhante ao de criação será aberto, mas com o título **"Edit Canned Response"** e os campos já preenchidos com os valores atuais da resposta
6. Modifique os campos desejados:
   * Código (se necessário)
   * Conteúdo (incluindo variáveis dinâmicas)
   * Anexos (adicione ou remova arquivos conforme necessário)
7. Revise as alterações, especialmente as variáveis dinâmicas
8. Clique no botão verde **"Update"** ou **"Save"** para salvar as alterações
9. Ou clique em **"Cancel"** para descartar as alterações

As alterações serão aplicadas imediatamente e refletidas na tabela de respostas rápidas.

**Nota:** Ao editar uma resposta rápida, certifique-se de que as variáveis dinâmicas estão corretamente escritas para evitar erros na substituição quando a resposta for utilizada.

***

## Excluindo uma Resposta Rápida

Para remover uma resposta rápida:

1. Na tabela de respostas rápidas, localize a resposta que deseja excluir
2. Na coluna **Actions**, clique no ícone de três pontos (`...`) correspondente à resposta
3. Um menu dropdown será exibido com as opções disponíveis
4. No menu dropdown, clique em **Delete** (acompanhado de um ícone de lixeira, exibido em texto vermelho para indicar uma ação destrutiva)
5. Um diálogo de confirmação será exibido
6. Confirme a exclusão no diálogo que aparecer

**Atenção:**

* A exclusão de uma resposta rápida é permanente e não pode ser desfeita
* Verifique se não há processos ou usuários dependendo desta resposta antes de excluí-la
* Considere editar a resposta em vez de excluí-la se houver dúvidas sobre seu uso futuro

***

## Usando Variáveis Dinâmicas

As variáveis dinâmicas são uma funcionalidade poderosa das respostas rápidas, permitindo personalizar automaticamente as mensagens com informações específicas do contexto.

### Variáveis Disponíveis

* **`{{contact.name}}`** - Substituído pelo nome do contato na conversa
* **`{{agent.name}}`** - Substituído pelo nome do agente que está utilizando a resposta
* **`{{account.name}}`** - Substituído pelo nome da conta/organização
* **`{{conversation.id}}`** - Substituído pelo ID único da conversa

### Como Usar Variáveis

1. Ao criar ou editar uma resposta rápida, digite as variáveis diretamente no campo Content
2. Use a sintaxe exata: chaves duplas `{{ }}` com o nome da variável dentro
3. Exemplo de uso:
   ```
   Olá, {{contact.name}}!
   Sou {{agent.name}} da {{account.name}}.
   Recebemos sua mensagem e já vamos te ajudar.
   ```
4. Quando a resposta for utilizada, as variáveis serão automaticamente substituídas pelos valores reais

### Dicas de Uso

* **Personalização:** Use `{{contact.name}}` para tornar as mensagens mais pessoais e amigáveis
* **Identificação:** Use `{{agent.name}}` e `{{account.name}}` para identificar claramente quem está respondendo
* **Rastreamento:** Use `{{conversation.id}}` quando precisar referenciar a conversa específica
* **Combinação:** Combine múltiplas variáveis na mesma resposta para máxima personalização

***

## Considerações Finais

* **Códigos Únicos:** Certifique-se de usar códigos únicos e descritivos para facilitar a identificação rápida das respostas
* **Variáveis Dinâmicas:** Aproveite as variáveis dinâmicas para personalizar as respostas e melhorar a experiência do cliente
* **Conteúdo Claro:** Escreva conteúdos claros e objetivos que transmitam a mensagem desejada de forma eficiente
* **Anexos:** Use anexos quando necessário para complementar a resposta com informações visuais ou documentos
* **Organização:** Mantenha as respostas rápidas organizadas com códigos consistentes e fáceis de lembrar
* **Revisão Regular:** Revise periodicamente as respostas existentes para garantir que continuam relevantes e atualizadas
* **Teste:** Teste as variáveis dinâmicas antes de usar em produção para garantir que estão funcionando corretamente
* **Nomenclatura:** Use códigos que sigam um padrão consistente para facilitar a busca e organização

As respostas rápidas são uma ferramenta essencial para acelerar o atendimento e melhorar a eficiência da equipe, permitindo respostas consistentes e personalizadas aos clientes de forma rápida e eficiente.


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