🆕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.

circle-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 Suitearrow-up-right.

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.

Resumo Gráfico do Processo de Integração

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

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:

circle-info

O que significa um número de telefone integrado a API Cloud?

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 de login —, este será o procedimento correto a ser seguido, isso porque será possível selecionar uma conta WhatsApp Business e um telefone já existente.

chevron-rightResumo das etapas necessárias, organizadas pela situação atual do seu número de telefonehashtag

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.

circle-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.

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.

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

Para usar um número de telefone existente do WhatsApp Messenger com a Cloud API, realizando o processo de integração pelo botão de Login, você terá que desvincular o WhatsApp para liberar o número.

Há duas opções: mudar o número – utilizar um novo número para realizar o processo de backup e, depois, fazer a integração normalmente com o número anterior – ou excluir a conta, não realizando o backup.

👉 4. Excluir ou mudar conta

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.

Se o número de telefone JÁ FOI integrado anteriormente na API Cloud do WhatsApp Business, 👉 5. Inicie o processo de login, depois, durante o passo a passo, selecione a opção 8.1 Se o número de telefone JÁ FOI integrado anteriormente na API Cloud do WhatsApp Business e, no momento de selecionar uma conta do WhatsApp Business, escolha a seguinte opção 9.1 Telefone integrado anteriormente.

circle-info

O que significa um número de telefone integrado a API Cloud?

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 de login —, este será o procedimento correto a ser seguido, isso porque será possível selecionar uma conta WhatsApp Business e um telefone já existente.

2.2 Número de telefone não integrado à API Cloud.

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 e você deseja fazer uma nova integração diretamente na API Cloud do WhatsApp Business, 👉 5. Inicie o processo de login, depois, durante o passo a passo, selecione a opção 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 e, no momento de selecionar uma conta do WhatsApp Business, escolha a seguinte opção 9.2 Integração direta.

circle-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.

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 para realizar a integração com coexistência entre o Aplicativo do WhatsApp Business e a API Cloud do WhatsApp Business.

circle-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. Caso a coexistência não esteja habilitada no momento da configuração, será necessário seguir com a integração direta.

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.

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

Se você fizer o cadastro por meio de um provedor de soluções que ofereça suporte ao cadastro de números do aplicativo Business, poderá usar o aplicativo WhatsApp Business e o aplicativo do parceiro da solução simultaneamente, e seu histórico de mensagens será preservado.

👉 5. Inicie o processo de login, depois, durante o passo a passo, selecione a opção 8.3 Se você deseja manter a COEXISTÊNCIA entre a API Cloud e o WhatsApp Business App e, no momento de selecionar uma conta do WhatsApp Business, escolha 9.3 Integração com Coexistência.

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

triangle-exclamation

Observe que, se você excluir seu número de telefone do aplicativo WhatsApp Business e registrá-lo para uso com a API em Nuvem, 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 em Nuvem.

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.

circle-info

Para mais informações sobre mudança do número de telefone, consulte: Sobre mudar seu numero de telefonearrow-up-right.

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.

circle-info

Para mais informações sobre exclusão do número de telefone, consulte: Como apagar a sua contaarrow-up-right.

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

circle-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.


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.

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

6. Tela de autorização

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".

triangle-exclamation

7. Selecione o Portfólio Empresarial

Selecione o Portifólio Empresarial (BM). Também há a opção "Criar um portifólio empresarial" caso não tenha atingido o limite de criação de portifólios.

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

chevron-rightVersão antiga da Integração:hashtag

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".

8. Selecione uma conta do WhatsApp Business

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

Selecione a Conta do WhatsApp Business existente, depois clique em Avançar.

"Teste" é apenas um nome exemplificativo da conta.
circle-info

Isso ocorre porque, se o número já foi usado em uma integração anterior, ele já está associado a uma Conta do WhatsApp Business na Plataforma. Portanto, em vez de criar uma nova, a etapa correta é selecionar a conta existente.

Depois, 👉 9.1 Telefone integrado anteriormente.

chevron-rightVersão antiga da Integração:hashtag

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".

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):

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.

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:

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

circle-info

Existe a opção de selecionar uma Conta do WhatsApp Business existente porque é possível gerenciar múltiplos números de telefone em uma única conta.

chevron-rightCriar uma nova Conta do WhatsApp Businesshashtag

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:

Depois, 👉 9.2 Integração direta.

chevron-rightVersão antiga da Integração:hashtag

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.

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.

Clique em "Avançar".

Depois, 👉 9.2 Integração direta.

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

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

Depois, 👉 9.3 Integração com coexistência.

chevron-rightVersão antiga da Integração:hashtag

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 primeira opção: Conectar seu app WhatsApp Business existente.

Clique em "Avançar".

Depois, 👉 9.3 Integração com coexistência.

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:

circle-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 WhatsApp Business.

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 existente, agora, selecione a opção "Usar um número do WhatsApp novo ou existente".

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

Por último, clique em Avançar. Isso levará a tela de 👉 10. Confirmação de acesso.

chevron-rightVersão antiga da Integração:hashtag

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

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.

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 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".

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

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.

chevron-rightVersão antiga da Integração:hashtag

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:

Depois, clique em Avançar.

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

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

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

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.

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

circle-info

Atenção: em relação a coexistência, leia atentamente a documentação da Meta, em especial ao que se refere às limitaçõesarrow-up-right da coexistência e a comparação entre os recursosarrow-up-right. Recursos como, por exemplo, a edição e exclusão de mensagens não estarão mais disponíveis no aplicativo do WhatsApp Business APÓS a integração com a API em nuvem.

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 à Business Manager (BM) selecionada na integração.

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

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.

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.

chevron-rightVersão antiga da Integração:hashtag

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.

Depois, clique em Avançar.

Você será direcionado para a tela de 👉11. Conclusão do processo de integração.

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

Após a integração, o vinculo será automático à Business Manager (BM) selecionada na integração.

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

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.

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

chevron-rightVersão antiga da Integração:hashtag

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.

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.

Você será direcionado para a tela de 👉11. Conclusão do processo de integração.

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

Se o número não estiver vinculado a mesma Business Manager (BM) que será utilizada durante o processo de integração na API, então há duas alternativas:

a) 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;

b) Fazer o processo de 👉 4. Excluir ou mudar conta, depois o processo de 2.2 Número de telefone não integrado à API Cloud, seguindo os passos para Manter Coexistência entre API Cloud e o WhatsApp Business App.

10. Confirmação de Acessos

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

chevron-rightVersão antiga da Integração:hashtag

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

Clique em "Continuar".

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

11. Conclusão do processo de integração

Clique em Concluir.

triangle-exclamation

Processos importantes 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: etapa obrigatória para viabilizar a utilização dos recursos vinculados à conta, como envio de Mensagens Template aos contatos.

  • Verificação da Empresa: 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 a 250 conversas iniciada pela empresa em um período contínuo de 24 horas.

Atualizado