> For the complete documentation index, see [llms.txt](https://doc.3va.app.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.3va.app.br/iniciar-chatbot.md).

# Iniciar Chatbot

O uso de chatbots contribui para aumentar a eficiência operacional e aprimorar a experiência do usuário, permitindo responder rapidamente a dúvidas frequentes, direcionar clientes aos recursos adequados e executar tarefas simples de forma automática. Dessa forma, os agentes humanos podem focar em atendimentos que exigem análise e intervenção mais complexas.

**Pré-requisitos**:

* Ter um chatbot do tipo **Automação** previamente criado na plataforma.

{% stepper %}
{% step %}

### Acessar a Opção de Anexo

1. Com a conversa já iniciada, na tela de **Atendimentos**, selecione a conversa em que deseja enviar o chatbot.
2. Na barra de digitação, clique no ícone de Anexo.
3. No menu exibido, selecione a opção **“Iniciar chatbot”.**

![](/files/f0d0a404cbe268978c0d39d768c9075de783f8bd)
{% endstep %}

{% step %}

### Selecionar e Enviar o Chatbot

Ao escolher a opção **Iniciar chatbot**, será aberto uma caixa de seleção para que você selecione o fluxo desejado.

1. Serão exibidos apenas os **chatbots de automação publicados** para o canal do atendimento.
2. A caixa de seleção inclui uma **barra de pesquisa** para localizar o chatbot pelo nome e filtros de uso: **Todos os usos**, **API**, **Conversas**, **Campanha** e **Sequência**.
3. Os chatbots disponíveis serão listados conforme o filtro aplicado.
4. Ao clicar no chatbot desejado, ele será **imediatamente enviado** na conversa e a automação será iniciada.

![](/files/6109815218be33517d7857f040c8766d0a96b290)
{% endstep %}

{% step %}

### Início do Chatbot e Opção de Interromper o Fluxo

1. Após o envio, o chatbot é iniciado automaticamente na conversa.
2. Na mensagem de transição, será exibido **qual usuário iniciou o chatbot**, garantindo rastreabilidade dentro do atendimento.
3. Durante a execução, também ficará disponível a opção **“Interromper fluxo do chatbot”**, permitindo encerrar a automação a qualquer momento.

![](/files/3595550aaa706ee90ef197d32529b637fd54d5bb)
{% endstep %}

{% step %}

### Interromper o Fluxo do Chatbot

Ao clicar em **“Interromper fluxo do chatbot”**, será exibido uma mensagem de confirmação.

Ao confirmar a ação clicando em **“Interromper”**:

* A execução do chatbot é imediatamente finalizada.
* O usuário do atendimento pode enviar mensagens normalmente.

![](/files/e778d50b975b573253b143aeaf1b7d5635aeb92a)

![](/files/9aebe1c5a2b1560f5c731c5b9769d50e7d20ec71)
{% endstep %}

{% step %}

### Gerenciando Mensagens Enviadas

Após a mensagem ser enviada, você terá várias opções para interagir com a mensagem diretamente na tela de atendimento:

#### Ações ao Passar o Mouse

Ao passar o mouse sobre a mensagem, duas ações rápidas aparecem:

* **Responder:** Clique no ícone de seta (↩︎) para citar a mensagem em sua próxima mensagem.
* **Baixar:** Clique no ícone de download (↓) para salvar o arquivo em seu computador (Disponível apenas para mensagens que contêm arquivos.)

![](/files/cb2d87f6280d7c3ad10b8004b484ff0b178aaee8)

#### Ações de Seleção

Você também pode selecionar uma ou mais mensagens clicando na caixa de seleção (checkbox) que aparece no canto. Ao fazer isso, uma barra de ações surgirá na parte inferior da tela com as seguintes opções:

* **Baixar mídia:** Faz o download de todos os itens selecionados (Disponível apenas para mensagens que contêm arquivos.)
* **Excluir:** Remove as mensagens selecionadas.
* **Encaminhar:** Envia as mensagens selecionadas para outra conversa.

![](/files/547ef238059762fc04326ef8e499e6c8547cd7c1)

![](/files/4f47bb3a846362599e814ea0603e1e48064c8706)

#### Excluindo uma Mensagem

Ao clicar em **"Excluir"** na barra de ações, um pop-up de confirmação será exibido. Você terá duas opções:

1. **Apagar para mim:** Remove a mensagem apenas da sua visualização.
2. **Apagar para todos:** Remove a mensagem para você e para o contato **(Nota: Esta opção está disponível apenas para canais da API Não Oficial).**

![](/files/903a63595eeb5c63c101fb773415acf7c304dbd3)

{% hint style="warning" %}
**Restrição de Gerenciamento**

Se o chatbot incluir um fluxo que utilize um Modelo de Mensagem, será possível apenas encaminhar a mensagem; não é possível selecionar ou excluir.
{% endhint %}

#### Detalhes da Mensagem (Avançado)

Clicando no menu de três pontos (`...`) ao lado da mensagem, você pode acessar os **"Detalhes da mensagem"**.

* Este painel mostra o status de entrega (Criado, Enviado, Entregue, Lido).
* Para usuários com perfil de **Administrador**, esta tela também exibe o **"ID da mensagem"** e o **"ID do canal"**, informações úteis para auditoria e integrações.

![](/files/714331d6eb534b4d0ee9f2f5b06ccbbf99727daa)
{% endstep %}
{% endstepper %}


---

# 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://doc.3va.app.br/iniciar-chatbot.md?ask=<question>&goal=<endgoal>
```

`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.