> 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.md).

# Configurando o WhatsApp (WhatsApp- Api)

## Conexão

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

<figure><img src="/files/5Q2ssanXIZkmbcAY0fob" alt=""><figcaption></figcaption></figure>

O login com o Facebook, 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*****&#x20;(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).

### Telefone

O telefone que será utilizado no sistema será solicitado durante o processo de login.

{% hint style="info" %}
Nossa orientação é a de que o telefone não esteja cadastrado manualmente previamente em nenhuma BM e que esse cadastro seja realizado apenas durante o processo de login.
{% endhint %}

### Passo a passo da integração

Para integrar o número de telefone ao nosso sistema, é necessário realizar o processo de integração.

Com todas as informações em mãos, o processo não costuma levar mais do que poucos minutos.

<details>

<summary><strong>Passo a Passo de Integração (Tutorial Simplificado)</strong></summary>

* Se o seu número de telefone **possui** um WhatsApp tradicional e **não possui** o Aplicativo do WhatsApp Business, será necessário desvincular o WhatsApp (mudar o número ou excluir a conta) para liberar o número. Depois disso, você terá que escolher entre duas opções:
  * Integração direta na API Cloud do WhatsApp Business: na tela do sistema, inicie o processo de login em Configurações > WhatsApp-Api > aba 'Conexão' > 'Logar com Facebook'; selecione um portifólio empresarial e uma conta do WhatsApp Business; depois, selecione a opção "Usar um número do WhatsApp novo ou existente", informe o número de telefone, faça a verificação do número, realize a confirmação de acesso e clique em 'Concluir'.
  * Manter Coexistência entre API Cloud e o WhatsApp Business App: instale o Aplicativo do WhatsApp Business, inicie o processo de login em Configurações > Whatsapp-Api > aba 'Conexão' > 'Logar com Facebook' selecione um portifólio empresarial e, na hora de selecionar uma conta do WhatsApp Business, selecione a opção "Conectar um app do WhatsApp Business", depois, insira o número de telefone do WhatsApp Business, realize o processo de verificação com o App do WhatsApp Business, faça a confirmação de acesso e clique em 'Concluir'.
* Se o seu número de telefone **não possui** WhatsApp tradicional e **não possui** o Aplicativo do WhatsApp Business, você terá que escolher entre duas opções:
  * Integração direta na API Cloud do WhatsApp Business: na tela do sistema, inicie o processo de login em Configurações > WhatsApp-Api > aba 'Conexão' > 'Logar com Facebook'; selecione um portifólio empresarial e uma conta do WhatsApp Business; depois, selecione a opção "Usar um número do WhatsApp novo ou existente", informe o número de telefone, faça a verificação do número, realize a confirmação de acesso e clique em 'Concluir'.
  * Manter Coexistência entre API Cloud e o WhatsApp Business App: instale o Aplicativo do WhatsApp Business, inicie o processo de login em Configurações > Whatsapp-Api > aba 'Conexão' > 'Logar com Facebook' selecione um portifólio empresarial e, na hora de selecionar uma conta do WhatsApp Business, selecione a opção "Conectar um app do WhatsApp Business", depois, insira o número de telefone do WhatsApp Business, realize o processo de verificação com o App do WhatsApp Business, faça a confirmação de acesso e clique em 'Concluir'.
* Se o seu número de telefone **já foi integrado anteriormente** a alguma API Cloud, inicie o processo de login em Configurações > Whatsapp-Api > aba 'Conexão' > 'Logar com Facebook' selecione um portifólio empresarial e, depois, uma conta WhatsApp Business existente. Em seguida, selecione a opção "Usar um número do WhatsApp novo ou existente", selecione o número de telefone, faça a confirmação de acesso e clique em 'Concluir'.
* Se o seu número de telefone **não possui** WhatsApp tradicional, mas **possui** o Aplicativo do WhatsApp Business, será necessário escolher entre duas opções:
  * Manter coexistência entre API Cloud e Aplicativo do WhatsApp Business: nesse caso, 3 situações podem acontecer:
    * (1) O número estar vinculado na mesma Business Manager ou (2) não estar vinculado em nenhuma Business Manager: nesses casos, insira o número de telefone do WhatsApp Business, realize o processo de verificação com o App do WhatsApp Business, faça a confirmação de acesso e clique em 'Concluir'.
    * (3) Número NÃO vinculado na MESMA Business Manager usada durante a integração: Há duas alternativas nesse caso:
      * Tentar desvincular da Business Manager (BM) atual e conectar na Business Manager (BM) que será registrada a API; entretanto, não há garantia de que esse processo irá funcionar;
      * Fazer o processo de excluir a conta ou mudar o número do WhatsApp para liberar o número, depois instale o Aplicativo do WhatsApp Business, inicie o processo de login em Configurações > Whatsapp-Api > aba 'Conexão' > 'Logar com Facebook' selecione um portifólio empresarial e, na hora de selecionar uma conta do WhatsApp Business, selecione a opção "Conectar um app do WhatsApp Business", depois, insira o número de telefone do WhatsApp Business, realize o processo de verificação com o App do WhatsApp Business, faça a confirmação de acesso e clique em 'Concluir'.
  * Não manter coexistência entre API Cloud e Aplicativo do WhatsApp Business: será necessário desvincular o WhatsApp (mudar o número ou excluir a conta) para liberar o número. Depois, você irá fazer o processo de integração direta na API Cloud do WhatsApp Business, então, para isso, na tela do sistema, inicie o processo de login em Configurações > WhatsApp-Api > aba 'Conexão' > 'Logar com Facebook'; selecione um portifólio empresarial e uma conta do WhatsApp Business; depois, selecione a opção "Usar um número do WhatsApp novo ou existente", informe o número de telefone, faça a verificação do número, realize a confirmação de acesso e clique em 'Concluir'.

</details>

Para garantir uma configuração correta, recomendamos seguir o passo a passo completo, que explica melhor cada etapa: 👉 [Nova Tela de Integração](/crm/administracao/configuracoes/configurando-o-whatsapp-whatsapp-api/nova-tela-de-integracao.md).

{% hint style="info" %}
Não se preocupe com o tamanho da documentação de integração. Apesar de parecer extensa à primeira vista, o processo de integração é bastante simples e rápido. A documentação é mais detalhada porque aborda diferentes cenários e possibilidades de configuração, muitas das quais provavelmente não serão necessárias no seu caso.

Então, siga o passo a passo da documentação e, caso surja qualquer dúvida durante o processo, fique à vontade para entrar em contato com o suporte. Estaremos à disposição para ajudar no que for necessário.
{% endhint %}

## Visão Geral

A aba **Visão Geral** apresenta um panorama completo da sua integração com a WhatsApp Business API. Nela, é possível acompanhar de forma centralizada as principais informações do ambiente, como o status do **WABA** (WhatsApp Business Account), do **APP**, do **Business Manager** e a **quantidade de números de telefone** ativos, facilitando o monitoramento e a validação do funcionamento da integração.

## Números e limites

A aba ***Números e limites*** exibe os números de telefone vinculados ao seu *Gerenciador do WhatsApp*, oferecendo uma visão detalhada do status de cada um. Nela, é possível identificar a qualidade dos números, quais estão ativos e em uso, além de acompanhar o [limite diário de conversas](/crm/administracao/configuracoes/configurando-o-whatsapp-whatsapp-api/dados-sobre-a-conta/limite-de-mensagem.md) disponível para a sua conta. Essas informações auxiliam no controle, no planejamento do volume de mensagens e na manutenção da qualidade da integração.

### Qualidade do número

A classificação de qualidade é baseada em como as mensagens foram recebidas pelos destinatários nos últimos 7 dias e é ponderada pela mais recente. Ela é determinada por uma combinação de sinais de qualidade das conversas entre empresas e usuários. Os exemplos incluem sinais de feedback do usuário, como bloqueios, denúncias e os motivos que os usuários fornecem quando bloqueiam uma empresa.

{% hint style="info" %}
Se aparecer "*UNKNOWN*", o status ainda não foi definido.
{% endhint %}

Os status, que são a classificação de qualidade, exibe os seguintes estados de qualidade:

* <mark style="background-color:green;">Verde</mark>: qualidade alta (bom)
* <mark style="background-color:yellow;">Amarelo</mark>: qualidade média (regular)
* <mark style="background-color:red;">Vermelho</mark>: qualidade baixa (Ruim)

A classificação de qualidade reflete como os usuários percebem as mensagens enviadas pela empresa. **Manter a classificação em Alta é essencial**, pois isso permite o acesso a mais recursos e melhores limites de envio dentro do *WhatsApp Business*.

Quando a classificação de qualidade cai para **Média** ou **Baixa**, o *Gerenciador do WhatsApp* passa a disponibilizar insights adicionais. Ao posicionar o cursor do mouse sobre o indicador de qualidade, é possível visualizar informações que ajudam a entender os principais fatores que contribuíram para essa redução, quando esses dados estiverem disponíveis.

Esses insights são importantes para identificar padrões de rejeição, como mensagens consideradas irrelevantes, excesso de envios ou conteúdos percebidos como indesejados. Com base nisso, é possível ajustar os modelos de mensagem, melhorar a segmentação do público e reduzir práticas que aumentam o risco de bloqueios.

Essas informações contribuem para uma análise mais precisa do comportamento dos usuários e ajudam a direcionar melhorias na comunicação, reduzindo a probabilidade de novos bloqueios e impactos negativos na qualidade do número.

{% hint style="info" %}
Quando um usuário bloqueia a empresa, ele pode selecionar um motivo para o bloqueio, como “Não é mais necessário”, “Não me inscrevi”, “Spam”, “Mensagens ofensivas” ou “Nenhum motivo”. Esses motivos podem repercutir na qualidade de seu número.
{% endhint %}

<details>

<summary>Alterações de status</summary>

Quando a classificação por qualidade alcançar a qualidade baixa, a classificação do seu número de telefone mudará para Baixa. Se a qualidade do número de telefone for baixa e estiver prestes a ser diminuída para um nível de mensagem mais baixo, o status do número de telefone mudará para Sinalizado. Quando um número de telefone é sinalizado, se a qualidade não melhorar em sete dias, o status dele retornará a Conectado. No entanto, o limite de mensagens diminuirá para o próximo nível. Por exemplo, o número de telefone que costumava ter o limite de 100 mil mensagens agora terá o limite de 10 mil mensagens.

* Conectado: você pode enviar mensagens dentro do seu limite de mensagens definido.
* Sinalizado: esse status ocorre quando a classificação por qualidade do número de telefone muda para Baixa e está prestes a diminuir para um nível de mensagens inferior. As empresas não podem atualizar os níveis de limite de mensagens no status Sinalizado. Se a classificação por qualidade:
  * Melhorar para uma qualidade alta ou média até o sétimo dia depois de o status ter sido alterado para Sinalizado, o status voltará para Conectado e seu nível de limite de mensagens permanecerá inalterado.
  * Não melhorar para uma qualidade alta ou média no sétimo dia depois de o status ter sido alterado para Sinalizado, ele retornará para Conectado. No entanto, seu limite de mensagens diminuirá para o próximo nível.

Se a sua classificação por qualidade atingir a qualidade baixa ou o status do seu número de telefone mudar para Sinalizado ou Restrito, você receberá um email e uma notificação no *Gerenciador de Negócios* como um aviso.

* Restrito: esse status ocorre quando você atinge o limite de mensagens, independentemente da classificação de qualidade. Enquanto o status estiver em Restrito, você não poderá enviar novas mensagens dentro de 24 horas. Você ainda pode responder a quaisquer mensagens que os clientes enviarem.

Para mais informações, acesse: [Sobre a classificação por qualidade do seu número de telefone do WhatsApp Business](https://www.facebook.com/business/help/896873687365001).

</details>

## Status de Saúde

A aba ***Status de Saúde*** apresenta o status do **WABA** (WhatsApp Business Account), do **aplicativo** e do **Business Manager**.&#x20;

Caso seja identificado algum problema em qualquer um desses componentes, a informação correspondente será exibida no campo **Erro**, facilitando a identificação e o acompanhamento de possíveis inconsistências.

{% hint style="info" %}
• Se o *WABA* estiver bloqueado, não será possível enviar ou receber mensagens.

• Se o *Business estiver* limitado, não será possível enviar mensagens, mas será possível receber mensagens, só que haverá limitação de quantidade; se estiver bloqueado, não recebe e nem envia mensagens.
{% endhint %}

Qualquer erro listado nesta página deve ser tratado diretamente com a *Meta*, pois ela é a responsável pelos dados e qualificações apresentados. Nosso sistema apenas replica as informações fornecidas pela *Meta*, sem realizar alterações ou interpretações adicionais.

## Perfil do WhatsApp

A aba ***Perfil do WhatsApp*** reúne as configurações de **foto de perfil**, **status**, **e-mail** e **link** do número de telefone comercial. Essas informações são exibidas para os seus contatos e contribuem para a identificação, credibilidade e apresentação da sua empresa no WhatsApp.