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

# Automação WhatsApp

> Automatize mensagens WhatsApp com gatilhos e ações na plataforma de automação

A plataforma de automação integra com WhatsApp para permitir que você envie mensagens automaticamente, dispare fluxos de eventos WhatsApp, e gere respostas IA programaticamente.

## Ações Disponíveis

### Enviar Mensagem Template WhatsApp

Envie uma mensagem template pré-aprovada para um cliente.

**Casos de Uso:**

* Enviar confirmações de pedido após uma compra
* Disparar lembretes de compromisso em horário agendado
* Entregar mensagens de follow-up após chamadas
* Reengajar clientes que não responderam

**Configuração:**

| Campo                        | Descrição                                                  |
| ---------------------------- | ---------------------------------------------------------- |
| **Remetente**                | Selecione seu remetente WhatsApp (deve estar online)       |
| **Template**                 | Escolha entre templates aprovados                          |
| **Telefone do Destinatário** | Número de telefone do cliente (formato E.164: +1234567890) |
| **Nome do Destinatário**     | Nome opcional do cliente para personalização               |
| **Variáveis**                | Valores dinâmicos para espaços reservados do template      |

<Tip>
  **Formato E.164** — Números de telefone devem estar em formato internacional com código do país. Exemplos:

  * ✅ `+5511999999999`
  * ✅ `+442071234567`
  * ❌ `(11) 9999-9999`
  * ❌ `07123456789`
</Tip>

### Enviar Mensagem WhatsApp (Formato Livre)

Envie uma mensagem de texto de formato livre para um cliente dentro da janela de mensagens de 24 horas.

<Warning>
  **Janela de 24 Horas Necessária** — Mensagens de formato livre só podem ser enviadas para clientes que mandaram mensagem para você nas últimas 24 horas. Para clientes fora dessa janela, use uma mensagem template.
</Warning>

**Casos de Uso:**

* Enviar follow-up imediato para conversas recentes
* Entregar informações sensíveis ao tempo
* Responder automaticamente a consultas de clientes

**Configuração:**

| Campo                        | Descrição                                     |
| ---------------------------- | --------------------------------------------- |
| **Remetente**                | Selecione seu remetente WhatsApp              |
| **Telefone do Destinatário** | Número de telefone do cliente (formato E.164) |
| **Mensagem**                 | Conteúdo da mensagem (máx. 4096 caracteres)   |

### Gerar Resposta IA

Gere uma resposta IA usando seu assistente, identificado por um identificador externo do cliente.

**Casos de Uso:**

* Construir interfaces de chat personalizadas
* Integrar WhatsApp com sistemas CRM externos
* Criar respostas IA multicanal
* Processar mensagens de plataformas externas

**Configuração:**

| Campo                        | Descrição                                                      |
| ---------------------------- | -------------------------------------------------------------- |
| **Assistente**               | Selecione o assistente IA para usar                            |
| **Identificador do Cliente** | ID único do cliente (ex. número de telefone, email, ID do CRM) |
| **Mensagem**                 | A mensagem para responder                                      |
| **Variáveis**                | Variáveis de contexto opcionais para o assistente              |

**Como Funciona:**

1. A ação encontra ou cria uma conversa para o identificador do cliente
2. Envia a mensagem para seu assistente IA
3. Retorna a resposta gerada pela IA
4. Você pode então enviar essa resposta via WhatsApp ou outros canais

## Gatilhos

### Mensagem WhatsApp Recebida

Dispare um fluxo quando um cliente enviar uma mensagem WhatsApp.

**Dados Disponíveis:**

* Número de telefone do cliente
* Conteúdo da mensagem
* ID do remetente
* Timestamp
* ID da conversa

**Exemplos de Casos de Uso:**

* Registrar mensagens em um CRM ou banco de dados
* Enviar notificações para sua equipe
* Disparar sequências de follow-up
* Coletar e processar dados de clientes

### Conversa WhatsApp Iniciada

Dispare um fluxo quando uma nova conversa WhatsApp começar.

**Dados Disponíveis:**

* Número de telefone do cliente
* Conteúdo da primeira mensagem
* Informações do remetente
* ID da conversa

### Conversa Finalizada

Dispare um fluxo quando uma conversa WhatsApp terminar (devido a timeout de inatividade ou fechamento manual).

**Dados Disponíveis:**

* Transcrição completa da conversa (array de mensagens e string formatada)
* Variáveis extraídas (da avaliação pós-conversa da IA)
* Variáveis de entrada passadas para o assistente
* Número de telefone e nome do cliente
* Informações do remetente WhatsApp (número de telefone, nome de exibição)
* ID e tipo da conversa
* Contagem de mensagens
* Timestamps (created\_at, ended\_at)

**Exemplos de Casos de Uso:**

* Sincronizar resumos de conversas e dados extraídos para seu CRM
* Disparar sequências de follow-up baseadas nos resultados da conversa
* Registrar análises de conversas em sistemas externos
* Enviar pesquisas de satisfação após conversas terminarem

<Tip>
  O gatilho Conversa Finalizada fornece o mesmo payload que o [Webhook Conversa Finalizada](/api-reference/webhooks/conversation-ended-webhook). Use o webhook para integrações diretas, ou este gatilho para fluxos de automação sem código.
</Tip>

## Exemplo de Fluxos de Trabalho

### Follow-up WhatsApp Pós-Chamada

Envie uma mensagem template WhatsApp após uma chamada completar:

```mermaid theme={null}
flowchart LR
    A[Gatilho Chamada Completada] --> B[Aguardar 5 minutos]
    B --> C{Resultado da Chamada?}
    C -->|Interessado| D[Enviar Template Interessado]
    C -->|Follow-up| E[Enviar Template Follow-up]
    C -->|Não Interessado| F[Fim]
```

**Configuração:**

1. Adicione gatilho **Chamada Completada**
2. Adicione ação **Delay** (opcional)
3. Adicione **Branch** baseado no resultado da chamada
4. Adicione ação **Enviar Template WhatsApp** para cada ramificação
5. Configure template e variáveis

### Qualificação de Leads via WhatsApp

Qualifique leads através de conversas WhatsApp:

```mermaid theme={null}
flowchart LR
    A[Submissão de Formulário] --> B[Enviar Template WhatsApp]
    B --> C[Aguardar Resposta]
    C --> D[IA Processa Resposta]
    D --> E[Atualizar CRM]
```

### Fluxo de Lembrete de Compromisso

Envie lembretes de compromisso automatizados:

```mermaid theme={null}
flowchart LR
    A[Gatilho de Agendamento] --> B[Buscar Compromissos]
    B --> C[Loop Através dos Compromissos]
    C --> D[Enviar Template de Lembrete]
    D --> E[Registrar na Planilha]
```

## Mapeamento de Variáveis

Ao enviar mensagens template, mapeie seus dados de fluxo para variáveis do template:

**Template:**

```
Olá {{1}}, seu compromisso com {{2}} está confirmado para {{3}}.

Local: {{4}}
```

**Mapeamento de Variáveis:**

| Variável do Template | Dados do Fluxo                 |
| -------------------- | ------------------------------ |
| `{{1}}`              | `{{trigger.customer_name}}`    |
| `{{2}}`              | `{{trigger.agent_name}}`       |
| `{{3}}`              | `{{trigger.appointment_date}}` |
| `{{4}}`              | `{{trigger.location}}`         |

## Tratamento de Erros

### Erros Comuns

| Erro                            | Causa                                        | Solução                                                     |
| ------------------------------- | -------------------------------------------- | ----------------------------------------------------------- |
| **Template não encontrado**     | ID do template inválido ou não aprovado      | Verifique se template está aprovado e ID está correto       |
| **Remetente offline**           | Remetente WhatsApp não está online           | Verifique status do remetente, garanta que esteja conectado |
| **Número de telefone inválido** | Número de telefone não está no formato E.164 | Formate como +\[código do país]\[número]                    |
| **Fora da janela de 24 horas**  | Tentando enviar formato livre fora da janela | Use mensagem template em vez disso                          |
| **Rate limited**                | Muitas mensagens enviadas                    | Implemente delays entre mensagens                           |

### Estratégia de Retry

Para mensagens que falharam, implemente uma estratégia de retry:

1. Aguardar 1 minuto
2. Tentar a ação novamente
3. Se ainda falhando, registrar o erro e notificar sua equipe

## Melhores Práticas

### 1. Sempre Use Templates para Saída

Ao iniciar contato com clientes, sempre use templates aprovados. Mensagens de formato livre só funcionam dentro da janela de 24 horas.

### 2. Inclua Opções de Opt-Out

Para mensagens de marketing, inclua instruções de opt-out para cumprir regulamentações e manter classificação de qualidade.

### 3. Respeite Rate Limits

Não envie muitas mensagens muito rapidamente. Implemente delays razoáveis entre envios em lote.

### 4. Trate Erros Graciosamente

Sempre adicione tratamento de erros aos seus fluxos. Registre falhas e notifique sua equipe sobre problemas.

### 5. Teste com Destinatários Únicos Primeiro

Antes de rodar campanhas em lote, teste seu fluxo com um único destinatário para verificar se tudo funciona corretamente.

### 6. Monitore Classificação de Qualidade

Mantenha um olho na classificação de qualidade do seu remetente. Pause campanhas se notar qualidade em declínio.

## Próximos Passos

* Aprenda sobre [mensagem templates](/whatsapp/templates) e como criá-los
* Configure [remetentes WhatsApp](/whatsapp/senders) para seus números de telefone
* Explore a [plataforma de automação](/automation-platform/introduction) para mais opções de fluxo de trabalho