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

# Integração WhatsApp Business

> Conecte seus assistentes IA ao WhatsApp Business para conversas automatizadas baseadas em texto com clientes

<Note>
  **Novo: Números Externos** — Agora você pode trazer seu próprio número móvel para o WhatsApp! Use números da plataforma ou conecte seu número móvel existente com verificação SMS/voz.
</Note>

## O que é a Integração WhatsApp Business?

A integração WhatsApp Business permite conectar seus assistentes IA ao WhatsApp, habilitando conversas automatizadas baseadas em texto com clientes através da plataforma de mensagens mais popular do mundo.

Com esta integração, você pode:

* **Receber mensagens de clientes** e responder automaticamente com IA
* **Enviar mensagens template** para iniciar conversas ou reengajar clientes
* **Usar respostas alimentadas por IA** para suporte ao cliente 24/7
* **Disparar fluxos de automação** baseados em conversas do WhatsApp
* **Rastrear todas as conversas** no seu painel

## Como Funciona

```mermaid theme={null}
flowchart LR
    A[Cliente] -->|Envia mensagem WhatsApp| B[Seu Remetente WhatsApp]
    B -->|Roteia para| C[Assistente IA]
    C -->|Gera resposta| B
    B -->|Responde para| A
```

1. **Crie um Remetente WhatsApp** usando um número da plataforma ou seu próprio número externo
2. **Conecte um Assistente IA** para lidar automaticamente com mensagens recebidas
3. **Crie Templates de Mensagem** para conversas de saída (exigido pelo Meta)
4. **Clientes mandam mensagens** e recebem respostas alimentadas por IA instantaneamente

## Componentes Principais

<CardGroup cols={2}>
  <Card title="Remetentes WhatsApp" icon="phone" href="/whatsapp/senders">
    Números de telefone registrados para mensagens WhatsApp Business
  </Card>

  <Card title="Templates de Mensagem" icon="file-lines" href="/whatsapp/templates">
    Formatos de mensagem pré-aprovados para conversas iniciadas pelo negócio
  </Card>

  <Card title="Conversas IA" icon="robot" href="/whatsapp/conversations">
    Respostas automatizadas alimentadas por IA para mensagens de clientes
  </Card>

  <Card title="Automação" icon="bolt" href="/whatsapp/automation">
    Dispare fluxos e envie mensagens via plataforma de automação
  </Card>
</CardGroup>

## Entendendo as Regras do WhatsApp Business

O WhatsApp tem regras específicas para mensagens comerciais que você precisa entender:

### A Janela de Mensagens de 24 Horas

<Info>
  Quando um cliente manda mensagem para você, uma **janela de 24 horas** se abre onde você pode enviar mensagens de formato livre. Após essa janela fechar, você deve usar um **template aprovado** para reengajar o cliente.
</Info>

* **Dentro de 24 horas**: Envie qualquer mensagem diretamente
* **Após 24 horas**: Deve usar uma mensagem template pré-aprovada

### Mensagens Template

Mensagens template são formatos de mensagem pré-aprovados necessários para:

* Iniciar novas conversas com clientes
* Reengajar clientes após a janela de 24 horas
* Enviar notificações, atualizações ou mensagens de marketing

Templates devem ser submetidos ao Meta para aprovação antes do uso (normalmente demora minutos a 24 horas).

### Classificação de Qualidade e Limites

O Meta monitora a qualidade das suas mensagens. Novos remetentes começam com capacidade limitada de mensagens que aumenta conforme você mantém boa qualidade:

| Nível de Qualidade | Limite Diário de Mensagens |
| ------------------ | -------------------------- |
| Novo Remetente     | \~250 mensagens            |
| Qualidade Baixa    | 1.000 mensagens            |
| Média              | 10.000 mensagens           |
| Qualidade Alta     | 100.000+ mensagens         |

<Warning>
  Altas taxas de bloqueio ou relatórios de spam reduzirão sua classificação de qualidade e reduzirão seus limites de mensagens. Sempre envie conteúdo relevante e solicitado.
</Warning>

## Recursos Suportados

### O que é Suportado

* **Números da plataforma** — Use números comprados através da nossa plataforma com verificação IA automatizada
* **Números externos** — Traga seu próprio número móvel e verifique via SMS ou chamada de voz
* Respostas automatizadas alimentadas por IA
* Mensagens template (Utilidade, Marketing, Autenticação)
* Templates de Solicitação de Chamada de Voz (solicitar permissão para ligar via WhatsApp)
* Histórico e rastreamento de conversas
* Integração com plataforma de automação

### Mídia e Visão

* **Análise de imagem (Visão)** — Quando clientes enviam imagens, seu assistente IA pode analisá-las usando LLMs com capacidade de visão (OpenAI, Claude, Gemini). A IA descreve e responde ao conteúdo da imagem dentro da conversa.
* **Transcrição de mensagem de voz** — Notas de voz recebidas são automaticamente transcritas baseadas nas configurações de idioma do seu assistente. O texto transcrito é processado pela IA assim como uma mensagem regular.
* **Anexos de mídia** — Toda mídia recebida (imagens, áudio, vídeo, documentos) é armazenada como anexos na conversa e acessível do seu painel.

### Em Breve

* Chamadas de voz do WhatsApp

## Começando

<Steps>
  <Step title="Escolha Seu Tipo de Número">
    Decida se vai usar um **número da plataforma** (comprado de nós) ou seu próprio **número móvel externo**. Números externos devem ser capazes de receber SMS ou chamadas de voz para verificação.
  </Step>

  <Step title="Crie um Remetente WhatsApp">
    Navegue para **Remetentes WhatsApp** e siga o assistente de configuração para conectar seu número ao WhatsApp Business.
  </Step>

  <Step title="Conecte um Assistente IA">
    Vincule um assistente IA para responder automaticamente às mensagens recebidas.
  </Step>

  <Step title="Crie Templates">
    Configure templates de mensagem para conversas de saída e aguarde aprovação do Meta.
  </Step>

  <Step title="Comece a Mandar Mensagens">
    Seu remetente WhatsApp está pronto! Clientes podem mandar mensagens e receber respostas alimentadas por IA.
  </Step>
</Steps>

## Próximos Passos

* Aprenda como [criar remetentes WhatsApp](/whatsapp/senders)
* Entenda [templates de mensagem](/whatsapp/templates) e processo de aprovação
* Configure [gatilhos de automação](/whatsapp/automation) para WhatsApp
