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

# Integrar aplicativo WhatsApp Business

> Desbloqueie recursos avançados de mensagens via API sem sair do aplicativo WhatsApp Business

## O que é a Coexistência do WhatsApp

**Isso significa que sua WhatsApp Business API e o aplicativo WhatsApp Business agora podem coexistir juntos!**

Integrar um número já em uso no aplicativo WhatsApp Business para acesso à API permite que tanto a API quanto o aplicativo operem no mesmo número de telefone. Você pode usar recursos como mensagens em grande escala, respostas de Agentes de IA, fluxos baseados em regras e Jornadas enquanto continua enviando mensagens pelo aplicativo WhatsApp Business.

Este recurso é perfeito para equipes que desejam fazer a transição para fluxos de trabalho baseados em API enquanto continuam usando o aplicativo existente.

## Por que usar a Coexistência do WhatsApp

**Cenário 1:** Se seus funcionários precisam se comunicar com os usuários usando um computador de trabalho durante o dia e continuar a conversa perfeitamente pelo aplicativo à noite.

**✅ Benefícios correspondentes:** As mensagens serão espelhadas entre o aplicativo móvel e a API. Ou seja:

1. As mensagens enviadas via API aparecerão no aplicativo WhatsApp Business.
2. As mensagens enviadas pelo aplicativo aparecerão no histórico de conversas da Cloud API, que você pode verificar em computadores.

**Cenário 2:** Se você deseja usar recursos como mensagens de marketing em massa, respostas automáticas inteligentes de Agentes de IA, engajamento de clientes baseado em Jornadas e outras funcionalidades avançadas, mantendo o acesso pelo aplicativo móvel.

**✅ Benefícios correspondentes:** A Coexistência do WhatsApp permite usar todos esses recursos avançados de API mantendo o envio de mensagens individuais no aplicativo.

**Cenário 3:** Se você já possui um número ativo no aplicativo WhatsApp Business e deseja evitar o incômodo de registrar um novo número de API.

**✅ Benefícios correspondentes:** Conecte perfeitamente o número do seu aplicativo WhatsApp Business e use as funcionalidades da API sem excluir sua conta do WhatsApp Business original.

## Informações importantes

#### **Taxa de transferência**

1. Para manter a compatibilidade com o aplicativo WhatsApp Business, os números de telefone comerciais em uso tanto com o aplicativo WhatsApp Business quanto com a Cloud API têm uma taxa de transferência fixa de 5 mps (mensagens por segundo).

#### **Requisito**

Para usar este recurso, você deve estar usando a versão 2.24.17 ou superior do aplicativo WhatsApp Business.

#### **Preços**

As mensagens enviadas pelo aplicativo WhatsApp Business continuam gratuitas; as mensagens enviadas pela Plataforma de Parceiros da API são cobradas com base no [modelo de preços da API](https://www.ycloud.com/price) existente.

#### **Comparação de funções após a vinculação**

A tabela a seguir descreve os recursos disponíveis para clientes comerciais que foram integrados à Cloud API, bem como quaisquer alterações na funcionalidade do aplicativo WhatsApp Business após a integração. Observação: mensagens de mídia (como aquelas contendo imagens, vídeos e áudios) com mais de 14 dias não poderão ser sincronizadas.

<img src="https://mintcdn.com/lchnan/9zlgZMZStxEKrVPM/product-assets/14b9cd3293-image-92.webp?fit=max&auto=format&n=9zlgZMZStxEKrVPM&q=85&s=e14e5de460730deb576b9eaf2ce9013b" alt="Captura de tela do produto YCloud" width="816" height="1583" data-path="product-assets/14b9cd3293-image-92.webp" />

## Como funciona

Abra **Contas do WhatsApp**, clique em **Criar canal** e localize **Coexistência do WhatsApp Business App**.

<Frame caption="Select Get started under WhatsApp Business APP Coexistence.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-2026-09-23/channel-coexistence-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=543cddc967324e176eb63dd9c2ee1bfc" alt="Opção de Coexistência do WhatsApp Business App em Criar canal." width="3024" height="1656" data-path="product-assets/english-help-2026-09-23/channel-coexistence-annotated.svg" />
</Frame>

<Frame caption="Read the tutorial, then select I'm ready to start to open embedded registration.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-2026-09-23/coexistence-start-button-annotated.svg?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=7413be0ed0198f1391ae1d085acecb5b" alt="Página de preparação de coexistência da YCloud com o botão de início de cadastro incorporado." width="3024" height="1656" data-path="product-assets/english-help-2026-09-23/coexistence-start-button-annotated.svg" />
</Frame>

A coexistência do aplicativo WhatsApp Business pode ser conectada de duas maneiras. Escolha o método que corresponde à forma como sua empresa gerencia os ativos da Meta.

| Método de conexão | Quando usar | Do que você precisa |
| - | - | - |
| **Conectar com o Facebook** | Use este método quando desejar que o número do aplicativo WhatsApp Business pertença e seja gerenciado no seu portfólio empresarial da Meta. | Uma conta do Facebook, documentos de registro da empresa e um site comercial para Verificação da Empresa. |
| **Conectar por código QR** | Use este método mais rápido quando não quiser entrar com o Facebook ou criar um portfólio empresarial durante a integração. | As informações da sua empresa e acesso ao aplicativo WhatsApp Business no telefone que está sendo conectado. |

Ambos os métodos mantêm o número de telefone disponível no aplicativo WhatsApp Business enquanto o conectam à YCloud.

## Opção 1: Conectar com o Facebook

Este método vincula o número do aplicativo WhatsApp Business a um portfólio empresarial da Meta. Posteriormente, você poderá manter e gerenciar os ativos comerciais associados no Portfólio empresarial da Meta.

Antes de começar, prepare uma conta do Facebook, os documentos de registro da sua empresa e o site dela. Esses materiais são necessários para a Verificação da Empresa.

1. Entre na sua conta do Facebook.
2. Crie um portfólio empresarial ou selecione um existente.
3. Na etapa da conta do WhatsApp Business, selecione **Conectar um aplicativo WhatsApp Business**.
4. Insira o número de telefone usado pelo seu aplicativo WhatsApp Business.
5. Quando o código QR for exibido, abra o WhatsApp Business App no celular e escaneie-o para autorizar a conexão.
6. No celular, escolha se deseja sincronizar seu histórico de conversas. Você pode sincronizar até os últimos seis meses de histórico.

## Opção 2: Conectar via código QR

Este é o método de integração mais rápido. Ele não exige login no Facebook nem a criação de um portfólio empresarial durante o processo de conexão.

1. Selecione o método de conexão por código QR.
2. Insira o nome da sua empresa e as informações do site.

<Warning>
  A coexistência com o WhatsApp Business App ainda requer a Verificação de Empresa. O **Nome da empresa** inserido durante a integração deve corresponder exatamente à razão social nos documentos de registro que você planeja enviar. Uma divergência pode afetar a Verificação de Empresa posteriormente.

  Insira o **Site** corretamente. Se a sua empresa não tiver um site, selecione **Minha empresa não tem um site ou página de perfil** em vez de deixar o campo incompleto.
</Warning>

3. Insira o número de telefone do WhatsApp Business App que você deseja conectar.
4. Abra o WhatsApp Business App no celular e escaneie o código QR para autorizar a conexão.
5. No celular, escolha se deseja sincronizar seu histórico de conversas. Você pode sincronizar até os últimos seis meses de histórico.

## Sincronizar histórico de conversas

Após a conclusão da autorização, a YCloud começa a sincronizar as conversas imediatamente se você optou por compartilhar seu histórico de conversas.

Mantenha o WhatsApp Business App aberto durante a sincronização. Novas mensagens aparecerão no YCloud Inbox somente após a conclusão da sincronização.

<img src="https://mintcdn.com/lchnan/RN4tXfXENVvDu0Te/product-assets/c75206157a-image-101.webp?fit=max&auto=format&n=RN4tXfXENVvDu0Te&q=85&s=07e76aadc8650d433a96bd1dffe3b496" alt="Monitore a sincronização do histórico de conversas do WhatsApp Business App na YCloud" width="1280" height="867" data-path="product-assets/c75206157a-image-101.webp" />

## Assista ao vídeo tutorial

[Assista ao tutorial de coexistência do WhatsApp Business App](https://youtu.be/gIJx2XGC3gA)

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="A coexistência afetará o uso normal do WhatsApp Business App?">
    Não. Você pode continuar enviando e recebendo mensagens e gerenciando contatos no WhatsApp Business App.
  </Accordion>

  <Accordion title="Posso configurar a coexistência por meio de uma API?">
    Não. A coexistência do WhatsApp Business App deve ser conectada por meio da plataforma YCloud. A YCloud não fornece uma API para essa operação de integração.
  </Accordion>

  <Accordion title="Por que a conta não aparece na YCloud depois que eu concluí a autorização?">
    Geralmente, isso significa que a autorização foi bem-sucedida, mas a vinculação final falhou. As causas possíveis incluem:

    * **Conectado anteriormente a outra plataforma:** A conta ainda pode estar associada a outro provedor. Siga o processo de migração de conta de coexistência antes de tentar vinculá-la à YCloud.
    * **Falha temporária de vinculação:** Se a interface de vinculação estava temporariamente instável, desvincule a YCloud do WhatsApp Business App no celular e inicie a conexão novamente.
    * **Informações do site incompletas:** Se nem um site válido nem **Minha empresa não tem um site ou página de perfil** tiver sido selecionado, a conta poderá permanecer pendente. Desvincule-a no celular e repita a conexão com as informações comerciais completas.
  </Accordion>

  <Accordion title="Como resolvo erros comuns de vinculação de coexistência?">
    | Erro | Significado e ação recomendada |
    | - | - |
    | `#2655093: already shared with another partner` | A conta foi associada anteriormente a outro provedor. Solicite ao provedor anterior a remoção completa do acesso de parceiro e tente novamente. Uma reconexão bem-sucedida não pode ser garantida. |
    | `#2655121: Restricted WhatsApp Business Account` | A conta está bloqueada ou foi bloqueada anteriormente no aplicativo móvel e pode ser considerada de alto risco. Use um número diferente ou aguarde vários dias antes de tentar novamente. |
    | `#3441061: phone number linked to automated events` | Desative os eventos automatizados indicados pela Meta, aguarde a sincronização das alterações da Meta e tente novamente. |
    | `Your phone number isn't eligible to connect to the WhatsApp Business platform. More activity on the WhatsApp Business app is needed to help determine eligibility.` | A Meta ainda não possui atividade recente suficiente para determinar que o número é elegível. Isso pode acontecer quando a conta é nova, tem poucas conversas recentes ou não esteve ativa recentemente. Continue usando o WhatsApp Business App para conversas genuínas e tente conectar novamente mais tarde. |
  </Accordion>

  <Accordion title="Por que uma conta de coexistência conectada anteriormente desapareceu?">
    A Meta pode desvincular a conta automaticamente quando o WhatsApp Business App estiver inativo ou quando a sessão do aplicativo for iniciada em um dispositivo diferente. Conecte a conta novamente na YCloud.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.