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

# WhatsApp Business (Meta)

> Conecte um número WhatsApp Business pela API oficial da Meta — sem colar token manualmente.

Conecte um número **WhatsApp Business** ao seu agente pela API oficial da Meta. O Zenda cuida do OAuth, do registro do número e dos webhooks — você só precisa concluir o fluxo no popup da Meta.

<Warning>
  **Pré-requisitos:** conta no [Zenda](https://app.zendachat.com), um agente criado, chip/número que **não** esteja ativo no WhatsApp pessoal ou no app WhatsApp Business no celular, e acesso de administrador ao **Meta Business** da sua empresa (ou permissão para criar/vincular uma WABA).
</Warning>

## Passo a passo

### 1. Abra Publicar

No dashboard: **Agentes** → escolha o agente → **Publicar**.

### 2. Configure o WhatsApp

1. No card **WhatsApp** (badge **Meta · Oficial**), clique em **Gerenciar**
2. Clique em **Conectar com Meta**
3. No popup da Meta:
   * Faça login (se pedido)
   * Escolha ou crie o **portfólio empresarial**
   * Escolha ou crie a **conta WhatsApp Business (WABA)**
   * Adicione o **número** e confirme o **código SMS** no celular
   * Defina o **nome comercial** (display name)
   * Conclua até o fim (**Concluir** / **Finish**)

### 3. Ative o canal

Volte ao Publicar. Você deve ver **Número vinculado** com o Phone ID e o toast **WhatsApp Business conectado!**

Ligue o interruptor do card **WhatsApp** para **Ativo**.

### 4. Teste

Do seu celular, envie uma mensagem (ex.: «Olá») para o número Business. O agente de IA deve responder em alguns segundos. A conversa aparece em **Activity**.

## O que o Zenda faz automaticamente

Após você concluir o popup Meta, o Zenda:

* Obtém o token de acesso do cliente
* Registra o número na API Cloud (se ainda estiver pendente)
* Inscreve sua conta WhatsApp nos webhooks do app
* Salva as credenciais no agente de forma segura

Você **não** precisa:

* Colar Phone Number ID ou Access Token
* Configurar URL de webhook no painel Meta
* Gerar token permanente manualmente

## Reconectar ou trocar número

1. Publicar → WhatsApp → **Gerenciar**
2. **Conectar com Meta** novamente
3. Escolha outra WABA ou número no fluxo Meta

Se o número já estava ativo na Meta, o Zenda detecta e não altera o que já funciona.

## Cartão de crédito na Meta

Para enviar e receber mensagens em produção, a Meta exige um **método de pagamento** na conta WhatsApp Business. Adicione em [business.facebook.com](https://business.facebook.com) → configurações da WABA → pagamentos.

A cobrança de conversas é feita pela **Meta**, não pelo Zenda.

## Assumir conversa (operador humano)

1. Na conversa em **Activity**, clique **Assumir conversa** — a IA para de responder.
2. Digite e envie — a mensagem chega no WhatsApp do cliente como **Operador**.
3. Use **Devolver para IA** para retomar automação.

Veja também [Activity](/guias/activity/overview).

## Validar se está tudo certo

| Onde                                                                      | O que verificar                             |
| ------------------------------------------------------------------------- | ------------------------------------------- |
| Zenda → Publicar                                                          | Card WhatsApp **Ativo**, «Número vinculado» |
| [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager) | Status do número: **Conectado**             |
| Celular                                                                   | Mensagem de teste → resposta da IA          |

Se o número aparecer **Pendente** na Meta por mais de 10 minutos após conectar, tente **Conectar com Meta** de novo ou fale com o suporte.

## Problemas comuns

<AccordionGroup>
  <Accordion title="O botão «Conectar com Meta» não aparece">
    O Embedded Signup ainda não está habilitado no ambiente. Entre em contato com o suporte Zenda.
  </Accordion>

  <Accordion title="Popup fecha sem conectar">
    Use o endereço **[https://app.zendachat.com](https://app.zendachat.com)** (não preview Vercel). Desative bloqueadores de popup/anúncios e tente outro navegador.
  </Accordion>

  <Accordion title="Número não recebe mensagens">
    Confira se o canal WhatsApp está **Ativo** no Publicar, se o número está **Conectado** no WhatsApp Manager e se o chip não está vinculado ao WhatsApp pessoal.
  </Accordion>

  <Accordion title="IA não responde">
    Verifique fontes/indexação do agente, cota de mensagens do plano e se o inbound chegou em **Activity**.
  </Accordion>
</AccordionGroup>

<Check>
  **Política Zenda + Meta:** o agente **só responde** quando o cliente envia mensagem primeiro. Não há disparos proativos nem campanhas de marketing pelo Zenda. Respeite as [políticas do WhatsApp Business](https://www.whatsapp.com/legal/business-policy).
</Check>

Dúvidas: [suporte@zendachat.com](mailto:suporte@zendachat.com) ou chat no dashboard.