> ## 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 Coex/API

> Guia completo para integração do WhatsApp Coexistence via Eazybe

O WhatsApp Coexistence permite que empresas conectem seu número ativo do WhatsApp Business App à WhatsApp Cloud API — sem perder conversas, contatos ou precisar registrar o número novamente.

## O que é Coexistence?

<CardGroup cols={2}>
  <Card title="Conectar à Cloud API" icon="cloud">
    Conecte o WhatsApp Business App à Cloud API perfeitamente
  </Card>

  <Card title="Continuar Usando o Business App" icon="mobile">
    Continue usando o Business App normalmente após a conexão
  </Card>

  <Card title="Sincronizar Tudo" icon="arrows-rotate">
    Sincronização de mensagens e contatos em tempo real
  </Card>

  <Card title="Sem Perda de Dados" icon="shield-check">
    Preserve o histórico de conversas e contatos sem nenhuma perda de dados
  </Card>
</CardGroup>

<Info>
  Este é o método mais seguro para migrar para a Cloud API sem perder dados. Você pode usar o mesmo número de telefone tanto no WhatsApp Business App quanto na API.
</Info>

## Pré-requisitos

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

<AccordionGroup>
  <Accordion title="Conta do WhatsApp Business" icon="whatsapp">
    Você deve ter uma conta/número do WhatsApp Business existente. **Números pessoais do WhatsApp não são suportados.**
  </Accordion>

  <Accordion title="Versão do App" icon="mobile">
    É necessário o WhatsApp Business App **versão 2.24.17 ou superior**. Versões anteriores falharão durante a vinculação por QR.
  </Accordion>

  <Accordion title="Saúde do Número" icon="heart-pulse">
    Seu número deve ter:

    * Atividade regular no WhatsApp
    * Sem restrições da Meta
    * Sem violações de políticas
    * Uso genuíno ativo por **mínimo 3-7 dias**
  </Accordion>

  <Accordion title="Página do Facebook Business" icon="facebook">
    É necessária uma Página do Facebook Business com **acesso de administrador**.
  </Accordion>

  <Accordion title="Restrições Regionais" icon="globe">
    Números da **Nigéria ou África do Sul** não são suportados atualmente devido às regulamentações da Meta.
  </Accordion>

  <Accordion title="Elegibilidade do Número" icon="check-circle">
    Seu número não deve estar:

    * Vinculado a outro provedor de WhatsApp API
    * Bloqueado pela Meta
  </Accordion>
</AccordionGroup>

## Guia de Configuração

<Steps>
  <Step title="Inserir Email e Fazer Login">
    Insira seu endereço de e-mail e faça login com sua conta.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908079503.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=83cef728e9f6f10b1b1c9edd999adca4" alt="Tela de Login" width="940" height="451" data-path="images/1908079503.png" />
  </Step>

  <Step title="Inserir OTP">
    Insira o OTP enviado para sua caixa de entrada do Gmail.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908080255.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=2897bd73a42176750d57b3a474354f32" alt="Verificação OTP" width="940" height="409" data-path="images/1908080255.png" />
  </Step>

  <Step title="Adicionar Número">
    Clique em **Adicionar Número** para prosseguir com o fluxo de cadastro integrado.

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

  <Step title="Login no Facebook">
    Insira suas credenciais de login do Facebook, ou clique em **Continuar como** se sua sessão estiver salva.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908181947.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=644a2b6667ab343ab778e7477e149014" alt="Login no Facebook" width="940" height="468" data-path="images/1908181947.png" />
  </Step>

  <Step title="Conceder Permissões">
    Clique em **Continuar** na página de permissões para autorizar a conexão.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908182968.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=45d6f052dac25f29fcf181fa86d6fa28" alt="Permissões" width="940" height="1101" data-path="images/1908182968.png" />
  </Step>

  <Step title="Preencher Detalhes da Empresa">
    Complete o formulário de detalhes comerciais com informações precisas.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908184223.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=72ee33bdf15f020866f7c3aebea5f471" alt="Detalhes da Empresa" width="940" height="481" data-path="images/1908184223.png" />
  </Step>

  <Step title="Criar Portfólio de Negócios">
    Crie ou escolha seu portfólio de negócios.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908184840.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=f37a74f2960f246dcbca40c8145a6228" alt="Portfólio de Negócios" width="940" height="480" data-path="images/1908184840.png" />

    <Warning>
      Sempre crie uma **NOVA conta WABA** para coexistência para garantir uso limpo e fluxo saudável.
    </Warning>
  </Step>

  <Step title="Escolher Método de Onboarding">
    Selecione seu método de onboarding:

    1. Conectar número existente do WhatsApp Business
    2. Começar com novo número de contato do WhatsApp

           <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908185631.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=d4c5f71756f1a209a4707b218e781d1d" alt="Método de Onboarding" width="940" height="1114" data-path="images/1908185631.png" />

    <Info>
      **Restrições:** O número não deve estar vinculado a nenhum outro parceiro, deve ser um número novo ou existente do WhatsApp Business, e não deve estar bloqueado pela Meta.
    </Info>
  </Step>

  <Step title="Inserir Número de Telefone">
    Selecione seu código de país e insira seu número de telefone.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908189194.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=e941c9778a717ab6f4cb127831662a0c" alt="Inserção de Número" width="602" height="303" data-path="images/1908189194.png" />
  </Step>

  <Step title="Escanear Código QR">
    Escaneie o código QR usando seu WhatsApp Business App.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908190332.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=50525a95773e69d32660a8a9a042a55d" alt="Escaneamento de Código QR" width="602" height="300" data-path="images/1908190332.png" />
  </Step>

  <Step title="Importar Histórico de Conversas">
    Escolha se deseja importar o histórico de conversas:

    * Todos os contatos são importados automaticamente
    * Opcional: Até **6 meses** de conversas 1:1
    * Opcional: Até **2 semanas** de mídia
    * Conversas em grupo **não** são importadas

          <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908191287.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=0feff67dd43d26ad4598a313aff59f3d" alt="Importar Histórico de Conversas" width="940" height="495" data-path="images/1908191287.png" />
  </Step>

  <Step title="Verificar Conta">
    Aguarde a verificação da conta. O processo de conexão leva algum tempo.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908192254.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=6eca6f00e0c59aeeac4f405b49d351f4" alt="Verificação" width="602" height="300" data-path="images/1908192254.png" />
  </Step>

  <Step title="Concluir Configuração">
    Clique em **Finalizar** para completar o processo de configuração.

    <img src="https://mintcdn.com/eazybe/KddIQ2H1brmf1ALS/images/1908192355.png?fit=max&auto=format&n=KddIQ2H1brmf1ALS&q=85&s=c767077fcfe546e13b9b794924a68ab4" alt="Configuração Concluída" width="602" height="300" data-path="images/1908192355.png" />
  </Step>
</Steps>

## Solução de Problemas

### Falha na Integração

<Warning>
  Motivos comuns para falha na integração:

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

**Solução:** Use outro número que tenha uso ativo do WhatsApp Business e sem violações anteriores.

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

<Steps>
  <Step title="Abrir WhatsApp Business App">
    Navegue até **Configurações > Ferramentas Comerciais > Plataforma WhatsApp Business**
  </Step>

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

  <Step title="Reiniciar Onboarding">
    Reinicie o processo de onboarding do Coex desde o início
  </Step>
</Steps>

<Info>
  Se você pulou manualmente a importação do histórico inicialmente, deve fazer offboarding completo e onboarding novamente para importar o histórico de conversas.
</Info>

### Número com Restrições da Meta

**Sintomas:**

* Falha instantânea
* Código QR não completa o escaneamento
* Nenhuma mensagem "Conectar à Plataforma Business" aparece

**Solução:** Use um número sem problemas de política e com atividade legítima frequente no WhatsApp Business.

## Perguntas Frequentes

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

  <Accordion title="Minhas conversas permanecerão no aplicativo do telefone?" icon="question">
    **Sim.** Nada é excluído do WhatsApp Business App. Todas as suas conversas permanecem intactas.
  </Accordion>

  <Accordion title="Posso continuar usando o WhatsApp Business App após o Coex?" icon="question">
    **Sim.** Você pode continuar usando o WhatsApp Business App normalmente após configurar o Coexistence.
  </Accordion>
</AccordionGroup>

## Precisa de Ajuda?

Se você tiver alguma dúvida ou precisar de mais assistência, não hesite em entrar em contato conosco em [hey@eazybe.com](mailto:hey@eazybe.com). Ficaremos felizes em ajudar!