API OFICIAL – SOCIALHUB Leitura estimada: 29 minutos 47 views SOCIAL HUB X API OFICIAL O que é, como ativar, configurar e usar a API OFICIAL integrado à SocialHub Navegação rápida Ver tudo API Oficial Antes de iniciar Número ativo Etapas Business Verification FAQ A API Oficial do WhatsApp O que é a API Oficial do WhatsApp Por que o WhatsApp comum começa a limitar? Como funciona na SocialHub Como configurar e integrar a API Oficial à SocialHub Antes de iniciar Se o número já estiver ativo no WhatsApp Etapa 1 • Etapa 2 • Etapa 3 • Etapa 4 Etapa 5 • Etapa 6 • Business Verification Etapa 7 • Etapa 8 • Etapa 9 • Etapa 10 FAQ A API Oficial do WhatsApp: o que é, como funciona e por que sua empresa deve utilizá-la O WhatsApp se tornou um dos principais canais de comunicação entre empresas e clientes no Brasil. No entanto, à medida que o volume de mensagens cresce e a operação se torna mais complexa, o uso do aplicativo comum deixa de ser suficiente. É nesse cenário que surge a WhatsApp Business Platform, solução oficial disponibilizada pela Meta para empresas que precisam operar o WhatsApp de forma profissional, escalável e integrada a sistemas. Este artigo mostra por que a API Oficial é a escolha mais segura para empresas que utilizam o WhatsApp como canal estratégico e explica, passo a passo, como configurar e integrar a API Oficial à SocialHub. Atenção A API Oficial não é um sistema “antibloqueio”. Ela é a infraestrutura oficial da Meta para uso empresarial do WhatsApp, mas continua sujeita às Diretrizes Oficiais do WhatsApp Business. Isso significa que o envio de mensagens fora das políticas, uso inadequado de templates ou práticas abusivas podem gerar restrições mesmo na API Oficial. A estrutura é oficial. O uso precisa estar dentro das regras. O que é a API Oficial do WhatsApp A API Oficial, chamada de WhatsApp Business Platform, é a versão empresarial do WhatsApp criada pela Meta. Ela não é um aplicativo de celular. É uma estrutura profissional que conecta o WhatsApp a sistemas como CRM, automação e plataformas de atendimento como a SocialHub. Quando você usa a API, o WhatsApp deixa de ser só um app de conversa e passa a ser parte da sua operação. Você consegue ter mais de um atendente no mesmo número, organizar o atendimento dentro do CRM, criar automações, usar chatbot e trabalhar campanhas de forma estruturada. É o WhatsApp pensado para empresas que estão crescendo. Por que o WhatsApp comum começa a limitar? O WhatsApp tradicional funciona bem no começo. Mas quando a empresa começa a crescer, aumentar volume de mensagens, rodar campanhas, organizar funil, dividir atendimento entre equipe, o aplicativo vira gargalo. Ele não foi criado para esse nível de operação. E quanto mais você força esse uso, maior o risco de restrições. A API resolve isso porque já nasce dentro da estrutura oficial da Meta, preparada para uso empresarial. Como funciona na SocialHub Quando você integra a API à SocialHub, o número passa a operar direto dentro do sistema. Isso significa que você organiza conversas, cria automações, acompanha métricas e estrutura campanhas de forma profissional. A lógica é simples: Importante Janela de 24 horas: se o cliente chamar você, abre uma janela de 24 horas para responder normalmente. Templates: se você quiser iniciar uma conversa ou falar fora dessa janela, utilize um template aprovado. O mais importante: dentro das regras. Como configurar e integrar a API Oficial à SocialHub Agora vamos para a parte prática. A integração da API Oficial segue um fluxo definido pela Meta. Se algum requisito não estiver correto, o processo pode travar. Por isso, antes de começar, é importante garantir que tudo esteja preparado. Antes de iniciar: o que precisa estar certo Antes de iniciar a integração, verifique: Atenção Esses pontos abaixo são os que mais causam travamento no meio do processo: • O número que será usado precisa estar livre. Ele não pode estar ativo no WhatsApp comum ou Business. Se estiver, a conta precisa ser excluída antes da ativação. • A conta da Meta precisa ter autenticação de dois fatores (2FA) ativada. Sem isso, a criação do portfólio empresarial pode falhar. • A empresa precisa ter um site válido. A Meta valida o domínio informado. Sites inexistentes ou inválidos impedem a criação do portfólio. • O usuário que fará a integração precisa ser administrador do Gerenciador Comercial. Se o número já estiver ativo no WhatsApp Para utilizar um número na API Oficial do WhatsApp, ele não pode estar ativo no aplicativo WhatsApp ou WhatsApp Business. Se o número estiver sendo utilizado atualmente no aplicativo, será necessário excluir a conta antes de iniciar a integração. Dica Passo a passo para excluir a conta do WhatsApp: 1) Abra o WhatsApp no celular 2) Acesse Configurações 3) Vá em Conta 4) Selecione Apagar minha conta 5) Confirme o número e finalize a exclusão Depois disso, o número fica livre para ser usado na WhatsApp Business Platform. Atenção: depois de migrar para a API, esse número deixa de funcionar no app e passa a operar exclusivamente via sistemas integrados, como a SocialHub. 1 Etapa 1 — Iniciar a integração na SocialHub Com tudo pronto, o primeiro passo é iniciar a integração dentro do Sistema Online. No menu lateral, acesse: Integrações → WhatsApp Oficial → Integrações de API Em seguida, informe o e-mail da sua conta na Social Hub e clique em “Iniciar com Facebook”. Nesse momento, você será redirecionado para o ambiente da Meta para autorizar a conexão e iniciar as configurações da conta WhatsApp Business. A partir daí, o processo continua dentro do fluxo oficial da Meta. Figura 1 — Início da integração dentro do Sistema Online. O que fazer agora Iniciar a integração e clicar em “Iniciar com Facebook”. Onde clicar Acesse o caminho abaixo no menu lateral: Integrações → WhatsApp Oficial → Integrações de API O que você deve ver na tela Você será redirecionado para o ambiente da Meta para autorizar a conexão. Se der errado Confira se está logado na conta Meta correta e se tem permissão de administrador no Gerenciador Comercial. 2 Etapa 2 — Autorizar a integração na Meta Após clicar em “Iniciar com Facebook”, será aberto um pop-up da Meta solicitando autorização para conectar sua conta ao CRM SocialHub. Nessa tela, a Meta explica que o processo permitirá: Conectar sua conta comercial Utilizar a API de Nuvem (Cloud API) Gerenciar conversas em grande escala Aqui não há nenhuma configuração técnica ainda. É apenas a etapa de autorização. Para continuar, clique em “Continuar”. Ao avançar, você estará concordando com os termos da Meta para uso da API e iniciará o fluxo oficial de criação ou vinculação da conta WhatsApp Business. Figura 2 — Tela de autorização inicial da Meta. O que fazer agora Clicar em Continuar para autorizar a conexão. Onde clicar Botão Continuar no pop-up da Meta. O que você deve ver na tela O fluxo avança para a seleção/criação dos ativos do negócio. Se der errado Bloqueador de pop-up pode impedir a janela. Libere pop-ups e tente novamente. 3 Etapa 3 — Criar ou selecionar os ativos do negócio Agora a Meta vai pedir para você definir quais ativos serão conectados à SocialHub. Aqui existem dois pontos importantes: Portfólio empresarial Você pode selecionar um portfólio já existente ou criar um novo. Se for sua primeira integração, normalmente será necessário clicar em “Criar um portfólio empresarial”. Esse portfólio é basicamente o “container” da sua empresa dentro da Meta. Conta do WhatsApp Business Você pode vincular uma conta existente ou criar uma nova. Se ainda não tiver uma conta WhatsApp Business na API, selecione “Criar uma conta do WhatsApp Business”. Depois de confirmar essas opções, clique em “Avançar”. A partir daqui, começamos a parte mais importante: a configuração do número que será utilizado na API. Figura 3 — Seleção/criação dos ativos do negócio na Meta. O que fazer agora Selecionar (ou criar) o portfólio empresarial e a conta WhatsApp Business, depois clicar em Avançar. Onde clicar Opções de seleção/criação + botão Avançar. O que você deve ver na tela A Meta avança para o preenchimento dos dados da empresa. Se der errado Se aparecer falta de permissão, confirme que o usuário logado é administrador do Gerenciador Comercial. 4 Etapa 4 — Preencher os Depois de criar ou selecionar o portfólio empresarial, a Meta solicitará os dados da empresa que será vinculada à API. Aqui você estará formalizando sua estrutura dentro do ambiente empresarial da Meta. Será necessário informar nome da empresa, e-mail comercial, categoria do negócio, país, fuso horário e um site válido. Esse site é um ponto importante. A Meta valida o domínio informado, então ele precisa existir e estar acessível. Caso o site seja inexistente ou inválido, o processo pode falhar nessa etapa. Após preencher todas as informações corretamente, clique em Avançar para continuar. Figura 4 — Preenchimento dos dados da empresa no ambiente Meta. O que fazer agora Preencher os dados da empresa e clicar em Avançar. Onde clicar Campos da empresa + botão Avançar. O que você deve ver na tela A Meta avança para o cadastro do número. Se der errado Domínio inválido ou site fora do ar costuma travar aqui. Confirme se o site abre normalmente. 5 Etapa 5 — Adicionar e validar o número de WhatsApp Agora começa a parte mais sensível da integração: o cadastro do número. A Meta oferece duas opções, mas para uso real e operação profissional o ideal é cadastrar um número próprio. Esse número precisa estar livre, ou seja, não pode estar ativo no WhatsApp comum ou Business. Se estiver, será necessário excluir a conta antes de continuar. Selecione o país corretamente (no caso do Brasil, +55), informe o número completo e defina o nome de exibição da conta. Esse nome deve representar sua empresa e pode passar por análise da Meta. Em seguida, escolha a forma de verificação SMS ou ligação telefônica e informe o código recebido. Depois da confirmação, o número passa oficialmente a existir dentro da WhatsApp Business Platform. A partir desse momento, ele deixa de funcionar no aplicativo tradicional e passa a operar exclusivamente via API. Atenção Atenção no nome de exibição (Display Name): esse ponto trava muita gente. O nome de exibição (Display Name) é o que vai aparecer para os clientes dentro do WhatsApp e passa por análise automática da Meta. Regras práticas que ajudam a evitar rejeição: • Use o nome real da empresa ou marca • Evite slogans e termos promocionais (ex.: “o melhor preço”, “promoção”, etc.) • Evite emojis e símbolos desnecessários • Se puder, mantenha relação com o nome do seu site/domínio Se o nome for rejeitado, você vai precisar ajustar e reenviar. Por isso, use o nome mais “oficial” possível. Figura 5 — Cadastro do número e nome de exibição. Figura 6 — Verificação do número via SMS ou ligação. Antes de finalizar, a Meta exibirá uma tela mostrando quais acessos a SocialHub terá dentro da sua conta empresarial. Essa etapa é essencial para que o sistema consiga operar corretamente. Ao confirmar, você está autorizando que a SocialHub gerencie a conta do WhatsApp, tenha acesso às conversas e registre os eventos necessários para envio e recebimento de mensagens. Sem essa autorização, a integração pode até parecer concluída, mas o número não terá permissão suficiente para funcionar plenamente. Clique em Confirmar para finalizar essa parte. Figura 7 — Confirmação de permissões para a SocialHub. O que fazer agora Cadastrar número + definir Display Name + validar por SMS/ligação e confirmar permissões. Onde clicar Campos do número → verificação (SMS/ligação) → confirmação do código → Confirmar permissões. O que você deve ver na tela Confirmação do número cadastrado e a tela de compartilhamento de permissões para a SocialHub. Se der errado (1) número ainda ativo no WhatsApp, (2) Display Name rejeitado, (3) SMS/ligação não chega — tente alternar o método. 6 Etapa 6 — Conta conectada e limite inicial Se tudo ocorreu corretamente, aparecerá a mensagem informando que sua conta está conectada ao CRM SocialHub. Nesse momento, o número já está ativo na infraestrutura da Meta. Importante Importante: A WhatsApp Business Platform trabalha com limite de conversas iniciadas pela empresa. Em contas novas, o limite inicial padrão é de 1.000 conversas iniciadas pela empresa por mês. Esse limite pode evoluir com o tempo conforme a conta ganha histórico, mantém boa reputação e, em alguns casos, após a verificação da empresa. Figura 8 — Conta conectada ao CRM SocialHub (limite inicial pode existir). Dica Se aparecer “limite inicial”, não é erro. É fase de início da conta na Meta e normalmente evolui com o tempo e com a conta verificada. O que fazer agora Confirmar que está conectado e seguir para configurar a forma de pagamento. Onde clicar Botão/atalho para Adicionar forma de pagamento (quando aparecer). O que você deve ver na tela Mensagem de conta conectada e opção de configurar cobrança. Se der errado Se não aparecer como conectado, revise as permissões concedidas e a conta Meta usada no login. ✔ Verificação da empresa (Business Verification) Essa é uma das dúvidas mais comuns durante a configuração da API Oficial. Em alguns casos, a Meta pode solicitar a verificação da empresa dentro do Meta Business Manager. Esse processo confirma que o negócio existe legalmente e que a conta comercial representa uma organização real. Quando a verificação é concluída, a empresa pode receber o selo de verificação (check azul) no perfil do WhatsApp Business. Esse selo aumenta a credibilidade da conta e reduz riscos de falsificação ou uso indevido da marca. Para empresas que utilizam a API Oficial do WhatsApp, essa verificação ajuda a fortalecer a confiança da conta dentro da plataforma e pode contribuir para maior estabilidade operacional ao longo do tempo. O que fazer Se a Meta solicitar a verificação, realize o processo diretamente no Meta Business Manager, seguindo o fluxo oficial de verificação da empresa. Onde realizar a verificação A verificação é feita dentro do Meta Business Manager, na área de configurações de segurança da empresa. O que pode ser solicitado Durante o processo, a Meta pode solicitar documentos que comprovem a existência legal da empresa, como: • CNPJ ou registro legal da empresa • contrato social ou documento de constituição • comprovante de endereço da empresa • validação do domínio do site Prazo do processo A análise pode levar alguns dias e, em alguns casos, até cerca de 30 dias, dependendo da documentação enviada e do volume de análises da Meta. Por que isso importa? A verificação ajuda a aumentar a confiança da conta dentro da plataforma, podendo contribuir para maior estabilidade da operação e evolução dos limites ao longo do tempo. 7 Etapa 7 — Configurar a forma de pagamento na Meta Mesmo com o número conectado, a API só poderá operar sem limitações após a configuração da forma de pagamento no Gerenciador de Negócios da Meta. Ao clicar em Adicionar forma de pagamento, você será direcionado ao painel de cobrança. A API Oficial possui cobrança direta da Meta. Isso significa que o consumo das mensagens enviadas será debitado da forma de pagamento cadastrada ali. O modelo mais comum é cartão de crédito internacional habilitado para compras no exterior. Empresas com alto volume podem solicitar linha de crédito, mas isso depende de aprovação da própria Meta. É importante entender que essa cobrança é separada da SocialHub. A Meta cobra pelo uso da infraestrutura da API (mensagens enviadas), enquanto a SocialHub cobra pelo uso da plataforma e do CRM. Desde 2026, o modelo de cobrança é por mensagem entregue, especialmente para templates de Marketing, Utilidade e Autenticação. Mensagens de serviço dentro da janela de 24 horas iniciada pelo cliente são gratuitas. Os detalhes completos de valores e categorias estão descritos no Guia de Custos oficial e devem ser consultados para informações atualizadas. Depois que a forma de pagamento estiver cadastrada, a integração está completamente concluída. Figura 9 — Tela de cobrança/pagamentos da Meta para cadastrar a forma de pagamento. Importante Observação: aqui você não está pagando a SocialHub. Você está cadastrando o pagamento da Meta, que cobra pelo uso da infraestrutura da API. O que fazer agora Cadastrar forma de pagamento no Gerenciador de Negócios da Meta. Onde clicar Área de Cobrança / Pagamentos na Meta. O que você deve ver na tela Forma de pagamento adicionada e cobrança ativa. Se der errado Cartão sem liberação internacional ou bloqueio do banco. Tente outro cartão ou ajuste com seu banco. 8 Etapa 8 — Acessar o Gerenciador de Modelos (Templates) Após concluir a integração, o número já aparece como ativo dentro do painel da SocialHub. Isso significa que a infraestrutura está pronta. Agora começa a parte estratégica da comunicação. Dentro do menu Gerenciar WhatsApp Oficial, acesse a área de Modelos de Mensagens e clique em Gerenciar modelos. É aqui que você cria os templates que serão enviados fora da janela de 24 horas ou para iniciar conversas com clientes. Sem template aprovado, não é possível iniciar uma conversa pela API. Figura 10 — Acesso ao Gerenciador de Modelos (Templates) dentro da SocialHub. Ao clicar em Criar modelo, você iniciará o processo de criação do template. A primeira decisão importante é escolher a categoria correta. A Meta divide os modelos em três categorias principais: Marketing — para promoções, ofertas e campanhas comerciais. Utilidades — para avisos operacionais, atualizações e comunicações transacionais. Autenticação — para envio de códigos e validações (OTP). Escolher a categoria correta é fundamental, pois ela impacta diretamente no tipo de cobrança e nas regras aplicáveis. Figura 11 — Escolha da categoria do template. Após selecionar a categoria, você definirá o nome do modelo (em letras minúsculas e sem espaços) e o idioma. O nome é interno e serve apenas para organização. Agora você constrói a mensagem que será enviada aos clientes. Você pode definir: – O tipo de variável (caso queira personalizar informações como nome, número de pedido, data etc.) – O corpo da mensagem (texto principal) – Um cabeçalho opcional (texto, imagem, documento ou vídeo) – Rodapé opcional – Botões interativos (respostas rápidas ou link) Figura 12 — Montagem do template com conteúdo, variáveis e pré-visualização. Figura 13 — Botões interativos e envio do template para revisão. Atenção Ponto de atenção: Templates são analisados pela Meta. Textos promocionais não podem ser cadastrados como utilidade, por exemplo. Depois de configurar tudo, clique em Enviar para revisão. O status ficará como “Pendente” até a aprovação da Meta. Esse processo normalmente leva poucos minutos, mas pode levar até 24 horas. Após a aprovação Quando o template for aprovado, ele aparecerá como ativo dentro do sistema. A partir desse momento, você poderá utilizá-lo em: – Disparos estruturados – Automações – Fluxos de chatbot – Mensagens fora da janela de 24 horas É importante lembrar que a cobrança ocorre por mensagem entregue, conforme a categoria escolhida, seguindo o modelo vigente da Meta. O que fazer agora Acessar o gerenciador e criar um template. Onde clicar Gerenciar WhatsApp Oficial → Modelos de Mensagens → Gerenciar modelos. O que você deve ver na tela Lista de modelos e botão Criar modelo. Se der errado Sem permissão ou número não ativo no painel — confirme se a integração finalizou e se o número aparece como ativo. 9 Etapa 9 — Iniciar uma conversa usando um template aprovado Depois que seu template estiver aprovado, ele já poderá ser utilizado dentro das conversas. Quando você acessar um contato cujo chat esteja encerrado, verá o botão “Abrir conversa”. Esse botão aparece justamente porque a janela de 24 horas não está ativa, ou seja, o cliente não enviou mensagem recentemente. Ao clicar em Abrir conversa, o sistema solicitará que você escolha um template aprovado. Isso acontece porque, fora da janela de 24 horas, a API exige o uso de modelo pré-aprovado pela Meta. Você seleciona o template desejado e confirma o envio. Nesse momento, o template será disparado ao cliente. Figura 14 — Botão “Abrir conversa” quando o chat está encerrado. Figura 15 — Seleção do template aprovado e confirmação do envio. O que fazer agora Clicar em Abrir conversa e escolher um template aprovado. Onde clicar Botão Abrir conversa dentro do atendimento do contato. O que você deve ver na tela Modal com lista de templates e botão para confirmar/usar. Se der errado Se não aparece template, confirme se existe template aprovado (ativo) e se categoria/idioma estão corretos. 10 Etapa 10 — Abertura da janela de 24 horas Assim que o cliente responder à mensagem enviada, inicia-se automaticamente a chamada janela de atendimento de 24 horas. Durante esse período, você pode enviar mensagens livres, sem necessidade de utilizar templates. Isso significa que o chat passa a funcionar como uma conversa normal, permitindo: – Atendimento manual – Uso de automações – Respostas personalizadas – Continuidade do fluxo Figura — Tempo do chat em aberto. Enquanto a janela estiver ativa, mensagens classificadas como serviço são gratuitas conforme as regras da Meta. Se o cliente não responder ou após 24 horas da última interação, a janela é encerrada automaticamente. Quando isso acontecer, o botão Abrir conversa volta a aparecer, indicando que será necessário utilizar um novo template para reiniciar o contato. Esse ciclo se repete sempre que for necessário iniciar uma nova conversa ativa. Sucesso Fechou: Template enviado → cliente responde → abre 24h → conversa livre → encerrou → volta o “Abrir conversa”. O que fazer agora Atender normalmente enquanto a janela estiver ativa. O que você deve ver na tela Chat em modo livre (sem exigir template a cada mensagem). Se der errado Se a janela fechar, o botão “Abrir conversa” volta a aparecer — aí precisa iniciar novamente via template. Perguntas frequentes sobre a API Oficial do WhatsApp Abaixo reunimos algumas das dúvidas mais comuns de empresas que estão começando a utilizar a WhatsApp Business Platform integrada à SocialHub. A API Oficial do WhatsApp pode ser bloqueada? Sim. A API Oficial é a infraestrutura oficial da Meta, mas não é um sistema “antibloqueio”. Se uma empresa enviar mensagens sem consentimento, utilizar templates fora das políticas, gerar muitas denúncias ou bloqueios por parte dos usuários, a conta pode sofrer restrições. Essas restrições podem incluir: • redução de limites de envio • bloqueio temporário de mensagens • ou até suspensão da conta Atenção: mesmo na API Oficial, é fundamental seguir as diretrizes da plataforma. Diretrizes oficiais: WhatsApp Business Policy. Qual é o limite inicial de envio na API? Contas novas normalmente começam com um limite de 1.000 conversas iniciadas pela empresa por mês. Esse limite pode evoluir automaticamente conforme a conta mantém: • boa reputação • histórico de uso saudável • baixa taxa de bloqueios ou denúncias À medida que a conta demonstra comportamento positivo, a Meta pode aumentar gradualmente esses limites. Dica: volume alto com baixa qualidade (muitos bloqueios/denúncias) tende a travar o crescimento do limite. Posso usar um número que já está no WhatsApp? Sim, mas primeiro será necessário excluir a conta desse número no aplicativo WhatsApp ou WhatsApp Business. Depois de migrar para a API Oficial, o número deixa de funcionar no aplicativo tradicional e passa a operar exclusivamente via sistema integrado, como a SocialHub. Atenção: após migrar para a API, você não usa mais esse número no app. Preciso manter o celular ligado para usar a API? Não. A API Oficial funciona diretamente na infraestrutura da Meta e não depende de: • celular conectado • QR Code • WhatsApp Web Toda a operação acontece dentro da plataforma integrada ao sistema. O cliente precisa salvar meu número para receber mensagens? Não. O contato pode receber mensagens mesmo sem salvar seu número. No entanto, quando o cliente salva o número, isso normalmente aumenta a confiança na conversa e pode reduzir a chance de bloqueios ou denúncias. Posso alterar um template depois de aprovado? Não. Depois que um template é aprovado pela Meta, ele não pode ser editado. Se for necessário alterar o conteúdo, será preciso criar um novo template e enviá-lo novamente para aprovação. Importante: pequenas mudanças de texto já exigem um novo template. Quanto tempo leva para um template ser aprovado? Na maioria dos casos, a aprovação acontece em poucos minutos. No entanto, dependendo do volume de análises da Meta, esse processo pode levar até 24 horas. O que acontece se o nome de exibição (Display Name) for rejeitado? Se o nome de exibição for rejeitado pela Meta, será necessário ajustá-lo e enviá-lo novamente para aprovação. Para evitar rejeições, recomenda-se utilizar: • o nome real da empresa ou marca • o mesmo nome presente no site da empresa Evite: • termos promocionais • emojis • símbolos desnecessários Atenção: quanto mais “oficial” e consistente com o domínio/site, maior a chance de aprovação. Verificação da empresa é obrigatória? Nem sempre. Algumas contas conseguem operar inicialmente sem a verificação completa da empresa. No entanto, em determinados casos a Meta pode solicitar a Business Verification, pedindo documentos da empresa para confirmar sua existência e legitimidade. Empresas verificadas costumam ter maior confiança dentro da plataforma. Eu consigo fazer disparos em massa com a API Oficial? A API permite envio de mensagens em escala utilizando templates aprovados pela Meta. Essas mensagens podem ser usadas para: • campanhas • notificações • comunicações com clientes Atenção: a Meta não permite spam ou envio para contatos que não tiveram relação prévia com a empresa. Boas práticas como consentimento do cliente e segmentação da base são fundamentais. Qual a diferença entre usar o WhatsApp Business normal e a API Oficial? O WhatsApp Business tradicional é um aplicativo de celular, pensado para operações menores. A API Oficial é uma infraestrutura empresarial, que conecta o WhatsApp a sistemas como CRM, automações e plataformas de atendimento. Com a API, você pode ter: • múltiplos atendentes no mesmo número • automações e chatbots • histórico centralizado de conversas • integração com sistemas • envio estruturado de campanhas Dica: se você tem equipe, automação e volume, a API tende a fazer mais sentido. Por que existe um limite de conversas que posso iniciar? A Meta controla o volume de conversas iniciadas pela empresa para proteger a experiência dos usuários e evitar spam. Contas novas normalmente começam com um limite inicial de 1.000 conversas iniciadas por mês, que pode aumentar conforme a conta ganha histórico positivo. Preciso ter um CNPJ para usar a API Oficial? Não necessariamente para iniciar a integração. No entanto, a Meta pode solicitar a verificação da empresa em algum momento. Nesse caso, documentos empresariais podem ser necessários. Empresas com CNPJ e domínio próprio costumam ter um processo de ativação mais estável. Meu template pode ser reprovado? Por quê? Sim. Templates passam por análise da Meta e podem ser reprovados por diversos motivos, como: • categoria incorreta (ex.: marketing classificado como utilidade) • linguagem considerada spam • conteúdo promocional excessivo • tentativa de contornar políticas da plataforma • texto confuso ou incompleto Quando um template é reprovado, basta ajustá-lo e enviá-lo novamente para revisão. Importante: clareza + categoria certa aumentam muito a taxa de aprovação. Por que minha mensagem não foi entregue ao cliente? Existem alguns motivos comuns para uma mensagem não ser entregue: • o cliente bloqueou o número • o número do contato é inválido ou inexistente • o limite de envio da conta foi atingido • o template utilizado foi reprovado ou não aprovado • o cliente não respondeu anteriormente e a janela de 24 horas está fechada Dica: se o chat estiver fora da janela de 24h, você precisa iniciar com um template aprovado. Voltar ao topo ↑
SOCIAL HUB X API OFICIAL O que é, como ativar, configurar e usar a API OFICIAL integrado à SocialHub Navegação rápida Ver tudo API Oficial Antes de iniciar Número ativo Etapas Business Verification FAQ A API Oficial do WhatsApp O que é a API Oficial do WhatsApp Por que o WhatsApp comum começa a limitar? Como funciona na SocialHub Como configurar e integrar a API Oficial à SocialHub Antes de iniciar Se o número já estiver ativo no WhatsApp Etapa 1 • Etapa 2 • Etapa 3 • Etapa 4 Etapa 5 • Etapa 6 • Business Verification Etapa 7 • Etapa 8 • Etapa 9 • Etapa 10 FAQ A API Oficial do WhatsApp: o que é, como funciona e por que sua empresa deve utilizá-la O WhatsApp se tornou um dos principais canais de comunicação entre empresas e clientes no Brasil. No entanto, à medida que o volume de mensagens cresce e a operação se torna mais complexa, o uso do aplicativo comum deixa de ser suficiente. É nesse cenário que surge a WhatsApp Business Platform, solução oficial disponibilizada pela Meta para empresas que precisam operar o WhatsApp de forma profissional, escalável e integrada a sistemas. Este artigo mostra por que a API Oficial é a escolha mais segura para empresas que utilizam o WhatsApp como canal estratégico e explica, passo a passo, como configurar e integrar a API Oficial à SocialHub. Atenção A API Oficial não é um sistema “antibloqueio”. Ela é a infraestrutura oficial da Meta para uso empresarial do WhatsApp, mas continua sujeita às Diretrizes Oficiais do WhatsApp Business. Isso significa que o envio de mensagens fora das políticas, uso inadequado de templates ou práticas abusivas podem gerar restrições mesmo na API Oficial. A estrutura é oficial. O uso precisa estar dentro das regras. O que é a API Oficial do WhatsApp A API Oficial, chamada de WhatsApp Business Platform, é a versão empresarial do WhatsApp criada pela Meta. Ela não é um aplicativo de celular. É uma estrutura profissional que conecta o WhatsApp a sistemas como CRM, automação e plataformas de atendimento como a SocialHub. Quando você usa a API, o WhatsApp deixa de ser só um app de conversa e passa a ser parte da sua operação. Você consegue ter mais de um atendente no mesmo número, organizar o atendimento dentro do CRM, criar automações, usar chatbot e trabalhar campanhas de forma estruturada. É o WhatsApp pensado para empresas que estão crescendo. Por que o WhatsApp comum começa a limitar? O WhatsApp tradicional funciona bem no começo. Mas quando a empresa começa a crescer, aumentar volume de mensagens, rodar campanhas, organizar funil, dividir atendimento entre equipe, o aplicativo vira gargalo. Ele não foi criado para esse nível de operação. E quanto mais você força esse uso, maior o risco de restrições. A API resolve isso porque já nasce dentro da estrutura oficial da Meta, preparada para uso empresarial. Como funciona na SocialHub Quando você integra a API à SocialHub, o número passa a operar direto dentro do sistema. Isso significa que você organiza conversas, cria automações, acompanha métricas e estrutura campanhas de forma profissional. A lógica é simples: Importante Janela de 24 horas: se o cliente chamar você, abre uma janela de 24 horas para responder normalmente. Templates: se você quiser iniciar uma conversa ou falar fora dessa janela, utilize um template aprovado. O mais importante: dentro das regras. Como configurar e integrar a API Oficial à SocialHub Agora vamos para a parte prática. A integração da API Oficial segue um fluxo definido pela Meta. Se algum requisito não estiver correto, o processo pode travar. Por isso, antes de começar, é importante garantir que tudo esteja preparado. Antes de iniciar: o que precisa estar certo Antes de iniciar a integração, verifique: Atenção Esses pontos abaixo são os que mais causam travamento no meio do processo: • O número que será usado precisa estar livre. Ele não pode estar ativo no WhatsApp comum ou Business. Se estiver, a conta precisa ser excluída antes da ativação. • A conta da Meta precisa ter autenticação de dois fatores (2FA) ativada. Sem isso, a criação do portfólio empresarial pode falhar. • A empresa precisa ter um site válido. A Meta valida o domínio informado. Sites inexistentes ou inválidos impedem a criação do portfólio. • O usuário que fará a integração precisa ser administrador do Gerenciador Comercial. Se o número já estiver ativo no WhatsApp Para utilizar um número na API Oficial do WhatsApp, ele não pode estar ativo no aplicativo WhatsApp ou WhatsApp Business. Se o número estiver sendo utilizado atualmente no aplicativo, será necessário excluir a conta antes de iniciar a integração. Dica Passo a passo para excluir a conta do WhatsApp: 1) Abra o WhatsApp no celular 2) Acesse Configurações 3) Vá em Conta 4) Selecione Apagar minha conta 5) Confirme o número e finalize a exclusão Depois disso, o número fica livre para ser usado na WhatsApp Business Platform. Atenção: depois de migrar para a API, esse número deixa de funcionar no app e passa a operar exclusivamente via sistemas integrados, como a SocialHub. 1 Etapa 1 — Iniciar a integração na SocialHub Com tudo pronto, o primeiro passo é iniciar a integração dentro do Sistema Online. No menu lateral, acesse: Integrações → WhatsApp Oficial → Integrações de API Em seguida, informe o e-mail da sua conta na Social Hub e clique em “Iniciar com Facebook”. Nesse momento, você será redirecionado para o ambiente da Meta para autorizar a conexão e iniciar as configurações da conta WhatsApp Business. A partir daí, o processo continua dentro do fluxo oficial da Meta. Figura 1 — Início da integração dentro do Sistema Online. O que fazer agora Iniciar a integração e clicar em “Iniciar com Facebook”. Onde clicar Acesse o caminho abaixo no menu lateral: Integrações → WhatsApp Oficial → Integrações de API O que você deve ver na tela Você será redirecionado para o ambiente da Meta para autorizar a conexão. Se der errado Confira se está logado na conta Meta correta e se tem permissão de administrador no Gerenciador Comercial. 2 Etapa 2 — Autorizar a integração na Meta Após clicar em “Iniciar com Facebook”, será aberto um pop-up da Meta solicitando autorização para conectar sua conta ao CRM SocialHub. Nessa tela, a Meta explica que o processo permitirá: Conectar sua conta comercial Utilizar a API de Nuvem (Cloud API) Gerenciar conversas em grande escala Aqui não há nenhuma configuração técnica ainda. É apenas a etapa de autorização. Para continuar, clique em “Continuar”. Ao avançar, você estará concordando com os termos da Meta para uso da API e iniciará o fluxo oficial de criação ou vinculação da conta WhatsApp Business. Figura 2 — Tela de autorização inicial da Meta. O que fazer agora Clicar em Continuar para autorizar a conexão. Onde clicar Botão Continuar no pop-up da Meta. O que você deve ver na tela O fluxo avança para a seleção/criação dos ativos do negócio. Se der errado Bloqueador de pop-up pode impedir a janela. Libere pop-ups e tente novamente. 3 Etapa 3 — Criar ou selecionar os ativos do negócio Agora a Meta vai pedir para você definir quais ativos serão conectados à SocialHub. Aqui existem dois pontos importantes: Portfólio empresarial Você pode selecionar um portfólio já existente ou criar um novo. Se for sua primeira integração, normalmente será necessário clicar em “Criar um portfólio empresarial”. Esse portfólio é basicamente o “container” da sua empresa dentro da Meta. Conta do WhatsApp Business Você pode vincular uma conta existente ou criar uma nova. Se ainda não tiver uma conta WhatsApp Business na API, selecione “Criar uma conta do WhatsApp Business”. Depois de confirmar essas opções, clique em “Avançar”. A partir daqui, começamos a parte mais importante: a configuração do número que será utilizado na API. Figura 3 — Seleção/criação dos ativos do negócio na Meta. O que fazer agora Selecionar (ou criar) o portfólio empresarial e a conta WhatsApp Business, depois clicar em Avançar. Onde clicar Opções de seleção/criação + botão Avançar. O que você deve ver na tela A Meta avança para o preenchimento dos dados da empresa. Se der errado Se aparecer falta de permissão, confirme que o usuário logado é administrador do Gerenciador Comercial. 4 Etapa 4 — Preencher os Depois de criar ou selecionar o portfólio empresarial, a Meta solicitará os dados da empresa que será vinculada à API. Aqui você estará formalizando sua estrutura dentro do ambiente empresarial da Meta. Será necessário informar nome da empresa, e-mail comercial, categoria do negócio, país, fuso horário e um site válido. Esse site é um ponto importante. A Meta valida o domínio informado, então ele precisa existir e estar acessível. Caso o site seja inexistente ou inválido, o processo pode falhar nessa etapa. Após preencher todas as informações corretamente, clique em Avançar para continuar. Figura 4 — Preenchimento dos dados da empresa no ambiente Meta. O que fazer agora Preencher os dados da empresa e clicar em Avançar. Onde clicar Campos da empresa + botão Avançar. O que você deve ver na tela A Meta avança para o cadastro do número. Se der errado Domínio inválido ou site fora do ar costuma travar aqui. Confirme se o site abre normalmente. 5 Etapa 5 — Adicionar e validar o número de WhatsApp Agora começa a parte mais sensível da integração: o cadastro do número. A Meta oferece duas opções, mas para uso real e operação profissional o ideal é cadastrar um número próprio. Esse número precisa estar livre, ou seja, não pode estar ativo no WhatsApp comum ou Business. Se estiver, será necessário excluir a conta antes de continuar. Selecione o país corretamente (no caso do Brasil, +55), informe o número completo e defina o nome de exibição da conta. Esse nome deve representar sua empresa e pode passar por análise da Meta. Em seguida, escolha a forma de verificação SMS ou ligação telefônica e informe o código recebido. Depois da confirmação, o número passa oficialmente a existir dentro da WhatsApp Business Platform. A partir desse momento, ele deixa de funcionar no aplicativo tradicional e passa a operar exclusivamente via API. Atenção Atenção no nome de exibição (Display Name): esse ponto trava muita gente. O nome de exibição (Display Name) é o que vai aparecer para os clientes dentro do WhatsApp e passa por análise automática da Meta. Regras práticas que ajudam a evitar rejeição: • Use o nome real da empresa ou marca • Evite slogans e termos promocionais (ex.: “o melhor preço”, “promoção”, etc.) • Evite emojis e símbolos desnecessários • Se puder, mantenha relação com o nome do seu site/domínio Se o nome for rejeitado, você vai precisar ajustar e reenviar. Por isso, use o nome mais “oficial” possível. Figura 5 — Cadastro do número e nome de exibição. Figura 6 — Verificação do número via SMS ou ligação. Antes de finalizar, a Meta exibirá uma tela mostrando quais acessos a SocialHub terá dentro da sua conta empresarial. Essa etapa é essencial para que o sistema consiga operar corretamente. Ao confirmar, você está autorizando que a SocialHub gerencie a conta do WhatsApp, tenha acesso às conversas e registre os eventos necessários para envio e recebimento de mensagens. Sem essa autorização, a integração pode até parecer concluída, mas o número não terá permissão suficiente para funcionar plenamente. Clique em Confirmar para finalizar essa parte. Figura 7 — Confirmação de permissões para a SocialHub. O que fazer agora Cadastrar número + definir Display Name + validar por SMS/ligação e confirmar permissões. Onde clicar Campos do número → verificação (SMS/ligação) → confirmação do código → Confirmar permissões. O que você deve ver na tela Confirmação do número cadastrado e a tela de compartilhamento de permissões para a SocialHub. Se der errado (1) número ainda ativo no WhatsApp, (2) Display Name rejeitado, (3) SMS/ligação não chega — tente alternar o método. 6 Etapa 6 — Conta conectada e limite inicial Se tudo ocorreu corretamente, aparecerá a mensagem informando que sua conta está conectada ao CRM SocialHub. Nesse momento, o número já está ativo na infraestrutura da Meta. Importante Importante: A WhatsApp Business Platform trabalha com limite de conversas iniciadas pela empresa. Em contas novas, o limite inicial padrão é de 1.000 conversas iniciadas pela empresa por mês. Esse limite pode evoluir com o tempo conforme a conta ganha histórico, mantém boa reputação e, em alguns casos, após a verificação da empresa. Figura 8 — Conta conectada ao CRM SocialHub (limite inicial pode existir). Dica Se aparecer “limite inicial”, não é erro. É fase de início da conta na Meta e normalmente evolui com o tempo e com a conta verificada. O que fazer agora Confirmar que está conectado e seguir para configurar a forma de pagamento. Onde clicar Botão/atalho para Adicionar forma de pagamento (quando aparecer). O que você deve ver na tela Mensagem de conta conectada e opção de configurar cobrança. Se der errado Se não aparecer como conectado, revise as permissões concedidas e a conta Meta usada no login. ✔ Verificação da empresa (Business Verification) Essa é uma das dúvidas mais comuns durante a configuração da API Oficial. Em alguns casos, a Meta pode solicitar a verificação da empresa dentro do Meta Business Manager. Esse processo confirma que o negócio existe legalmente e que a conta comercial representa uma organização real. Quando a verificação é concluída, a empresa pode receber o selo de verificação (check azul) no perfil do WhatsApp Business. Esse selo aumenta a credibilidade da conta e reduz riscos de falsificação ou uso indevido da marca. Para empresas que utilizam a API Oficial do WhatsApp, essa verificação ajuda a fortalecer a confiança da conta dentro da plataforma e pode contribuir para maior estabilidade operacional ao longo do tempo. O que fazer Se a Meta solicitar a verificação, realize o processo diretamente no Meta Business Manager, seguindo o fluxo oficial de verificação da empresa. Onde realizar a verificação A verificação é feita dentro do Meta Business Manager, na área de configurações de segurança da empresa. O que pode ser solicitado Durante o processo, a Meta pode solicitar documentos que comprovem a existência legal da empresa, como: • CNPJ ou registro legal da empresa • contrato social ou documento de constituição • comprovante de endereço da empresa • validação do domínio do site Prazo do processo A análise pode levar alguns dias e, em alguns casos, até cerca de 30 dias, dependendo da documentação enviada e do volume de análises da Meta. Por que isso importa? A verificação ajuda a aumentar a confiança da conta dentro da plataforma, podendo contribuir para maior estabilidade da operação e evolução dos limites ao longo do tempo. 7 Etapa 7 — Configurar a forma de pagamento na Meta Mesmo com o número conectado, a API só poderá operar sem limitações após a configuração da forma de pagamento no Gerenciador de Negócios da Meta. Ao clicar em Adicionar forma de pagamento, você será direcionado ao painel de cobrança. A API Oficial possui cobrança direta da Meta. Isso significa que o consumo das mensagens enviadas será debitado da forma de pagamento cadastrada ali. O modelo mais comum é cartão de crédito internacional habilitado para compras no exterior. Empresas com alto volume podem solicitar linha de crédito, mas isso depende de aprovação da própria Meta. É importante entender que essa cobrança é separada da SocialHub. A Meta cobra pelo uso da infraestrutura da API (mensagens enviadas), enquanto a SocialHub cobra pelo uso da plataforma e do CRM. Desde 2026, o modelo de cobrança é por mensagem entregue, especialmente para templates de Marketing, Utilidade e Autenticação. Mensagens de serviço dentro da janela de 24 horas iniciada pelo cliente são gratuitas. Os detalhes completos de valores e categorias estão descritos no Guia de Custos oficial e devem ser consultados para informações atualizadas. Depois que a forma de pagamento estiver cadastrada, a integração está completamente concluída. Figura 9 — Tela de cobrança/pagamentos da Meta para cadastrar a forma de pagamento. Importante Observação: aqui você não está pagando a SocialHub. Você está cadastrando o pagamento da Meta, que cobra pelo uso da infraestrutura da API. O que fazer agora Cadastrar forma de pagamento no Gerenciador de Negócios da Meta. Onde clicar Área de Cobrança / Pagamentos na Meta. O que você deve ver na tela Forma de pagamento adicionada e cobrança ativa. Se der errado Cartão sem liberação internacional ou bloqueio do banco. Tente outro cartão ou ajuste com seu banco. 8 Etapa 8 — Acessar o Gerenciador de Modelos (Templates) Após concluir a integração, o número já aparece como ativo dentro do painel da SocialHub. Isso significa que a infraestrutura está pronta. Agora começa a parte estratégica da comunicação. Dentro do menu Gerenciar WhatsApp Oficial, acesse a área de Modelos de Mensagens e clique em Gerenciar modelos. É aqui que você cria os templates que serão enviados fora da janela de 24 horas ou para iniciar conversas com clientes. Sem template aprovado, não é possível iniciar uma conversa pela API. Figura 10 — Acesso ao Gerenciador de Modelos (Templates) dentro da SocialHub. Ao clicar em Criar modelo, você iniciará o processo de criação do template. A primeira decisão importante é escolher a categoria correta. A Meta divide os modelos em três categorias principais: Marketing — para promoções, ofertas e campanhas comerciais. Utilidades — para avisos operacionais, atualizações e comunicações transacionais. Autenticação — para envio de códigos e validações (OTP). Escolher a categoria correta é fundamental, pois ela impacta diretamente no tipo de cobrança e nas regras aplicáveis. Figura 11 — Escolha da categoria do template. Após selecionar a categoria, você definirá o nome do modelo (em letras minúsculas e sem espaços) e o idioma. O nome é interno e serve apenas para organização. Agora você constrói a mensagem que será enviada aos clientes. Você pode definir: – O tipo de variável (caso queira personalizar informações como nome, número de pedido, data etc.) – O corpo da mensagem (texto principal) – Um cabeçalho opcional (texto, imagem, documento ou vídeo) – Rodapé opcional – Botões interativos (respostas rápidas ou link) Figura 12 — Montagem do template com conteúdo, variáveis e pré-visualização. Figura 13 — Botões interativos e envio do template para revisão. Atenção Ponto de atenção: Templates são analisados pela Meta. Textos promocionais não podem ser cadastrados como utilidade, por exemplo. Depois de configurar tudo, clique em Enviar para revisão. O status ficará como “Pendente” até a aprovação da Meta. Esse processo normalmente leva poucos minutos, mas pode levar até 24 horas. Após a aprovação Quando o template for aprovado, ele aparecerá como ativo dentro do sistema. A partir desse momento, você poderá utilizá-lo em: – Disparos estruturados – Automações – Fluxos de chatbot – Mensagens fora da janela de 24 horas É importante lembrar que a cobrança ocorre por mensagem entregue, conforme a categoria escolhida, seguindo o modelo vigente da Meta. O que fazer agora Acessar o gerenciador e criar um template. Onde clicar Gerenciar WhatsApp Oficial → Modelos de Mensagens → Gerenciar modelos. O que você deve ver na tela Lista de modelos e botão Criar modelo. Se der errado Sem permissão ou número não ativo no painel — confirme se a integração finalizou e se o número aparece como ativo. 9 Etapa 9 — Iniciar uma conversa usando um template aprovado Depois que seu template estiver aprovado, ele já poderá ser utilizado dentro das conversas. Quando você acessar um contato cujo chat esteja encerrado, verá o botão “Abrir conversa”. Esse botão aparece justamente porque a janela de 24 horas não está ativa, ou seja, o cliente não enviou mensagem recentemente. Ao clicar em Abrir conversa, o sistema solicitará que você escolha um template aprovado. Isso acontece porque, fora da janela de 24 horas, a API exige o uso de modelo pré-aprovado pela Meta. Você seleciona o template desejado e confirma o envio. Nesse momento, o template será disparado ao cliente. Figura 14 — Botão “Abrir conversa” quando o chat está encerrado. Figura 15 — Seleção do template aprovado e confirmação do envio. O que fazer agora Clicar em Abrir conversa e escolher um template aprovado. Onde clicar Botão Abrir conversa dentro do atendimento do contato. O que você deve ver na tela Modal com lista de templates e botão para confirmar/usar. Se der errado Se não aparece template, confirme se existe template aprovado (ativo) e se categoria/idioma estão corretos. 10 Etapa 10 — Abertura da janela de 24 horas Assim que o cliente responder à mensagem enviada, inicia-se automaticamente a chamada janela de atendimento de 24 horas. Durante esse período, você pode enviar mensagens livres, sem necessidade de utilizar templates. Isso significa que o chat passa a funcionar como uma conversa normal, permitindo: – Atendimento manual – Uso de automações – Respostas personalizadas – Continuidade do fluxo Figura — Tempo do chat em aberto. Enquanto a janela estiver ativa, mensagens classificadas como serviço são gratuitas conforme as regras da Meta. Se o cliente não responder ou após 24 horas da última interação, a janela é encerrada automaticamente. Quando isso acontecer, o botão Abrir conversa volta a aparecer, indicando que será necessário utilizar um novo template para reiniciar o contato. Esse ciclo se repete sempre que for necessário iniciar uma nova conversa ativa. Sucesso Fechou: Template enviado → cliente responde → abre 24h → conversa livre → encerrou → volta o “Abrir conversa”. O que fazer agora Atender normalmente enquanto a janela estiver ativa. O que você deve ver na tela Chat em modo livre (sem exigir template a cada mensagem). Se der errado Se a janela fechar, o botão “Abrir conversa” volta a aparecer — aí precisa iniciar novamente via template. Perguntas frequentes sobre a API Oficial do WhatsApp Abaixo reunimos algumas das dúvidas mais comuns de empresas que estão começando a utilizar a WhatsApp Business Platform integrada à SocialHub. A API Oficial do WhatsApp pode ser bloqueada? Sim. A API Oficial é a infraestrutura oficial da Meta, mas não é um sistema “antibloqueio”. Se uma empresa enviar mensagens sem consentimento, utilizar templates fora das políticas, gerar muitas denúncias ou bloqueios por parte dos usuários, a conta pode sofrer restrições. Essas restrições podem incluir: • redução de limites de envio • bloqueio temporário de mensagens • ou até suspensão da conta Atenção: mesmo na API Oficial, é fundamental seguir as diretrizes da plataforma. Diretrizes oficiais: WhatsApp Business Policy. Qual é o limite inicial de envio na API? Contas novas normalmente começam com um limite de 1.000 conversas iniciadas pela empresa por mês. Esse limite pode evoluir automaticamente conforme a conta mantém: • boa reputação • histórico de uso saudável • baixa taxa de bloqueios ou denúncias À medida que a conta demonstra comportamento positivo, a Meta pode aumentar gradualmente esses limites. Dica: volume alto com baixa qualidade (muitos bloqueios/denúncias) tende a travar o crescimento do limite. Posso usar um número que já está no WhatsApp? Sim, mas primeiro será necessário excluir a conta desse número no aplicativo WhatsApp ou WhatsApp Business. Depois de migrar para a API Oficial, o número deixa de funcionar no aplicativo tradicional e passa a operar exclusivamente via sistema integrado, como a SocialHub. Atenção: após migrar para a API, você não usa mais esse número no app. Preciso manter o celular ligado para usar a API? Não. A API Oficial funciona diretamente na infraestrutura da Meta e não depende de: • celular conectado • QR Code • WhatsApp Web Toda a operação acontece dentro da plataforma integrada ao sistema. O cliente precisa salvar meu número para receber mensagens? Não. O contato pode receber mensagens mesmo sem salvar seu número. No entanto, quando o cliente salva o número, isso normalmente aumenta a confiança na conversa e pode reduzir a chance de bloqueios ou denúncias. Posso alterar um template depois de aprovado? Não. Depois que um template é aprovado pela Meta, ele não pode ser editado. Se for necessário alterar o conteúdo, será preciso criar um novo template e enviá-lo novamente para aprovação. Importante: pequenas mudanças de texto já exigem um novo template. Quanto tempo leva para um template ser aprovado? Na maioria dos casos, a aprovação acontece em poucos minutos. No entanto, dependendo do volume de análises da Meta, esse processo pode levar até 24 horas. O que acontece se o nome de exibição (Display Name) for rejeitado? Se o nome de exibição for rejeitado pela Meta, será necessário ajustá-lo e enviá-lo novamente para aprovação. Para evitar rejeições, recomenda-se utilizar: • o nome real da empresa ou marca • o mesmo nome presente no site da empresa Evite: • termos promocionais • emojis • símbolos desnecessários Atenção: quanto mais “oficial” e consistente com o domínio/site, maior a chance de aprovação. Verificação da empresa é obrigatória? Nem sempre. Algumas contas conseguem operar inicialmente sem a verificação completa da empresa. No entanto, em determinados casos a Meta pode solicitar a Business Verification, pedindo documentos da empresa para confirmar sua existência e legitimidade. Empresas verificadas costumam ter maior confiança dentro da plataforma. Eu consigo fazer disparos em massa com a API Oficial? A API permite envio de mensagens em escala utilizando templates aprovados pela Meta. Essas mensagens podem ser usadas para: • campanhas • notificações • comunicações com clientes Atenção: a Meta não permite spam ou envio para contatos que não tiveram relação prévia com a empresa. Boas práticas como consentimento do cliente e segmentação da base são fundamentais. Qual a diferença entre usar o WhatsApp Business normal e a API Oficial? O WhatsApp Business tradicional é um aplicativo de celular, pensado para operações menores. A API Oficial é uma infraestrutura empresarial, que conecta o WhatsApp a sistemas como CRM, automações e plataformas de atendimento. Com a API, você pode ter: • múltiplos atendentes no mesmo número • automações e chatbots • histórico centralizado de conversas • integração com sistemas • envio estruturado de campanhas Dica: se você tem equipe, automação e volume, a API tende a fazer mais sentido. Por que existe um limite de conversas que posso iniciar? A Meta controla o volume de conversas iniciadas pela empresa para proteger a experiência dos usuários e evitar spam. Contas novas normalmente começam com um limite inicial de 1.000 conversas iniciadas por mês, que pode aumentar conforme a conta ganha histórico positivo. Preciso ter um CNPJ para usar a API Oficial? Não necessariamente para iniciar a integração. No entanto, a Meta pode solicitar a verificação da empresa em algum momento. Nesse caso, documentos empresariais podem ser necessários. Empresas com CNPJ e domínio próprio costumam ter um processo de ativação mais estável. Meu template pode ser reprovado? Por quê? Sim. Templates passam por análise da Meta e podem ser reprovados por diversos motivos, como: • categoria incorreta (ex.: marketing classificado como utilidade) • linguagem considerada spam • conteúdo promocional excessivo • tentativa de contornar políticas da plataforma • texto confuso ou incompleto Quando um template é reprovado, basta ajustá-lo e enviá-lo novamente para revisão. Importante: clareza + categoria certa aumentam muito a taxa de aprovação. Por que minha mensagem não foi entregue ao cliente? Existem alguns motivos comuns para uma mensagem não ser entregue: • o cliente bloqueou o número • o número do contato é inválido ou inexistente • o limite de envio da conta foi atingido • o template utilizado foi reprovado ou não aprovado • o cliente não respondeu anteriormente e a janela de 24 horas está fechada Dica: se o chat estiver fora da janela de 24h, você precisa iniciar com um template aprovado. Voltar ao topo ↑
