Central de Ajuda Quaza Provedores

Guia de ativação da API Oficial do WhatsApp (passo a passo do provedor) (PT)

Guia de ativação da API Oficial do WhatsApp (passo a passo do provedor) — Quaza

Guia de ativação da API Oficial do WhatsApp

Como criar e ativar sua conta na API Oficial do WhatsApp pela plataforma Quaza — que é BSP homologado pela Meta e cuida de toda a parte técnica. Este guia mostra o que reunir antes de começar e o passo a passo completo, do Meta Business Manager até o número pronto para enviar e receber mensagens.

Resumo: a Quaza realiza a integração técnica (Embedded Signup, webhook e Cloud API) sem que você precise acessar nenhum painel de desenvolvedor da Meta. Sua parte é reunir os pré-requisitos, criar a conta no Meta Business, preparar o número e autorizar o acesso. O processo leva de poucos minutos a alguns dias úteis, dependendo da análise da Meta.
Nesta wiki:

Quando usar a API Oficial (e quando NÃO)

A API Oficial do WhatsApp (Cloud API da Meta) é o canal homologado para o provedor se comunicar com os clientes em escala — enviar fatura, aviso de vencimento, código de aceite de contrato e atender pelo chat — com número verificado e sem risco de bloqueio por uso indevido.

Use a API Oficial quando… NÃO é o caminho quando…
Você quer enviar mensagens automáticas (fatura, cobrança, aceite) com número estável e verificado pela Meta. Você só quer testar o chat rapidamente — para isso existe a integração não-oficial (ZApi), configurada em outra tela.
Precisa de limites altos de envio e templates aprovados oficialmente. O número que pretende usar já é o WhatsApp pessoal do escritório e não pode perder o histórico.
Quer reduzir o custo de SMS substituindo por mensagens de WhatsApp. A empresa ainda não tem CNPJ ativo, site próprio ou documentação regular (a Meta reprova).

Antes de começar — o que reunir

Reúna todos os itens abaixo antes de iniciar o processo. Os marcados como OBRIGATÓRIO bloqueiam a ativação se estiverem ausentes. O gargalo número 1 de reprovações é o site da empresa.

1. Conta pessoal no Facebook do responsável

Status Requisito e orientação
OBRIGATÓRIO Perfil pessoal no Facebook ativo. O Business Manager exige uma conta pessoal para autenticação — não é possível criar sem ela. Os dados pessoais não aparecem para os clientes da empresa.
ATENÇÃO Conta com pelo menos 30 dias de uso e alguma atividade. Perfis muito novos ou sem atividade são bloqueados ao criar o Business Manager. Se necessário, use o perfil de um sócio.

2. Dados da empresa — CNPJ e documentação

Status Requisito e orientação
OBRIGATÓRIO CNPJ ativo e regular na Receita Federal. A situação cadastral precisa estar "Ativa". CNPJ com pendências, suspenso ou em baixa é reprovado.
OBRIGATÓRIO Razão social idêntica em todos os documentos e no Business Manager. Um espaço, ponto ou abreviação diferente já causa reprovação. Ex.: "Provedor Internet Ltda" ≠ "Provedor Internet LTDA".
OBRIGATÓRIO Contrato social, certificado MEI ou comprovante de constituição. Arquivo nítido, sem cortes e sem marca-d'água. Fotos borradas são reprovadas automaticamente.
OBRIGATÓRIO Comprovante de endereço da empresa emitido nos últimos 3 meses. Conta de luz, água ou telefone em nome da empresa (não do sócio pessoa física), com o mesmo endereço do contrato social.

3. Site da empresa — causa nº 1 de reprovações

Status Requisito e orientação
OBRIGATÓRIO Site no ar com HTTPS ativo (cadeado no navegador). Sites sem HTTPS são reprovados na verificação de domínio.
OBRIGATÓRIO Razão social completa e CNPJ visíveis no rodapé do site. A Meta compara o conteúdo do site com os documentos. O rodapé deve trazer razão social + CNPJ + endereço + telefone, exatamente como na Receita.
OBRIGATÓRIO Domínio próprio registrado (ex.: provedorxyz.com.br). Sites em subdomínios gratuitos têm baixíssima taxa de aprovação.
OBRIGATÓRIO Página de Política de Privacidade publicada e acessível no site. Exigência da Meta + LGPD.
ATENÇÃO E-mail corporativo com domínio próprio (ex.: contato@provedorxyz.com.br). Contas Gmail/Hotmail enfraquecem o processo.

4. Número de telefone exclusivo

Status Requisito e orientação
OBRIGATÓRIO Número NÃO cadastrado em nenhum app WhatsApp (nem pessoal, nem Business). Se já estiver em uso, é preciso excluir a conta dentro do app antes de prosseguir — e isso apaga todo o histórico de conversas.
OBRIGATÓRIO Número capaz de receber SMS ou chamada de voz. O código de verificação de 6 dígitos chega por SMS ou ligação. Se for número fixo, não pode ter URA ou gravação ativa no momento da ativação — a linha precisa atender a ligação da Meta.
OK Pode ser número brasileiro fixo, celular ou virtual, de qualquer operadora. Após a ativação, o número fica vinculado exclusivamente ao chat da Quaza e deixa de receber chamadas via WhatsApp (apenas ligações normais da operadora).

5. Cartão de crédito para pagamento das mensagens à Meta

Status Requisito e orientação
OBRIGATÓRIO Cartão Visa ou Mastercard com função internacional ativa. A Meta só aceita Visa ou Mastercard — Elo, Hipercard, American Express e cartões de débito não são aceitos.
ATENÇÃO A cobrança é feita em dólar (USD), direto pela Meta. A fatura chega em USD e o banco converte pela cotação do dia mais IOF. Ao adicionar o cartão, a Meta pode fazer uma transação de teste simbólica que fica bloqueada por até 48h.
O gargalo mais comum é o site: razão social diferente da Receita, CNPJ ausente no rodapé ou domínio sem HTTPS causam a maioria das reprovações. Verifique isso antes de enviar os documentos.

Visão geral do processo

Depois de reunir os pré-requisitos, a ativação segue as etapas abaixo. A Quaza é BSP homologado pela Meta e executa a parte técnica; ao cliente cabem o cadastro, a documentação e a autorização.

# Etapa Responsável Tempo estimado
1 Criar conta no Meta Business Manager Cliente ~10 min
2 Verificação de negócio (envio de documentos) Cliente 3 a 10 dias úteis
3 Preparar o número de telefone Cliente ~5 min
4 Conectar o número ao Quaza (Embedded Signup) Quaza + Cliente ~5 min
5 Cadastro e aprovação dos templates Ambos 24 a 48h
6 Conta ativa — cartão e configurações finais Ambos Imediato

Passo a passo da ativação

1Criar conta no Meta Business Manager

O Meta Business Manager é o painel central onde ficam todos os ativos de negócio da empresa na Meta. É o ponto de partida obrigatório.

  1. Acesse business.facebook.com e faça login com a conta de administrador (preferencialmente o Facebook corporativo).
  2. Clique em Criar conta e preencha o nome do negócio (a razão social exata), seu nome completo e o e-mail corporativo.
  3. Ao criar a conta do WhatsApp Business, defina o Nome de exibição — é o nome que aparecerá para os clientes. Ele deve coincidir com a razão social e o domínio do site, e não pode conter a palavra "WhatsApp" nem marcas de terceiros.
  4. Ative a autenticação em dois fatores (2FA) quando solicitado — é obrigatória.
Menu Adicionar com a opção Criar nova conta do WhatsApp

No Meta Business, em Configurações do negócio → Contas do WhatsApp, use Adicionar → "Criar nova conta do WhatsApp".

Tela Criar uma conta do WhatsApp Business com o campo Nome de exibição

Tela "Criar uma conta do WhatsApp Business": o campo Nome de exibição deve trazer o nome comercial da empresa.

O nome do negócio e o Nome de exibição devem ser idênticos à razão social dos documentos. Discrepâncias causam reprovação na etapa de verificação.

2Verificação de negócio

A verificação de negócio é o que libera os limites de envio. Sem ela, a conta opera em modo restrito (250 conversas por dia).

Business Manager → Configurações do negócio → Central de Segurança → Iniciar verificação
  1. Informe CNPJ, razão social, endereço, site e telefone comercial — exatamente como nos documentos.
  2. Envie os documentos sociais (contrato social ou equivalente) quando solicitado.
  3. Aguarde a análise da Meta (de 2 a 10 dias úteis, conforme o caso).
Central de Segurança do Meta Business mostrando a empresa verificada

Central de Segurança: quando a verificação é concluída, a empresa aparece como "Verificada".

Depois de verificada, a conta sobe de limite de envio conforme o volume e a qualidade das mensagens — a Meta promove os níveis automaticamente:

Nível Requisito Limite por dia
Tier 0 Sem verificação 250 conversas
Tier 1 Negócio verificado 1.000 conversas
Tier 2 Tier 1 + volume 10.000 conversas
Tier 3 Tier 2 + volume Ilimitado

3Preparar o número de telefone

O número usado na API precisa ser exclusivo — não pode estar ativo em nenhum aplicativo WhatsApp (pessoal ou Business).

  1. Verifique se o número já está cadastrado em algum app WhatsApp.
  2. Se estiver, faça backup das conversas (Configurações → Conversas → Backup) e exclua a conta dentro do app (Configurações → Conta → Excluir minha conta).
Tela do app WhatsApp para apagar a conta do número

No app, em Configurações → Conta → Apagar minha conta: é preciso liberar o número antes da ativação.

Atenção: excluir a conta do app WhatsApp apaga permanentemente todo o histórico de conversas daquele número. Faça o backup antes.

4Conectar o número ao Quaza (Embedded Signup)

Esta é a etapa técnica, feita pela Quaza dentro do próprio sistema. O cliente apenas autoriza o acesso pelo fluxo oficial da Meta (Embedded Signup) — não precisa acessar nenhum painel de desenvolvedor.

Comunicação → Configuração de WhatsApp → Adicionar configuração
  1. Crie uma configuração com uma Descrição e o Número que será usado.
  2. No campo Integração, selecione "Meta business" e deixe a Situação como Habilitado.
  3. Clique em "Conectar com Facebook Business". Abre o login da Meta (com a conta de administrador, pessoa física) e, em seguida, o popup de autorização.
  4. Confirme as permissões. Se a conta tiver mais de um número, o Quaza pergunta "Selecione o número que deseja utilizar" → clique em Confirmar.
Tela do Quaza Adicionar whatsApp configuração com Integração Meta business

No Quaza, a configuração com Integração = "Meta business"; os campos Número Telefone API ID e Token são preenchidos sozinhos após a conexão.

Popup de autorização Embedded Signup conectando a conta à Quaza

Popup da Meta (Embedded Signup): o cliente confirma e autoriza o acesso da Quaza.

Ao confirmar, o Quaza preenche automaticamente os dados de integração (API ID e Token) e configura o webhook. Aparece a mensagem "Conexão com Facebook Business aplicada!" e o número fica pronto. O cliente não precisa acessar nenhum painel técnico da Meta.

5Cadastro e aprovação dos templates

Com o número ativo, as mensagens enviadas fora da janela de 24h precisam usar templates (modelos) aprovados pela Meta. O prazo de aprovação é de 24 a 48h.

WhatsApp Manager com a lista de modelos de mensagem em análise

Gerenciador do WhatsApp → Modelos de mensagem: cada template entra "Em análise" até a Meta aprovar.

Ao criar o template, selecione manualmente a categoria "Utilitários" (a Meta costuma pré-selecionar "Marketing"). Templates de Marketing têm custo maior e exigem opt-in explícito do contato.

O passo a passo detalhado de criação e importação de templates está na wiki própria — veja Cadastro e importação de templates (WhatsApp Meta Business) .

6Conta ativa — cartão e configurações finais

Com o número ativo e os templates aprovados, falta cadastrar o cartão de crédito que paga as mensagens à Meta.

Business Manager → Configurações do negócio → Contas do WhatsApp → Configurações de pagamento
  1. Em Adicionar forma de pagamento, selecione a moeda Dólar americano (USD) — a Meta converte para reais na fatura.
  2. Insira os dados do cartão Visa ou Mastercard e salve.
Janela Adicionar dados de pagamento com moeda em dólar

Adicionar dados de pagamento: selecione a localização e a moeda (Dólar americano) antes de inserir o cartão.

Resumo da conta no Meta Business com verificação e status aprovado

Resumo da conta: com a empresa "Verificada" e o status "Aprovada", o número já pode enviar e receber mensagens.

Sem cartão cadastrado, os templates não são disparados fora da janela de 24h. Cadastre o cartão antes dos primeiros envios.
Conta ativa! O número já envia e recebe mensagens pela API Oficial. A partir daqui o atendimento e os envios acontecem pelo chat e pelos disparos do Quaza.

Fluxo — quem faz o quê

O processo envolve três atores: o cliente (provedor), a Quaza (BSP) e a Meta. O diagrama abaixo mostra a ordem das etapas e de quem é cada uma.

CLIENTE (provedor) QUAZA (BSP) META 1 Cria conta no BusinessManager + Nome de exibição 2 Envia documentos paraverificação de negócio Analisa e verifica3 a 10 dias úteis 3 Libera o número(remove de apps WhatsApp) 4 Abre o Embedded Signupem Configuração WhatsApp Autoriza o acessoe escolhe o número 5 Configura webhook eCloud API (automático) Verifica númeropor SMS / ligação 6 Cadastra templatescategoria Utilitários Aprova templates24 a 48h 7 Cadastra cartãoVisa/Master em USD Conta ativaenvia e recebe mensagens

Glossário

Termo O que é
Meta Business Manager Painel central da Meta (business.facebook.com) onde ficam os ativos de negócio da empresa: contas do WhatsApp, verificação, pagamentos.
BSP Business Solution Provider — parceiro homologado pela Meta para integrar empresas à API Oficial. A Quaza é BSP.
API Oficial / Cloud API A interface oficial do WhatsApp para enviar e receber mensagens de forma programática, hospedada pela Meta.
Embedded Signup Fluxo oficial da Meta em que o cliente autoriza o BSP a configurar a conta, sem precisar mexer em tokens manualmente.
WABA WhatsApp Business Account — a conta de WhatsApp da empresa dentro da Meta, que agrupa os números.
Nome de exibição O nome que aparece para os clientes nas conversas. Passa por aprovação da Meta e deve refletir a empresa.
Template (modelo) Mensagem pré-aprovada pela Meta, obrigatória para iniciar conversa fora da janela de 24h. Tem categoria (Utilitários ou Marketing).
Janela de 24h Período após a última mensagem do cliente em que a empresa pode responder livremente. Fora dela, só com template.
Verificação de negócio Análise da Meta que confirma que a empresa existe e libera os limites de envio (sair do modo restrito de 250 conversas/dia).
Tier Nível de limite de mensagens por dia. Sobe automaticamente conforme volume e qualidade.

Pegadinhas frequentes

  1. Site fora do padrão. Razão social diferente da Receita, CNPJ ausente no rodapé ou domínio sem HTTPS — causa nº 1 de reprovação. Ajuste o site antes de enviar documentos.
  2. Razão social com diferença mínima. Um ponto, espaço ou abreviação diferente entre o Business Manager e os documentos já reprova a verificação.
  3. Número ainda ativo num WhatsApp. Se o número estiver em qualquer app WhatsApp, é preciso excluir a conta primeiro — e isso apaga o histórico. Faça backup antes.
  4. Número fixo com URA ou gravação. A linha precisa atender a ligação de verificação da Meta; URA/gravação impedem o código de chegar.
  5. Cartão não aceito. Só Visa ou Mastercard com função internacional. Elo, Amex, Hipercard e débito são recusados. A cobrança vem em dólar.
  6. Template criado como "Marketing". A Meta pré-seleciona Marketing; selecione "Utilitários" manualmente para evitar custo maior e exigência de opt-in.
  7. Sem cartão cadastrado. Os templates não disparam fora da janela de 24h enquanto não houver forma de pagamento na conta.
  8. Nome de exibição com "WhatsApp" ou marca de terceiros. É reprovado pela Meta. Use o nome comercial da empresa.

Perguntas frequentes

Quanto tempo leva a ativação completa?

A parte técnica (passo 4) leva minutos. O que demora é a verificação de negócio da Meta — de 3 a 10 dias úteis — e a aprovação dos templates (24 a 48h). Reunir os documentos certos de antemão é o que mais acelera.

Preciso acessar algum painel de desenvolvedor da Meta?

Não. A Quaza, como BSP, faz toda a parte técnica pelo Embedded Signup. Você só autoriza o acesso pelo popup oficial da Meta dentro do Quaza.

Posso usar o WhatsApp da empresa que já uso no celular?

Só se você liberar o número antes — excluindo a conta dentro do app, o que apaga o histórico. O ideal é usar um número exclusivo para a API.

Posso usar número fixo?

Sim, desde que ele receba SMS ou ligação e não tenha URA/gravação ativa no momento da verificação, pois a Meta envia um código de 6 dígitos por ligação.

Quanto custa por mensagem?

A Meta cobra por conversa, em dólar, conforme a categoria. Mensagens utilitárias são mais baratas que as de marketing, e respostas dentro da janela de 24h são gratuitas. Os valores e a tabela oficial são definidos pela Meta.

Por que minha verificação foi reprovada?

Na maioria dos casos é o site: sem HTTPS, sem razão social/CNPJ no rodapé, ou domínio gratuito. Também reprova quando a razão social no Business Manager difere da Receita. Ajuste e tente de novo.

O que é a janela de 24h?

É o período após a última mensagem do cliente em que a empresa pode responder livremente. Passado esse tempo, só é possível iniciar contato com um template aprovado.

Qual a diferença entre template Utilitário e Marketing?

Utilitário é para mensagens transacionais (fatura, aviso de vencimento, aceite) — mais barato. Marketing é para promoção e exige opt-in do contato, com custo maior.

Onde cadastro o número depois de verificado?

Em Comunicação → Configuração de WhatsApp, criando uma configuração com Integração "Meta business" e clicando em "Conectar com Facebook Business".

O número vai continuar recebendo ligações de WhatsApp?

Não. Após a ativação, o número fica vinculado exclusivamente ao chat da Quaza e não recebe mais chamadas via WhatsApp — apenas ligações normais da operadora.

E se a conexão automática com o Facebook Business não funcionar?

Refaça o passo "Conectar com Facebook Business" com a conta de administrador (pessoa física). Se persistir, abra um chamado no Suporte Quaza com o print do erro.

Documentos relacionados