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

# WhatsApp Coexistência (Coex)

> Entenda como usar WhatsApp App e API Oficial simultaneamente no mesmo número

## O que é WhatsApp Coexistência (Coex)?

**WhatsApp Coexistência (Coex)** é um recurso lançado pela Meta que permite que um mesmo número de WhatsApp seja utilizado **simultaneamente** em três ambientes:

* 📱 **WhatsApp App** (aplicativo no celular)
* 💻 **WhatsApp Web** (navegador)
* 🔌 **API Oficial do WhatsApp** (WhatsApp Business Platform, incluindo Make Talk)

### Antes do Coex

Quando um número era migrado para a API Oficial:

* ❌ Parava de funcionar no telefone
* ❌ Não recebia mais mensagens no app
* ❌ Só podia ser utilizado via API

### Com o Coex

Agora é possível usar **todos os ambientes ao mesmo tempo** no mesmo número.

<Note>
  O Coex é um recurso oficial da Meta.
</Note>

***

## O que o Coex permite?

### Uso simultâneo de múltiplos ambientes

Você pode usar simultaneamente:

* ✅ WhatsApp no aplicativo do celular
* ✅ WhatsApp no WhatsApp Web
* ✅ WhatsApp pela API Oficial (Make Talk)

### Benefícios para sua operação

Isso beneficia times que querem:

* **Continuar usando o WhatsApp App** para interações manuais
* **Deixar o time de vendas ou recepção** atuando no WhatsApp App
* **Usar automações, fluxos, agentes de IA e campanhas** via API simultaneamente
* **Manter histórico de conversas** - Importar até 6 meses de histórico de chats 1:1 e 2 semanas de mídias
* **Preservar contatos** - Todos os contatos são importados automaticamente

### Casos de uso ideais

É especialmente útil para:

* 🏨 **Hotéis** que usam recepção + automação
* 🏪 **Lojas físicas** que mantêm atendimento humano no aplicativo
* 👥 **Pequenos negócios** que precisam de flexibilidade
* 🏢 **Empresas** com times híbridos (humano + IA)
* 📱 **Empresas em migração** que querem transição suave sem perder dados

***

## O que o Coex NÃO muda

É fundamental entender as limitações:

### ❌ Coex NÃO permite envios em massa pelo aplicativo

Todos os envios de campanha ou disparo devem continuar sendo feitos:

* ✅ Exclusivamente pela API Oficial
* ✅ Usando templates aprovados pela Meta
* ✅ Dentro das regras de políticas e cobrança da Meta

<Warning>
  **Importante:** O App não ganha permissão extra. Não existe "envio em massa pelo app". Para campanhas, você **deve** usar a API Oficial.
</Warning>

### ❌ As regras de cobrança da Meta continuam iguais

Mesmo usando Coex:

* ✅ Respeitam-se as janelas de 24h e 72h
* ✅ Campanhas são sempre categoria Marketing
* ✅ Cobrança ocorre por mensagem entregue
* ✅ Não existe "envio gratuito ilimitado" pelo app

<Note>
  Para entender o modelo de cobrança completo, [consulte nossa página sobre cobrança da API Oficial](/administradores/cobranca-whatsapp-api).
</Note>

### ⚠️ O aplicativo pode não exibir toda a conversa enviada pela API

Dependendo do provedor e das funcionalidades futuras da Meta:

* Mensagens enviadas via API podem não aparecer no app
* Histórico pode não ser sincronizado 100% com o dispositivo
* Mídias enviadas pela API podem não aparecer no chat do app

Isso varia por release da Meta e é uma limitação técnica natural do Coex.

***

## Requisitos para usar Coexistência

Antes de configurar a Coexistência, verifique se você atende aos seguintes requisitos:

### ✅ Requisitos obrigatórios

* **WhatsApp Business App ativo**: Seu número deve estar conectado ao WhatsApp Business App (não WhatsApp pessoal)
* **Atividade mínima**: O número deve estar ativo no aplicativo por **pelo menos 7 dias**, com interações regulares
* **Versão atualizada**: WhatsApp Business App versão **2.24.17 ou superior**
* **Página de Negócios do Facebook**: Você precisa de uma Página de Negócios do Facebook com acesso de administrador
* **País elegível**: Verifique se seu país é suportado pela Meta (alguns países não são elegíveis para Coex)

<Warning>
  **Importante:** A Meta não permite que empresas se cadastrem via Coex de alguns países. Verifique se seu país está na lista de países elegíveis antes de iniciar o processo.
</Warning>

### ❌ O que NÃO funciona com Coex

* Números de WhatsApp pessoal (não comercial)
* Números que não estão no WhatsApp Business App
* Países não elegíveis pela Meta

***

## Como configurar a Coexistência

O processo de configuração da Coexistência envolve 5 etapas principais:

<Steps>
  <Step title="Escolha o método de integração">
    Ao iniciar a configuração na Make Talk, você será solicitado a escolher entre:

    * **Conectar seu número de telefone (MM Lite)** - Cadastro tradicional
    * **Conectar seu aplicativo WhatsApp Business (Coexistência)** - Use esta opção

    Selecione **"Conectar seu aplicativo WhatsApp Business (Coexistência do WhatsApp)"**.
  </Step>

  <Step title="Inicie a configuração via Facebook Business">
    * Clique em **"Continuar com o Facebook"** para começar
    * Faça login na sua Página de Negócios do Facebook
    * Certifique-se de ter acesso de **administrador** a esta página
    * Conceda as permissões necessárias quando solicitado
    * Selecione seu **Portfólio de Negócios** existente usado no WhatsApp
    * Recomendamos inserir a **URL do seu site** para evitar problemas na configuração
  </Step>

  <Step title="Vincule sua conta via QR Code">
    * Você verá uma tela com um **código QR**
    * Você receberá uma mensagem do **Facebook Business** no seu WhatsApp Business App
    * Abra a mensagem, clique em **"Conectar"** e depois em **"Conectar à Plataforma de Negócios"**
    * Escaneie o código QR exibido
  </Step>

  <Step title="Escolha se deseja importar histórico">
    Após escanear o QR Code, você será perguntado se deseja **importar chats antigos**:

    **O que será importado:**

    * ✅ **Todos os contatos** (importação automática)
    * ✅ Até **6 meses de histórico de conversas 1:1**
    * ✅ Até **2 semanas de histórico de mídias**
    * ❌ **Histórico de chats em grupo** não será importado (permanece no app)

    <Note>
      A importação está **ativada por padrão**. Se você pular e mudar de ideia depois, precisará desvincular e vincular novamente (refazer todo o processo) para importar o histórico.
    </Note>
  </Step>

  <Step title="Confirme a conexão">
    * O processo de conexão pode levar até **2 minutos**
    * Após conexão bem-sucedida, você verá uma tela de confirmação no WhatsApp Business App
    * A Make Talk receberá automaticamente a confirmação do Meta
    * Os contatos e chats começarão a sincronizar automaticamente
  </Step>
</Steps>

### Sincronização de dados

Após a conexão, os dados são sincronizados da seguinte forma:

| Dados                                 | Tipo de sincronização          | Momento              |
| ------------------------------------- | ------------------------------ | -------------------- |
| Todos os contatos                     | Sincronização em segundo plano | Imediato             |
| Histórico de chats (últimas 24 horas) | Sincronização em tempo real    | Imediato             |
| Histórico de chats (últimos 90 dias)  | Sincronização em segundo plano | Inicia imediatamente |
| Histórico de chats (últimos 6 meses)  | Sincronização em segundo plano | Inicia imediatamente |

<Note>
  Os contatos importados aparecerão na Make Talk com a tag de origem **"WhatsApp Business App"**. Os chats sincronizados aparecerão na Caixa de Entrada da Equipe.
</Note>

***

## Limitações importantes do Coex

### 1. Sincronização parcial entre App/Web/API

Nem sempre tudo que é enviado pela API aparecerá no app — especialmente:

* Mensagens automáticas
* Campanhas
* Fluxos de IA
* Mensagens transacionais de alta escala

### 2. Restrições de volume no App

O WhatsApp App continua limitado a conversas normais.

Não permite:

* ❌ Disparos
* ❌ Automações pesadas
* ❌ Envios simultâneos para milhares de usuários
* ❌ Mensagens programadas ou segmentadas

<Note>
  Para isso existe a API Oficial, usada pela Make Talk. [Saiba mais sobre campanhas em massa](/administradores/campanhas-massa-whatsapp).
</Note>

### 3. Possibilidade de conflitos de sessão

Em alguns provedores (e ainda relatado por integradores):

* Múltiplas sessões podem causar atraso de entrega ou duplicação
* O app pode desconectar temporariamente
* Notificações podem falhar por alguns segundos

### 4. Dispositivos companheiros

Após a migração para a API em nuvem:

* ✅ Todos os dispositivos companheiros vinculados serão **desvinculados automaticamente**
* ✅ Você pode vinculá-los novamente após a migração
* ❌ **WhatsApp para Windows** e **WhatsApp para WearOS** não são suportados
* ⚠️ Mensagens enviadas/recebidas em dispositivos não suportados **não aparecerão na Make Talk**

### 5. Automações do WhatsApp Business App

Se você usa automações no WhatsApp Business App:

* ⚠️ **Desative** mensagens de boas-vindas e mensagens de ausência no app antes de usar a Make Talk
* ✅ Configure essas automações na Make Talk usando **Automação Baseada em Regras** para operações mais suaves
* ⚠️ Automações do app podem conflitar com as automações da API

***

## Preços e cobrança com Coexistência

### Mensagens pelo WhatsApp Business App

* ✅ **Mensagens enviadas pelo WhatsApp Business App permanecem gratuitas**
* ✅ Não há custo adicional para usar o app normalmente

### Mensagens pela API (Make Talk)

* 💰 **Mensagens enviadas via Make Talk seguem a tabela de preços da API em nuvem do Meta**
* 💰 Cobrança por janela de conversa de 24 horas
* 💰 Categorias: Marketing, Utilidade, Autenticação, Serviço

<Note>
  Para entender o modelo de cobrança completo, [consulte nossa página sobre cobrança da API Oficial](/administradores/cobranca-whatsapp-api).
</Note>

### Meta Verified

* ✅ Se você integrar um número via Coex que já está inscrito no **Meta Verified**, o **selo azul continuará aparecendo** tanto na Make Talk quanto no app WhatsApp Business
* ⚠️ Se você usar o método de Embedded Signup (removendo o número do app antes da integração), o selo será perdido

***

## Múltiplos números com Coexistência

A Make Talk permite conectar **múltiplos números de telefone** a uma única conta (no plano Business), permitindo gerenciar todos os números em um só lugar.

### Como funciona

* Você pode integrar cada número usando:
  * **Processo de Coexistência** (Coex)
  * **Método de Cadastro Integrado (MM Lite)**
* Exemplo: Conecte um número via Coex e outro via MM Lite na mesma conta
* Todos os contatos e chats dos números conectados aparecerão na aba de **Contatos** e na **Caixa de Entrada da Equipe**
* Você pode distinguir contatos carregados do WhatsApp Business App usando a etiqueta de origem **"WhatsApp Business App"**

<Note>
  Para números conectados via Coexistência, os chats são sincronizados em tempo real para a Caixa de Entrada da Equipe, garantindo colaboração sem interrupções.
</Note>

***

## Como funciona o Coex na Make Talk

### ✅ Total compatibilidade

A Make Talk é **100% compatível** com números habilitados em Coex.

### ✅ Fluxos de IA, automações e campanhas continuam pela API

Você mantém toda a inteligência:

* 🧠 **RAG** - Base de conhecimento estruturada
* 🔧 **Ferramentas** conectadas a sistemas
* 📢 **Campanhas de remarketing**
* 🔌 **Integrações com CRM**
* 🧮 **Cálculos dinâmicos**
* 🤖 **Agentes personalizados**

Tudo isso continua acontecendo pela API, **independente do uso do app**.

### ✅ O time do cliente pode continuar usando o WhatsApp App normalmente

Exemplos práticos:

* 🏨 **Recepção do hotel** atendendo hóspedes
* 💼 **Vendedores** atendendo clientes
* 👨‍💻 **Atendentes** usando WhatsApp Web durante o expediente

Enquanto isso:

* 🤖 A IA da Make Talk responde automaticamente quando necessário
* 📢 As campanhas de marketing são executadas pela API
* ⚙️ Os fluxos de automação continuam funcionando

***

## Recomendações práticas

### 1. Evite duplicidade de respostas

Se o atendente usa o app e a IA está ativada, defina:

* ⏰ **Horários da IA** - Quando a IA deve responder
* 🔄 **Regras de fallback** - Quando transferir para humano
* 🕐 **Janela de atendimento manual** - Períodos exclusivos para humanos

<Tip>
  Configure horários e regras de transbordo para evitar que a IA e o atendente respondam ao mesmo tempo.
</Tip>

### 2. Deixe claro qual canal será usado para campanhas

<Warning>
  **Importante:** Campanhas sempre serão enviadas pela API Make Talk. Não use o app para envios em massa.
</Warning>

### 3. Não use o app para envios manuais repetitivos

O app continua com limitações e arrisca bloqueio se usado incorretamente.

Para envios repetitivos ou em volume, use sempre a API Oficial.

### 4. Se o cliente depender do app para ver todas as mensagens

Explique a limitação natural do Coex:

> Nem tudo que a API envia aparecerá no app. Isso é normal e esperado.

Para visualizar todas as mensagens, use o painel da Make Talk.

### 5. Verificar status da conexão

Para verificar o status da conexão do seu número do WhatsApp na Make Talk:

* Vá em **Mais** → **Canais**
* Você verá o status do seu número nesta página

### 6. Solução de problemas

**Se a conexão falhar durante a configuração:**

* Você será direcionado para a página de **Status da Conta** na Make Talk
* Verá uma mensagem de erro apropriada
* Terá a opção de **reiniciar o processo** usando Coex ou MM Lite

**Se o histórico de mensagens não sincronizar:**

1. Desconecte a conexão do Coex:
   * Abra o aplicativo WhatsApp Business no seu telefone
   * Vá em **Configurações**
   * Selecione **Ferramentas comerciais**
   * Toque em **Plataforma do WhatsApp Business**
   * Escolha **Desconectar**

2. Reconecte seu número usando a configuração do Coex novamente

3. Verifique se as mensagens sincronizam corretamente

**Se não receber o código do Facebook no WhatsApp:**

* Verifique se você já recebeu códigos de verificação do Facebook em sua conta do WhatsApp anteriormente
* Se sim, basta clicar no botão **"Continuar"** para prosseguir

**Como desconectar a Coexistência:**

* No seu telefone, abra o aplicativo **WhatsApp Business**
* Vá para: **Configurações** → **Ferramentas de Negócios** → **Plataforma WhatsApp Business**
* Você encontrará a opção de desconectar

***

## Perguntas frequentes (FAQ)

### O que é a Coexistência do WhatsApp (Coex)?

A Coexistência do WhatsApp (Coex) é uma solução do Meta que permite conectar seu WhatsApp Business App existente à plataforma de API em nuvem (Make Talk) **sem perder dados** ou precisar reregistrar seu número de telefone.

### Quais são os benefícios de usar a Coexistência?

* ✅ Migrar para a API mantendo histórico de conversas, contatos e número de telefone
* ✅ Transição suave sem interrupção do serviço
* ✅ Usar app e API simultaneamente no mesmo número
* ✅ Importar até 6 meses de histórico de conversas

### Posso importar meu histórico de conversas depois?

Não. Se você ignorar a importação do histórico durante o processo de integração, precisará **desvincular e vincular novamente** (refazer todo o processo) para importá-lo mais tarde.

### Posso usar um número de WhatsApp pessoal?

Não. Esse recurso só suporta números que já estão registrados com o **aplicativo WhatsApp Business**. Números de WhatsApp pessoais não são compatíveis.

### O que acontece com meus dispositivos companheiros?

Todos os dispositivos companheiros vinculados serão **desvinculados automaticamente** após a migração. Você pode vinculá-los novamente, exceto WhatsApp para Windows e WhatsApp para WearOS, que não são suportados.

### Preciso desativar automações do WhatsApp Business App?

Sim. Desative as mensagens de boas-vindas/ausência no WhatsApp Business App e configure-as na Make Talk usando **Automação Baseada em Regras** para operações mais suaves.

***

## Conclusão

O WhatsApp Coexistência é um avanço importante da Meta, permitindo que empresas usem **WhatsApp App + WhatsApp API ao mesmo tempo** no mesmo número.

### Para clientes da Make Talk, isso significa:

* ✅ **Maior flexibilidade** - Use app e API conforme necessário
* ✅ **Atendimento híbrido** - Humanos e IA trabalhando juntos
* ✅ **Sem perder automações** - Mantém toda a inteligência da API
* ✅ **Conformidade total** - Mantém políticas da Meta
* ✅ **Preservação de dados** - Importa histórico e contatos automaticamente
* ✅ **Transição suave** - Sem interrupção do serviço

### Mas é essencial compreender:

* 📢 Campanhas, automações e fluxos continuam sendo **100% pela API**
* 📱 O app **não ganha permissões adicionais**
* 🔄 A sincronização entre API e app **pode não ser completa**
* ⚠️ Mensagens enviadas via API podem não aparecer no app

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Caixas de entrada" icon="inbox" href="/administradores/caixas-entrada">
    Configure seus canais WhatsApp.
  </Card>

  <Card title="Campanhas em massa" icon="paper-plane" href="/administradores/campanhas-massa-whatsapp">
    Saiba como disparar campanhas via API.
  </Card>

  <Card title="Modelo de cobrança" icon="dollar-sign" href="/administradores/cobranca-whatsapp-api">
    Entenda os custos da API Oficial.
  </Card>

  <Card title="Riscos do QR Code" icon="exclamation-triangle" href="/administradores/riscos-whatsapp-qrcode">
    Por que não usar QR Code para campanhas.
  </Card>
</CardGroup>
