Como conectar WhatsApp Cloud API Oficial

Como conectar WhatsApp Cloud API Oficial (BETA)

A WhatsApp Cloud API é a integração oficial da Meta para conectar o WhatsApp ao Syncro. Diferente da conexão via QR Code, a Cloud API permite o uso de templates pré-aprovados, maior estabilidade e envio estruturado de mensagens em alto volume.

No Syncro, a Cloud API funciona em modo Coexistência, permitindo vincular o WhatsApp Business à API oficial da Meta enquanto o aplicativo continua funcionando normalmente no celular.

Atenção sobre a versão BETA

A WhatsApp Cloud API ainda está em BETA no Syncro.

Se o card WhatsApp Cloud API não aparecer no painel de Integrações, significa que a funcionalidade ainda não foi liberada para sua conta. Nesse caso, entre em contato com o suporte para verificar a disponibilidade.

Pré-requisitos

Antes de conectar a Cloud API, verifique se você tem:

• Permissão de admin

• Feature flag whatsapp_cloud_api habilitada na conta

• WhatsApp Business app na versão 2.24.17 ou superior

• Número ativo no WhatsApp Business há pelo menos 7 dias

• País suportado pela Meta

• Conta Facebook Business verificada

A integração é compatível com países como Brasil, Estados Unidos, México, Índia, Indonésia, Hong Kong e Singapura.

Diferenças entre WAHA e Cloud API

A conexão via WAHA funciona por QR Code e é indicada para operações conversacionais do dia a dia.

A Cloud API é a integração oficial da Meta e é mais indicada para operações com maior volume, uso de templates aprovados e maior estabilidade.

Principais diferenças:

Para prospecção em volume ou disparos estruturados, a Cloud API é a opção mais recomendada. Para atendimento comum e conversas do dia a dia, o WAHA costuma ser suficiente.

Como conectar WhatsApp Cloud API no Syncro

1. No menu lateral, acesse Configurações → Integrações.

2. Localize o card WhatsApp Cloud API com o badge BETA.

3. Clique em Conectar com Meta.

4. O Syncro abrirá o Embedded Signup da Meta em uma janela popup.

5. Faça login na conta Facebook que administra o Meta Business.

6. Selecione ou crie o Business Manager responsável pela integração.

7. Selecione o WhatsApp Business Account (WABA) ou crie um novo.

8. Escolha o número de telefone que será conectado.

9. Confirme as permissões solicitadas pela Meta.

10. Aguarde o popup fechar.

11. O Syncro receberá os dados da integração e finalizará o vínculo automaticamente.

12. Quando o processo terminar, o card mostrará o número como Conectado.

Como escolher o número de telefone

Durante o fluxo de conexão, você poderá escolher um número já existente ou cadastrar um novo.

Se o número já estiver em uso no WhatsApp Business do celular, ele poderá aparecer para reaproveitamento no modo Coexistência.

Se for um número novo, será necessário concluir a verificação por SMS ou ligação.

Como adicionar mais de um número

Você pode conectar vários números à mesma conta.

Para adicionar outro número:

1. Acesse o card WhatsApp Cloud API.

2. Clique em Adicionar outro número.

3. Repita o fluxo de conexão com a Meta.

4. Aguarde a confirmação de conexão.

Cada número conectado conta no limite do seu plano.

O que muda na operação do dia a dia

Depois de conectar via Cloud API, alguns comportamentos mudam na rotina de atendimento e disparos.

Janela de 24 horas

A Cloud API segue a regra oficial da Meta de janela de 24 horas.

Isso significa que você pode enviar mensagens livres para o cliente apenas dentro das primeiras 24 horas após a última interação dele.

Fora dessa janela, é necessário utilizar um template aprovado.

Templates HSM

Para abrir conversas fora da janela de 24 horas, é necessário usar templates HSM aprovados pela Meta.

Esses templates precisam ser criados, enviados para análise e aprovados antes do uso.

Grupos no WhatsApp

A Cloud API não permite listar grupos para envio, pois a Meta não disponibiliza esse recurso pela API oficial.

Se sua operação precisa enviar mensagens para grupos, utilize uma instância WAHA paralela.

Pré-requisitos no Meta Developer Portal

Para que o botão Conectar com Meta funcione corretamente, o app no Meta Developer Portal precisa ter:

• Produto WhatsApp adicionado ao app

• Business Verification aprovada

• Permissão whatsapp_business_messaging aprovada em App Review

• Embedded Signup Configuration criada com Solution Type = Coexistence

Se você é cliente do Syncro, normalmente não precisa mexer no Meta Developer Portal. Basta seguir o fluxo do Embedded Signup.

Token de acesso e saúde da integração

A Cloud API depende de um token de acesso válido para continuar funcionando.

O Syncro verifica diariamente a saúde do token e notifica a conta caso exista risco de expiração.

Os possíveis status são:

• Válido: integração funcionando normalmente

• Expirando em breve: aviso exibido por email ou dashboard

• Expirado: mensagens deixam de ser entregues até a reconexão

Como reconectar a Cloud API

Se aparecer um alerta de expiração ou falha na integração:

1. Acesse Configurações → Integrações.

2. Localize o card WhatsApp Cloud API.

3. Clique em Reconectar.

4. Siga novamente o fluxo da Meta.

5. Aguarde a confirmação de conexão.

Após reconectar, o envio de mensagens volta a funcionar normalmente.

Conclusão

A WhatsApp Cloud API Oficial é a integração mais robusta para empresas que precisam de estabilidade, envio em escala e uso de templates aprovados pela Meta.

No Syncro, ela permite conectar o WhatsApp Business de forma estruturada, mantendo o aplicativo funcionando no celular e oferecendo mais controle para operações comerciais, atendimento e automações.