Visão Geral das Contas

Credenciais são a ponte entre o CloudWhats e a API do WhatsApp Business. Na prática, cada credencial representa uma conexão operacional entre a sua conta Meta, um número de telefone e a plataforma — é ela que permite enviar, receber e administrar mensagens.

O que é uma credencial

Uma credencial armazena todas as informações necessárias para se comunicar com a API do WhatsApp Cloud:

WABA / Business Account ID — identificador da conta WhatsApp Business no Meta
Phone Number ID — identificador único do número de telefone conectado
Access Token — token usado para autenticar chamadas na API do Meta
Dados do número — como display name, verified name e status operacional
Metadados da integração — modo de conexão, validade do token e dados do onboarding

Modelo BYOC (Bring Your Own Credentials)

A oferta pública atual do CloudWhats opera no modelo BYOC — você traz sua própria operação do Meta Business. Isso significa que:

Você mantém controle sobre a conta Meta Business, WABA e números usados na operação
Os custos de mensagens continuam sendo cobrados diretamente pelo Meta na sua conta
O CloudWhats cuida da camada de operação, atendimento, automações e gestão
Você pode trabalhar com mais de um número, respeitando os limites do seu plano

No fluxo recomendado (Conectar via Meta), você não precisa chegar com um app próprio no Facebook Developers. O mais importante é ter acesso à conta Meta/Facebook da operação e a um número elegível.

Tipos de credencial

Embedded Signup do Meta

É o fluxo mais simples para a maioria das operações. Você autoriza a conta Meta, escolhe a WABA e o número, e o CloudWhats conclui automaticamente as etapas principais da conexão — incluindo a troca do token, a descoberta do número e a assinatura do webhook.

Configuração manual

Indicada para operações BYOC que já possuem app, WABA, token e setup técnico no Meta. Nesse modo, você informa manualmente os dados da credencial e, quando necessário, conclui o webhook e outras permissões diretamente no seu app da Meta.

Cada número de telefone só pode estar vinculado a uma única plataforma por vez. Se o número estiver usando o WhatsApp Business App, será necessário migrá-lo primeiro.

Em Configurações → Credenciais, o CloudWhats pode exibir o modal oficial da Meta para conectar a conta. Esse é o caminho recomendado porque reduz trabalho operacional e evita erros de configuração.

Abra a página de credenciais e inicie a conexão com a Meta
Faça login e escolha a conta Business / WABA que fará parte da operação
Selecione ou cadastre o número que será usado
Conclua a autorização para que o CloudWhats finalize a integração
Depois, revise a área de Números para confirmar status, conta ativa e eventual etapa final de registro por PIN

Delegação de acesso e gerenciamento

Na tela de credenciais você pode:

Conectar — adicionar uma nova conta via Meta ou configuração manual
Revisar método de conexão — entender se a credencial entrou via modal da Meta ou setup manual
Excluir — remover a credencial do CloudWhats quando ela não deve mais operar aqui
Delegar acesso — controlar quais membros da equipe e times têm acesso a cada credencial
Consultar webhook — copiar a URL e o token exibidos quando você estiver em fluxo manual

A escolha da conta ativa fica em Configurações → Alterar Conta. Já preferências como confirmações de leitura e indicador de digitação ficam na área de Privacidade.

Limites do plano

O número máximo de credenciais (números de WhatsApp) que você pode conectar depende do seu plano. Verifique os limites em Configurações → Faturamento. Se precisar de mais números, considere fazer upgrade do plano.