Este guia explica como conectar um número do WhatsApp Business pela API oficial da Meta ao Spark. O fluxo tem duas partes: preparar sua conta na Meta e, em seguida, vincular o número no painel do Spark.
O que você vai precisar
- Conta no Meta Business Suite (crie uma se ainda não tiver).
- Um número de telefone válido (chip ou número digital).
- O app WhatsApp Business instalado no celular desse número (método de coexistência — você continua usando o app no telefone e o Spark no computador).
- Acesso de administrador à organização no Spark.
Se o número ainda estiver no WhatsApp comum (pessoal), migre para o WhatsApp Business no celular antes de seguir.
Acesse business.facebook.com e faça login ou crie sua conta empresarial.
Após entrar, você verá a página inicial do portfólio empresarial:
1.2 Preencher e verificar os dados da empresa
Abra Informações da empresa e preencha os dados do negócio.
- Se o portfólio for novo, complete todos os campos obrigatórios.
- A Meta pode pedir verificação da empresa (CNPJ, razão social, enquadramento etc.). O prazo costuma ser de alguns dias e pode chegar a cerca de duas semanas.
- Em alguns casos a Meta libera o uso sem verificação obrigatória imediata.
Se o número aparecer no Spark mas nada enviar ou receber, confira se a verificação da empresa está aprovada no portfólio da Meta.
2.1 Abrir o gerenciador de contas do WhatsApp
Acesse Contas do WhatsApp no Meta Business Suite. Nessa página você vê os números já vinculados ao portfólio e gerencia pagamentos e configurações avançadas.
2.2 Vincular uma conta do WhatsApp Business (coexistência)
- Clique em Adicionar.
- Escolha Vincular uma conta do WhatsApp Business.
- Informe o número de telefone (com o celular por perto — você vai precisar dele nas próximas etapas).
- Clique em Continuar.
- A Meta envia um código de confirmação por WhatsApp para esse número. Digite o código na tela da Meta.
Quando o código for aceito, o número fica registrado no seu portfólio comercial. A partir daí você pode vinculá-lo ao Spark.
Parte 3 — Conectar o número no Spark
3.1 Abrir a integração de WhatsApp Business
- Entre no painel do Spark na organização correta.
- Vá em Configurações → Integrações → WhatsApp Business.
3.2 Criar uma nova conexão
- Clique em Nova conexão.
- (Opcional) Escolha o funil e a etapa em que novos contatos que mandarem mensagem devem entrar. Você pode pular essa etapa e configurar depois.
- Clique em Conectar com WhatsApp.
Um popup oficial da Meta abrirá no navegador.
Etapa inicial — leia as informações e clique em Continuar.
Portfólio e conta — selecione o portfólio empresarial em que você registrou o número na Parte 2. Em seguida, escolha Conectar um app do WhatsApp Business e clique em Avançar.
Número — informe o mesmo número cadastrado na Meta. Nas etapas seguintes aparecerá um QR Code para confirmar a vinculação.
Se preferir, use Em vez disso, use um código de acesso no popup. A Meta envia uma mensagem ao WhatsApp Business com um link ou código — costuma ser mais simples do que escanear o QR no computador.
Histórico de conversas — a Meta pergunta se deseja compartilhar conversas antigas. O Spark não importa mensagens anteriores à conexão; só sincroniza o que acontece depois que o número entra na organização. Recomendamos Não compartilhar conversas para evitar confusão.
Confirme a conexão no app (código ou QR Code, conforme a opção escolhida). O popup no navegador só avança quando você terminar no celular.
Fuso horário — escolha o fuso da sua operação e confirme a concessão de acesso.
Finalizar — na última tela, clique em Concluir (não escolha “Gerenciar pagamentos” para encerrar o fluxo de conexão com o Spark).
Em alguns segundos o popup fecha e o número aparece na tabela de conexões do Spark. Pronto: você já pode receber e enviar mensagens desse número pelo Inbox.
Problemas comuns
O fluxo expirou ou o número não apareceu na tabela
O popup da Meta tem tempo limite. Se demorar demais, feche tudo e comece de novo em Nova conexão → Conectar com WhatsApp.
Essa não é a conclusão correta para vincular ao Spark. Repita o processo e, na última etapa, escolha Concluir.
O número aparece conectado, mas não envia nem recebe mensagens
- Confira se a verificação da empresa está aprovada em Informações da empresa na Meta.
- Em Contas do WhatsApp, veja se o número está Online. Se estiver offline, remova a conexão no Spark e vincule de novo.
Quero fazer disparos em massa
Conectar o número é só o primeiro passo. Para campanhas pelo WhatsApp Business você também precisa:
- cadastrar forma de pagamento na Meta (cobrança de conversas pela API);
- ter modelos de mensagem aprovados pela Meta quando a conversa estiver fora da janela de 24 horas.
No Spark, use Disparos e Modelos de mensagem — incluindo variáveis manuais e automáticas no texto do modelo. Se o menu de disparos não estiver disponível na sua organização, fale com quem administra a conta no Spark.
Próximos passos
