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

# Onboarding para Coexistência via Eazybe

> Guia completo para conectar seu número do WhatsApp Business App à API do WhatsApp Cloud sem perder conversas, contatos ou exigir re-registro.

## Introdução

A Coexistência do WhatsApp permite que empresas conectem seu número ativo do WhatsApp Business App à API do WhatsApp Cloud — sem perder conversas, contatos ou exigir re-registro.

**Este guia aborda:**

* O que é Coexistência
* Pré-requisitos antes do onboarding
* Processo de configuração passo a passo
* Problemas comuns e soluções
* Perguntas frequentes para iniciantes
* Melhores práticas após o onboarding

***

## O que é a Coexistência do WhatsApp?

A Coexistência (Coex) permite que empresas:

* Conectem o WhatsApp Business App à API Cloud
* Continuem usando o Business App normalmente
* Sincronizem mensagens e contatos em uma plataforma de API Cloud
* Evitem re-registrar o número
* Preservem o selo de Verificado (se aplicável)

**Benefícios Principais:**

* Usar o mesmo número de telefone no Business App e na API
* Sincronização de mensagens e contatos em tempo real
* Combinar interação humana com automação
* Preservar histórico de conversas e contatos
* Manter acesso à interface familiar do WhatsApp Business App

<Note>
  Este é o método mais seguro para migrar para a API Cloud sem perder dados.
</Note>

***

## Pré-requisitos

Antes de iniciar o processo de onboarding, certifique-se de atender a estes requisitos:

<Steps>
  <Step title="Conta do WhatsApp Business Obrigatória">
    Seu número deve estar registrado no WhatsApp Business App. Números pessoais do WhatsApp não são suportados.
  </Step>

  <Step title="WhatsApp Business App Versão 2.24.17 ou Superior">
    Versões anteriores falharão durante a vinculação do QR. Atualize seu app antes de continuar.
  </Step>

  <Step title="Requisitos de Saúde do Número">
    Seu número deve ter:

    * Atividade regular no WhatsApp
    * Sem restrições da Meta
    * Sem violações de políticas
    * Uso ativo e genuíno antes e depois da conexão de Coexistência (conversas reais 1:1 e atividade consistente por pelo menos 3–7 dias)
  </Step>

  <Step title="Página do Facebook Business com Acesso de Administrador">
    Você precisa de acesso de administrador a uma Página do Facebook Business para completar a configuração.
  </Step>

  <Step title="Conta Meta Business Obrigatória">
    Uma Conta Meta Business é necessária para a integração.
  </Step>

  <Step title="Elegibilidade do Número">
    Seu número não pode estar atualmente vinculado a outro provedor de API do WhatsApp.
  </Step>
</Steps>

<Warning>
  Números da Nigéria ou África do Sul podem estar sujeitos a regulamentações e restrições adicionais da Meta.
</Warning>

***

## Processo de Onboarding Passo a Passo

### Configuração Inicial

<Steps>
  <Step title="Login com Email">
    Digite seu endereço de email para iniciar o processo de onboarding.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908028628.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=b50a846b2a103294685e5a969d954c11" alt="Login com Email" width="1050" height="504" data-path="images/1908028628.png" />
  </Step>

  <Step title="Inserir OTP">
    Digite o código OTP enviado para seu email.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908029950.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=66710991e5929a238956e280a5f43aa4" alt="Inserir OTP" width="1895" height="824" data-path="images/1908029950.png" />

    Após a verificação do OTP, você será redirecionado para a página Começar.
  </Step>

  <Step title="Clique em Adicionar Número">
    Clique no botão **Adicionar Número** para continuar com a conexão do seu número do WhatsApp.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908032104.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=ac117ad094789682e61f201c369541f5" alt="Adicionar Número" width="940" height="405" data-path="images/1908032104.png" />
  </Step>

  <Step title="Login com Facebook">
    Faça login com sua conta do Facebook. Você pode clicar em **Continuar como** se seu login do Facebook já estiver salvo.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908034817.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=5dbf202a8f15123709a7fed55b412c4b" alt="Login com Facebook" width="1102" height="548" data-path="images/1908034817.png" />
  </Step>

  <Step title="Conceder Permissões">
    Revise a página de permissões e clique em **Continuar** para prosseguir.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908035914.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=a520653ab5a15d0f4924874d336a39db" alt="Página de Permissões" width="734" height="859" data-path="images/1908035914.png" />
  </Step>

  <Step title="Preencher Detalhes do Negócio">
    Insira as informações do seu negócio nos campos obrigatórios.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908036666.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=b30adc381688434e2cf81c2dda9b46be" alt="Detalhes do Negócio" width="1098" height="562" data-path="images/1908036666.png" />
  </Step>

  <Step title="Escolher ou Criar Portfólio de Negócio">
    Selecione um portfólio de negócio existente ou crie um novo.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908037094.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=5bbba6f26b07296681b855a771592730" alt="Escolher Portfólio de Negócio" width="1100" height="562" data-path="images/1908037094.png" />

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908040842.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=b1674d4f050de06bcc79a9d1cecb109b" alt="Criar Nova WABA" width="745" height="883" data-path="images/1908040842.png" />
  </Step>
</Steps>

<Tip>
  Sempre crie uma **conta WABA NOVA** para a configuração de coexistência. Isso garante uso limpo e um fluxo de conexão saudável.
</Tip>

***

### Escolha Seu Método de Onboarding

Você tem duas opções:

1. **Conectar número existente do WhatsApp Business** — Recomendado para a maioria dos usuários
2. **Começar com um novo número de contato do WhatsApp**

<Warning>
  **Restrições:**

  * O número não pode estar atualmente vinculado a outro parceiro
  * Deve ser um número novo ou existente do WhatsApp Business
  * O número não pode estar bloqueado pela Meta
</Warning>

***

### Conectar Número Existente do WhatsApp Business

<Steps>
  <Step title="Inserir Número de Telefone">
    Selecione seu código de país e insira seu número de telefone, depois clique em **Próximo**.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908044314.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=c70d95671e9a3135becd70897903f4fc" alt="Inserir Número de Telefone" width="1112" height="560" data-path="images/1908044314.png" />
  </Step>

  <Step title="Escanear Código QR">
    Uma mensagem do WhatsApp será enviada para seu número. Clique em **Escanear Código QR** e escaneie o código exibido com seu WhatsApp Business App.

    <img src="https://mintcdn.com/eazybe/LwZyGcAmA1wyXuKZ/images/1908049708.png?fit=max&auto=format&n=LwZyGcAmA1wyXuKZ&q=85&s=4359e2d8d60aef655f19826561f756ff" alt="Escanear Código QR" width="1124" height="560" data-path="images/1908049708.png" />
  </Step>

  <Step title="Escolher Importação do Histórico de Conversas">
    Após escanear o código QR, configure suas preferências de importação:

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908050113.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=76ddd25b0f9fc008fc60d72c8a3e84a7" alt="Importação do Histórico de Conversas" width="954" height="502" data-path="images/1908050113.png" />

    * **Contatos:** Todos os contatos são importados automaticamente
    * **Conversas 1:1:** Opcional — Importe até 6 meses de histórico de conversas
    * **Mídia:** Opcional — Importe até 2 semanas de arquivos de mídia
    * **Conversas em Grupo:** Não são importadas
  </Step>

  <Step title="Aguardar Verificação da Conta">
    Sua conta será verificada. Este processo pode levar algum tempo.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908052548.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=b6f92960ba1ea02f81d2312f1795b9a9" alt="Verificação da Conta" width="1124" height="560" data-path="images/1908052548.png" />
  </Step>

  <Step title="Clique em Finalizar">
    Após a verificação estar completa, clique em **Finalizar** para completar a configuração.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908055256.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=45b2232ba8c0f0a0385491758a826ec4" alt="Finalizar Configuração" width="1132" height="570" data-path="images/1908055256.png" />
  </Step>
</Steps>

***

## Solução de Problemas

### Problema 1: Integração Falhou

**Razões comuns:**

* Versão antiga do WhatsApp
* Inatividade do número
* Restrições da Meta
* Sem acesso de administrador à Página do Facebook

<Tip>
  **Solução:** Use outro número com uso ativo do WhatsApp Business e sem violações anteriores.
</Tip>

***

### Problema 2: O Histórico de Conversas Não Foi Importado

Se a importação falhar, siga estes passos:

<Steps>
  <Step title="Abrir WhatsApp Business App">
    Abra o WhatsApp Business App no seu telefone.
  </Step>

  <Step title="Navegar para Configurações">
    Vá para **Configurações → Ferramentas de Negócio → Plataforma WhatsApp Business**.
  </Step>

  <Step title="Desconectar">
    Toque em **Desconectar** para remover a conexão atual.
  </Step>

  <Step title="Reiniciar Onboarding">
    Inicie o processo de onboarding de Coexistência novamente desde o início.
  </Step>
</Steps>

<Warning>
  Se você pulou manualmente a importação do histórico inicialmente, você deve desconectar completamente e reconectar. Note que os backups de conversas podem não ser restaurados se você escolheu a opção errada durante o registro inicial.
</Warning>

***

### Problema 3: O Número Tem Restrições da Meta

**Sintomas:**

* O onboarding de Coexistência falha instantaneamente
* O código QR não completa
* A mensagem "Conectar à Plataforma Business" não aparece

<Tip>
  **Solução:** Use um número novo sem problemas de políticas e com atividade frequente e legítima do WhatsApp Business.
</Tip>

***

## Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Posso usar um número pessoal do WhatsApp?">
    Não. Apenas números do WhatsApp Business App são permitidos para Coexistência.
  </Accordion>

  <Accordion title="Minhas conversas permanecerão no app do meu telefone?">
    Sim. Nada é excluído do WhatsApp Business App. Suas conversas existentes permanecem intactas.
  </Accordion>

  <Accordion title="Posso continuar usando o WhatsApp Business App após Coex?">
    Sim. Você pode continuar usando o WhatsApp Business App normalmente enquanto também se beneficia da integração com a API Cloud.
  </Accordion>
</AccordionGroup>

***

## Artigos Relacionados

* [Começando com Sua Conta Oficial do WhatsApp Business (WABA)](/pt/waba/overview)
* [Como Conectar Sua Conta do WhatsApp Business (WABA) ao Eazybe](/pt/waba/connect-waba)
* [WABA: Perguntas Frequentes (FAQ)](/pt/waba/faq)