Skip to main content
Este guia conecta um número do WhatsApp Business ao Spark pela API oficial da Meta. O número continua funcionando no app WhatsApp Business do celular (modo coexistência): você pode responder pelo celular ou pelo Spark, e as duas pontas ficam sincronizadas. O processo tem três partes: preparar a conta na Meta, registrar o número e conectar no Spark. Se a pessoa que vai autorizar o número não usa o painel do Spark, envie a ela um link de conexão.
Você precisa ser administrador da organização no Spark. Se quiser que as conversas novas entrem direto no CRM, crie antes um funil com pelo menos uma etapa.

​
O que você vai precisar

  • Uma conta no Meta Business Suite.
  • Um número de telefone com o app WhatsApp Business instalado no celular. Se o número ainda está no WhatsApp comum, migre para o WhatsApp Business antes de seguir.
  • O celular com esse número por perto, para confirmar códigos e ler o QR code.
  • Pop-ups liberados no navegador para o site do Spark.

​
Parte 1: preparar a conta na Meta

​
Entrar no Meta Business Suite

Acesse o Meta Business Suite e entre ou crie a conta empresarial. Página de login ou cadastro do Meta Business Suite Depois de entrar, você vê a página inicial do portfólio empresarial. Página inicial do Meta Business Suite

​
Preencher e verificar os dados da empresa

Abra Informações da empresa e preencha os dados do negócio. A Meta pode pedir a verificação da empresa (CNPJ, razão social e documentos). A análise costuma levar alguns dias e pode chegar a cerca de duas semanas. Informações da empresa com dados preenchidos e verificação concluída
Se o número aparece no Spark, mas nada é enviado ou recebido, confira se a verificação da empresa está aprovada no portfólio da Meta.

​
Parte 2: registrar o número na Meta

  1. Abra Contas do WhatsApp no Meta Business Suite.
  2. Clique em “Adicionar” e escolha “Vincular uma conta do WhatsApp Business”.
Menu exibido após clicar em Adicionar, na página de contas do WhatsApp
  1. Informe o número de telefone e clique em “Continuar”.
Formulário solicitando o número de telefone para iniciar a conexão
  1. A Meta envia um código de confirmação pelo WhatsApp para esse número. Digite o código na tela.
Tela da Meta solicitando o código de verificação Mensagem do Facebook Business no WhatsApp com o código de verificação Quando o código é aceito, o número fica registrado no portfólio e pode ser conectado ao Spark.

​
Parte 3: conectar no Spark

​
Criar a conexão

  1. No painel do Spark, confira se está na organização certa.
  2. Vá em Configurações → Integrações → WhatsApp Business.
Página de números do WhatsApp Business no Spark
  1. Clique em “Nova conexão”.
  2. Se quiser, escolha o funil e a etapa em que os contatos novos devem entrar. Dá para configurar depois.
  3. Clique em “Conectar com WhatsApp”. Uma janela da Meta abre no navegador.
Diálogo para escolher funil e etapa ao criar nova conexão

​
Concluir na janela da Meta

Leia as informações iniciais e clique em “Continuar”. Primeira etapa do popup de conexão da Meta Selecione o portfólio empresarial em que você registrou o número na Parte 2, escolha “Conectar um app do WhatsApp Business” e clique em “Avançar”. Popup da Meta com seleção de portfólio e conta do WhatsApp Business Informe o mesmo número. A Meta mostra um QR code para confirmar a vinculação pelo app. Popup da Meta com QR Code para confirmar o telefone
Se preferir, clique em “Em vez disso, use um código de acesso”. A Meta envia uma mensagem ao WhatsApp Business com um link de confirmação, o que costuma ser mais simples do que ler o QR code na tela do computador.
No celular, abra a mensagem da Meta e toque em “Conectar”. Mensagem da Meta no WhatsApp com link para confirmar a vinculação Tela que abre ao tocar em Conectar na mensagem da Meta O app pergunta se você quer compartilhar o histórico de conversas. Para ver as conversas antigas no Spark, escolha compartilhar. Veja Importar contatos e histórico abaixo. Opções de compartilhamento do histórico de conversas no WhatsApp Business Confirme no celular. A janela no navegador só avança depois disso. Escolha o fuso horário da operação e confirme o acesso. Popup da Meta solicitando configuração de fuso horário Na última tela, clique em “Concluir”. Não escolha a opção de adicionar forma de pagamento para encerrar o fluxo. Última etapa do popup com opção de concluir a conexão Em alguns segundos a janela fecha e o número aparece na lista de conexões, com o nome verificado na Meta. Pronto: as mensagens desse número já chegam em Chats.

​
Importar contatos e histórico

Logo depois de conectar, o Spark pede à Meta os contatos e o histórico de conversas do app WhatsApp Business. Os nomes salvos na agenda do app passam a ser usados nos contatos do Spark. Na lista de conexões, a coluna “Modo” mostra o andamento: Sobre o histórico importado:
  • Mensagens antigas não disparam automações, follow-ups nem webhooks, e as conversas importadas não contam como oportunidades novas.
  • A Meta só envia arquivos de mídia recentes (até 14 dias). Mídias mais antigas aparecem como “[Mídia não disponível]”.

​
Usar o app e o Spark ao mesmo tempo

  • Mensagens que você envia pelo app no celular aparecem no Spark como enviadas pela empresa.
  • Uma conversa iniciada pelo app cria o contato no Spark, mas não dispara as automações de entrada.
  • Raramente a Meta não repassa uma mensagem ao Spark. Ela aparece como “[Mensagem indisponível no momento. Confira no app WhatsApp Business.]”.

​
Gerenciar a conexão

Pelo menu da linha da conexão você pode:
  • Ver status de saúde: mostra se o número pode enviar e receber mensagens e lista os problemas informados pela Meta.
  • Editar o nome, o funil e a etapa.
  • Configurar ligações, quando habilitadas para a organização. Veja Ligações no WhatsApp.
  • Excluir, com ou sem migração das conversas. Veja Excluir uma conexão.
Se a conexão mostrar o aviso “Desconectado”, a Meta informou que o número saiu do Spark (por exemplo, foi desvinculado pelo app ou registrado de novo). Clique em “Nova conexão” e conecte o mesmo número para voltar a enviar mensagens.

​
Problemas comuns

O número está conectado a outra organização do Spark. Peça a um administrador dela para excluir a conexão em Configurações → Integrações → WhatsApp Business e tente de novo.
A conta do WhatsApp autorizada não tem exatamente um número. Conecte de novo e, na janela da Meta, escolha o número desejado.
A janela da Meta tem tempo limite (cerca de 5 minutos no Spark). Feche tudo e comece de novo em “Nova conexão”.
Essa não é a conclusão do fluxo de conexão. Repita o processo e, na última etapa, clique em “Concluir”.
Confira se a verificação da empresa está aprovada em Informações da empresa e se o número aparece como Online em Contas do WhatsApp. Use também “Ver status de saúde” no Spark.

​
Janela de 24 horas e campanhas

Pela API oficial, você responde livremente até 24 horas depois da última mensagem do cliente. Fora dessa janela, só é possível enviar modelos oficiais aprovados pela Meta. Para disparos em massa você também precisa cadastrar uma forma de pagamento na Meta, porque o WhatsApp cobra por mensagens de modelo. Veja Modelos de mensagem e Disparos.

​
Próximos passos