# WhatsApp Business (Meta) — guia do vendedor

> Documentação para vendedores da Unefesta.
> Versão HTML: https://www.unefesta.com.br/documentacao-vendedor/integracao/whatsapp-business-meta-guia-do-vendedor

Este guia explica como conectar o WhatsApp Business da **sua loja** à Unefesta, o que muda no dia a dia, **custos cobrados pela Meta** (não pela Unefesta) e como evitar erros comuns.

A Unefesta atua como **provedor de tecnologia Meta**. Você continua usando o **app WhatsApp Business no celular** e, ao mesmo tempo, responde clientes pelo **chat da Unefesta** — as conversas ficam sincronizadas quando a Meta permite (modo **coexistência**).

> **Referência oficial Meta:** [Onboard WhatsApp Business app users (Coexistence)](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users)

---

## Visão geral

Como as mensagens circulam depois da conexão:

1. O **cliente** fala pelo WhatsApp no celular.
2. A mensagem passa pela **plataforma WhatsApp Business (Meta)**.
3. Você pode responder pelo **app WhatsApp Business** no celular **ou** pelo **chat da Unefesta** no painel — as conversas ficam sincronizadas quando a Meta permite (modo coexistência).

| Canal | Para que serve |
|-------|----------------|
| **App WhatsApp Business (celular)** | Conversas 1:1 como você já usa hoje; mensagens enviadas pelo app **não geram cobrança de API** pela Meta |
| **Chat Unefesta** | Atender compradores e leads no painel; respostas em texto podem ir também para o WhatsApp do cliente |
| **Contatos da loja** | Enviar **modelos aprovados** (marketing ou utilitários) para contatos da sua agenda |

Cada **loja** conecta **um número** WhatsApp Business. Se você tem várias lojas, conecte uma por vez em **Integrações das Lojas**.

---

## Requisitos mínimos

Antes de conectar, confira:

| Requisito | Detalhe |
|-----------|---------|
| **App WhatsApp Business no celular** | Versão **2.24.17 ou superior** (atualize pela loja de apps) |
| **Conta Meta Business** | Portfólio comercial verificado ou em uso regular no Gerenciador de Negócios |
| **Número já no WhatsApp Business** | O fluxo conecta o número **existente** (coexistência), não cria linha nova pela Unefesta |
| **Assinatura Unefesta ativa** | Acesso ao painel do vendedor |
| **Integração liberada** | Se a seção **WhatsApp Business (Meta)** não aparecer, a funcionalidade ainda não está disponível para sua conta — aguarde o rollout |

Depois de conectar:

| Requisito | Por quê |
|-----------|---------|
| **Forma de pagamento na Meta** | A Meta exige método de pagamento na conta WhatsApp Business para **enviar mensagens pela API** (respostas no chat, modelos, notificações de pedido). Sem isso, o envio pela plataforma pode falhar |
| **Manter o app aberto na primeira sincronização** | Facilita a conexão e a sincronização inicial de dados entre Meta e Unefesta |

---

## Como conectar

1. No menu lateral, abra **Integrações das Lojas**.
2. Role até a seção **WhatsApp Business (Meta)**.
3. No campo **Loja**, escolha a loja que receberá o número.
4. Escolha a **política de sincronização** (veja abaixo) e clique em **Conectar**.
5. Mantenha **esta aba do navegador aberta** — o código de autorização expira em cerca de 30 segundos.
6. No popup da Meta:
   - Faça login na conta correta (a mesma do Gerenciador de Negócios).
   - Escolha **conectar o WhatsApp Business existente** (coexistência).
   - No celular, abra o app WhatsApp Business, confirme **Conectar à plataforma comercial** e informe o **código de verificação** se solicitado.
   - Quando perguntado, você pode **compartilhar o histórico de conversas** com a plataforma (recomendado se a política for “sincronizar tudo”).
7. Ao concluir, a tela mostra **Conectado**, o número e as **etapas 2 e 3** (pagamento na Meta e conta pronta para enviar).

### Depois de conectar: as três etapas

Na própria tela de integração:

| Etapa | O que significa |
|-------|-----------------|
| **1. Conectar** | Número vinculado à loja (coexistência) |
| **2. Pagamento na Meta** | Método de pagamento cadastrado na conta WhatsApp Business — **obrigatório** para a API enviar |
| **3. Conta pronta para enviar** | A Meta liberou o envio (pagamento ok e conta sem pendência). Sem isso, chat, modelos e notificações de pedido podem falhar |

Use **Atualizar status** se a etapa 3 continuar pendente depois de cadastrar o pagamento.

### Política de sincronização (contatos e mensagens)

Antes de conectar (e depois, nas configurações da conexão), você escolhe o que a Unefesta deve guardar:

| Opção | O que entra na Unefesta |
|-------|-------------------------|
| **Sincronizar tudo** | Agenda WhatsApp, histórico compartilhado e mensagens novas (incluindo respostas enviadas pelo app no celular) |
| **Só contatos e pedidos Unefesta** | Mensagens e contatos **somente** se o telefone já estiver em **Contatos da loja** ou tiver **qualquer pedido** na Unefesta |

No modo restrito, a mesma regra vale para:

- sincronização inicial (histórico e agenda SMB da Meta);
- mensagens novas via webhook;
- **ecos da loja** (mensagens que você envia pelo app WhatsApp Business no celular e a Meta espelha na Unefesta).

**Importante:**

- A Meta continua enviando os dados; a Unefesta **filtra no ingest**. O que for descartado **não fica guardado** para reaproveitar depois.
- Você pode **alterar a política** em **Integrações** enquanto estiver conectado. A mudança vale para mensagens e contatos **novos**. Histórico já ignorado **não volta**; o que já foi importado **não é apagado** só por mudar a opção.
- O histórico completo da Meta só pode ser pedido de novo em condições limitadas (janela curta após o onboarding / novo Embedded Signup). Mudar a política **não** dispara um segundo sync completo sozinho.

### Sincronização de histórico e contatos

Na primeira conexão (coexistência), a Unefesta pede à Meta o **histórico de conversas** (se você compartilhou) e os **contatos** da agenda do WhatsApp Business — e aplica a política escolhida. Na tela aparece:

- **Histórico:** aguardando a Meta / em andamento / concluído / não compartilhado
- **Contatos:** aguardando a Meta / concluído (ou “a Meta não enviou contatos”, se a agenda estiver vazia)

Deixe o **app aberto** nos primeiros minutos. A tela atualiza sozinha; se ficar em “aguardando” por vários minutos com agenda vazia, isso é esperado.

### Configurar pagamento na Meta (etapa 2)

Na etapa **Pagamento na Meta**:

1. Clique em **Abrir pagamento na Meta** (abre o Gerenciador de Negócios).
2. Cadastre cartão ou outro método aceito pela Meta para a conta WhatsApp Business.
3. Volte à Unefesta e clique em **Atualizar status**.

Sem forma de pagamento válida, mensagens enviadas **pelo chat Unefesta** ou **modelos** podem não ser entregues, mesmo com a conexão aparentemente ativa.

---

## Como usar no dia a dia

### Atender clientes no chat

1. Abra **Chats** no menu.
2. Conversas vindas do WhatsApp aparecem como **Lead WhatsApp** quando o contato ainda não tem conta de comprador na Unefesta (e, no modo restrito, só se forem elegíveis pela política de sincronização).
3. Quando o WhatsApp estiver conectado e a **janela de 24 horas** estiver aberta, você verá:

   > *Respostas em texto serão enviadas também pelo WhatsApp Business da loja (coexistência com o app no celular).*

4. Digite a mensagem em **Digite sua mensagem…** e envie normalmente.
5. Mensagens que você envia **pelo app no celular** também podem aparecer no chat Unefesta (espelhamento), **respeitando a política de sincronização**.

Se a janela de 24h estiver fechada, aparece um aviso em amarelo: suas respostas ficam **somente no chat Unefesta** até o cliente mandar uma nova mensagem pelo WhatsApp.

### Excluir conversas de lead (sem conta Unefesta)

Em **Chats**, nos cards de conversa **Lead WhatsApp** ou grupo **sem usuário comprador** na Unefesta, o vendedor vê um ícone de **lixeira**.

- Pede **confirmação** antes de apagar.
- Exclui o **chat e todas as mensagens** daquela conversa (incluindo anexos).
- **Não** aparece em chats de clientes com conta Unefesta.
- Conversas **vinculadas a pedidos** não podem ser excluídas por este caminho.

### Enviar modelos (marketing ou campanhas)

1. Abra **Contatos** no menu (**Contatos da loja**).
2. Selecione a loja no seletor superior, se necessário.
3. Clique em um contato com telefone.
4. Na área **Enviar modelo WhatsApp**, escolha o modelo e clique em **Enviar modelo**.

Para criar modelos:

1. Em **Contatos da loja**, clique em **Modelos WhatsApp**.
2. Use **Novo modelo** e aguarde a **aprovação da Meta** (pode levar até 24 horas).

Modelos de **marketing** exigem que o contato tenha autorizado receber promoções. Se ainda não autorizou, a Unefesta envia automaticamente um pedido com botões **Sim** / **Não** no WhatsApp.

### Notificações de pedido pelo WhatsApp (opcional)

Por padrão, atualizações de checkout e pagamento ficam **somente no chat Unefesta** (sem custo Meta de conversa UTILITY).

Para enviar também pelo WhatsApp:

1. Em **Integrações das Lojas**, na conexão da loja, marque a opção:

   **Quero enviar notificações de pedido e pagamento também pelo WhatsApp (modelos UTILITY aprovados pela Meta).**

2. Confirme no diálogo — a Meta **cobra por conversa UTILITY** enviada ao comprador. Este custo será por sua conta.

Para ver a lista completa de modelos enviados (checkout, pagamento, **contrato**, cancelamento, trilha de status, pós-venda), consulte [Notificações de pedido pelo WhatsApp](../pedidos/notificacoes-whatsapp.md).

---

## Custos: quem cobra o quê

| Item | Quem cobra | Observação |
|------|------------|------------|
| **Assinatura Unefesta** | Unefesta | Plano para uso da plataforma — **não** inclui mensagens WhatsApp da Meta |
| **Mensagens pelo app WhatsApp Business (celular)** | Meta | **Grátis** (fora da tarifação Cloud API), conforme política Meta para app Business |
| **Respostas em texto pelo chat Unefesta (janela 24h aberta)** | Meta | **Grátis** — mensagens fora de template (`type: text`, imagem, etc.) com **janela de atendimento (CSW)** aberta após o cliente ter escrito no WhatsApp. Na Meta: categoria *service*, `billable: false` |
| **Modelos UTILITY