Use este guia quando você precisar configurar, entender ou validar **Como fazer sua primeira conversa de teste** na IAra.

## Antes de começar na IAra

- Confirme que seu usuário tem permissão para acessar a área citada no artigo.
- Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
- Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

## Guia detalhado

Bem-vindo a IAra! Esta é a primeira etapa de uma série prática que leva você de uma conta totalmente nova a um suporte técnico em pleno funcionamento. Ao final desta lição, você terá uma caixa de entrada de site funcionando e terá respondido à primeira mensagem do cliente.

## O que você aprenderá

* O que é IAra e como ele se encaixa na sua pilha de suporte

* O que são canais e caixas de entrada e como eles se relacionam

* Como uma mensagem do cliente se torna uma conversa no seu painel

* Como configurar uma caixa de entrada de chat ao vivo em um site em menos de cinco minutos

* Como enviar sua primeira resposta e resolver a conversa

**Você precisará de:** Uma conta da IAra (a avaliação gratuita funciona) e qualquer site onde você possa colar um trecho de código. Não tem um site à mão? Você pode testar em um arquivo HTML local.

---

## O que é IAra?

IAra é um painel único para todas as conversas com clientes que sua empresa tem - e-mail, chat ao vivo no site, WhatsApp, Instagram, Facebook, SMS, Telegram e muito mais. Em vez de alternar entre cinco aplicativos diferentes e perder o controle de quem disse o quê, sua equipe trabalha em um só lugar, com contexto, histórico e ferramentas compartilhados.

Pense nela como a **caixa de entrada compartilhada para clientes** da sua equipe, mas com a automação, os relatórios e os ajudantes de IA que uma equipe de suporte real precisa.

\

---

## Canais e caixas de entrada (o único conceito a ser entendido primeiro)

Um **canal** é um *tipo* de comunicação — e-mail, site, WhatsApp, SMS, etc.

Uma **caixa de entrada** é uma *instância específica* de um canal conectado à sua conta. Por exemplo:

* "support[@]acme.com" é uma caixa de entrada de e-mail

* O widget de bate-papo em `acme.com` é a caixa de entrada de um site

* Seu número `+1-555-…` do WhatsApp é uma caixa de entrada do WhatsApp

Você pode ter quantas caixas de entrada precisar, até mesmo várias do mesmo tipo (uma caixa de entrada de site para marketing, outra para faturamento).  \
 \
Cada mensagem que chega fica dentro de uma caixa de entrada, e cada caixa de entrada pode ter seus próprios agentes, horário comercial, saudação e regras de roteamento.

> **Dica:** não pense demais no layout da sua caixa de entrada no primeiro dia. Comece com um, fique confortável e depois divida conforme sua equipe cresce.

---

## Como uma mensagem se torna uma conversa

Este é o ciclo de vida de uma única mensagem do cliente – tenha isso em mente ao analisar o restante do produto:

1. **A pessoa atendida envia uma mensagem** em um de seus canais (por exemplo, digita no widget do seu site).

2. **IAra cria uma conversa** na caixa de entrada correspondente. A conversa começa no status **Aberto** ou no status **Pendente** se a IAra estiver conectado.

3. **Um agente é atribuído** — automaticamente (por meio de política de atribuição) ou manualmente.

4. **Respostas do agente** no painel. A resposta volta para a pessoa atendida pelo *mesmo* canal em que ele escreveu.

5. **A conversa é resolvida** quando o problema é resolvido. Ele não é excluído — o histórico completo permanece pesquisável, anexado ao contato.

As conversas têm quatro status comuns: **Aberta**, **Pendente**, **Adiada** e **Resolvida**. Você conhecerá todos eles conforme avança.

---

## Configure sua primeira caixa de entrada: chat ao vivo no site

Usaremos o canal do site porque é a maneira mais rápida de ver a IAra funcionando de ponta a ponta.

### Passo 1 — Abra a configuração da caixa de entrada

No painel, vá para **Configurações → Caixas de entrada → Adicionar caixa de entrada**.

### Etapa 2 — Escolha "Site"

Você verá uma grade de tipos de canais. Clique no ícone **Site**.

### Etapa 3 — Preencha o básico

* **Nome do site** — o que seus clientes verão na parte superior do widget de chat (por exemplo, *Suporte Acme*).

* **Domínio do site** — a URL onde o widget ficará (por exemplo, `https://acme.com`).

* **Cor do widget** — escolha algo da marca.

* **Título e slogan de boas-vindas** — a primeira coisa que os visitantes leem quando abrem o widget.

### Etapa 4 — Adicionar agentes

Escolha quais colegas de equipe podem responder às mensagens desta caixa de entrada. Você pode adicionar ou remover pessoas posteriormente.

### Etapa 5 — Instale o snippet

IAra entregará a você um pequeno trecho de JavaScript. Cole-o no `<head>` do seu site (ou logo antes de `</body>`). Atualize sua página e você verá o balão de bate-papo no canto.

***Ainda não tem site?** Você não precisa de um para testar. Vá para **Configurações → Caixas de entrada**, clique no **ícone de engrenagem** próximo à sua nova caixa de entrada para abrir suas configurações, em seguida, abra a guia **Configuração** e clique em **Abrir no Codepen** no script. Um widget ao vivo será aberto em seu navegador, onde você poderá enviar mensagens imediatamente.*

### Passo 6 — Envie uma mensagem de teste

Clique no balão de bate-papo do seu site, digite *"Olá do meu primeiro visitante!"* e clique em enviar.

### Etapa 7 — Responder no painel

Volte para o painel da IAra. A nova conversa aparecerá no topo da sua lista de conversas com um selo de não lida. Clique nele, digite sua resposta na caixa de bate-papo na parte inferior e clique em enviar. A pessoa atendida verá isso instantaneamente no widget.

🎉 Você acabou de realizar sua primeira conversa na IAra.

---

## Um rápido tour pela visualização da conversa

Quando você estiver dentro de uma conversa, veja o que cada parte faz – resumidamente:

| Área | Para que serve |
| ---------------------------- | ------------------------------------------------------------------------------------- |
| **Caixa de resposta** | Enviar respostas públicas ao cliente |
| **Notas privadas** | Discuta a conversa com colegas de equipe – a pessoa atendida nunca vê isso |
| **Barra lateral direita** | Detalhes do cliente, ações de conversa, atributos personalizados e conversas anteriores |
| **Ações de conversação** | Atribua um agente, altere o status, adie, adicione etiquetas |
| **Lista de conversas (esquerda)** | Filtrar por status, responsável, caixa de entrada, etiqueta ou pasta salva |

Você não precisa usar nenhum desses no primeiro dia. Responder na caixa de chat é suficiente para oferecer suporte a atendimentos reais.

---

## Resolvendo a conversa

Quando terminar de ajudar a pessoa atendida:

1. Clique em **Resolver** na parte superior da conversa.

2. A conversa sai da fila **Aberta** e entra em **Resolvida**.

3. Se você ativou o CSAT, a pessoa atendida será automaticamente solicitado a avaliar a experiência.

Se a pessoa atendida responder após a resolução, a conversa **reabrirá automaticamente** — nada passa despercebido.

---

## Experimente estes a seguir (opcional, 1 minuto cada)

Enquanto estiver aqui, dê uma olhada em um ou dois deles para que não sejam estranhos mais tarde:

* **Defina seu status como Online** — avatar no canto superior direito → *Online/Ocupado/Offline*.

* **Envie uma nota privada** — digite `@teammate parece um problema de cobrança` na guia Notas privadas.

* **Adicione uma etiqueta** — tente `bug-report` ou `feature-request` na barra superior.

* **Adiar a conversa** — útil para casos de "espera de clientes".

---

## Perguntas comuns do primeiro dia

**A pessoa atendida verá meu nome?**

Sim – seu nome de exibição e avatar nas configurações do perfil aparecem nas respostas enviadas. Reserve um minuto para definir ambos antes de responder a um cliente real.

**E se eu responder para a pessoa errada?**

Você pode excluir uma mensagem enviada (no widget de chat ao vivo, não é compatível com outros canais). Depois disso, envie uma correção de acompanhamento – o original permanece no painel com uma mensagem excluída para maior precisão, a pessoa atendida não o verá novamente.

**Dois agentes podem trabalhar na mesma conversa?**

Sim. Um agente é o **Responsável** (proprietário da resposta); outros podem ser adicionados como **Participantes da conversa** para acompanhar e intervir.

**Alguma coisa que eu digito na caixa de bate-papo é enviada imediatamente?**

Não. As respostas só serão enviadas quando você clicar em **Enviar** (ou pressionar ⌘/Ctrl+Enter). E se você sair do meio da mensagem, a IAra mantém um **Rascunho de resposta** para que você não perca seu trabalho.

---

## O que vem a seguir

Na **Lição 2**, iremos além da caixa de resposta: notas privadas, respostas prontas, etiquetas e como manter sua fila organizada à medida que as conversas se acumulam.

Até então, sua lição de casa é simples: **envie três mensagens de teste do widget e responda a cada uma delas.** A memória muscular supera a teoria.

Bem-vindo a bordo. 👋

---

## Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

## Problemas comuns

- Usuário sem permissão para acessar a configuração.
- Nome de tela diferente entre versões ou contas.
- Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
- Falta de teste em conversa realista antes de liberar para a equipe.

## Checklist final

- [ ] Configuração revisada por um administrador.
- [ ] Teste realizado com dado ou conversa controlada.
- [ ] Impacto para agentes e gestores entendido.
- [ ] Artigos relacionados revisados para evitar links quebrados.