# Dommus Conecta

# 1. Iniciando um novo atendimento



# 1.1 Criando um novo atendimento

Dentro do módulo **Conecta**, é possível registrar novos atendimentos de forma prática, permitindo organizar e acompanhar todas as interações realizadas com os clientes.

1. Para iniciar, clique no botão **(+)** para criar um novo atendimento.
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/g89image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/g89image.png)
2. Uma nova tela será aberta com os campos de configuração.
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/9JRimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/9JRimage.png)

### Campos de Configuração

- **Meio de Comunicação:**  
    Selecione por onde o atendimento será realizado (ex: SMS, E-mail, WhatsApp, VoIP).
- **Nome:**  
    Informe o nome do cliente ou contato que está sendo atendido.
- **Telefone:**  
    Campo obrigatório quando o meio de comunicação for SMS, WhatsApp ou VoIP.
- **E-mail:**  
    Campo obrigatório quando o meio de comunicação selecionado for E-mail.
- **Status do Atendimento:**  
    Define o estágio atual do atendimento (ex: Em andamento, Finalizado, Pendente).
- **Tipo de Atendimento:**  
    Permite categorizar o tipo de interação (ex: Suporte, Pós-venda, Comercial).
- **Originado por:**  
    Selecione o número de telefone ou endereço de e-mail vinculado ao atendimento, conforme o canal escolhido.
- **Tags:**  
    Etiquetas opcionais que auxiliam na organização e filtragem dos atendimentos.

Após o preenchimento das informações, clique em **Iniciar atendimento** para registrar o atendimento no sistema.

---

### Visualização do Atendimento

Após a criação, será gerado um **card de atendimento**, contendo as informações de abertura e permitindo o acompanhamento das interações.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/hb7image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/hb7image.png)

### Atendimento via WhatsApp

Para atendimentos realizados via **WhatsApp**, existem algumas regras importantes:

- É necessário utilizar um **template previamente aprovado pela Meta** para iniciar a conversa
- O envio desse template é obrigatório para o primeiro contato com o cliente
- A digitação de mensagens livres só será liberada após o cliente responder

👉 Após a resposta do cliente, é aberta uma **janela de 24 horas**, na qual é possível interagir livremente sem a necessidade de novos templates.

### Observações Importantes

- O canal selecionado define quais campos serão obrigatórios
- Atendimentos via WhatsApp dependem de template aprovado
- A janela de 24 horas é controlada pela Meta e não pelo sistema
- Recomenda-se validar o canal antes de iniciar o atendimento

# 1.2 Gerenciando o Atendimento

Após a criação de um **atendimento** no Conecta, o sistema exibe automaticamente todos os **templates de conversa** disponíveis na tela. Esses templates são mensagens pré-configuradas que servem como ponto de partida para a comunicação com o cliente.

Para enviar a primeira mensagem:

1. Selecione o **template** desejado.
2. Clique em **“Enviar Mensagem Selecionada.”**

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/wMtimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/wMtimage.png)

Assim que o envio é realizado, a mensagem é direcionada ao cliente vinculado ao atendimento.  
Em seguida, é necessário **aguardar a resposta do cliente** para que a conversa possa prosseguir.

#### **Importante**

O Conecta utiliza a **ferramenta oficial da Meta** (WhatsApp Business API), o que significa que a comunicação segue as regras de privacidade e autenticação da plataforma.  
Por esse motivo, **o cliente precisa responder ao template inicial** para que a conversa seja liberada.

Após a resposta do cliente, o sistema abre uma **janela de conversa de 24 horas**, durante a qual o atendente pode interagir livremente com o cliente.  
Quando esse período se encerra, o chat é automaticamente bloqueado para novas mensagens, sendo necessário o envio de **um novo template aprovado** para retomar o contato.

---

#### **Envio de Mídias e Arquivos**  


Durante a conversa com o cliente dentro da **janela de 24 horas**, o Conecta permite o envio de diferentes tipos de conteúdo, facilitando a comunicação e o compartilhamento de informações importantes.

Na parte inferior da tela do atendimento, o sistema oferece várias opções de interação:

- **Campo de Texto:** para digitar e enviar mensagens diretamente ao cliente.
- **Botão de Emojis:** adiciona reações e ícones para uma comunicação mais leve e humanizada.
- **Botão de Três Pontos (⋯):** abre o menu de **envio de arquivos e mídias**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/akoimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/akoimage.png)

#### **Envio de Áudio**

Durante a conversa com o cliente dentro da **janela de 24 horas**, o Conecta também permite o envio de mensagens de áudio, tornando a comunicação mais rápida e prática.

Na parte inferior da tela do atendimento, o sistema oferece a opção de gravação de áudio:

- **Botão de Áudio:** permite gravar e enviar mensagens de voz diretamente ao cliente.
- **Gravação Rápida:** o áudio pode ser enviado de forma simples durante a conversa.
- **Histórico da Conversa:** os áudios enviados ficam registrados no atendimento.  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/hgFimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/hgFimage.png)

⚠️ **Importante:**  
É necessário permitir o uso do microfone no navegador para realizar a gravação dos áudios.

#### **Envio de Imagens e Anexos**

O envio pode ser feito de forma direta:

1. Clique nos **três pontinhos (⋯)**.
2. Escolha o arquivo desejado (imagem, PDF, documento etc.).
3. Clique em **Enviar**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/MISimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/MISimage.png)

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/03aimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/03aimage.png)

O sistema permite anexos leves, portanto **arquivos grandes podem ser bloqueados**. Caso ocorra erro no envio, é recomendado **reduzir o tamanho do arquivo** antes de tentar novamente.

#### **Galeria de Imagens**

O Conecta oferece uma **galeria de imagens** para armazenar conteúdos visuais utilizados com frequência — por exemplo, fotos de empreendimentos.  
Assim, em vez de procurar e anexar as mesmas imagens toda vez, basta selecionar diretamente da galeria e enviar com um clique.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/Luhimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/Luhimage.png)

#### **Galeria de Arquivos**

Além das imagens, há também a **galeria de arquivos**, onde podem ser armazenados materiais como **apresentações, catálogos e books em PDF**.  
Isso otimiza o tempo do atendente e garante que todos os materiais enviados estejam atualizados e padronizados.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/3k1image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/3k1image.png)

#### **Outras Funcionalidades da Tela de Atendimento**

- **Envio de Templates:** é possível reenviar **templates aprovados**, utilizando o botão **“Selecionar Mensagens”**, que lista todos os modelos disponíveis para uso.

![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/n8gimage.png)

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/mP5image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/mP5image.png)

- **Anotações:** campo destinado a observações internas sobre o atendimento. Funciona como um **bloco de notas**, permitindo registrar informações relevantes, procurar por outros atendimentos relacionados e manter um histórico de interações organizado.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/ehlimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/ehlimage.png)

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/2Y2image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/2Y2image.png)

---

#### **Menu de informações do atendimento**

Na tela de **informações do atendimento**, o Conecta concentra todos os dados e ações relacionadas ao cliente, oferecendo uma visão completa e integrada do relacionamento.

Além de visualizar os detalhes da conversa, é possível realizar diversas funções diretamente dessa tela, tornando o atendimento mais ágil e conectado com os demais módulos do sistema.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/QUUimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/QUUimage.png)

#### **Visualização de Dados do Cliente**

O sistema exibe as principais informações do cliente atendido, como:

- **Nome e dados de contato** (telefone, e-mail, canal utilizado).
- **Histórico de atendimentos anteriores.**
- **Tarefas vinculadas** ao cliente.
- **Envolvidos no atendimento**, facilitando o acompanhamento de quem já interagiu com aquele contato.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/iCximage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/iCximage.png)

#### **Vinculando múltiplos processos ao atendimento**

Um mesmo atendimento também pode ser associado a mais de um processo. Isso permite concentrar todas as interações do cliente em um único atendimento, facilitando o acompanhamento quando houver mais de um processo relacionado.

##### **Como vincular**

1. Abra o atendimento desejado.
2. Localize a seção **Processos**.
3. Clique em **Vincular Processo**.  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-07/scaled-1680-/0Q1image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-07/0Q1image.png)
4. Selecione o processo que deseja vincular.
5. Repita a operação para adicionar quantos processos forem necessários.  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-07/scaled-1680-/lDmimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-07/lDmimage.png)

> **Observação:** Todos os processos vinculados permanecem disponíveis no mesmo atendimento, permitindo alternar entre eles sempre que necessário.

#### **Integração com Outros Módulos**

Quando há uma **OPV (Oportunidade de Venda)** ou um **processo** vinculado ao cliente, o Conecta exibe essas informações diretamente na tela.  
Ao clicar sobre o número da OPV ou do processo, o sistema cria um **link direto** para o **módulo de Vendas** e o **módulo Prospecta** respectivamente, abrindo automaticamente o registro correspondente e exibindo os detalhes do cliente.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/8YJimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/8YJimage.png)

Essa integração permite transitar entre módulos sem precisar sair do atendimento, tornando o fluxo de trabalho mais fluido.

#### **Abertura de Chamados no Atende**

Outro recurso disponível é a **integração com o módulo Atende**.  
Por meio do menu de opções do atendimento, é possível clicar em **“Abrir Chamado no Atende”**, o que habilita o **botão de ticket** dentro do Conecta.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/0STimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/0STimage.png)

Esse recurso é especialmente útil quando o cliente entra em contato para relatar algum problema — por exemplo, uma manutenção ou solicitação técnica referente ao apartamento.  
Com apenas um clique, o atendente consegue abrir o chamado diretamente do Conecta, sem precisar acessar outro módulo manualmente.

---

#### **Explorando as opções de atendimento**

O Conecta permite realizar diversas ações dentro de um atendimento já criado, tornando o gerenciamento mais prático e flexível.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/FIhimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/FIhimage.png)

#### **Edição de Atendimento**

A **edição** é usada para ajustar informações ou transferir o atendimento conforme a necessidade.  
Entre as funções disponíveis estão:

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/O0Himage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/O0Himage.png)

- **Transferir o cliente para outro ramal** — ideal quando o atendimento foi iniciado no setor incorreto.
- **Alterar o atendente responsável**, permitindo a redistribuição de contatos.
- **Atualizar o status do atendimento**, conforme o andamento da conversa.
- **Editar o nome do destinatário**, útil para identificar um cliente que ainda não se apresentou.
- **Adicionar tags** ao atendimento, facilitando a categorização e a busca posterior.
- **Definir o tipo de atendimento**, de acordo com o tema tratado (suporte, comercial, manutenção etc.).

Essas edições garantem que cada atendimento permaneça organizado, com informações precisas e sempre atualizadas.

#### **Finalização do Atendimento**

Ao encerrar uma conversa com o cliente, o atendente pode acessar o menu de **Opções de Atendimento** e escolher **“Finalizar Atendimento.”**

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/XOJimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/XOJimage.png)

Quando essa opção é acionada, o sistema exibe duas alternativas:

- **Arquivar Atendimento:** remove o atendimento da visualização principal e o move para a **Lixeira**, localizada no menu lateral. O registro permanece armazenado e pode ser **resgatado a qualquer momento**.
- **Manter Atendimento:** finaliza a conversa, mas **mantém o registro visível** na **Central de Atendimento**, permitindo consulta futura sem precisar restaurar.

#### **Exclusão de Atendimento**

Também é possível **enviar o atendimento diretamente para a lixeira**, caso seja necessário remover a conversa do histórico.  
Essa ação **exclui o atendimento** da central, movendo-o automaticamente para a área de **Arquivados**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/bz4image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/bz4image.png)

# 1.3 Envio de E-mail como Comunicado

#### Visão Geral

A funcionalidade permite disponibilizar e-mails enviados pela **Central de Atendimento** como comunicados no **Portal do Cliente**.

Ao marcar a opção **Enviar e-mail como comunicado**, o histórico daquela conversa fica acessível ao cliente por meio do menu ou widget **Comunicados**, permitindo a consulta das mensagens sempre que necessário.

---

#### Como acessar

1. Acesse **Central de Atendimento**.
2. Abra um atendimento do tipo **E-mail**.
3. Clique em **Enviar E-mail**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-07/scaled-1680-/eepimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-07/eepimage.png)

---

#### Enviando um comunicado

1. Preencha normalmente os dados do e-mail.
2. Marque a opção **Enviar e-mail como comunicado**.
3. Clique em **Enviar E-mail**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-07/scaled-1680-/OeOimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-07/OeOimage.png)

##### Campos da tela

<div class="TyagGW_tableContainer" id="bkmrk-campo-descri%C3%A7%C3%A3o-para"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="1684" data-start="1352"><thead data-end="1373" data-start="1352"><tr data-end="1373" data-start="1352"><th class="last:pe-10" data-col-size="sm" data-end="1360" data-start="1352">Campo</th><th class="last:pe-10" data-col-size="md" data-end="1373" data-start="1360">Descrição</th></tr></thead><tbody data-end="1684" data-start="1397"><tr data-end="1441" data-start="1397"><td data-col-size="sm" data-end="1404" data-start="1397">Para</td><td data-col-size="md" data-end="1441" data-start="1404">Destinatário principal do e-mail.</td></tr><tr data-end="1480" data-start="1442"><td data-col-size="sm" data-end="1453" data-start="1442">CC / CCO</td><td data-col-size="md" data-end="1480" data-start="1453">Destinatários em cópia.</td></tr><tr data-end="1516" data-start="1481"><td data-col-size="sm" data-end="1491" data-start="1481">Assunto</td><td data-col-size="md" data-end="1516" data-start="1491">Título do comunicado.</td></tr><tr data-end="1602" data-start="1517"><td data-col-size="sm" data-end="1549" data-start="1517">Enviar e-mail como comunicado</td><td data-col-size="md" data-end="1602" data-start="1549">Disponibiliza o atendimento no Portal do Cliente.</td></tr><tr data-end="1640" data-start="1603"><td data-col-size="sm" data-end="1612" data-start="1603">Anexos</td><td data-col-size="md" data-end="1640" data-start="1612">Permite anexar arquivos.</td></tr><tr data-end="1684" data-start="1641"><td data-col-size="sm" data-end="1652" data-start="1641">Mensagem</td><td data-col-size="md" data-end="1684" data-start="1652">Conteúdo enviado ao cliente.</td></tr></tbody></table>

</div></div>---

#### Visualizando o comunicado

Após o envio, o cliente poderá acessar o **Portal do Cliente**, localizar o menu ou widget **Comunicados** e selecionar o comunicado desejado para visualizar todo o histórico daquela conversa.

---

#### Boas práticas

- Utilize assuntos objetivos para facilitar a identificação dos comunicados.
- Revise o conteúdo antes do envio, pois ele ficará disponível ao cliente.
- Marque a opção **Enviar e-mail como comunicado** apenas quando desejar disponibilizar aquele atendimento no Portal do Cliente.
- Verifique se o widget **Comunicados** está configurado corretamente.

---

#### Glossário

<div class="TyagGW_tableContainer" id="bkmrk-termo-descri%C3%A7%C3%A3o-comu"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="2544" data-start="2314"><thead data-end="2335" data-start="2314"><tr data-end="2335" data-start="2314"><th class="last:pe-10" data-col-size="sm" data-end="2322" data-start="2314">Termo</th><th class="last:pe-10" data-col-size="md" data-end="2335" data-start="2322">Descrição</th></tr></thead><tbody data-end="2544" data-start="2359"><tr data-end="2460" data-start="2359"><td data-col-size="sm" data-end="2372" data-start="2359">Comunicado</td><td data-col-size="md" data-end="2460" data-start="2372">Atendimento enviado por e-mail e disponibilizado para consulta no Portal do Cliente.</td></tr><tr data-end="2544" data-start="2461"><td data-col-size="sm" data-end="2470" data-start="2461">Widget</td><td data-col-size="md" data-end="2544" data-start="2470">Componente do Portal do Cliente responsável por listar os comunicados.</td></tr></tbody></table>

</div></div><div class="text-base my-auto mx-auto [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)" id="bkmrk--7"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1" data-conversation-screenshot-content=""><div></div></div></div>

# 2. Central de Atendimento



# 2.1 Tudo sobre a central de atendimento

A **Central de Atendimento** é a tela principal do módulo **Conecta**, onde o atendente pode visualizar todos os seus atendimentos em um único lugar. Essa visão centralizada facilita o acompanhamento, o gerenciamento e a continuidade das conversas com clientes.

A interface é organizada com **filtros rápidos**, **separação por meios de comunicação** e **cards de atendimentos**, oferecendo praticidade no dia a dia.

#### **Filtros Laterais**

No painel lateral, encontram-se os filtros de acesso rápido, que permitem visualizar atendimentos de acordo com categorias específicas, como:

- **Disparos em Massa**
- **Pagamentos Atrasados**
- **Leads**
- **Contatos Desqualificados**

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/j3Mimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/j3Mimage.png)

Abaixo desses filtros, há a seção de **marcadores personalizados**, onde é possível criar novos marcadores conforme a necessidade da equipe, tornando a organização mais flexível e adaptada ao fluxo de trabalho.

#### **Filtros por Ramal, Tipo de Atendimento e Situação**

Também é possível refinar a busca de atendimentos utilizando os filtros adicionais disponíveis no topo da tela.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/scaled-1680-/Eojimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/Eojimage.png)

#### Campos Disponíveis

- **Status do Atendimento (Situação)**  
    Permite filtrar os atendimentos de acordo com o status atual (ex: aberto, finalizado, pendente, etc).
- **Tipo do Atendimento**  
    Possibilita visualizar atendimentos conforme a categoria (ex: Sucesso do Cliente, Pagamento em Atraso, entre outros).
- **Ramal**  
    Permite filtrar os atendimentos vinculados a um ramal específico, facilitando a visualização por equipe ou operador.

#### Como Utilizar

Basta selecionar uma ou mais opções nos campos desejados.  
Os atendimentos serão atualizados automaticamente conforme os filtros aplicados.

#### Observações

- Os filtros podem ser utilizados de forma combinada com os demais filtros da tela.
- Ideal para análises mais específicas e segmentação de atendimentos por origem ou responsável.

#### **Aba de Atendimentos**

A aba principal exibe todos os **cards de atendimentos**, mostrando por padrão **todos os registros**, independentemente do status.  
O usuário pode optar por visualizar apenas os **atendimentos não vistos**, garantindo prioridade para novas interações.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/c4Jimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/c4Jimage.png)

Na parte superior da tela, encontram-se os **ícones das plataformas de atendimento**, que permitem filtrar rapidamente os atendimentos por canal específico.  
O Conecta oferece integração com diversos meios de comunicação, incluindo:

- **E-mail**
- **WhatsApp**
- **VoIP**
- **SMS**
- **Messenger**
- **Direct do Instagram**

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/M88image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/M88image.png)

Ao clicar sobre o ícone de uma plataforma, a visualização é ajustada para mostrar apenas os atendimentos daquele canal, facilitando a gestão e o foco de cada operador.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/VMHimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/VMHimage.png)

---

#### **Filtrando por data e atendentes**

Além dos filtros laterais e de plataformas, o Conecta também permite filtrar os atendimentos por **data** e **atendentes**.

Por padrão, a tela exibe os atendimentos do **dia atual**, facilitando a visualização do que está acontecendo em tempo real. No entanto, é possível alterar o período para consultar atendimentos de dias anteriores, conforme a necessidade.

Também é possível **selecionar os atendentes** cujos atendimentos deseja visualizar.  
Ao clicar no botão **(+)**, novos atendentes podem ser adicionados à lista de exibição, permitindo ao gestor acompanhar o volume e o andamento dos atendimentos de diferentes membros da equipe em uma única tela.

<p class="callout warning">Somente perfis administrativos consegue visualizar todos os atendimentos de todos os usuários, perfis de atendimento tem acesso apenas aos atendimentos próprios.</p>

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/9giimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/9giimage.png)

#### **Filtros avançados de atendimentos**

O **Filtro Avançado** é uma ferramenta essencial da **Central de Atendimento** do Conecta, permitindo localizar atendimentos de forma detalhada e precisa. Ele oferece diversos critérios de busca, combinando filtros de canal, período, tipo de atendimento, atendente e muito mais.

Para acessar o filtro, clique no **ícone de lupa** no canto superior direito da tela.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/nJbimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/nJbimage.png)

#### **Campos do Filtro Avançado**

- **Meio de Comunicação:** permite escolher um ou mais canais de atendimento (SMS, WhatsApp, E-mail, VoIP, Messenger, Instagram, entre outros). Assim, é possível visualizar apenas os atendimentos do canal desejado.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/rNcimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/rNcimage.png)

- **Última Movimentação do Atendimento:** define o período de busca. Por padrão, o Conecta mostra os atendimentos do dia atual, mas aqui é possível ajustar as datas para buscar pela abertura do atendimento.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/8iDimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/8iDimage.png)

- **Tipo de Atendimento:** seleciona a categoria do atendimento (ex: *Disparo em massa*, *Lead Interessado*, *Pagamento em Atraso*).

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/245image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/245image.png)

- **Status do Atendimento:** filtra pelos estágios do atendimento (ex: *Aberto*, *Finalizado*, *Em andamento*).

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/Fgzimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/Fgzimage.png)

- **Marcadores:** permite filtrar por etiquetas personalizadas criadas pela equipe.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/gN0image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/gN0image.png)

- **Exibir Somente Não Lidas:** quando ativado, exibe apenas os atendimentos que ainda não foram visualizados.
- **Telefone Destinatário:** busca atendimentos enviados para um e-mail específico. É possível ao clicar sobre a seta, alterar para o e-mail.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/10Himage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/10Himage.png)

- **Nome Destinatário:** localiza conversas associadas a um cliente ou contato pelo nome.
- **Contato Origem:** define o número de telefone ou e-mail do remetente utilizado no atendimento.
- **Atendimento / Proponente:** campos usados para localizar atendimentos por número de registro ou pelo nome do proponente (em casos de vendas ou processos).
- **Empreendimento / Unidade:** disponíveis para empresas com múltiplos projetos ou filiais, permitindo filtrar atendimentos vinculados a um empreendimento específico.
- **Atendentes:** seleciona um ou mais usuários responsáveis pelos atendimentos.
- **Campos de Exportação (OPV, Processo, Ticket):** marcam quais informações adicionais serão incluídas na exportação dos dados.

#### **Ações Disponíveis**

Na parte inferior da janela, estão as opções de ação:

- **Fixar Filtro:** mantém o filtro aplicado como padrão para futuras visualizações.
- **Limpar:** remove todos os critérios aplicados, retornando à visualização padrão.
- **Exportar:** gera um arquivo com os resultados filtrados para análise externa.
- **Filtrar:** aplica os critérios selecionados e atualiza a listagem de atendimentos.

---

#### **Sala de Espera**

A **Sala de Atendimento** é um recurso do Conecta criado para garantir que nenhum atendimento seja perdido, mesmo quando todos os atendentes estão ocupados ou indisponíveis.

Ela funciona como uma **fila de espera inteligente**, onde os atendimentos ficam temporariamente armazenados até que um atendente disponível possa assumi-los.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/tBsimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/tBsimage.png)

#### **Como Funciona**

Quando um novo atendimento chega e:

- **todos os atendentes estão ocupados**, ou
- **não existe nenhum atendente qualificado** (com perfil compatível com o tipo de atendimento ou canal),

o sistema automaticamente encaminha esse atendimento para a **Sala de Atendimento**.

Lá, o registro fica visível para os atendentes habilitados, que podem acessar a sala e **“resgatar” o atendimento** manualmente. Ao resgatar, o atendimento é atribuído ao atendente que o pegou, seguindo o fluxo normal de comunicação com o cliente.

#### **Vantagens da Sala de Atendimento**

- Evita perda de contatos e leads por falta momentânea de atendentes.
- Garante que todos os atendimentos sejam processados, mesmo em horários de pico.
- Permite que o gestor visualize o volume de atendimentos pendentes e redistribua a carga entre a equipe.
- Mantém a experiência do cliente contínua e organizada.

# 2.2. Exportação de Conteúdo de Mensagens Enviadas

<div class="qMYqUG_convSearchResultHighlightRoot" id="bkmrk-a-funcionalidade-exp"><div class="relative w-full overflow-visible"><section class="text-token-text-primary w-full focus:outline-none [--shadow-height:45px] has-data-writing-block:pointer-events-none has-data-writing-block:-mt-(--shadow-height) has-data-writing-block:pt-(--shadow-height) [&:has([data-writing-block])>*]:pointer-events-auto [content-visibility:auto] supports-[content-visibility:auto]:[contain-intrinsic-size:auto_100lvh] R6Vx5W_threadScrollVars scroll-mb-[calc(var(--scroll-root-safe-area-inset-bottom,0px)+var(--thread-response-height))] scroll-mt-[calc(var(--header-height)+min(200px,max(70px,20svh)))]" data-scroll-anchor="false" data-testid="conversation-turn-23" data-turn="assistant" data-turn-id="request-WEB:db26cfd5-7b9f-4b07-90a7-b1fbf8788e82-10" data-turn-id-container="request-WEB:db26cfd5-7b9f-4b07-90a7-b1fbf8788e82-10" dir="auto">A funcionalidade **Exportar Conteúdo de Mensagens** permite exportar informações completas dos atendimentos registrados no sistema, incluindo mensagens e dados relacionados ao atendimento.

A exportação pode ser utilizada para consulta, compartilhamento, armazenamento ou impressão dos registros.

<div class="text-base my-auto mx-auto pb-10 [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1 group/turn-messages focus-visible:outline-hidden relative flex w-full min-w-0 flex-col agent-turn"><div class="flex max-w-full flex-col gap-4 grow"><div class="min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal outline-none keyboard-focused:focus-ring [.text-message+&]:mt-1" data-message-author-role="assistant" data-message-id="a7a3ef87-116c-491c-b5a3-787f4c2d8270" data-message-model-slug="gpt-5-5" data-turn-start-message="true" dir="auto" tabindex="0"><div class="flex w-full flex-col gap-1 empty:hidden"><div class="markdown prose dark:prose-invert wrap-break-word w-full dark markdown-new-styling">---

</div></div></div></div></div></div>#### Como acessar

Acesse a tela de **Atendimentos &gt; Abrir Tela de Itens Enviados**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/scaled-1680-/GIzimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/GIzimage.png)

  
<div class="text-base my-auto mx-auto pb-10 [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1 group/turn-messages focus-visible:outline-hidden relative flex w-full min-w-0 flex-col agent-turn"><div class="flex max-w-full flex-col gap-4 grow"><div class="min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal outline-none keyboard-focused:focus-ring [.text-message+&]:mt-1" data-message-author-role="assistant" data-message-id="a7a3ef87-116c-491c-b5a3-787f4c2d8270" data-message-model-slug="gpt-5-5" data-turn-start-message="true" dir="auto" tabindex="0"><div class="flex w-full flex-col gap-1 empty:hidden"><div class="markdown prose dark:prose-invert wrap-break-word w-full dark markdown-new-styling">---

</div></div></div></div></div></div>#### Seleção dos atendimentos

Antes da exportação, é necessário selecionar os atendimentos desejados.

O sistema permite:

<div class="text-base my-auto mx-auto pb-10 [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1 group/turn-messages focus-visible:outline-hidden relative flex w-full min-w-0 flex-col agent-turn"><div class="flex max-w-full flex-col gap-4 grow"><div class="min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal outline-none keyboard-focused:focus-ring [.text-message+&]:mt-1" data-message-author-role="assistant" data-message-id="a7a3ef87-116c-491c-b5a3-787f4c2d8270" data-message-model-slug="gpt-5-5" data-turn-start-message="true" dir="auto" tabindex="0"><div class="flex w-full flex-col gap-1 empty:hidden"><div class="markdown prose dark:prose-invert wrap-break-word w-full dark markdown-new-styling">- Selecionar atendimentos individualmente
- Selecionar todos os atendimentos disponíveis

</div></div></div></div></div></div>⚠️ É obrigatório selecionar pelo menos um atendimento para realizar a exportação.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/scaled-1680-/6Giimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/6Giimage.png)

<div class="text-base my-auto mx-auto pb-10 [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1 group/turn-messages focus-visible:outline-hidden relative flex w-full min-w-0 flex-col agent-turn"><div class="flex max-w-full flex-col gap-4 grow"><div class="min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal outline-none keyboard-focused:focus-ring [.text-message+&]:mt-1" data-message-author-role="assistant" data-message-id="a7a3ef87-116c-491c-b5a3-787f4c2d8270" data-message-model-slug="gpt-5-5" data-turn-start-message="true" dir="auto" tabindex="0"><div class="flex w-full flex-col gap-1 empty:hidden"><div class="markdown prose dark:prose-invert wrap-break-word w-full dark markdown-new-styling">---

</div></div></div></div></div></div>#### Como exportar os conteúdos

<div class="text-base my-auto mx-auto pb-10 [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1 group/turn-messages focus-visible:outline-hidden relative flex w-full min-w-0 flex-col agent-turn"><div class="flex max-w-full flex-col gap-4 grow"><div class="min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal outline-none keyboard-focused:focus-ring [.text-message+&]:mt-1" data-message-author-role="assistant" data-message-id="a7a3ef87-116c-491c-b5a3-787f4c2d8270" data-message-model-slug="gpt-5-5" data-turn-start-message="true" dir="auto" tabindex="0"><div class="flex w-full flex-col gap-1 empty:hidden"><div class="markdown prose dark:prose-invert wrap-break-word w-full dark markdown-new-styling">1. Acesse a tela de atendimentos
2. Selecione os atendimentos desejados
3. Clique no botão de ações no cabeçalho
4. Selecione a opção **Exportar Conteúdo Mensagens**

</div></div></div></div></div></div>Após a execução da ação, o sistema realizará a exportação das informações dos atendimentos selecionados.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/scaled-1680-/nGbimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/nGbimage.png)

<div class="text-base my-auto mx-auto pb-10 [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1 group/turn-messages focus-visible:outline-hidden relative flex w-full min-w-0 flex-col agent-turn"><div class="flex max-w-full flex-col gap-4 grow"><div class="min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal outline-none keyboard-focused:focus-ring [.text-message+&]:mt-1" data-message-author-role="assistant" data-message-id="a7a3ef87-116c-491c-b5a3-787f4c2d8270" data-message-model-slug="gpt-5-5" data-turn-start-message="true" dir="auto" tabindex="0"><div class="flex w-full flex-col gap-1 empty:hidden"><div class="markdown prose dark:prose-invert wrap-break-word w-full dark markdown-new-styling">---

</div></div></div></div></div></div>#### Informações exportadas

O arquivo exportado poderá conter informações como:

<div class="text-base my-auto mx-auto pb-10 [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1 group/turn-messages focus-visible:outline-hidden relative flex w-full min-w-0 flex-col agent-turn"><div class="flex max-w-full flex-col gap-4 grow"><div class="min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal outline-none keyboard-focused:focus-ring [.text-message+&]:mt-1" data-message-author-role="assistant" data-message-id="a7a3ef87-116c-491c-b5a3-787f4c2d8270" data-message-model-slug="gpt-5-5" data-turn-start-message="true" dir="auto" tabindex="0"><div class="flex w-full flex-col gap-1 empty:hidden"><div class="markdown prose dark:prose-invert wrap-break-word w-full dark markdown-new-styling">- ID do atendimento
- Nome do atendimento
- Tipo de atendimento
- Contato de origem
- Contato de destino
- Data e hora da criação
- Assunto
- Conteúdo das mensagens
- Data e hora das mensagens
- Dados de monitoramento

---

</div></div></div></div></div></div>#### Alertas importantes

<p class="callout warning">Caso nenhum atendimento seja selecionado, o sistema exibirá um alerta solicitando a seleção de pelo menos um atendimento.</p>

<p class="callout warning">A funcionalidade depende de permissão de acesso para exportação.</p>

<div class="text-base my-auto mx-auto pb-10 [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1 group/turn-messages focus-visible:outline-hidden relative flex w-full min-w-0 flex-col agent-turn"><div class="flex max-w-full flex-col gap-4 grow"><div class="min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal outline-none keyboard-focused:focus-ring [.text-message+&]:mt-1" data-message-author-role="assistant" data-message-id="a7a3ef87-116c-491c-b5a3-787f4c2d8270" data-message-model-slug="gpt-5-5" data-turn-start-message="true" dir="auto" tabindex="0"><div class="flex w-full flex-col gap-1 empty:hidden"><div class="markdown prose dark:prose-invert wrap-break-word w-full dark markdown-new-styling">---

</div></div></div></div></div></div>#### ⚠️ Pontos de atenção

<div class="text-base my-auto mx-auto pb-10 [--thread-content-margin:var(--thread-content-margin-xs,calc(var(--spacing)*4))] @w-sm/main:[--thread-content-margin:var(--thread-content-margin-sm,calc(var(--spacing)*6))] @w-lg/main:[--thread-content-margin:var(--thread-content-margin-lg,calc(var(--spacing)*16))] px-(--thread-content-margin)"><div class="[--thread-content-max-width:40rem] @w-lg/main:[--thread-content-max-width:48rem] mx-auto max-w-(--thread-content-max-width) flex-1 group/turn-messages focus-visible:outline-hidden relative flex w-full min-w-0 flex-col agent-turn"><div class="flex max-w-full flex-col gap-4 grow"><div class="min-h-8 text-message relative flex w-full flex-col items-end gap-2 text-start break-words whitespace-normal outline-none keyboard-focused:focus-ring [.text-message+&]:mt-1" data-message-author-role="assistant" data-message-id="a7a3ef87-116c-491c-b5a3-787f4c2d8270" data-message-model-slug="gpt-5-5" data-turn-start-message="true" dir="auto" tabindex="0"><div class="flex w-full flex-col gap-1 empty:hidden"><div class="markdown prose dark:prose-invert wrap-break-word w-full dark markdown-new-styling">- Verifique os atendimentos selecionados antes da exportação
- Utilize a opção de selecionar todos apenas quando necessário
- Revise os dados exportados após a geração do arquivo
- Confirme se o usuário possui permissão para utilizar a funcionalidade

---

</div></div></div></div></div></div></section></div></div>

# 3. Fila de Atendimento



# 3.1 Inserindo e qualificando o atendente

A **Fila de Atendimento** é a funcionalidade do Conecta responsável por gerenciar a distribuição dos atendimentos entre os atendentes disponíveis, de acordo com o canal de comunicação e as qualificações de cada um. Ela garante que os atendimentos sejam encaminhados corretamente, otimizando o tempo de resposta e evitando sobrecarga em um único colaborador.

#### **Acessando a Fila de Atendimento**

Para acessar a fila:

1. Vá até o **menu lateral** do Conecta.
2. Clique na opção **“Fila de Atendimento.”**

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/7YZimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/7YZimage.png)

Na tela que se abre, é possível configurar e gerenciar os atendentes vinculados a cada canal.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/VAdimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/VAdimage.png)

#### **Configuração da Fila**

1. Clique no **ícone indicado**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/OiYimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/OiYimage.png)

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/v6Iimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/v6Iimage.png)

A interface possui duas abas principais:

- **Meio de Comunicação**
- **Atendentes**

Na aba de **Meio de Comunicação**, você pode selecionar os canais disponíveis — **WhatsApp**, **VoIP** e **E-mail** — além de escolher o **ramal** que será vinculado a cada atendente.

Na aba de **Atendentes**, é exibida a lista de usuários disponíveis para integrar a fila. Para adicionar um atendente clique sobre a aba Adicionar atendentes e a lista de usuários é exibida

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/a99image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/a99image.png)

Em seguida, clique no **botão ( + )** ao lado do nome do usuário desejado. Assim que o atendente é adicionado, ele aparece na lista com sua **posição na fila** e na lupa é possível ver os meios de comunicação vinculados ao atendente.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/efmimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/efmimage.png)

#### **Qualificando o Atendente**

Para que o atendente possa efetivamente receber atendimentos, é necessário qualificá-lo:

1. Clique no **ícone de lupa** ao lado do nome do atendente.
2. Na janela que se abre, **habilite os meios de comunicação** em que ele está apto a atuar.
    
    
    - Exemplo: Habilite **WhatsApp** e selecione os ramais correspondentes.
    - Faça o mesmo para **VoIP** e **E-mail**, conforme necessário.

Após essa configuração, o atendente passa a ser **qualificado** para receber atendimentos nesses canais.

#### **Resultado**

Com a fila configurada e os atendentes qualificados, o sistema distribui automaticamente os atendimentos conforme a disponibilidade e os canais habilitados. Isso garante agilidade, equilíbrio na distribuição e eficiência no atendimento ao cliente.

# 4. Disparo em Massa



# 4.1 Criando a base de disparo

Para iniciar um disparo em massa, primeiro é preciso criar a **base de disparo**, que será o conjunto de contatos ou registros que receberão a mensagem.

1. No menu lateral do sistema, clique no **ícone de Disparo em Massa**.
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/RfEimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/RfEimage.png)
2. Na tela que se abre, vá até a **aba “Bases de Disparo”**.
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/Bzfimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/Bzfimage.png)
3. Clique no botão **( + )** para **criar uma nova base**.
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/Ff3image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/Ff3image.png)
4. Na nova janela, preencha as informações solicitadas:
    
    
    - **Nome da base:** defina um nome que identifique claramente a finalidade do disparo (ex: *Campanha Outubro Clientes VIP*).
    - **Tipo da base:** escolha entre as opções disponíveis:
        
        
        - **Processos:** usada quando você quer puxar dados de **vendas concluídas**, permitindo enviar mensagens a clientes que já finalizaram compras ou contratos.
        - **Oportunidades:** utilizada para acessar os dados de **leads e prospects** cadastrados no módulo *Prospecta*, facilitando campanhas de conversão ou acompanhamento.
        - **Contato:** voltada para disparos manuais, quando você já possui **nomes, e-mails ou telefones** dos clientes para os quais deseja enviar mensagens específicas.
            
            [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/SD0image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/SD0image.png)

Os dados são anexados por arquivo csv onde vamos subir apenas os dados correspondentes ao tipo da Base, abaixo um exemplo como deve ficar cada tipo

**Processo** preenchemos o apenas o número do processo como no exemplo abaixo, o código do processo é o mesmo que aparece no card do processo no Vende, precisamos apenas do número dele.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/jqkimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/jqkimage.png) [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/KG3image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/KG3image.png)

---

**Oportunidade** criamos a base neste tipo seguindo o mesmo padrão do processo, porém, pegando o código da OPV do lead.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/dAbimage.png) ](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/dAbimage.png)

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/KlYimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/KlYimage.png)

---

**Contatos** o tipo contato o preenchimento é avulso, não puxa de dentro do sistema, a planilha precisa ser preenchida no formato abaixo

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/8pVimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/8pVimage.png)

---

Inserido o arquivo de disparo, você consegue visualizar se deu certo a base clicando no menu editar e em seguida visualizar, se listar os contatos temos a base pronta para uso.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/7Fpimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/7Fpimage.png)

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/C3Timage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/C3Timage.png)

# 4.2 Realizando disparos em massa

Após criar o **template** que será enviado e anexar a **base de disparo**, o próximo passo é configurar o **agendamento do disparo**.

Para isso, clique no botão **(+)** e preencha as informações conforme os campos abaixo:

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/7lKimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/7lKimage.png)

#### **Dados do Agendamento**

- **Nome:** Identificação do disparo. Use um nome descritivo para reconhecer facilmente a campanha (ex: *Promoção Novembro – Clientes Ativos*).
- **Tipo de Atendimento:** Escolha o tipo relacionado ao disparo, como *Informação sobre imóvel*, *Pós-venda*, Régua de Cobrança etc.
- **Situação do Atendimento:** Define em que estágio o atendimento está. No exemplo, está selecionado *Atendimento Finalizado*, ideal para comunicações de acompanhamento.
- **Meio de Comunicação:** Selecione o canal por onde a mensagem será enviada — **E-mail**, **SMS** ou **WhatsApp**.
- **Template:** Escolha o modelo de mensagem previamente criado que será usado para o disparo.
- **Contato Origem:** Indique o contato ou ramal que será exibido como origem do disparo.
- **Assunto:** Campo utilizado para definir o título da mensagem (visível principalmente em envios por e-mail).

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/YbAimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/YbAimage.png)

#### **Disparos**

- **Base de Disparo:** Escolha a base de contatos criada anteriormente (Processos, Oportunidades ou Contatos).
- **Data e Hora:** Defina o momento em que o disparo será executado em caso de agendamento.
- **Imediato:** Quando marcado, o disparo é enviado assim que o agendamento for salvo.
- **Recorrência:** Permite programar disparos automáticos em intervalos regulares.

# 4.3 Utilização de Tags em Bases de Contatos para Disparos em Massa

#### Resumo

Nas campanhas de disparo em massa com base de envio do tipo **Contatos**, é possível utilizar tags para personalizar o conteúdo das mensagens.

As tags disponíveis são preenchidas automaticamente com os dados dos contatos importados, permitindo incluir informações como nome, e-mail e telefone diretamente na comunicação enviada

---

#### Tags Disponíveis

As seguintes tags podem ser utilizadas:

<table id="bkmrk-tag-descri%C3%A7%C3%A3o-%7B%7Bnome"><thead><tr><th>Tag</th><th>Descrição</th></tr></thead><tbody><tr><td>\[nome\_base\]</td><td>Nome do contato</td></tr><tr><td>\[email\_base\]</td><td>E-mail do contato</td></tr><tr><td>\[telefone\_base\]</td><td>Telefone do contato</td></tr></tbody></table>

Essas informações são obtidas a partir dos campos obrigatórios da planilha de importação de contatos.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/ot2image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/ot2image.png)

---

#### Como Utilizar

Durante a criação do disparo ou configuração do template, insira as tags diretamente no conteúdo da mensagem.

Exemplo:

> Olá, \[nome\_base\]!
> 
> Estamos entrando em contato através do e-mail \[email\_base\] e do telefone \[telefone\_base\] para compartilhar informações importantes.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/pC3image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/pC3image.png)

---

#### Resultado do Envio

Para um contato com os seguintes dados:

<table id="bkmrk-nome-e-mail-telefone"><thead><tr><th>Nome</th><th>E-mail</th><th>Telefone</th></tr></thead><tbody><tr><td>João Silva</td><td><joao@email.com></td><td>(31) 99999-9999</td></tr></tbody></table>

A mensagem será enviada da seguinte forma:

> Olá, João Silva!
> 
> Estamos entrando em contato através do e-mail <joao@email.com> e do telefone (31) 99999-9999 para compartilhar informações importantes.

---

#### Observações

- As tags estão disponíveis apenas para bases de disparo do tipo **Contatos**.
- Os valores são preenchidos automaticamente durante o envio.
- Caso algum dado esteja ausente ou inválido na importação, a tag poderá ser enviada sem conteúdo.
- Recomenda-se validar a planilha antes de realizar o disparo.

---

#### Benefícios

- Comunicação mais personalizada.
- Maior proximidade com os destinatários.
- Facilidade na criação de campanhas.
- Melhor aproveitamento das informações já existentes na base importada.

# 5. Templates



# 5.1 Cadastrando um novo template

O módulo **Conecta** permite criar **mensagens marketing ou mensagens de atendimento** que podem ser enviadas aos clientes por diferentes **meios de comunicação**, como:

- **E-mail**
- **WhatsApp**
- **SMS**

Essas mensagens podem ser utilizadas tanto para **comunicações de atendimento** quanto para **campanhas de marketing**, oferecendo flexibilidade e personalização na forma de contato com o cliente.

---

### Aprovação de Templates

- **SMS e E-mail**: não exigem aprovação do suporte.
- **WhatsApp**: requer aprovação pela **Meta**, pois o sistema utiliza a **API oficial do WhatsApp Business**.
    
    
    - Esse processo pode ser feito conforme a documentação [\[Aprovação de Template para WhatsApp\]](https://duvida.dommus.com.br/books/dommus-conecta/page/52-envio-e-aprovacao-de-templates-whatsapp).

---

### Como criar um Template

1. **Acesse** o menu lateral → **Configurações** → **Templates**.
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/befimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/befimage.png)
2. Clique no botão **( + )** para criar um novo template.
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/E06image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/E06image.png)
3. Na tela que se abre, selecione o **meio de comunicação** desejado (SMS, WhatsApp ou E-mail).
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/pE1image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/pE1image.png)
4. Conforme o meio escolhido, novas opções serão habilitadas para preenchimento.

---

### Exemplo: Criação de Template de E-mail

Ao selecionar **E-mail**, serão exibidos os seguintes campos obrigatórios:

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/Pe6image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/Pe6image.png)

- **Nome do Template**\* – identificação interna da mensagem.
- **Assunto**\* – título que será exibido ao cliente.
- **Tipo de Template**\* – escolha entre:
    
    
    - *Texto*
    - *Texto e Imagem*

Além desses campos, também é possível configurar:

- **Ramais** – permite definir de qual conta de e-mail (ou remetente) o disparo será feito, ideal quando há mais de uma conta vinculada ao Conecta.
- **Tipo de Atendimento** – categoriza o template conforme a natureza do envio (ex.: Suporte, Comercial, Pós-venda).
- **Atendentes** – restringe a disponibilidade do template para usuários específicos.
- **Tags de Módulos** – usadas para personalização automática de informações (ex.: *Nome do Cliente*, *Número do Ticket*, *Empreendimento*).

---

### Edição da Mensagem

No painel à **direita da tela**, há um editor completo de mensagem onde é possível:

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/N3Rimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/N3Rimage.png)

- Criar e formatar o texto livremente.
- Adicionar imagens e links.
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/dfvimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/dfvimage.png)
- Incorporar **HTML**, para construir e-mails com layout mais elaborado e visual profissional.
    
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/Fhjimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/Fhjimage.png)

---

### Finalização

Após configurar e revisar todos os campos:

1. Clique em **Salvar**.
2. O template estará pronto para uso em disparos manuais, automações ou campanhas dentro do Conecta.

---

### Benefícios

- **Padronização** das comunicações enviadas aos clientes.
- **Agilidade** no disparo de mensagens recorrentes.
- **Personalização** com dados dinâmicos via tags.
- **Flexibilidade** para campanhas de marketing ou atendimento automatizado.

# 5.2 Envio e Aprovação de Templates WhatsApp

#### Visão Geral

A funcionalidade de Templates WhatsApp permite criar, configurar e enviar modelos de mensagens para aprovação através da integração com a plataforma oficial do WhatsApp.

Os templates aprovados podem ser utilizados em comunicações ativas com clientes, garantindo conformidade com as políticas da Meta/WhatsApp e padronização das mensagens enviadas pela operação.

Além do envio para aprovação, a funcionalidade permite acompanhar o status dos templates e realizar o reenvio de modelos rejeitados, quando necessário.

---

#### ⚠️ Configuração Inicial

Antes de utilizar a funcionalidade, é necessário que a integração com a Twilio esteja devidamente configurada no ambiente.

A liberação da funcionalidade depende de parametrizações realizadas pelo time de Suporte Dommus, incluindo:

- Habilitação das permissões necessárias;

Caso a funcionalidade não esteja disponível ou apresente erros de integração, entre em contato com o Suporte Dommus.

---

#### Como Acessar

1. Acesse o módulo **Conecta**.
2. Navegue até a tela de **Templates**.
3. Será exibida a listagem de templates cadastrados.
4. Clique em **Adicionar** para criar um novo template ou selecione um registro existente para edição.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/I3Kimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/I3Kimage.png)

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/ix8image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/ix8image.png)

---

#### Entendendo a Tela

##### Aba Dados

Concentra as informações principais do template:

<table id="bkmrk-campo-obrigatoriedad"><thead><tr><th>Campo</th><th>Obrigatoriedade</th><th>Descrição</th></tr></thead><tbody><tr><td>Nome do Template</td><td>Obrigatório</td><td>Nome utilizado para identificação do template dentro da plataforma. Recomenda-se utilizar uma nomenclatura clara e padronizada para facilitar a localização e manutenção dos modelos cadastrados.</td></tr><tr><td>Tipo de Atendimento</td><td>Não obrigatório</td><td>Permite vincular o template a um tipo específico de atendimento. O preenchimento é opcional e deve ser utilizado quando houver necessidade de segmentar a utilização do modelo.</td></tr><tr><td>Atendentes Vinculados</td><td>Não obrigatório</td><td>Permite restringir a utilização do template a atendentes específicos. Caso não seja informado, o template ficará disponível conforme as permissões definidas no sistema.</td></tr><tr><td>Ramal do Template</td><td>Não obrigatório</td><td>Permite associar o template a um ramal específico do canal de atendimento. O preenchimento deve ser realizado apenas quando houver necessidade de direcionamento para um ramal determinado.</td></tr></tbody></table>

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/yYBimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/yYBimage.png)

##### Aba Dados Tags

Exibe informações relacionadas à integração e às variáveis utilizadas na mensagem:

<table id="bkmrk-campo-obrigatoriedad-1" style="width: 100%;"><thead><tr><th style="width: 12.3928%;">Campo</th><th style="width: 20.4842%;">Obrigatoriedade</th><th style="width: 67.0992%;">Descrição</th></tr></thead><tbody><tr><td style="width: 12.3928%;">Account SID</td><td style="width: 20.4842%;">Não obrigatório</td><td style="width: 67.0992%;">Identificador da conta responsável pelo template. **Este campo é preenchido automaticamente pelo sistema** após a aprovação do template e não deve ser informado manualmente pelo usuário.</td></tr><tr><td style="width: 12.3928%;">Template ID</td><td style="width: 20.4842%;">Não obrigatório</td><td style="width: 67.0992%;">Identificador único do template. **O preenchimento é realizado automaticamente pelo sistema após a aprovação do template**, não sendo necessário informar qualquer valor durante o cadastro.</td></tr><tr><td style="width: 12.3928%;">Módulo de Origem das Tags</td><td style="width: 20.4842%;">Opcional</td><td style="width: 67.0992%;">Define de qual módulo do sistema serão disponibilizadas as tags dinâmicas para utilização na mensagem. **Deve ser configurado apenas quando houver necessidade de utilizar informações dinâmicas no conteúdo do template.**</td></tr><tr><td style="width: 12.3928%;">Categoria do Template</td><td style="width: 20.4842%;">Obrigatório</td><td style="width: 67.0992%;">Categoria utilizada no processo de validação junto ao WhatsApp. Para utilização desta funcionalidade, deve ser selecionada a opção **Utilidades**.</td></tr></tbody></table>

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/xHhimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/xHhimage.png)

#### Campo Mensagem

Área destinada à construção da mensagem que será enviada para aprovação.

Permite utilizar DommusTags para personalização automática do conteúdo enviado ao cliente.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/6P8image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/6P8image.png)

<span style="color: rgb(34, 34, 34); font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 1.666em; font-weight: 400;">Enviar Aprovação WhatsApp</span>

Responsável por encaminhar o template para análise da Twilio/WhatsApp.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/Zy5image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/Zy5image.png)

#### Habilitar Reenvio do Template

Disponível apenas para templates rejeitados e para usuários com a devida permissão.

Ao utilizar esta opção, um novo template será criado para nova submissão.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/4D0image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/4D0image.png)

---

#### Enviando um Template para Aprovação

1. Preencha todas as informações obrigatórias do template.
2. Monte o conteúdo da mensagem utilizando texto e, se necessário, tags dinâmicas.
3. Clique em **Enviar Aprovação WhatsApp**.
4. Será exibida uma janela solicitando exemplos para cada tag utilizada.
5. Informe valores reais ou exemplos compatíveis com o conteúdo da mensagem.
6. Clique em **Enviar**.
7. O template será enviado para análise da Twilio/WhatsApp.
8. O status passará para **Em Análise**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/s0aimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/s0aimage.png)

#### Informando exemplos das Tags

Sempre que a mensagem possuir variáveis dinâmicas, será necessário informar exemplos para cada tag utilizada.

Esses exemplos são enviados juntamente com o template para auxiliar o processo de validação realizado pela Meta.

Tags repetidas serão exibidas apenas uma vez na janela de preenchimento.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/eoPimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/eoPimage.png)

---

#### Acompanhando o Status do Template

Após o envio para aprovação, o status poderá ser consultado na listagem principal.

Os principais status são:

<table id="bkmrk-status-significado-e"><thead><tr><th>Status</th><th>Significado</th></tr></thead><tbody><tr><td>Em Análise</td><td>Template enviado e aguardando avaliação.</td></tr><tr><td>Aprovado</td><td>Template liberado para utilização.</td></tr><tr><td>Rejeitado</td><td>Template recusado pela Meta/WhatsApp.</td></tr></tbody></table>

Os status também são identificados visualmente através de indicadores na listagem.

- **Verde**: Aprovado
- **Vermelho**: Reprovado

---

#### Reenviando um Template Rejeitado

Quando um template for rejeitado:

1. Abra o cadastro do template.
2. Analise o motivo da rejeição exibido no rodapé da tela.
3. Clique em **Habilitar Reenvio do Template**.
4. Confirme a operação.
5. Realize os ajustes necessários.
6. Efetue um novo envio para aprovação.

Ao habilitar o reenvio:

- O Template ID anterior será removido;
- Um novo template será gerado na Twilio;
- O fluxo de aprovação será reiniciado.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/scaled-1680-/EgXimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-06/EgXimage.png)

---

#### Mensagens e Alertas

<table id="bkmrk-situa%C3%A7%C3%A3o-mensagem-a%C3%A7" style="width: 100%; height: 140.067px;"><thead><tr style="height: 29.8667px;"><th style="width: 12.6353%; height: 29.8667px;">Situação</th><th style="width: 36.471%; height: 29.8667px;">Mensagem</th><th style="width: 50.9036%; height: 29.8667px;">Ação Recomendada</th></tr></thead><tbody><tr style="height: 33.6667px;"><td style="width: 12.6353%; height: 33.6667px;">Alerta</td><td style="width: 36.471%; height: 33.6667px;">Template SID inválido ou Template ID inválido</td><td style="width: 50.9036%; height: 33.6667px;">Verificar as configurações da integração Twilio.</td></tr><tr style="height: 29.8667px;"><td style="width: 12.6353%; height: 29.8667px;">Confirmação</td><td style="width: 36.471%; height: 29.8667px;">Deseja habilitar o reenvio do template?</td><td style="width: 50.9036%; height: 29.8667px;">Confirmar para gerar um novo template.</td></tr><tr style="height: 46.6667px;"><td style="width: 12.6353%; height: 46.6667px;">Erro</td><td style="width: 36.471%; height: 46.6667px;">Failed to create template</td><td style="width: 50.9036%; height: 46.6667px;">Revisar estrutura da mensagem e orientações de aprovação do WhatsApp.</td></tr></tbody></table>

---

#### Situações Comuns de Uso

##### Criar um novo template

Criar um template da categoria Marketing para envio de campanhas, informando exemplos das tags utilizadas durante o processo de aprovação.

##### Criar template com botões

Utilizar o tipo Resposta Rápida para disponibilizar opções de interação diretamente na mensagem enviada ao cliente.

##### Corrigir template rejeitado

Revisar o motivo da rejeição, ajustar o conteúdo e realizar uma nova submissão utilizando a opção de reenvio.

---

#### Boas Práticas e Pontos de Atenção

- Utilize nomes claros e padronizados para facilitar a identificação dos templates.
- Evite excesso de variáveis consecutivas na mensagem.
- Sempre informe exemplos coerentes para as tags utilizadas.
- Revise o conteúdo antes de solicitar aprovação.
- Atualize a listagem de templates para consultar mudanças de status.
- Evite mensagens genéricas ou com excesso de conteúdo promocional.
- Siga as diretrizes da Meta para aumentar as chances de aprovação.  
      
    <p class="callout info">**Importante**: A aprovação ou rejeição dos templates é realizada pelos serviços da Meta/WhatsApp. A Dommus não possui controle sobre o processo de validação.</p>

---

#### Glossário

<table id="bkmrk-termo-descri%C3%A7%C3%A3o-twil" style="width: 63.5714%; height: 204.2px;"><thead><tr style="height: 29.6px;"><th style="width: 18.7032%; height: 29.6px;">Termo</th><th style="width: 81.079%; height: 29.6px;">Descrição</th></tr></thead><tbody><tr style="height: 29.6px;"><td style="width: 18.7032%; height: 29.6px;">Template</td><td style="width: 81.079%; height: 29.6px;">Modelo de mensagem previamente aprovado para envio.</td></tr><tr style="height: 29.6px;"><td style="width: 18.7032%; height: 29.6px;">Account SID</td><td style="width: 81.079%; height: 29.6px;">Identificador único da conta.</td></tr><tr style="height: 29.6px;"><td style="width: 18.7032%; height: 29.6px;">Template ID</td><td style="width: 81.079%; height: 29.6px;">Identificador único do template.</td></tr><tr style="height: 29.6px;"><td style="width: 18.7032%; height: 29.6px;">DommusTags</td><td style="width: 81.079%; height: 29.6px;">Variáveis utilizadas para personalização automática das mensagens.</td></tr></tbody></table>

# 6. Acompanhamento de Atendentes



# 6.1 Como funciona o dashboard

O **Acompanhamento de Atendentes em Tempo Real** é um recurso avançado do Conecta que permite ao gestor monitorar a performance da equipe de atendimento de forma imediata e precisa.

Esse recurso está disponível no **menu lateral**, na opção **“Acompanhar Atendentes” → “Acompanhamento em Tempo Real.”**

<p class="callout info">**No círculo vermelho é possível adicionar a foto do atendente**</p>

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/scaled-1680-/8KNimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2025-10/8KNimage.png)

#### **Funcionamento**

Ao acessar o painel, é exibido um **dashboard dinâmico** com cartões individuais de cada atendente, apresentando informações atualizadas conforme a atividade no sistema.

Esse dashboard é **configurado internamente pela Dommus**, sendo necessário solicitar a habilitação da funcionalidade.  
Após a ativação, o Conecta passa a reunir automaticamente os principais indicadores de desempenho dos atendentes.

#### **Indicadores Disponíveis**

Entre as métricas apresentadas no painel estão:

- **Tempo online** de cada atendente;
- **Quantidade total de atendimentos realizados**;
- **Atendimentos via VoIP**, incluindo:
    
    
    - Ligações **recebidas** e **realizadas**;
    - **Minutagem total** de chamadas;
    - **Tempo máximo de ligação**;
- **Produtividade geral** do atendente;
- **Atendimentos via WhatsApp**;
- **Resgates realizados na Sala de Espera**;
- **Atendimentos concluídos**;
- **E-mails e tickets abertos.**

#### **Objetivo**

Com essas informações, o gestor consegue:

- Visualizar o **desempenho individual e coletivo** da equipe;
- Identificar gargalos de atendimento ou sobrecarga em determinados canais;
- Tomar **decisões rápidas e embasadas** sobre alocação de atendentes e prioridades;
- Acompanhar a **eficiência operacional em tempo real**.

# 7. Tags de Atendimento



# Tags de Atendimento

As **Tags de Atendimento** são utilizadas como identificadores visuais (flags), permitindo categorizar e facilitar a identificação dos atendimentos dentro do sistema.

---

### Cadastro de Tags

Para criar uma nova tag, acesse a tela de **Tags de Atendimento**:

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/scaled-1680-/PNZimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/PNZimage.png)

Em seguida:

- Clique para adicionar uma nova tag
- Informe o **nome da tag**
- Clique em **Salvar**

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/scaled-1680-/xvNimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/xvNimage.png)

👉 As tags cadastradas ficarão disponíveis para uso nos atendimentos.

---

### Vinculando uma tag ao atendimento

Para associar uma tag a um atendimento específico:

- Acesse o atendimento desejado
- Clique em **Editar**

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/scaled-1680-/XsVimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/XsVimage.png)

Na tela de edição:

- Localize o campo **Tags do Atendimento**
- Selecione a tag desejada

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/scaled-1680-/gLpimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/gLpimage.png)

- Clique em **Salvar Alterações**

---

### Visualização no atendimento

Após a inclusão:

- A tag ficará visível no **card do atendimento**
- Permitindo uma identificação rápida do contexto ou prioridade[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/scaled-1680-/9tdimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-04/9tdimage.png)

---

### Exemplos de uso

As tags podem ser utilizadas para identificar situações como:

- Lead quente
- Cliente recorrente
- Prioridade alta
- Pós-venda

---

### Observações Importantes

- As tags são opcionais, mas recomendadas para organização
- Um mesmo atendimento pode possuir mais de uma tag
- As tags facilitam a filtragem e identificação visual dos atendimentos

# 8. Agenda de Contatos



# 8.1. Cadastrando um Novo Contato

#### Visão Geral

Agora é possível criar uma agenda de contatos no Dommus para facilitar a abertura de atendimentos.

Após cadastrar um contato, ele poderá ser reutilizado durante a criação de novos atendimentos, independentemente do meio de comunicação utilizado.

A funcionalidade permite localizar contatos previamente cadastrados através da agenda disponível na tela de atendimento.

<div contenteditable="false" id="bkmrk-">---

</div>#### Como Acessar a Funcionalidade

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/scaled-1680-/zErimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/zErimage.png)

Para acessar a funcionalidade:

1. Acesse a tela `Agenda de Contatos`.
2. No canto superior direito, clique em `+ Novo Contato`.
3. A tela de cadastro do contato será exibida.

Para utilizar um contato salvo durante um atendimento:

1. Inicie um novo atendimento.
2. No campo `Contato Destinatário`, clique no ícone de agenda.
3. A janela `Agenda de Contatos` será exibida.
4. Pesquise o contato desejado.
5. Selecione o contato para iniciar o atendimento.

<div contenteditable="false" id="bkmrk--2">---

</div>#### Entendendo a Tela

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/scaled-1680-/DFSimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/DFSimage.png)

Na tela `Agenda de Contatos`, o sistema apresenta um painel com os indicadores:

- `Total de Contatos`
- `Com Número`
- `Com E-mail`
- `Adicionados Hoje`

Na parte superior direita da tela existe:

- Campo de pesquisa por nome, telefone ou e-mail
- Botão `+ Novo Contato`

A listagem principal apresenta as colunas:

- Nome
- Telefone
- E-mail
- Status
- Ações

**Durante a abertura de um novo atendimento**, o sistema exibe um ícone de agenda ao lado do campo `Contato Destinatário`.

Ao clicar nesse ícone, será aberta a janela `Agenda de Contatos`, contendo:

- Campo de pesquisa de contatos
- Lista de contatos cadastrados
- Mensagem `Nenhum contato encontrado.` quando não houver registros localizados

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/scaled-1680-/lJFimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/lJFimage.png)

<div contenteditable="false" id="bkmrk--5">---

</div>#### Como Preencher as Informações

Ao cadastrar um novo contato, informe:

<table id="bkmrk-campo-descri%C3%A7%C3%A3o-nome"><tbody><tr><th>Campo</th><th>Descrição</th></tr><tr><td>Nome</td><td>Nome do contato</td></tr><tr><td>E-mail</td><td>E-mail do contato</td></tr><tr><td>Celular</td><td>Número de celular do contato</td></tr></tbody></table>

Após preencher as informações, salve o cadastro.

<div contenteditable="false" id="bkmrk--6">---

</div>#### Cadastro de novo contato

1. Acesse a tela `Agenda de Contatos`.
2. Clique em `+ Novo Contato`.
3. Preencha as informações do contato.
4. Salve o cadastro.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/scaled-1680-/hdiimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/hdiimage.png)

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/scaled-1680-/Qd9image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-05/Qd9image.png)

#### Utilização do contato em um atendimento

1. Inicie um novo atendimento.
2. Clique no ícone de agenda ao lado do campo `Contato Destinatário`.
3. Localize o contato desejado.
4. Selecione o contato.
5. Continue o processo de abertura do atendimento.

<div contenteditable="false" id="bkmrk--9">---

</div>#### O Que Acontece Depois

Após salvar o contato:

- O contato fica disponível na `Agenda de Contatos`
- O contato poderá ser reutilizado em novos atendimentos
- O contato poderá ser localizado através da pesquisa

<div contenteditable="false" id="bkmrk--10">---

</div>#### Mensagens que Podem Aparecer

<table id="bkmrk-situa%C3%A7%C3%A3o-mensagem-ex"><tbody><tr><td>Situação</td><td>Mensagem exibida</td><td>Como proceder</td></tr><tr><td>Nenhum contato encontrado</td><td>`Nenhum contato encontrado.`</td><td>Verifique se o contato foi cadastrado corretamente</td></tr></tbody></table>

<div contenteditable="false" id="bkmrk--11">---

</div><div contenteditable="false" id="bkmrk--12">---

</div>#### Pontos de Atenção

- Verifique os dados do contato antes de salvar
- Utilize a pesquisa para localizar contatos rapidamente
- Mantenha os contatos atualizados

# 9. Gestão de Agentes de IA



# 9.1 Entendendo o Agente de IA

## Pré-requisitos

Antes de criar seu primeiro Agente de IA, é necessário que a equipe técnica da Dommus realize algumas configurações iniciais na sua conta. Essas configurações são feitas uma única vez.

**Se sua empresa ainda não possui essas configurações, entre em contato com o time de suporte técnico da Dommus.**

Após a conclusão, você poderá criar e gerenciar seus Agentes de IA normalmente.

## 1. Visão Geral

A Gestão de Agentes de IA permite que administradores do inquilino criem e configurem agentes de atendimento automatizados que representam a empresa em canais como WhatsApp. Cada agente é personalizado com identidade corporativa, tom de voz e capacidades específicas, funcionando como um representante virtual da organização.

Esta funcionalidade resolve a necessidade de oferecer atendimento automatizado sem exigir intervenção técnica da Dommus. O administrador configura o agente uma única vez, associa-o aos canais de comunicação desejados e o sistema provisiona automaticamente a integração com a OpenAI. Além disso, todas as ações são rastreadas para auditoria, garantindo conformidade e segurança.

A funcionalidade é utilizada por administradores que desejam implementar atendimento por IA, sem necessidade de conhecimento técnico profundo. Os benefícios incluem redução de custos operacionais, disponibilidade 24/7 de atendimento, e rastreabilidade completa de todas as interações automatizadas.

---

## 2. Como acessar

Configurações → Agentes de IA

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/pMVimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/pMVimage.png)

Alternativamente, é possível vincular um agente a um canal diretamente na tela de Ramais, sem navegar até a Gestão de Agentes.

---

## 3. Conhecendo a tela

A tela de Gestão de Agentes de IA é organizada em uma listagem principal que exibe todos os agentes cadastrados no cliente. No topo, o botão **"Mais"** permite criar um novo agente. A tabela paginada apresenta as informações essenciais de cada agente, facilitando a visualização e o gerenciamento rápido.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/itZimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/itZimage.png)

Cada linha da tabela oferece ações diretas: editar configurações, **ativar ou inativar o agente, e rotacionar a chave de API.** Um agente inativo não será utilizado em novos atendimentos, mas suas configurações são preservadas para reativação posterior.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/lIeimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/lIeimage.png)

---

## 4. Campos da tela

### Nome do Agente

Nome de apresentação do agente que será exibido aos clientes finais.

**Tipo:** Texto

**Obrigatório:** Sim

**Regras:**

- Máximo de 100 caracteres.
- Campo obrigatório para salvar.

---

### Modelo do Agente

Define o tipo de agente a ser criado. O modelo pré-seleciona o modelo OpenAI recomendado e exibe apenas as capacidades disponíveis para esse modelo.

**Tipo:** Lista (select)

**Opção:** Atendimento Pré-Venda

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/LXDimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/LXDimage.png)

---

### Modelo de IA

Versão específica do modelo de inteligência artificial da OpenAI que será utilizada pelo agente.

**Tipo:** Lista (select)

**Obrigatório:** Sim

**Regras:**

- Pré-preenchido automaticamente com o modelo padrão sugerido pelo Modelo do Agente selecionado.
- Editável, permitindo seleção de outras versões disponíveis.
- Exemplo de valores: `gpt-4o-mini`, `gpt-4o`, etc.  
      
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/70Limage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/70Limage.png)

---

### Chave de API OpenAI

Credencial fornecida pelo usuário **interno** para autenticar o agente junto à OpenAI.

**Tipo:** Texto (campo de senha)

**Obrigatório:** Sim (na criação); Opcional (na edição)

**Regras:**

- Informada manualmente pelo operador durante a criação.
- Persistida de forma cifrada no backend; nunca é exibida após o salvamento.
- Na edição, um checkbox "Adicionar nova chave de API" permite informar uma nova chave sem alterar a anterior.
- Se o checkbox estiver desmarcado, a chave existente é mantida sem alteração.
- Se o checkbox estiver marcado e o campo vazio, validação impede o envio com mensagem "Informe a nova chave de API."

---

### Usuário-ator (auditoria)

Usuário do sistema responsável pela criação ou edição do agente. Este campo é utilizado para rastreamento em logs de auditoria.

**Tipo:** Lista pesquisável (select)

**Obrigatório:** Sim

**Regras:**

- Carregado com usuários ativos da sua base.
- Campo obrigatório para salvar.  
      
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/0Ovimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/0Ovimage.png)

---

### Personalidade

Descrição do tom de voz e estilo de comunicação do agente. Define como o agente se comportará nas interações com clientes.

**Tipo:** Área de texto (textarea)

**Obrigatório:** Sim

**Regras:**

- Máximo de 1.000 caracteres.
- Campo obrigatório para salvar.  
      
    **Exemplo:**
    
    > Você é o DOM, SDR da Construtora Dommus, construtora referência em imóveis de alto padrão. Seu objetivo é qualificar leads e agendar reuniões com os Consultores Executivos.
    > 
    >  **Tom de Voz e Linguagem:** Formal, elegante, sofisticado, caloroso e genuinamente acolhedor. Português culto, impecável e fluido — proibido usar gírias, jargões agressivos de vendas ou linguagem robótica. Sempre trate por "Senhor(a)" ou pelo nome precedido de cortesia (ex.: "Sr. Eduardo").
    > 
    >  **Postura e Princípios:** Consultiva e Discreta — priorize a escuta ativa, respeitando o tempo e a privacidade do cliente. Sofisticação Sem Pressa — esqueça gatilhos de urgência ("Últimas unidades!"). O alto padrão exige paciência e exclusividade. Limites — seja solícita e segura, mas nunca negocie preços ou invente dados técnicos; direcione dúvidas complexas ao consultor com elegância.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/WVgimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/WVgimage.png)

---

### Políticas da Empresa

Permite cadastrar orientações e regras específicas da empresa que devem ser consideradas pelo Agente de IA durante os atendimentos.

Utilize este campo para informar políticas, procedimentos ou diretrizes que o agente deve seguir ao interagir com os clientes.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/gv6image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/gv6image.png)

### Nome da empresa

Nome da empresa representada pelo agente.

**Tipo:** Texto

**Obrigatório:** Sim

**Regras:**

- Máximo de 200 caracteres.
- Campo obrigatório para salvar.

---

### Descrição da empresa

Informações sobre produtos, serviços, diferenciais e contexto geral da empresa. O agente utiliza essas informações para fornecer respostas contextualizadas aos clientes.

**Tipo:** Área de texto (textarea)

**Obrigatório:** Sim

**Regras:**

- Máximo de 2.000 caracteres.
- Campo obrigatório para salvar.

**Exemplo:**

> **Construtora Dommus — Referência em Imóveis de Alto Padrão**
> 
> Desde 2018, a Dommus se posiciona como uma construtora diferenciada no mercado imobiliário de alto padrão. Nossa missão transcende a simples construção de empreendimentos; buscamos estabelecer relações duradouras e significativas com cada cliente, compreendendo profundamente seus objetivos, desejos e aspirações.
> 
> Acreditamos que excelência não se limita ao produto final. Acompanhamos nossos clientes em todas as etapas da jornada: na fase de exploração e dúvidas, durante o processo de aquisição e construção, e, principalmente, após a entrega, mantendo um relacionamento próximo e atencioso. Cada empreendimento Dommus é resultado de um compromisso inabalável com a qualidade, a sofisticação e o cuidado personalizado.
> 
> Nossos diferenciais incluem: arquitetura contemporânea e sustentável, acabamentos premium, localização estratégica em regiões valorizadas, e um atendimento consultivo que prioriza a escuta ativa e a exclusividade. Contamos com uma rede consolidada de fornecedores, parceiros e consultores especializados, todos alinhados à nossa filosofia de excelência.
> 
> Hoje, a Dommus é sinônimo de confiança, inovação e realização de sonhos imobiliários para famílias que buscam mais do que um lar — buscam um legado.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/1lZimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/1lZimage.png)

---

### Temperatura

Parâmetro que controla a criatividade e variabilidade das respostas do agente. Valores mais baixos produzem respostas mais previsíveis; valores mais altos, mais criativas.

**Tipo:** Número (decimal)

**Obrigatório:** Sim

**Regras:**

- Intervalo: 0 a 2.
- Passo: 0,1.
- Valor padrão: 1,0.
- Campo obrigatório para salvar.

---

### Identificador público da chave

Identificador único e público da chave de API OpenAI associada ao agente. Utilizado para rastreabilidade de custos e identificação da chave sem expor seu valor secreto.

**Tipo:** Texto (somente leitura)

**Obrigatório:** Não

**Regras:**

- Gerado automaticamente pelo sistema ao criar o agente.
- Exibido apenas após o salvamento.
- Acompanhado de botão "Copiar" para facilitar a cópia para a área de transferência.
- Nunca editável pelo usuário.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/5yTimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/5yTimage.png)

---

## 5. Funcionalidades

### Gerenciar capacidades

As capacidades representam funcionalidades específicas que o agente pode executar. Cada modelo de agente possui um conjunto de capacidades compatíveis.

**Passo a passo:**

1. Abra o modal de edição do agente (conforme descrito acima).
2. Clique na aba "Capacidades".
3. A aba exibe a lista de capacidades atualmente vinculadas ao agente.  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/RBQimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/RBQimage.png)
4. Para adicionar uma capacidade: 
    - Selecione a capacidade e selecione o botão "+ Adicionar".
    - Um select pesquisável aparece com as capacidades disponíveis (excluindo as já vinculadas).
    - Selecione uma capacidade.
    - Clique no botão verde de confirmação.  
        [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/TqEimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/TqEimage.png)
5. Para remover uma capacidade: 
    - Clique no ícone de lixeira (remover) ao lado da capacidade desejada.  
        [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/8M0image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/8M0image.png)

---

### Gerenciar bases de conhecimento

As bases de conhecimento fornecem informações contextuais que o agente utiliza para responder perguntas dos clientes com precisão.

**Passo a passo:**

1. Abra o modal de edição do agente.
2. Clique na aba "Bases de Conhecimento".
3. A aba exibe a lista de bases atualmente vinculadas ao agente.
4. Se não houver bases cadastradas no sistema, a mensagem "Nenhuma Base de Conhecimento cadastrada." é exibida.
5. É permitido ter zero bases vinculadas.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/j1rimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/j1rimage.png)

---

### Gerenciar contatos de origem

Os contatos de origem representam os canais de comunicação (como números de WhatsApp) através dos quais o agente atenderá os clientes.

**Passo a passo:**

1. Abra o modal de edição do agente.
2. Clique na aba "Contatos de Origem".
3. A aba exibe a lista de contatos de origem atualmente vinculados ao agente.
4. Para adicionar um contato: 
    - Clique no campo "Selecione" ou no botão "+ Adicionar".
    - Um select pesquisável aparece com os contatos disponíveis
    - Contatos já vinculados a outro agente exibem uma indicação visual ("vinculado ao Agente X") e podem ser reatribuídos.
    - Selecione um contato.
    - Clique no botão verde de confirmação[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/Q81image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/Q81image.png)
5. Para remover um contato: 
    - Clique no ícone de lixeira (remover) ao lado do contato desejado.  
        [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/SMyimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/SMyimage.png)
    - O contato é removido e uma mensagem de sucesso é exibida: "Contato de Origem removido com sucesso."

---

### Ativar ou inativar agente

Um agente inativo não será utilizado em novos atendimentos, mas suas configurações são preservadas.

**Passo a passo:**

1. Na tabela de agentes, localize o agente desejado.
2. Na coluna "Ações", clique no ícone de ativar/inativar (alternador ou ícone específico).  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/0H9image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/0H9image.png)

---

### Rotacionar chave de API

A rotação de chave permite gerar uma nova credencial OpenAI sem excluir o agente, mantendo a segurança.

**Passo a passo:**

1. Na tabela de agentes, localize o agente desejado.
2. Na coluna "Ações", clique no ícone de rotacionar chave (chave ou ícone específico).
3. Uma caixa de confirmação aparece: "Deseja rotacionar a chave de API? A chave atual será revogada."
4. Clique em "Confirmar".
5. O sistema gera uma nova chave OpenAI e revoga a anterior.
6. A lista é recarregada e uma mensagem de sucesso é exibida: "Chave de API rotacionada com sucesso."
7. O identificador público da chave (`id_chave_api_openai`) na tabela é atualizado.
8. O valor secreto da nova chave nunca é exibido no frontend.

---

### Vincular agente de IA na tela de Ramais

É possível vincular um agente diretamente na tela de Ramais, sem navegar até a Gestão de Agentes.

**Passo a passo:**

1. Acesse Configurações → Ramais.  
    [![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/Rdkimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/Rdkimage.png)
2. Na tabela de ramais, localize a coluna "Agente de IA".
3. Clique no select da linha desejada.
4. Selecione o agente desejado.

---

## 6. Regras de negócio

- **Modelo imutável:** O Modelo do Agente não pode ser alterado após a criação. Se for necessário mudar o modelo, um novo agente deve ser criado.
- **Provisionamento automático:** Ao criar um agente, o sistema provisiona automaticamente a integração com a OpenAI usando a chave informada. O operador não precisa fazer nada além de fornecer a chave.
- **Rastreabilidade de auditoria:** O campo "Usuário-ator" registra qual usuário criou ou editou o agente, permitindo rastreamento completo em logs de auditoria.
- **Agente inativo preserva configuração:** Inativar um agente não desvincula seus contatos de origem nem apaga suas configurações. O agente pode ser reativado posteriormente com todas as suas definições intactas.
- **Contatos de origem reatribuíveis:** Um contato de origem pode ser reatribuído de um agente para outro sem restrições, permitindo flexibilidade na configuração de canais.
- **Capacidades contextuais:** Apenas as capacidades compatíveis com o modelo selecionado são exibidas e disponíveis para vinculação.
- **Bases de conhecimento opcionais:** Um agente pode operar sem bases de conhecimento vinculadas. As bases são opcionais e utilizadas para enriquecer as respostas do agente.
- **Tenant-scoped:** Todos os agentes, capacidades e contatos são isolados por inquilino (tenant). Um usuário só consegue visualizar e gerenciar agentes do seu próprio inquilino.

---

## 7. Fluxo da funcionalidade

**Fluxo de criação e configuração completa de um agente:**

1. Administrador acessa Configurações → Agentes de IA.
2. Clica em "Novo Agente".
3. Modal abre com a aba "Dados do Agente".
4. Seleciona o Modelo do Agente (ex: "Atendimento Pré-Venda").
5. Preenche Nome, Chave de API OpenAI, Usuário-ator, Personalidade, Nome da empresa e Descrição da empresa.
6. Ajusta Modelo de IA e Temperatura conforme necessário.
7. Clica em "Salvar".
8. Sistema valida os dados e cria o agente com a chave cifrada.
9. Modal fecha e mensagem de sucesso é exibida.
10. Lista é recarregada exibindo o novo agente.
11. Administrador clica em "Editar" para abrir o modal novamente.
12. Agora as abas "Capacidades", "Bases de Conhecimento" e "Contatos de Origem" estão disponíveis.
13. Na aba "Capacidades", adiciona as capacidades desejadas (ex: "Consulta de Disponibilidade", "Agendamento de Visita").
14. Na aba "Bases de Conhecimento", vincula bases relevantes (se disponíveis).
15. Na aba "Contatos de Origem", vincula os canais de comunicação (números de WhatsApp).
16. Clica em "Salvar".
17. Agente está pronto para atender clientes nos canais vinculados.

---

## 8. Observações

- **Chave de API nunca é exibida:** Por razões de segurança, o valor secreto da chave de API OpenAI nunca aparece no frontend em nenhuma circunstância, nem durante a criação, edição ou rotação.
- **Identificador público para rastreabilidade:** O campo `id_chave_api_openai` (identificador público) é exibido para permitir rastreamento de custos e auditoria, sem expor a chave secreta.
- **Operação de rotação de chave é atômica:** O backend garante que a nova chave seja criada, o registro atualizado e a chave anterior revogada de forma atômica. Em caso de erro parcial, a chave anterior permanece válida.
- **Modelo OpenAI não validado em tempo de configuração:** Se um modelo OpenAI inexistente for informado, a validação ocorre apenas no primeiro atendimento. A UI exibe um aviso informativo durante a edição.
- **Abas de edição não aparecem na criação:** As abas "Capacidades", "Bases de Conhecimento" e "Contatos de Origem" só são exibidas no modal de edição, após o agente ser criado. Isso simplifica o fluxo de criação inicial.
- **Capacidades com slug não encontrado:** Se uma capacidade tiver seu slug removido do código, ela aparecerá na UI com uma badge "indisponível" e um tooltip explicativo, sem bloquear a edição dos demais campos.
- **Integração com Twilio:** A coexistência de um Agente de IA da Dommus e uma integração Twilio é permitida. O Agente de IA da Dommus tem prioridade no fluxo de atendimento, conforme informado ao operador.
- **Alterações entram em vigor imediatamente:** Qualquer alteração salva em um agente entra em vigor imediatamente para novos atendimentos. Atendimentos em andamento não são afetados.
- **Cópia de identificador público:** O botão "Copiar" ao lado do `id_chave_api_openai` facilita a cópia do identificador para a área de transferência, útil para rastreamento externo.

# 9.2. Capacidade de Criação de Lead/OPV

## Visão Geral

A funcionalidade **Envio do Lead ao CRM - Dommus Prospecta** permite que o Agente de IA envie automaticamente para o Dommus Prospecta os leads identificados durante os atendimentos realizados pelo WhatsApp.

Com a integração, o lead é criado no CRM com as informações de **Empreendimento, Mídia, Origem e Campanha**, facilitando a continuidade do atendimento comercial.

## Antes de Começar

Antes de utilizar a funcionalidade, é necessário:

- Ter um **Agente de IA** cadastrado no Dommus Conecta.
- Ter um **ramal de WhatsApp** configurado e associado ao Agente de IA.
- Ativar a capacidade **Envio do Lead ao CRM - Dommus Prospecta** no Agente de IA.
- Configurar os mapeamentos de **Mídias, Origens e Campanhas** no Dommus Prospecta.

---

## Como Configurar

### 1. Ativar a capacidade no Agente de IA

Acesse **Configurações &gt; Agentes de IA**, localize o agente desejado e clique em **Editar**.

Na aba **Capacidades**, adicione a opção **Envio do Lead ao CRM - Dommus Prospecta**.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/xR9image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/xR9image.png)

### 2. Configurar o ramal do WhatsApp

Acesse **Configurações &gt; Ramais** e, na seção **WhatsApp**, edite o ramal utilizado no atendimento.

Confira se o **Agente de IA** está corretamente associado ao ramal.

### 3. Configurar os mapeamentos

No Dommus Prospecta, acesse **Configurações &gt; Mapeamentos**.

Configure as informações utilizadas pela integração:

<table id="bkmrk-configura%C3%A7%C3%A3o-valor-u" style="width: 35.2381%; height: 118.722px;"><thead><tr style="height: 29.6806px;"><th style="width: 34.4405%; height: 29.6806px;">Configuração</th><th style="width: 65.1463%; height: 29.6806px;">Valor utilizado</th></tr></thead><tbody><tr style="height: 29.6806px;"><td style="width: 34.4405%; height: 29.6806px;">**Mídia**</td><td style="width: 65.1463%; height: 29.6806px;">WHATSAPP</td></tr><tr style="height: 29.6806px;"><td style="width: 34.4405%; height: 29.6806px;">**Origem**</td><td style="width: 65.1463%; height: 29.6806px;">CENTRAL DE ATENDIMENTO</td></tr><tr style="height: 29.6806px;"><td style="width: 34.4405%; height: 29.6806px;">**Campanha**</td><td style="width: 65.1463%; height: 29.6806px;">CAMPANHA PADRÃO</td></tr></tbody></table>

---

## Como Funciona

Após as configurações, o fluxo ocorre automaticamente:

1. O cliente inicia um atendimento pelo WhatsApp.
2. O Agente de IA realiza o atendimento e identifica o empreendimento de interesse.
3. A capacidade envia as informações do lead para o Dommus Prospecta.
4. O lead é criado como uma oportunidade no CRM.
5. O registro fica disponível em **Lista de Oportunidades**.

### Identificação do Empreendimento

O Agente de IA tenta identificar o empreendimento durante a conversa com o cliente.

Caso não consiga identificar a informação durante o atendimento, o sistema utiliza o empreendimento configurado no **contato de origem**.

---

## Pontos de Atenção

- Verifique se a capacidade **Envio do Lead ao CRM - Dommus Prospecta** está ativa no Agente de IA.
- Confirme se o ramal do WhatsApp está associado ao agente correto.
- Mantenha os mapeamentos de **Mídia, Origem e Campanha** configurados no Dommus Prospecta.
- A oportunidade somente poderá ser criada corretamente se as informações necessárias estiverem devidamente mapeadas.

---

## Resultado

Após o atendimento, a oportunidade criada pelo Agente de IA pode ser consultada na tela **Lista de Oportunidades** do Dommus Prospecta.

# 9.3 Consulta de Produtos por Empreendimento

## Visão Geral

A capacidade **Consulta de Produtos - Empreendimentos** permite que o agente de IA consulte informações dos empreendimentos cadastrados no sistema e utilize esses dados durante o atendimento aos clientes.

A partir da configuração do empreendimento e da habilitação dessa capacidade, o agente pode consultar informações como:

- Unidades disponíveis;
- Valores;
- Atrativos e características do empreendimento;
- Características das unidades, como tipologia, área, quartos, suítes, banheiros e vagas;
- Fotos cadastradas.

---

## Antes de Começar

Para utilizar a capacidade, é necessário:

- Possuir um empreendimento cadastrado em **VENDE &gt; Configurações &gt; Gestão de Empreendimentos**;
- Configurar o empreendimento para exibição aos clientes;
- Preencher corretamente as informações das unidades;
- Habilitar a capacidade **Consulta de Produtos - Empreendimentos** no agente de IA.

---

## Como Configurar

### 1. Configurar o Empreendimento

Acesse **VENDE &gt; Configurações &gt; Gestão de Empreendimentos** e edite o empreendimento que será disponibilizado para consulta.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/KtMimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/KtMimage.png)

Na aba **Cadastro**, confira as seguintes configurações:

**Exibir para o Cliente (chatbots)?**

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/AI7image.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/AI7image.png)

Deve estar habilitado para permitir que o empreendimento seja consultado pelo agente de IA.

**Tipo**

Deve estar configurado como:

**Empreendimento de Fato - Lançamento, Incorporação, Loteamento e Afins**

Empreendimentos configurados como **Catálogo de Imóveis Avulsos** não terão suas unidades consultadas por essa capacidade.

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/qvpimage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/qvpimage.png)

### 2. Conferir as Informações das Unidades

As unidades devem estar cadastradas com suas respectivas informações, como:

- Tipologia;
- Disponibilidade;
- Valores;
- Área;
- Quartos;
- Suítes;
- Banheiros;
- Vagas;
- Galeria de fotos.

### 3. Habilitar a Capacidade de IA

No **Dommus Conecta,** na configuração do agente de IA, habilite a capacidade:

**Consulta de Produtos - Empreendimentos**

[![image.png](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/scaled-1680-/p2himage.png)](https://duvida.dommus.com.br/uploads/images/gallery/2026-08/p2himage.png)

Após essas configurações, o agente estará apto a consultar os dados dos empreendimentos configurados.

---

## Informações Consultadas pelo Agente

Durante o atendimento, o agente de IA pode consultar e apresentar ao cliente as informações cadastradas no empreendimento.

### Unidades Disponíveis

Permite consultar as unidades disponíveis para venda e suas respectivas características.

### Valores

Permite consultar os valores cadastrados para as unidades.

### Atrativos do Empreendimento

Permite utilizar as características e informações cadastradas sobre o empreendimento para complementar a apresentação ao cliente.

### Características das Unidades

O agente pode consultar informações como:

- Tipologia;
- Área;
- Quartos;
- Suítes;
- Banheiros;
- Vagas.

### Galeria

Quando houver imagens cadastradas, as fotos vinculadas às unidades também podem ser utilizadas na consulta.

---

## O Que Acontece Depois

Com o empreendimento corretamente configurado e a capacidade **Consulta de Produtos - Empreendimentos** habilitada, o agente passa a consultar essas informações durante os atendimentos.

Por exemplo, ao receber uma solicitação sobre determinado empreendimento, o agente pode consultar as unidades disponíveis e apresentar ao cliente opções com seus respectivos valores e características.

---

## Em Caso de Erro

Caso o agente não encontre as informações do empreendimento, verifique:

- Se **Exibir para o Cliente (chatbots)?** está habilitado;
- Se o **Tipo** do empreendimento está configurado corretamente;
- Se existem unidades cadastradas e disponíveis;
- Se as informações das unidades estão preenchidas;
- Se a capacidade **Consulta de Produtos - Empreendimentos** está habilitada para o agente.

Se as configurações estiverem corretas e o agente continuar sem consultar os dados, procure o suporte da Dommus.

---

## Boas Práticas e Pontos de Atenção

- Mantenha as informações dos empreendimentos e unidades atualizadas.
- Mantenha os valores e a disponibilidade das unidades atualizados.
- Preencha as características das unidades para permitir respostas mais completas.
- Cadastre fotos na galeria sempre que disponíveis.
- A qualidade das informações apresentadas pelo agente depende dos dados cadastrados no sistema.