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

# Conversas WhatsApp

> Rastreie e gerencie conversas WhatsApp alimentadas por IA com clientes

Conversas WhatsApp são rastreadas junto com suas outras conversas, permitindo que você revise histórico de mensagens, monitore performance da IA e gerencie interações com clientes.

## Visualizando Conversas WhatsApp

Conversas WhatsApp aparecem na sua seção **Conversas** com um distintivo de tipo "WhatsApp".

Cada conversa inclui:

* Histórico completo de mensagens
* Número de telefone do cliente
* Assistente IA conectado
* Timestamps para todas as mensagens
* Métricas de custo e uso

## Tipos de Conversa

| Tipo                                                   | Descrição                                |
| ------------------------------------------------------ | ---------------------------------------- |
| <span style={{color: '#22c55e'}}>**WhatsApp**</span>   | Conversas de clientes via WhatsApp       |
| <span style={{color: '#8b5cf6'}}>**Widget Web**</span> | Conversas de clientes via widget do site |
| <span style={{color: '#f97316'}}>**Teste**</span>      | Conversas de teste do painel             |

## Como Funcionam as Conversas WhatsApp

### Cliente Inicia Contato

1. Cliente envia mensagem para seu número WhatsApp
2. Sistema cria ou encontra conversa existente
3. Mensagem é roteada para seu assistente IA
4. IA gera e envia resposta
5. Janela de mensagens de 24 horas abre

### Dentro da Janela de 24 Horas

* IA responde automaticamente a cada mensagem
* Respostas de formato livre são permitidas
* Conversa continua naturalmente

### Após 24 Horas

* Cliente deve mandar mensagem novamente para reabrir janela
* Você pode enviar mensagens template para reengajar
* IA permanece pronta para responder quando cliente responde

## Recursos de Conversa

### Histórico de Mensagens

Veja o bate-papo completo entre cliente e IA:

* Mensagens do cliente (recebidas)
* Respostas da IA (enviadas)
* Timestamps para cada mensagem
* Chamadas de função feitas durante conversa

### Variáveis de Conversa

Variáveis coletadas ou definidas durante a conversa:

* Identificador do cliente
* Dados extraídos pela IA
* Contexto passado de fluxos de automação

### Rastreamento de Custo

Cada conversa rastreia:

* Contagem total de mensagens
* Custo por mensagem
* Custo total da conversa

## Gerenciando Conversas

### Filtrando Conversas

Filtre sua lista de conversas por:

* Tipo (WhatsApp, Widget Web, Teste)
* Assistente
* Intervalo de datas
* Identificador do cliente

### Exportando Dados de Conversa

Exporte dados de conversa para análise:

1. Navegue para Conversas
2. Aplique filtros conforme necessário
3. Use opções de exportação para baixar dados

## Comportamento do Assistente IA

Seu assistente IA lida com conversas WhatsApp baseado na sua configuração:

### Prompt do Sistema

O mesmo prompt do sistema usado para chamadas de voz e widgets web se aplica ao WhatsApp. Garanta que seu prompt funciona bem para comunicação baseada em texto.

<Tip>
  **Prompts Amigáveis ao Texto** — Para assistentes que lidam tanto com voz quanto WhatsApp, considere incluir instruções para formatação de texto como usar bullet points e parágrafos mais curtos.
</Tip>

### Ferramentas e Funções

IA pode chamar ferramentas durante conversas WhatsApp:

* Buscar informações em bancos de dados
* Agendar compromissos
* Transferir para agentes humanos
* Coletar e validar dados

### Bases de Conhecimento

As bases de conhecimento do seu assistente estão disponíveis para conversas WhatsApp, permitindo que a IA responda perguntas usando seu conteúdo carregado.

## Mídia em Conversas

### Galeria de Anexos

Todos os arquivos de mídia recebidos em conversas WhatsApp (imagens, áudio, vídeo, documentos) são armazenados como anexos. Navegue pelos arquivos recebidos na visualização de detalhes da conversa.

### Análise de Imagem (Visão)

Quando um cliente envia uma imagem, seu assistente IA pode analisá-la usando LLMs com capacidade de visão (OpenAI, Claude, Gemini). A análise e resposta da IA são mostradas na conversa junto com a imagem original.

### Transcrição de Nota de Voz

Mensagens de voz recebidas são automaticamente transcritas com base nas configurações de idioma do seu assistente. O texto transcrito aparece na conversa junto com o áudio, e a IA responde ao conteúdo transcrito.

### Enviando Arquivos para Clientes

Operadores podem enviar arquivos de volta para clientes diretamente da interface da conversa. Isso é útil para compartilhar documentos, imagens ou outros recursos durante uma conversa.

## Melhores Práticas

### 1. Revise Conversas Regularmente

Monitore respostas da IA para garantir qualidade. Procure por:

* Informações precisas
* Tom apropriado
* Conclusão bem-sucedida de objetivos
* Sinais de satisfação do cliente

### 2. Treine Sua IA

Use insights de conversas para melhorar seu assistente:

* Identifique perguntas comuns
* Atualize bases de conhecimento
* Refine prompts do sistema
* Adicione ferramentas ou funções ausentes

### 3. Monitore Tempos de Resposta

Usuários WhatsApp esperam respostas rápidas. Monitore:

* Latência de resposta da IA
* Qualquer delay ou timeout
* Entregas de mensagens falhadas

### 4. Trate Escalações

Configure caminhos de escalação para problemas complexos:

* Ferramenta de transferir para agente humano
* Coletar informações de callback
* Agendar chamadas de follow-up

## Métricas de Conversa

Rastreie métricas-chave para suas conversas WhatsApp:

| Métrica                     | Descrição                                     |
| --------------------------- | --------------------------------------------- |
| **Total de Conversas**      | Número de conversas únicas de clientes        |
| **Mensagens por Conversa**  | Contagem média de mensagens                   |
| **Taxa de Resposta**        | Porcentagem de mensagens com respostas IA     |
| **Tempo Médio de Resposta** | Tempo entre mensagem do cliente e resposta IA |
| **Custo por Conversa**      | Custo médio incluindo uso da IA               |

## Integração com Outros Canais

Conversas WhatsApp existem junto com seus outros canais de comunicação:

* **Chamadas Telefônicas**: Conversas de voz rastreadas separadamente
* **Widget Web**: Conversas de texto do seu site
* **Conversas API**: Sessões de chat programáticas

Todos os tipos de conversa usam o mesmo assistente IA, proporcionando experiências consistentes entre canais.

## Próximos Passos

* Aprenda sobre [remetentes WhatsApp](/whatsapp/senders) e configuração de remetente
* Configure [templates de mensagem](/whatsapp/templates) para mensagens de saída
* Configure [automação](/whatsapp/automation) para fluxos de trabalho WhatsApp
* Revise [configurações do assistente IA](/ai-assistants/settings/prompt-and-tools) para respostas ótimas