> For the complete documentation index, see [llms.txt](https://ajuda.livechat360.com.br/crm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.livechat360.com.br/crm/administracao/configuracoes/configurando-o-whatsapp-whatsapp-api/nova-tela-de-integracao.md).

# Nova Tela de Integração

Etapas para o processo de integração do seu número de telefone com o sistema. Utilize os links desta documentação para navegar entre as etapas do processo.

{% hint style="info" %}
Se você não possui um *Portifólio Empresarial* será necessário criar um seguindo a seguinte documentação: [Como criar um portfólio empresarial no Meta Business Suite](https://pt-br.facebook.com/business/help/1710077379203657). 

O cadastro precisa ser feito com a conta pessoal do Facebook de quem será o responsável em administrar esse portifólio empresarial. Para entrar no *Portifólio Empresarial* você usa seu nome de usuário e senha do *Facebook*.
{% endhint %}

## Resumo Gráfico do Processo de Integração

Resumo gráfico do passo a passo das diferentes possibilidade de integração:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FKUwFMPWIdSzwEX7Ctn0K%2FQuadro%20de%20Salvamento.png?alt=media&amp;token=4b8fae18-d156-4246-9919-d174c06e1634" alt=""><figcaption></figcaption></figure>

## Identifique a situação do seu número de telefone

Antes de tudo, identifique em quais das 4 situação o seu número de telefone se encontra e clique no link associado a ela. Isso será importante para saber quais passos de integração você irá seguir:

* **(1)** [Número de Telefone **com** WhatsApp Messenger e **sem** Aplicativo do WhatsApp Business](#id-1.-numero-de-telefone-com-whatsapp-messenger-e-sem-aplicativo-do-whatsapp-business). <mark style="color:$info;">Nesse caso, o número de telefone está vinculado exclusivamente ao</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">App do WhatsApp tradicional</mark>*<mark style="color:$info;">, que é a versão mais utilizada pelas pessoas no dia a dia para comunicação pessoal.</mark>
* **(2)** [Número de Telefone **sem** WhatsApp Messenger e **sem** Aplicativo do WhatsApp Business](#id-2.-numero-de-telefone-sem-whatsapp-messenger-e-sem-aplicativo-do-whatsapp-business). <mark style="color:$info;">Nesse caso, o número de telefone não possui nenhum aplicativo do WhatsApp vinculado.</mark>
* **(3)** [Número de Telefone **integrado** à API Cloud ou **já associado** a uma *Conta WhatsApp*](#id-2.1-numero-de-telefone-integrado-a-api-cloud-ou-ja-associado-a-uma-conta-whatsapp).

{% hint style="info" %} <mark style="color:$info;">**O que significa um número de telefone integrado a API Cloud ou já associado a uma Conta WhatsApp?**</mark>

<mark style="color:$info;">Quando o número de telefone já tiver sido utilizado em uma integração anterior — por exemplo, em um processo concluído por meio do botão “</mark>*<mark style="color:$info;">Logar com o Facebook</mark>*<mark style="color:$info;">” — ou quando, por algum outro motivo, já estiver associado a uma</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Conta do WhatsApp</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">(WABA) em um</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Portfólio Empresarial (BM)</mark>*<mark style="color:$info;">, este será o procedimento correto a ser seguido.</mark>

<mark style="color:$info;">Isso ocorre porque, nesse processo, será possível selecionar o</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Portfólio Empresarial (BM)</mark>*<mark style="color:$info;">, a</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Conta do WhatsApp Business (WABA)</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">e, consequentemente, o número de telefone que já está cadastrado.</mark>
{% endhint %}

{% hint style="info" %} <mark style="color:$info;">Caso você desconfie que o seu número já esteja associado a uma</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Conta WhatsApp</mark>*<mark style="color:$info;">, entre em cada um dos seus</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Portfólios Empresariais</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">pelo</mark> [<mark style="color:$info;">link</mark>](https://business.facebook.com/latest/settings/whatsapp_account) <mark style="color:$info;">e, em cada uma das</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Contas do WhatsApp</mark>*<mark style="color:$info;">, na aba</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Phone numbers</mark>*<mark style="color:$info;">, verifique se encontra o número de telefone que deseja integrar. Se encontrar, esse será o</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Portifólio Empresarial (BM)</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">e a</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Conta do WhatsApp</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">(WABA) que irá utilizar no processo de integração.</mark>
{% endhint %}

* **(4)** [Número de Telefone **sem** WhatsApp Messenger e **com** Aplicativo do WhatsApp Business](#id-3.-numero-de-telefone-sem-whatsapp-messenger-e-com-aplicativo-do-whatsapp-business). <mark style="color:$info;">Nesse caso, o número de telefone está vinculado exclusivamente ao</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">App do WhatsApp Business</mark>*<mark style="color:$info;">, que é a versão do aplicativo desenvolvida para uso empresarial.</mark>

<details>

<summary><strong>Resumo das etapas necessárias, organizadas pela situação atual do seu número de telefone</strong></summary>

Este é um resumo das etapas necessárias para o processo de integração, com o objetivo de oferecer uma visão geral das ações que serão realizadas em cada cenário possível, de acordo com a situação em que o número de telefone se encontra.

{% hint style="info" %}
Atenção: o conteúdo deste card é apenas um resumo. O passo a passo completo para a realização da integração está descrito logo abaixo.
{% endhint %}

O processo geral começa identificando em qual destes quatro cenários o seu número se encaixa:

#### 1. Número com WhatsApp Messenger (Pessoal) e sem WhatsApp Business

O número está vinculado apenas ao aplicativo comum do WhatsApp. A API não funciona em conjunto com o app pessoal.

* Ação Necessária: Você deve liberar o número antes de integrar.
* Opções:
  * Mudar o número: Se deseja manter o histórico, use a função "Mudar número" nas configurações do WhatsApp para passar a conta para outro chip. O número original ficará livre após cerca de 2 horas.
  * Excluir a conta: Se não precisa do histórico, vá em Configurações > Conta > Apagar conta. Isso libera o número imediatamente.
* Próximo Passo: Após liberar, siga para o processo de *Login com Facebook* no sistema.

#### 2. Número sem nenhum aplicativo (Nem Messenger, nem Business)

O chip não tem conta de WhatsApp ativa no momento. Aqui há duas sub-situações:

**2.1 Número JÁ integrado à API Cloud anteriormente**

O número já foi usado em uma integração de API (em outro sistema ou no mesmo).

* Etapas:
  1. Inicie o "*Login com Facebook*" no sistema.
  2. Durante o passo a passo, selecione a opção que indica que o número já foi integrado.
  3. Escolha a conta do WhatsApp Business existente para puxar os dados.

**2.2 Número NUNCA integrado à API Cloud**

O número está "limpo" e você vai começar do zero.

* Opção A: Integração Direta (Sem App)
  * O número será exclusivo do sistema (não funcionará em celular).
  * Etapas: Inicie o "*Login com Facebook*" e selecione a opção de fazer uma nova integração direta.
* Opção B: Coexistência (Com App Business)
  * Permite usar o sistema e o *App WhatsApp Business* no celular simultaneamente.
  * Etapas:
    1. Instale e ative o *WhatsApp Business App* no celular primeiro.
    2. Inicie o "*Login com Facebook*".
    3. Selecione a opção de Manter a Coexistência.

#### 3. Número com WhatsApp Business App (e sem Messenger)

O número já está sendo usado no aplicativo WhatsApp Business.

* Opção A: Manter Coexistência
  * Deseja continuar usando o app no celular junto com o sistema.
  * Etapas: Inicie o "*Login com Facebook*" e, nas opções, escolha Integração com Coexistência.
* Opção B: NÃO Manter Coexistência (Uso exclusivo no sistema)
  * Ação Necessária: Deve excluir ou mudar a conta do WhatsApp Business (semelhante ao Cenário 1) para liberar o número para a API pura.
  * Nota: Faça backup antes se quiser salvar as conversas, pois ao apagar a conta o histórico do app é perdido.

#### 4. Etapa Comum: O Processo de Login

Independentemente da situação acima, após preparar o número, o fluxo no sistema é:

1. Acessar *Configurações* > *Whatsapp-Api* > *Conexão*.
2. Clicar em *Logar com Facebook*.
3. O usuário deve ter acesso administrativo à *Business Manager* (BM) da empresa.
4. Seguir as telas de permissão e seleção do Portfólio Empresarial e da Conta do WhatsApp.

</details>

## 0. Escolha entre Coexistência e MM Lite

Ao clicar no botão "***Logar com Facebook***", uma tela irá aparecer para que seja escolhida uma das opções:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FF27zW9D7R7ynamzhH7O2%2Fimage.png?alt=media&amp;token=eea79920-9e6e-43c9-bac1-6955e02877dc" alt=""><figcaption></figcaption></figure>

### **Coexistência**:&#x20;

Escolher essa opção faz mais sentido quando o cliente diz:

> "*Eu quero continuar usando meu WhatsApp Business no celular, mas também quero conectar esse mesmo número ao sistema.*"

A **Coexistência** é indicada para empresas que desejam conectar o *WhatsApp Business* à plataforma sem deixar de utilizar o aplicativo no celular. Com ela, o mesmo número pode permanecer ativo no *App WhatsApp Business* e, simultaneamente, ser utilizado pela API para atendimento, automações, chatbot e gestão das conversas.

A principal vantagem é permitir uma **transição mais flexível para a operação pela plataforma**, sem a necessidade de abandonar imediatamente a utilização do *App WhatsApp Business*. As mensagens e o histórico podem ser sincronizados entre os ambientes, permitindo que a operação continue tanto pelo aplicativo quanto pela plataforma.

Dessa forma, a Coexistência é especialmente recomendada para empresas que **já utilizam o WhatsApp Business no dia a dia e desejam adicionar uma plataforma de atendimento, automação e gestão sem abrir mão do aplicativo**.

{% hint style="info" %}
Entretanto, ao escolher a Coexistência, o aplicativo do WhatsApp Business irá sofrer algumas limitações, como:

* O recurso de **mensagens temporárias** será desativado para todas as conversas individuais;
* O recurso de **visualização única** será desabilitado para todas as conversas individuais;
* As mensagens de **localização em tempo real** serão desabilitadas para todas as conversas individuais;
* As **listas de transmissão** do app serão desabilitadas. A empresa não poderá criar novas listas de transmissão pelo app. As listas de transmissão existentes se tornarão somente leitura.&#x20;

Para mais informações dos recursos que ficarão indisponíveis no *WhatsApp Business App* após a integração com a API, leia atentamente a documentação da *Meta*, em especial ao que se refere às [limitações](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/#limitations) da coexistência e a [comparação entre os recursos](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/#feature-comparison).
{% endhint %}

Nosso sistema está preparado para gerenciar as mensagens enviadas pelo WhatsApp Business diretamente pelo celular por meio do [**Modo Eco**](/crm/administracao/chat-ao-vivo-atendente.md#modo-eco). Com essa funcionalidade, as mensagens enviadas pelo aplicativo no celular também serão sincronizadas e ficarão disponíveis no sistema. Ou seja, as mensagens enviadas pelo celular também irão aparecer no sistema.

{% hint style="warning" %}
O número de telefone deve estar registrado e ativo no *WhatsApp Business App* para utilizar a Coexistência. Números recém registrados no app podem não estar imediatamente elegíveis para esse recurso. A Meta pode exigir um período mínimo de atividade no aplicativo; atualmente, há relatos de provedores indicando nenhuma exigência ou até mesmo uma exigência de 7 dias, embora, no passado, já tenha sido exigido um período de até 3 meses.

De todo modo, é possível tentar realizar a integração por meio do processo de *Coexistência*. Caso o número ainda não esteja elegível, a própria *Meta* informará a indisponibilidade durante o processo de integração. Nesse caso, será necessário aguardar o período de atividade exigido e tentar realizar a integração novamente posteriormente.

Como alternativa, também é possível realizar a integração pelo processo convencional, sem utilizar a *Coexistência*. Nesse modelo, o número deixa de ser utilizado pelo *WhatsApp Business App* e passa a operar exclusivamente pela integração com a plataforma.
{% endhint %}

### **MM Lite**: &#x20;

Escolher essa opção faz mais sentido quando a preocupação principal é:

> "*Eu quero enviar campanhas de marketing pelo WhatsApp com melhor eficiência de entrega.*" ou "*Eu não tenho interesse em manter a coexistência com o WhatsApp Business do meu celular.*"

O **MM Lite (Marketing Messages API)** é uma solução da Meta voltada especificamente para o **envio de mensagens de marketing pelo WhatsApp**. Seu principal diferencial é utilizar mecanismos de otimização da Meta para melhorar a entrega das campanhas e priorizar contatos com maior potencial de interação.

A solução é especialmente interessante para empresas que realizam **campanhas promocionais, ações de reengajamento e envios de marketing em maior escala**. Nesses casos, o MM Lite pode contribuir para melhorar o desempenho das campanhas sem que seja necessário simplesmente aumentar o volume de mensagens enviadas.

Por isso, o MM Lite é mais indicado para empresas que têm **marketing como uma parte relevante da operação no WhatsApp** e desejam aproveitar as otimizações oferecidas pela Meta para suas campanhas.

Nosso sistema está preparado para realizar o envio de mensagens no formato **MM Lite** por meio da lista de [**Transmissões**](/crm/administracao/transmissao.md#mm-lite). Ao criar uma *Transmissão* em massa, será possível escolher se o envio será realizado utilizando ou não o **modo MM Lite**.

## 1. Número de Telefone com WhatsApp Messenger e sem Aplicativo do WhatsApp Business.

Para utilizar um número de telefone que atualmente está vinculado ao aplicativo do ***WhatsApp Messenger*** em uma integração realizada pelo botão “***Logar com Facebook***”, é necessário primeiro **remover o vínculo do número com o aplicativo WhatsApp**.

Isso ocorre porque, conforme as regras da *Meta*, na integração convencional com a ***WhatsApp Cloud API***, o mesmo número de telefone não pode permanecer registrado e ativo no ***WhatsApp Messenger*** e, ao mesmo tempo, ser utilizado pela API. Ou seja, não será possível utilizar simultaneamente a API e o aplicativo tradicional do *WhatsApp* no mesmo número de telefone.

Portanto, antes de iniciar a integração com a API, o número deverá estar **livre do registro no aplicativo WhatsApp**.

Há duas opções para a remoção do vínculo: **mudar o número** – utilizar um novo número para realizar o processo de backup (as informações das conversas ficarão nesse novo número) e, depois, fazer a integração normalmente com o número anterior – ou **excluir a conta**, não realizando o backup.

&#x20;👉 [4. Excluir ou mudar conta](#id-4.-excluir-ou-mudar-uma-conta-do-aplicativo-whatsapp-messenger-ou-whatsapp-business)

## 2. Número de Telefone sem WhatsApp Messenger e sem Aplicativo do WhatsApp Business.

Nesse caso, você terá que identificar duas situações:

### 2.1 Número de Telefone integrado à *API Cloud* ou já associado a uma *Conta WhatsApp*.

Se o número de telefone JÁ FOI integrado anteriormente no WhatsApp API Cloud ou está associado a uma *Conta do WhatsApp* (WABA) em um *Portfólio Empresarial (BM)*, 👉 [5. Inicie o processo de login](#id-5.-inicie-o-processo-de-login), <mark style="color:$info;">depois, durante o passo a passo, selecione a opção</mark> [<mark style="color:$info;">8.1 Se o número de telefone JÁ FOI integrado anteriormente na API Cloud do WhatsApp Business</mark>](#id-8.1-se-o-numero-de-telefone-ja-foi-integrado-anteriormente-na-api-cloud-do-whatsapp-business) <mark style="color:$info;">e, no momento de selecionar uma conta do WhatsApp Business, escolha a seguinte opção</mark> [<mark style="color:$info;">9.1 Telefone integrado anteriormente</mark>](#id-9.1-se-o-numero-de-telefone-ja-foi-integrado-anteriormente-na-api-cloud-do-whatsapp-business)<mark style="color:$info;">.</mark>

{% hint style="info" %} <mark style="color:$info;">**O que significa um número de telefone integrado a API Cloud ou já associado a uma Conta WhatsApp?**</mark>

<mark style="color:$info;">Quando o número de telefone já tiver sido utilizado em uma integração anterior — por exemplo, em um processo concluído por meio do botão “</mark>*<mark style="color:$info;">Logar com o Facebook</mark>*<mark style="color:$info;">” — ou quando, por algum outro motivo, já estiver associado a uma</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Conta do WhatsApp</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">em um</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Portfólio Empresarial</mark>*<mark style="color:$info;">, este será o procedimento correto a ser seguido.</mark>

<mark style="color:$info;">Isso ocorre porque, nesse processo, será possível selecionar o</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Portfólio Empresarial</mark>*<mark style="color:$info;">, a</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Conta do WhatsApp Business</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">e, consequentemente, o número de telefone que já está cadastrado.</mark>
{% endhint %}

### 2.2 Número de telefone não integrado à *API Cloud* ou não associado a uma *Conta WhatsApp*.

Nesse caso, você pode escolher duas alternativas:

#### 2.2.1 Integração direta na API Cloud do WhatsApp Business.

Uma vez que o número de telefone NÃO ESTÁ cadastrado na API Cloud ou associado a uma *Conta do WhatsApp* (WABA) em um *Portfólio Empresarial (BM)* e você deseja fazer uma integração diretamente na API Cloud do WhatsApp Business, 👉 [5. Inicie o processo de login](#id-5.-inicie-o-processo-de-login), <mark style="color:$info;">depois, durante o passo a passo, selecione a opção</mark> [<mark style="color:$info;">8.2 Se o número de telefone NÃO ESTIVER cadastrado na API Cloud e você deseja fazer uma nova integração diretamente na API Cloud do WhatsApp Business</mark>](#id-8.2-se-o-numero-de-telefone-nao-estiver-cadastrado-na-api-cloud-e-voce-deseja-fazer-uma-nova-integra) <mark style="color:$info;">e, no momento de selecionar uma conta do WhatsApp Business (WABA), escolha a seguinte opção</mark> [<mark style="color:$info;">9.2 Integração direta</mark>](#id-9.2-se-o-numero-de-telefone-nao-estiver-cadastrado-na-api-cloud-e-voce-deseja-fazer-uma-nova-integra)<mark style="color:$info;">.</mark>

{% hint style="info" %}
Feita a integração direta, não será mais possível utilizar o aplicativo do *WhatsApp Business* e o sistema ao mesmo tempo, pois, a partir desse momento, todas as mensagens passam a ser direcionadas exclusivamente para o sistema integrado.
{% endhint %}

#### 2.2.2 Manter Coexistência entre API Cloud e o WhatsApp Business App

Uma vez que o número de telefone NÃO ESTÁ cadastrado na API Cloud, você pode optar por **instalar o Aplicativo do WhatsApp Business** e seguir 👉 [3.1 Manter coexistência](#id-3.1-manter-coexistencia-entre-api-cloud-e-aplicativo-do-whatsapp-business) para realizar a integração com coexistência entre o Aplicativo do WhatsApp Business e a API Cloud do WhatsApp Business.

{% hint style="info" %}
Ao utilizar a integração com coexistência, o aplicativo WhatsApp Business e o sistema podem ser acessados simultaneamente. Nessa modalidade, as mensagens são recebidas tanto pelo aplicativo quanto pelo sistema, conforme o comportamento definido pela Meta.

A funcionalidade de coexistência é recente e ainda não foi disponibilizada amplamente pela Meta. Por esse motivo, a integração pode ou não estar liberada para determinado número de telefone. Caso a coexistência não esteja habilitada no momento da configuração, será necessário seguir com a integração direta ou escolher um outro número de telefone para integrar ao sistema.

Números de telefone ou Portfólios Empresariais recém-criados ou trocados, geralmente não estão elegíveis para o uso da coexistência. Nessas situações, a integração direta tende a ser a única opção disponível para manter o mesmo número de telefone.
{% endhint %}

## 3. Número de Telefone sem WhatsApp Messenger e com Aplicativo do WhatsApp Business.

Nesse caso, será necessário escolher duas opções:

### 3.1 Manter coexistência entre API Cloud e Aplicativo do WhatsApp Business

Você poderá usar simultaneamente o aplicativo *WhatsApp Business* e o sistema integrado, e seu histórico de mensagens será preservado no aplicativo.

{% hint style="info" %}
Essa opção de integração não está disponível para todos os usuários, pois a *Meta* restringe seu uso a apenas alguns parceiros. Caso você possua um número com o *Aplicativo WhatsApp Business* já consolidado no mercado – e não pode abrir mão dele –, pode valer a pena insistir e tentar realizar a integração por esse método.

Caso a integração com coexistência não se mostre possível depois da tentativa, as alternativas restantes são **utilizar outro número de telefone para a integração** ou **manter o mesmo número, seguindo o** [**processo de integração sem coexistência**](#id-3.2-nao-manter-coexistencia-entre-api-cloud-e-aplicativo-do-whatsapp-business) (3.2).
{% endhint %}

{% hint style="info" %}
Atenção: em relação a coexistência, leia atentamente a documentação da Meta, em especial ao que se refere às [limitações](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/#limitations) da coexistência e a [comparação entre os recursos](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/#feature-comparison). Recursos como, por exemplo, a edição/exclusão de mensagens, mensagens temporárias, visualização única e lista de transmissão, não estarão mais disponíveis no *Aplicativo do WhatsApp Business* APÓS a integração com a API em nuvem.
{% endhint %}

👉 [5. Inicie o processo de login](#id-5.-inicie-o-processo-de-login), <mark style="color:$info;">depois, durante o passo a passo, selecione a opção</mark> [<mark style="color:$info;">8.3 Se você deseja manter a COEXISTÊNCIA entre a API Cloud e o WhatsApp Business App</mark>](#id-8.3-se-voce-deseja-manter-a-coexistencia-entre-a-api-cloud-e-o-whatsapp-business-app) <mark style="color:$info;">e, no momento de selecionar uma conta do WhatsApp Business (WABA), escolha</mark> [<mark style="color:$info;">9.3 Integração com Coexistência</mark>](#id-9.3-se-voce-deseja-manter-a-coexistencia-entre-a-api-cloud-e-o-whatsapp-business-app)<mark style="color:$info;">.</mark>

### 3.2 Não manter coexistência entre API Cloud e Aplicativo do WhatsApp Business

Para usar um número de telefone existente no aplicativo WhatsApp Business com a API Cloud, você precisa excluir ou mudar sua conta. Siga para 👉 [4. Excluir ou mudar conta](#id-4.-excluir-ou-mudar-uma-conta-do-aplicativo-whatsapp-messenger-ou-whatsapp-business)

{% hint style="danger" %}
Lembre-se de fazer backup do seu histórico de conversas no aplicativo WhatsApp Business. Estes são os guias sobre como fazer isso para [Android](https://faq.whatsapp.com/481135090640375/?cms_platform=android\&helpref=platform_switcher) ou [iOS](https://faq.whatsapp.com/481135090640375/?cms_platform=iphone\&helpref=platform_switcher).
{% endhint %}

Observe que, se você excluir seu número de telefone do aplicativo WhatsApp Business e registrá-lo para uso com a API Cloud, seu histórico de mensagens será perdido e você não poderá usar esse número com o aplicativo WhatsApp Business novamente, a menos que cancele o registro do número na API Cloud.

## 4. Excluir ou mudar uma conta do aplicativo WhatsApp Messenger ou WhatsApp Business

Ao configurar uma integração com o sistema, pode ser necessário liberar o número de telefone utilizado no aplicativo WhatsApp Business. Existem duas formas principais de realizar esse procedimento: ***apagar a conta*** ou ***alterar o número***. Cada opção possui impactos diferentes no aplicativo.

### Se precisar fazer backup

Se **precisar fazer backup** das conversas da conta vinculada ao número, então será necessário **trocar o número**, pois isso transfere os dados e as configurações da sua conta para seu novo número de telefone.

A opção ***Alterar o Número*** substitui o número registrado no WhatsApp Business por outro número de telefone. Nesse caso:

* O histórico de conversas é mantido dentro do aplicativo, mas passa a ficar associado ao novo número. Isso significa que, ao enviar mensagens pelo aplicativo, elas serão enviadas utilizando o novo número, e não mais o número anterior.
* O número anterior é liberado para posterior integração ao sistema.

Durante o processo, recomenda-se **marcar a opção para não notificar os contatos sobre a mudança**, evitando comunicações desnecessárias.

Essa alternativa é útil quando se deseja preservar o histórico no aplicativo, mas ainda assim liberar o número original para uso no sistema.\
\
Para isso, vá até o *WhatsApp* > *Configurações* > *Conta* > *Mudar número*.\
Será necessário esperar por volta de 2h para prosseguir com a integração no sistema.&#x20;

{% hint style="info" %}
Para mais informações sobre mudança do número de telefone, consulte: [Sobre mudar seu numero de telefone](https://faq.whatsapp.com/1166321223998129/?helpref=hc_fnav).
{% endhint %}

### Se não precisar fazer backup

Se **não precisar fazer backup das conversas** – o que vai fazer com que todas as conversas anteriores sejam perdidas –, então será necessário **apagar a conta**.

O processo de ***Apagar a Conta*** remove completamente a conta do WhatsApp Business vinculada ao número de telefone. Ao utilizar essa opção:

* O aplicativo do WhatsApp Business é resetado.
* ⚠️Todas as conversas, contatos e histórico armazenados localmente são removidos.
* O número de telefone é desvinculado do WhatsApp Business, ficando disponível para ser integrado ao sistema.

Essa opção é recomendada quando não há necessidade de manter o histórico de mensagens no aplicativo ou quando o ambiente precisa ser completamente liberado para integração.

Para isso, vá até o *WhatsApp* > *Configurações* > *Conta* > *Apagar conta*.

{% hint style="info" %}
Para mais informações sobre exclusão do número de telefone, consulte: [Como apagar a sua conta](https://faq.whatsapp.com/2138577903196467/?helpref=hc_fnav\&cms_platform=android).
{% endhint %}

### Após apagar a conta ou alterar o número

Após liberar o número — seja por apagar a conta ou por alterar o número —, ele já pode ser utilizado no processo de integração com o sistema. Siga para 👉 [2.2 Número de telefone não integrado à *API Cloud* ou não associado a uma *Conta WhatsApp*](#id-2.2-numero-de-telefone-nao-integrado-a-api-cloud-ou-nao-associado-a-uma-conta-whatsapp)*.*

{% hint style="info" %}
Caso a integração seja concluída rapidamente, as próximas mensagens enviadas pelos contatos ao número já passarão a aparecer diretamente no sistema, garantindo continuidade no atendimento.
{% endhint %}

***

## 5. Inicie o processo de login

No sistema, acesse a página *Configurações* > *Whatsapp-Api* > *Conexão* e clique no botão ***Logar com Facebook***.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FL1CHjHHU4ve5i6VhRATt%2Fimage.png?alt=media&amp;token=dad68c36-1c32-4cc8-a803-02f182e34c6e" alt=""><figcaption></figcaption></figure>

### Quem deve clicar no botão 'Logar com facebook'?

O login com o Facebook (Cadastro Incorporado), para fazer integração automática com o sistema, deve ser realizado por usuários do Facebook que sejam convidados, ou proprietários, de uma **Business Manager** (BM) do Cliente e que tenham **permissão** de acesso liberada. Consulte: [Associando uma pessoa a uma BM](/crm/administracao/configuracoes/configurando-o-whatsapp-whatsapp-api/associando-uma-pessoa-a-um-portifolio-empresarial-bm.md) para configurar essas permissões.

Na janela que se abrir, selecione uma conta do Facebook cujo usuário está associado, sendo proprietário ou convidado com permissões liberadas, a **Business Manager** (BM) que será utilizada nos próximos passos, depois clique no botão ***Continuar como*****...**.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FXgMj3g6kgQsJkfUy6yC2%2Fimage.png?alt=media&amp;token=3f264de5-dfdb-41cb-9723-5c774389c5b3" alt="" width="421"><figcaption></figcaption></figure>

## 6. Tela de autorização

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2F0BBHqtzpAPwEmt45HWzH%2Fimage.png?alt=media&amp;token=9eed9476-de1f-473d-9429-29c5bd3e7014" alt="" width="423"><figcaption></figcaption></figure>

Esta tela exibe uma janela de autorização da Meta para conectar uma conta comercial à plataforma parceira "LiveChat 360".

O objetivo principal é ativar a integração com a API do WhatsApp Business, permitindo o gerenciamento automatizado e seguro de grandes volumes de mensagens de clientes.

Para finalizar o vínculo entre os serviços e aceitar os termos de uso, o usuário deve clicar no botão azul "**Continuar**".

{% hint style="danger" %}
**Atenção**: Caso, nesta etapa, o botão para avançar na configuração esteja identificado como "***Continuar***", siga as etapas indicadas normalmente. Entretanto, se o botão estiver identificado como "***Começar***" – como mostrado na imagem abaixo –, isso indica que a versão de integração disponibilizada pela *Meta* é a antiga, sendo necessário seguir as orientações apresentadas nos cards expansíveis intitulados ***Versão antiga da Integração***.

![](https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2Fyb8gTiEick9lif8YUBRP%2Fimage.png?alt=media\&token=b9a4c7df-946a-4ac6-9993-2d1cda945faf)
{% endhint %}

## 7. Selecione o Portfólio Empresarial

Selecione o **Portifólio Empresarial** (antiga BM) ao qual o número de telefone já está vinculado.

{% hint style="info" %} <mark style="color:$info;">Caso você suspeite que o seu número de telefone já esteja associado a uma</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Conta do WhatsApp (WABA)**</mark><mark style="color:$info;">, acesse cada um dos seus</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Portfólios Empresariais (BM)**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">pelo</mark> [<mark style="color:$info;">link</mark>](https://business.facebook.com/latest/settings/whatsapp_account) <mark style="color:$info;">e, dentro de cada</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Conta do WhatsApp**</mark><mark style="color:$info;">, acesse a aba</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Phone numbers**</mark><mark style="color:$info;">. Verifique se o número de telefone que deseja integrar está listado.</mark>

<mark style="color:$info;">Se encontrar o número, esse será o</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Portfólio Empresarial (BM)**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">e a</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Conta do WhatsApp (WABA)**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">que deverão ser utilizados no processo de integração.</mark>

<mark style="color:$danger;">Caso o número não seja encontrado em nenhum dos Portfólios Empresariais aos quais você possui acesso, mas você tenha certeza de que ele está associado a uma</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**Conta do WhatsApp (WABA)**</mark><mark style="color:$danger;">, será necessário identificar em qual</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**Portfólio Empresarial**</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">ele está vinculado.</mark>

<mark style="color:$danger;">Depois de identificar o Portfólio, será possível</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**solicitar ou conceder as permissões de acesso necessárias**</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">para realizar a integração ou, caso seja necessário utilizar o número em outro Portfólio,</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**remover o vínculo atual e associá-lo ao Portfólio desejado**</mark><mark style="color:$danger;">.</mark>

<mark style="color:$danger;">Se não for possível identificar o</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**Portfólio Empresarial**</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">ao qual o número está vinculado, será necessário</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**remover o vínculo existente do número com a Conta do WhatsApp (WABA)**</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">antes de realizar uma nova integração.</mark>

<mark style="color:$danger;">Após a remoção, o número poderá ser associado à</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**Conta do WhatsApp**</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">e ao</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">**Portfólio Empresarial**</mark> <mark style="color:$danger;"></mark><mark style="color:$danger;">desejados durante o processo de integração.</mark>
{% endhint %}

Caso o número de telefone ainda não esteja vinculado a nenhum portfólio, selecione o portfólio ao qual deseja vinculá-lo. Se o número de telefone ainda não estiver associado a um *Portfólio Empresarial*, também será possível selecionar a opção "*Criar um Portfólio Empresarial*", desde que a conta esteja elegível para criar um novo portfólio e não tenha atingido o limite estabelecido pela *Meta*.

Para selecionar ou criar um portifólio, clique no menu suspenso do "*Portifólio empresarial*" e selecione a opção desejada:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FtyDermR2ox0VklLANq15%2Fimage.png?alt=media&amp;token=d0f6a193-689c-4bd5-97fe-aa213df9981b" alt="" width="420"><figcaption></figcaption></figure>

<details>

<summary><strong>Versão antiga da Integração:</strong></summary>

Se a sua versão da integração for a antiga – as telas apresentadas forem diferentes –, siga o procedimento abaixo:

Selecione um portfólio empresarial já existente (ex.: LIVECHAT 360) ou CRIE UM NOVO.

Clique em "**Avançar**".

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FwXQFQEIyBHskLgGtwbaP%2Fimage.png?alt=media&amp;token=52fc126d-d634-467d-8e58-41e83d62da06" alt="" width="298"><figcaption></figcaption></figure>

</details>

## 8. Selecione uma conta do WhatsApp Business

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FButg4L1oB8Gro6UImIxk%2Fimage.png?alt=media&amp;token=664b16ea-6775-45fe-bcaa-14e28c50c2ab" alt="" width="352"><figcaption></figcaption></figure>

### **8.1 Se o número de telefone JÁ FOI integrado anteriormente na API Cloud do WhatsApp Business**:

> * Se está seguindo os passo para '[2.2.1 Integração direta na API Cloud do WhatsApp Business'](#id-2.2.1-integracao-direta-na-api-cloud-do-whatsapp-business), pule para [8.2](#id-8.2-se-o-numero-de-telefone-nao-estiver-cadastrado-na-api-cloud-e-voce-deseja-fazer-uma-nova-integra).
> * Se está seguindo os passo para '[3.1 Manter coexistência entre API Cloud e Aplicativo do WhatsApp Business](#id-3.1-manter-coexistencia-entre-api-cloud-e-aplicativo-do-whatsapp-business)', pule para [8.3](#id-8.3-se-voce-deseja-manter-a-coexistencia-entre-a-api-cloud-e-o-whatsapp-business-app).
> * Se está seguindo o passo para '[2.1 Número de Telefone integrado à API Cloud ou já associado a uma *Conta WhatsApp*](#id-2.1-numero-de-telefone-integrado-a-api-cloud-ou-ja-associado-a-uma-conta-whatsapp)', **continue por aqui**.

Selecione a *Conta do WhatsApp Business* (WABA) em que o telefone está vinculado, depois clique em ***Avançar***.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FA1u3oF0UXojIV5yIvX9S%2Fimage.png?alt=media&amp;token=4cc32788-0af1-4d08-8245-2d4fa072338a" alt="" width="352"><figcaption><p>"Teste" é apenas um nome exemplificativo da conta.</p></figcaption></figure>

{% hint style="info" %} <mark style="color:$info;">Isso ocorre porque o número de telefone já está associado a uma</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Conta do WhatsApp</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">Business (WABA) no</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Portifólio Empresarial</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">(BM) da plataforma da</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Meta</mark>*<mark style="color:$info;">. Portanto, em vez de criar uma nova conta, a etapa correta é selecionar a conta em que o número de telefone está.</mark>

<mark style="color:$info;">Lembrando que para que a</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Conta do WhatsApp</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">(WABA) em que está o telefone apareça, é necessário estar selecionado corretamente o</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Portifólio Empresarial</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">(BM) que abriga a</mark> <mark style="color:$info;"></mark>*<mark style="color:$info;">Conta do WhatsApp</mark>* <mark style="color:$info;"></mark><mark style="color:$info;">em que o telefone está vinculado.</mark>
{% endhint %}

{% hint style="warning" %} <mark style="color:$info;">No caso de ter sido selecionado o</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Portfólio Empresarial**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">correto, já confirmado como aquele ao qual o número de telefone está vinculado, e, mesmo assim, a</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Conta do WhatsApp**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">ou o</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**número de telefone**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">não aparecer para seleção, será necessário</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**verificar as permissões e os ativos disponíveis no Portfólio Empresarial**</mark><mark style="color:$info;">, pois o usuário que está realizando a integração pode não ter acesso à Conta do WhatsApp ou ao número de telefone correspondente.</mark>

<mark style="color:$info;">Nessa situação, confirme se a</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Conta do WhatsApp**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">está efetivamente vinculada ao Portfólio Empresarial selecionado e se o usuário possui as permissões necessárias para gerenciá-la. Caso as configurações estejam corretas e o ativo continue não sendo exibido, pode ser necessário</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**atualizar o acesso à conta ou realizar novamente a autenticação com a Meta**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">para que os ativos disponíveis sejam carregados corretamente.</mark>

<mark style="color:$info;">Se, após realizar todas as verificações e confirmar que o</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Portfólio Empresarial**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">selecionado é o correto, a</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**Conta do WhatsApp**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">ou o</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**número de telefone**</mark> <mark style="color:$info;"></mark><mark style="color:$info;">ainda não aparecer para seleção, será necessário</mark> <mark style="color:$info;"></mark><mark style="color:$info;">**excluir o vínculo do número de telefone com a Conta do WhatsApp atual e realizar novamente o processo de integração**</mark><mark style="color:$info;">.</mark>
{% endhint %}

Depois, 👉 [9.1 Telefone integrado anteriormente](#id-9.1-se-o-numero-de-telefone-ja-foi-integrado-anteriormente-na-api-cloud-do-whatsapp-business).

<details>

<summary><strong>Versão antiga da Integração:</strong></summary>

Se a sua versão da integração for a antiga– as telas apresentadas forem diferentes –, siga o procedimento abaixo:

Você terá duas opções:

* Conectar seu app WhatsApp Business existente ❌
* Inserir um novo número de telefone do WhatsApp para começar ✅

Escolha a segunda opção: **Inserir um novo número de telefone do WhatsApp para começar**.

Clique em "**Avançar**".

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FMtjfciYdv7Hi1dLGpL4h%2Fimage.png?alt=media&amp;token=dab4bc9c-71d0-4742-b87f-1238e52e4b12" alt="" width="298"><figcaption></figcaption></figure>

Clique em "**Avançar**".

Escolha a conta do WhatsApp Business já criada e vinculada ao número que deseja utilizar (na imagem de exemplo: LIVECHAT 360):

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FfyHHGqxTlAwfStdOYeGG%2Fimage.png?alt=media&amp;token=4a4a6312-8830-4cb9-b222-b9bb985f025b" alt="" width="298"><figcaption></figcaption></figure>

Em “*Crie ou selecione um perfil do WhatsApp Business*”, escolha um perfil já existente que contem o número desejado (na imagem de exemplo: LVT TESTE).

Clique em "**Avançar**".

Depois, 👉 [9.1 Telefone integrado anteriormente](#versao-antiga-da-integracao-4).

</details>

### **8.2 Se o número de telefone NÃO ESTIVER cadastrado na API Cloud** **e você deseja fazer uma nova integração diretamente na API Cloud do WhatsApp Business**:&#x20;

> * Se está seguindo os passo para '[3.1 Manter coexistência entre API Cloud e Aplicativo do WhatsApp Business](#id-3.1-manter-coexistencia-entre-api-cloud-e-aplicativo-do-whatsapp-business)', pule para [8.3](#id-8.3-se-voce-deseja-manter-a-coexistencia-entre-a-api-cloud-e-o-whatsapp-business-app).
> * Se está seguindo os passo para '[2.2.1 Integração direta na API Cloud do WhatsApp Business](#id-2.2.1-integracao-direta-na-api-cloud-do-whatsapp-business)', **continue por aqui**.

Você poderá selecionar uma Conta do WhatsApp Business (WABA) existente (se houver) OU criar uma nova Conta do WhatsApp Business, depois clique em ***Avançar***.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2F4tGaUcWL5wgCrVCN6o92%2Fimage.png?alt=media&amp;token=84b1382e-4fd8-4491-a534-8ff3e6b1b8d3" alt="" width="352"><figcaption></figcaption></figure>

{% hint style="info" %}
Existe a opção de selecionar uma Conta do WhatsApp Business (WABA) existente porque é possível gerenciar múltiplos números de telefone em uma única conta.
{% endhint %}

<details>

<summary>Criar uma nova Conta do WhatsApp Business</summary>

Se tiver sido escolhida a opção de criar uma nova Conta do WhatsApp Business, uma tela adicional surgirá para que sejam informados os dados da empresa:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FHJEnD8FfW5DsrfyaiqwQ%2Fimage.png?alt=media&amp;token=0cec4cf2-3628-426f-a41a-cce7db73a96d" alt="" width="352"><figcaption></figcaption></figure>

</details>

Depois, 👉 [9.2 Integração direta](#id-9.2-se-o-numero-de-telefone-nao-estiver-cadastrado-na-api-cloud-e-voce-deseja-fazer-uma-nova-integra).

<details>

<summary><strong>Versão antiga da Integração:</strong></summary>

Se a sua versão da integração for a antiga – as telas apresentadas forem diferentes –, siga o procedimento abaixo:

Você terá duas opções:

* Conectar seu app WhatsApp Business existente ❌
* Inserir um novo número de telefone do WhatsApp para começar ✅

Escolha a segunda opção: **Insira um novo número de telefone do WhatsApp para começar**.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FOuJ2KWcUNE1m3IKRKISv%2Fimage.png?alt=media&amp;token=c9de610e-291e-4d21-b69d-401eb82bc547" alt="" width="298"><figcaption></figcaption></figure>

Clique em "**Avançar**".

Agora, **crie uma nova conta** ou **selecione sua conta do WhatsApp Business**. Atente-se pois a conta é diferente do número, podendo uma conta ter vários números. Quando os números estão na mesma conta, eles compartilham os recursos dela, como as mensagens templates.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FiIf9kGDB0ImlEKaO1iN2%2Fimage.png?alt=media&amp;token=33cfabe8-beb2-447b-8ae5-becfa2a2797a" alt="" width="297"><figcaption></figcaption></figure>

Clique em "***Avançar***".

Depois, 👉 [9.2 Integração direta](#versao-antiga-da-integracao-5).

</details>

### **8.3 Se você deseja manter a COEXISTÊNCIA entre a API Cloud e o WhatsApp Business App**:&#x20;

> * Se está seguindo os passo para '[3.1 Manter coexistência entre API Cloud e Aplicativo do WhatsApp Business](#id-3.1-manter-coexistencia-entre-api-cloud-e-aplicativo-do-whatsapp-business)', **continue por aqui**.

Você poderá selecionar a opção "*Conectar um app do WhatsApp Business*", depois clique em ***Avançar***.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2F3UAv15dJhYqzS65JsBtR%2Fimage.png?alt=media&amp;token=e4129e38-ff6c-4e1b-8cda-17bd0435c581" alt="" width="352"><figcaption></figcaption></figure>

Depois, 👉 [9.3 Integração com coexistência](#id-9.3-se-voce-deseja-manter-a-coexistencia-entre-a-api-cloud-e-o-whatsapp-business-app).

<details>

<summary><strong>Versão antiga da Integração:</strong></summary>

Se a sua versão da integração for a antiga – as telas apresentadas forem diferentes –, siga o procedimento abaixo:

Você terá duas opções:

* Conectar seu app WhatsApp Business existente ✅
* Inserir um novo número de telefone do WhatsApp para começar ❌

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2Fm1PYBNWtFOwdKLyJyErW%2Fimage.png?alt=media&amp;token=ede9adb6-26d0-422b-9997-adddee80da47" alt="" width="292"><figcaption></figcaption></figure>

Escolha a primeira opção: **Conectar seu app WhatsApp Business existente**.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2Fi8yhnW4d7BoxQeD4G7ws%2Fimage.png?alt=media&amp;token=ae22602a-dbd7-4d9a-96a3-6a168b18d869" alt="" width="292"><figcaption></figcaption></figure>

Clique em "**Avançar**".

Depois, 👉 [9.3 Integração com coexistência](#versao-antiga-da-integracao-6).

</details>

## 9. Escolha do cenário de integração e passos a passos

Identifique qual das 3 situações se aplica ao seu número de telefone e, em seguida, siga o passo a passo da seção correspondente:

{% hint style="info" %}
Durante o processo de integração pode ser que a leitura de um **QR Code** seja solicitada. A leitura deve ser realizada utilizada **o próprio aplicativo do&#x20;*****WhatsApp Business***.
{% endhint %}

### 9.1 Se o número de telefone JÁ FOI integrado anteriormente na API Cloud do WhatsApp Business

Tendo sido anteriormente selecionada a Conta do WhatsApp Business (WABA) existente, agora, selecione a opção "*Usar um número do WhatsApp novo ou existente*".

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FPmYCeJv7B8Ektx59xN5u%2Fimage.png?alt=media&amp;token=8dec26a1-2b73-4d41-9956-57653055b0e7" alt="" width="420"><figcaption></figcaption></figure>

Depois, selecione o número de telefone no menu suspenso:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FTxEUGmnhfAE96GRxfheW%2Fimage.png?alt=media&amp;token=e25a3450-681b-4aa5-ace6-872d2462b690" alt="" width="352"><figcaption></figcaption></figure>

Por último, clique em **Avançar**. Isso levará a tela de 👉 [10. Confirmação de acesso](#id-10.-confirmacao-de-acessos).

<details>

<summary><strong>Versão antiga da Integração:</strong></summary>

Se a sua versão da integração for a antiga – as telas apresentadas forem diferentes –, siga o procedimento abaixo:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FfyHHGqxTlAwfStdOYeGG%2Fimage.png?alt=media&amp;token=4a4a6312-8830-4cb9-b222-b9bb985f025b" alt="" width="298"><figcaption></figcaption></figure>

Em “*Crie ou selecione um perfil do WhatsApp Business*”, escolha um perfil já existente que contem o número desejado (na imagem de exemplo: LVT TESTE).

Clique em "**Avançar**".

Isso levará a tela de 👉 [10. Confirmação de acesso](#versao-antiga-da-integracao-8).

</details>

### 9.2 Se o número de telefone NÃO ESTIVER cadastrado na API Cloud e você deseja fazer uma nova integração diretamente na API Cloud do WhatsApp Business

Tendo sido anteriormente selecionada uma Conta do WhatsApp Business (WABA) existente (se houver) ou criado uma nova Conta do WhatsApp Business, agora, selecione a opção "*Usar um número do WhatsApp novo ou existente*".

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FPmYCeJv7B8Ektx59xN5u%2Fimage.png?alt=media&amp;token=8dec26a1-2b73-4d41-9956-57653055b0e7" alt="" width="420"><figcaption></figcaption></figure>

Depois, informe o prefixo nacional +55 e digite o número de telefone:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FDMxOcX6cta3QtmzNdNm6%2Fimage.png?alt=media&amp;token=d89b93d1-ebf5-4bfb-bbfa-1876d882490f" alt="" width="352"><figcaption></figcaption></figure>

Por último, clique em **Avançar**. Isso o levará a tela de ***Verificação do Número***. Feita a verificação, você será direcionado para a tela de 👉 [10. Confirmação de acesso](#id-10.-confirmacao-de-acessos).

<details>

<summary><strong>Versão antiga da Integração:</strong></summary>

Se a sua versão da integração for a antiga – as telas apresentadas forem diferentes –, siga o procedimento abaixo:

**Crie um perfil do WhatsApp Business.** Para isso, defina um nome de exibição do seu WhatsApp Business e a categoria que melhor descreve sua empresa:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2F3yX9aondaQdHaUrSQ0xc%2Fimage.png?alt=media&amp;token=e5f8acf2-24c0-4879-acea-4f82f8594e7b" alt="" width="294"><figcaption></figcaption></figure>

Depois, clique em ***Avançar***.

Selecione a opção ***Adicionar um novo número*** e clique em ***Avançar***:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FgLYIyUAH5XDCZcT5fwbz%2Fimage.png?alt=media&amp;token=d924a6cd-4ea1-48b5-a506-1000237c7f42" alt="" width="296"><figcaption></figcaption></figure>

Depois, adicione o código do pais (Brasil é +55) e o seu número de telefone e clique em ***Avançar***.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FqATyVyZGe8OiCEksBR2l%2Fimage.png?alt=media&amp;token=edf3dedd-71c1-46d3-9348-ef5d69a08965" alt="" width="294"><figcaption></figcaption></figure>

O próximo passo será fazer a **verificação do seu número de telefone**.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FUSImckCPh3EGrapXZb0t%2Fimage.png?alt=media&amp;token=c35952d7-e42b-4c9b-bfda-89477308a277" alt="" width="294"><figcaption></figcaption></figure>

Ao termino da verificação, clique em ***Avançar***.

Por fim, você será direcionado para a tela de 👉[11. Conclusão do processo de integração](#id-8.-conclusao-do-processo-de-integracao).

</details>

### 9.3 Se você deseja manter a COEXISTÊNCIA entre a API Cloud e o WhatsApp Business App

{% hint style="info" %}
Atenção: em relação a coexistência, leia atentamente a documentação da Meta, em especial ao que se refere às [limitações](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/#limitations) da coexistência e a [comparação entre os recursos](https://developers.facebook.com/docs/whatsapp/embedded-signup/custom-flows/onboarding-business-app-users/#feature-comparison). Recursos como, por exemplo, a edição/exclusão de mensagens, mensagens temporárias, visualização única e lista de transmissão, não estarão mais disponíveis no *Aplicativo do WhatsApp Business* APÓS a integração com a API em nuvem.
{% endhint %}

Tendo sido anteriormente selecionada a opção "*Conectar um app do WhatsApp Business*", há 3 situações que podem acontecer:

#### 9.3.1 Número vinculado na mesma Business Manager (BM)

Após a integração, o vinculo será automático ao Portifólio Empresarial (BM) selecionado na integração.

Selecione o **prefixo nacional +55**, insira o **número de telefone do WhatsApp Business** e clique no botão ***Avançar***.&#x20;

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FlXp8bupwPSMPagbaQwj0%2Fimage.png?alt=media&amp;token=f7ea4ee9-4c35-44b5-b109-ec28f0f8dd3a" alt="" width="352"><figcaption></figcaption></figure>

Realize o passo a passo de verificação que será requisitado. Possivelmente a empresa receberá, no aplicativo do WhatsApp Business, um código QR e instruções para verificar se há novas mensagens no aplicativo.&#x20;

Depois que a empresa escolher as opções de verificação e escanear o código, será possível concluir o restante do fluxo de Cadastro Incorporado.

Você será direcionado para a tela de 👉 [10. Confirmação de acesso](#id-10.-confirmacao-de-acessos).

<details>

<summary><strong>Versão antiga da Integração:</strong></summary>

Se a sua versão da integração for a antiga – as telas apresentadas forem diferentes –, siga o procedimento abaixo:

Selecione o código do pais (Brasil é +55) e insira o seu número de telefone de WhatsApp Business.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FCHZcjVIzmxjYpTp20Jec%2Fimage.png?alt=media&amp;token=a3fabc12-1c9c-46b0-812d-8e0bcf19da50" alt="" width="291"><figcaption></figcaption></figure>

Depois, clique em ***Avançar***.

Você será direcionado para a tela de 👉[11. Conclusão do processo de integração](#id-8.-conclusao-do-processo-de-integracao).

</details>

#### 9.3.2 Número NÃO vinculado em **NENHUMA** Business Manager (BM)

Após a integração, o vinculo será automático ao Portifólio Empresarial (BM) selecionado na integração.

Selecione o **prefixo nacional +55**, insira o **número de telefone do WhatsApp Business** e clique no botão ***Avançar***.&#x20;

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FlXp8bupwPSMPagbaQwj0%2Fimage.png?alt=media&amp;token=f7ea4ee9-4c35-44b5-b109-ec28f0f8dd3a" alt="" width="352"><figcaption></figcaption></figure>

Realize o passo a passo de verificação que será requisitado. Possivelmente a empresa receberá, no aplicativo do WhatsApp Business, um código QR e instruções para verificar se há novas mensagens no aplicativo.&#x20;

Depois que a empresa escolher as opções de verificação e escanear o código, será possível concluir o restante do fluxo de Cadastro Incorporado.

Você será direcionado para a tela de 👉 [10. Confirmação de acesso](#id-10.-confirmacao-de-acessos)

<details>

<summary><strong>Versão antiga da Integração:</strong></summary>

Se a sua versão da integração for a antiga – as telas apresentadas forem diferentes –, siga o procedimento abaixo:

Selecione o código do pais (Brasil é +55) e insira o seu número de telefone de WhatsApp Business.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FCHZcjVIzmxjYpTp20Jec%2Fimage.png?alt=media&amp;token=a3fabc12-1c9c-46b0-812d-8e0bcf19da50" alt="" width="291"><figcaption></figcaption></figure>

O próximo passo, no caso de não ter adicionado o número de telefone ao portifólio empresaria, será fazer a verificação do seu número de telefone e clicar em ***Avançar***.

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FQLNXjZQ3MVSBecVr1vqk%2Fimage.png?alt=media&amp;token=88e5b526-7576-4143-98c8-54e5026af730" alt="" width="287"><figcaption></figcaption></figure>

&#x20;Você será direcionado para a tela de 👉[11. Conclusão do processo de integração](#id-8.-conclusao-do-processo-de-integracao).

</details>

#### 9.3.3 Número **NÃO** vinculado na **MESMA** Business Manager (BM)

Se o número não estiver vinculado ao mesma Portifólio Empresarial (BM) que será utilizada durante o processo de integração na API, então há duas alternativas:

**a)** Tentar desvincular do Portifólio Empresarial (BM) atual e conectar no Portifólio Empresarial (BM) que será registrada a API; entretanto, não há garantia de que esse processo irá funcionar;

**b)** Fazer o processo de 👉 [4. Excluir ou mudar conta](#id-4.-excluir-ou-mudar-uma-conta-do-aplicativo-whatsapp-messenger-ou-whatsapp-business), depois o processo de [2.2 Número de telefone não integrado à *API Cloud* ou não associado a uma *Conta WhatsApp*](#id-2.2-numero-de-telefone-nao-integrado-a-api-cloud-ou-nao-associado-a-uma-conta-whatsapp), seguindo os passos para Manter Coexistência entre API Cloud e o WhatsApp Business App.

## 10. Confirmação de Acessos

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FENEuHVDcR71B8TezQNcx%2Fimage.png?alt=media&amp;token=e8f3b5ee-051e-4d3a-a914-35fe1b55ab2c" alt="" width="420"><figcaption></figcaption></figure>

Clique no botão ***Confirmar*** para compartilhar os acessos necessários. Feito isso, a sua conta será conectada:

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FK39w2XOZ0glUhNwFyDvU%2Fimage.png?alt=media&amp;token=5b0a0872-6f11-4ea6-92a2-a7040b236501" alt="" width="419"><figcaption></figcaption></figure>

<details>

<summary><strong>Versão antiga da Integração:</strong></summary>

Se a sua versão da integração for a antiga – as telas apresentadas forem diferentes –, siga o procedimento abaixo:

Será exibida a tela com as permissões que o app (Atenderserver WTSP) terá:

* Gerenciar contas do WhatsApp
* Acessar conversas
* Registrar eventos

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2F5vOeI2hglq1wJIKKLKn9%2Fimage.png?alt=media&amp;token=1948c320-2edc-4940-8d18-400beabb55c3" alt="" width="293"><figcaption></figcaption></figure>

Clique em "**Continuar**".

Após clicar em continuar, siga as demais solicitações da Meta para concluir o vinculo.

</details>

## 11. Conclusão do processo de integração <a href="#id-8.-conclusao-do-processo-de-integracao" id="id-8.-conclusao-do-processo-de-integracao"></a>

Clique em ***Concluir***.

{% hint style="danger" %}
ATENÇÃO: É **OBRIGATÓRIO** QUE O BOTÃO DE '**CONCLUIR**' SEJA APERTADO AO FINAL DO PROCESSO. Não feche a página antes de clicar no botão.
{% endhint %}

<figure><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2Fp5qDMReyjXwUnlzSa7pd%2Fimage.png?alt=media&amp;token=6394ba55-949d-4361-9ea8-79ba962e648d" alt="" width="420"><figcaption></figcaption></figure>

## Processos essenciais após a integração

Após a conclusão da integração, é necessário realizar algumas configurações adicionais para garantir o pleno funcionamento do serviço. Entre elas:

* [Configurar forma de pagamento](/crm/administracao/configuracoes/configurando-o-whatsapp-whatsapp-api/configurando-uma-forma-de-pagamento.md): etapa **obrigatória** para viabilizar a utilização dos recursos vinculados à conta, como envio de [*Mensagens Template*](/crm/administracao/personalizacao/mensagem-template.md) aos contatos.
* [Verificação da Empresa](/crm/administracao/configuracoes/configurando-o-whatsapp-whatsapp-api/verificacao-da-empresa.md): processo de validação que confirma as informações da empresa junto à Meta, garantindo maior segurança e mais recursos no uso da plataforma. Embora seja possível começar a usar a API sem ela, a verificação é o "*portão de entrada*" para escalar sua operação e transmitir confiança. Empresas sem verificação, em geral, ficam [limitadas](/crm/administracao/configuracoes/configurando-o-whatsapp-whatsapp-api/dados-sobre-a-conta/limite-de-mensagem.md) a 250 conversas iniciada pela empresa em um período contínuo de 24 horas.

{% hint style="info" %}
Enquanto a **verificação da empresa** não for realizada, o Business Status será indicado como "**Limitado**" em *Configurações* > *WhatsApp-Api* > abas '*Visão Geral*' ou '*Status de Saúde*'.

<p align="center"><img src="https://920770335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGYj93MEsVgt6SU5U8KFq%2Fuploads%2FAVrkn9LIQurpGtNJNVLu%2Fimage.png?alt=media&amp;token=eb8ac04b-2dc0-4f90-974b-a78730e3bbff" alt=""></p>
{% endhint %}

{% hint style="info" %}
No site da sua empresa, que deverá ser informado durante o processo de Verificação da Empresa, **inclua no rodapé o CNPJ utilizado na verificação**. Essa informação é importante porque facilita a validação da empresa pelas plataformas responsáveis, aumenta a credibilidade do seu negócio e garante maior transparência para os usuários. Além disso, manter o CNPJ visível e consistente com os dados cadastrados ajuda a evitar reprovações ou atrasos no processo de verificação, assegurando que a análise seja concluída de forma mais rápida e eficiente.
{% endhint %}

## Processos opcionais após a integração

Após a conclusão da integração, é opcional realizar algumas configurações adicionais, dentre elas:

* [Alterar foto do perfil, status, e-mail e site](/crm/administracao/configuracoes/configurando-o-whatsapp-whatsapp-api/foto-de-perfil-e-descricoes.md).
* [Selo de Conta Comercial Verificada](/crm/administracao/configuracoes/configurando-o-whatsapp-whatsapp-api/dados-sobre-a-conta/selo-de-conta-comercial-verificada.md) <mark style="color:$info;">(não está disponível para todas as empresas)</mark>.

## Teste após a integração

Após concluir a integração, para garantir que tudo esteja funcionando corretamente, realize os seguintes testes:

1. Envie uma mensagem, pelo seu WhatsApp pessoal, para o número de telefone integrado.
2. No sistema, acesse a página [*Chat*](/crm/administracao/chat-ao-vivo-atendente.md) e verifique se a mensagem foi recebida corretamente.
3. Recebida a mensagem, responda ao contato enviando uma mensagem utilizando o sistema.
4. Confirme se a resposta chegou corretamente ao seu contato.
5. Em seguida, na página *Personalização* > [*Mensagem Template*](/crm/administracao/personalizacao/mensagem-template.md), crie uma mensagem template do tipo *UTILIDADE* e, pela página de *Chat*, [envie-a](/crm/administracao/chat-ao-vivo-atendente.md#mensagem-template) para esse mesmo contato, respeitando o prazo máximo de 24 horas desde a última mensagem enviada pelo contato <mark style="color:$info;">– dessa forma, a Meta não irá cobrar o uso da mensagem template de utilidade</mark>.
6. Verifique se a mensagem template chegou ao seu contato.&#x20;

Se todos os passos forem executados com sucesso e as mensagens forem enviadas e recebidas corretamente, estará confirmado que o processo de integração foi concluído com êxito.

Caso algum dos passos não funcione como esperado, entre em contato com o suporte informando:

* Qual era a [situação do seu número de telefone](#identifique-a-situacao-do-seu-numero-de-telefone) e quais etapas da integração foram realizadas;
* Quais erros ou comportamentos inesperados ocorreram.

Sempre que possível, anexe capturas de tela para facilitar a análise do ocorrido.