> ## Documentation Index > Fetch the complete documentation index at: https://docs.crmspark.com.br/llms.txt > Use this file to discover all available pages before exploring further. # WhatsApp Business (API oficial) > Prepare a conta na Meta, conecte o número ao Spark mantendo o app WhatsApp Business no celular e importe contatos e histórico de conversas. 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](https://docs.crmspark.com.br/canais/conexao-por-link.md). > [!NOTE] > > 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](https://docs.crmspark.com.br/conceitos/funis-e-etapas.md). ## O que você vai precisar * Uma conta no [Meta Business Suite](https://business.facebook.com/latest/home). * 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](https://business.facebook.com/latest/home) e entre ou crie a conta empresarial. ![Página de login ou cadastro do Meta Business Suite](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-business-suite-login.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=513731bb44f82221b8dd6e7f4e489f9e) Depois de entrar, você vê a página inicial do portfólio empresarial. ![Página inicial do Meta Business Suite](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-business-suite-home.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=8aae99ad4c6abb040cbe49ca31165de9) ### Preencher e verificar os dados da empresa Abra [Informações da empresa](https://business.facebook.com/latest/settings/business_info) 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](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-business-portfolio-info-verified.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=b3061e986e2fb124b5d841242c430954) > [!WARNING] > > 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](https://business.facebook.com/latest/settings/whatsapp_account) 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](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-whatsapp-accounts-add-menu.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=1f5c4bec435107fa4117fbaa10881c3c) 3. Informe o número de telefone e clique em "Continuar". ![Formulário solicitando o número de telefone para iniciar a conexão](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-whatsapp-link-business-phone-prompt.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=81ed7d1249721908f623f035e5aa1ae2) 4. 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](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-whatsapp-verification-code-form.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=946dd16816469a973625e9e8a4e4f41e) ![Mensagem do Facebook Business no WhatsApp com o código de verificação](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-whatsapp-verification-code-in-app.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=348d0a7287972426bb7d9a317332126f) 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](https://crmspark.com.br/dash), confira se está na organização certa. 2. Vá em [Configurações → Integrações → WhatsApp Business](https://crmspark.com.br/dash/settings/integrations/whatsapp). ![Página de números do WhatsApp Business no Spark](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/spark-whatsapp-integrations-list.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=2d7620c8507d963be5b50cd614101911) 3. Clique em "Nova conexão". 4. Se quiser, escolha o funil e a etapa em que os contatos novos devem entrar. Dá para configurar depois. 5. Clique em "Conectar com WhatsApp". Uma janela da Meta abre no navegador. ![Diálogo para escolher funil e etapa ao criar nova conexão](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/spark-whatsapp-new-connection-funnel-step.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=ae28d47975749e042456d9afa8bcf152) ### Concluir na janela da Meta Leia as informações iniciais e clique em "Continuar". ![Primeira etapa do popup de conexão da Meta](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-embedded-signup-welcome.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=eeca1067e24bdb020938f13a11c5a6fe) 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](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-embedded-signup-select-portfolio.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=cfed828c25c5edd0e7d0873a8260e12d) 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](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-embedded-signup-qr-or-access-code.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=a3220b0d37cebe75bf213342fd7bd9f6) > [!TIP] > > 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](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-whatsapp-spark-link-message.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=dbbbf536cd647ebf5d6480ba8b0eaed4) ![Tela que abre ao tocar em Conectar na mensagem da Meta](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-whatsapp-spark-connect-from-message.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=a99a9dd15fc745de1ac65f39ea9cd769) 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](#importar-contatos-e-histórico) abaixo. ![Opções de compartilhamento do histórico de conversas no WhatsApp Business](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-whatsapp-chat-history-sharing-choice.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=2746d8cd0269bca9a04f3126c66203d2) 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](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-embedded-signup-timezone.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=3ecbd5e4ff4f6bfe18010a420e026846) 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](https://mintcdn.com/linksolues/qj8tongQjw4Htel8/images/guia/conectar-whatsapp-business/meta-embedded-signup-complete-finish.png?fit=max\&auto=format\&n=qj8tongQjw4Htel8\&q=85\&s=f9e744a2e853fa788fca5fc085c3fd3f) 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](https://crmspark.com.br/dash/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: | Aviso | O que significa | | - | - | | Importando histórico | As conversas antigas estão chegando. Pode levar alguns minutos. | | Histórico importado | Terminou. O aviso mostra quantas conversas e mensagens vieram. | | Histórico não compartilhado | O compartilhamento foi recusado no app. As mensagens novas continuam sendo registradas normalmente. | | Histórico indisponível | Passou o prazo. A Meta só permite importar até 24 horas depois da conexão. Para tentar de novo, exclua e conecte o número outra vez. | 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](https://docs.crmspark.com.br/canais/ligacoes-whatsapp.md). * Excluir, com ou sem migração das conversas. Veja [Excluir uma conexão](https://docs.crmspark.com.br/canais/visao-geral.md#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 > **Este número já está em outra organização** > > 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](https://crmspark.com.br/dash/settings/integrations/whatsapp) e tente de novo. > **Não identificamos o número** > > 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. > **Processo de conexão expirou ou foi cancelado** > > A janela da Meta tem tempo limite (cerca de 5 minutos no Spark). Feche tudo e comece de novo em "Nova conexão". > **Terminei em Adicionar forma de pagamento e o número não apareceu** > > Essa não é a conclusão do fluxo de conexão. Repita o processo e, na última etapa, clique em "Concluir". > **O número aparece conectado, mas não envia nem recebe** > > Confira se a verificação da empresa está aprovada em [Informações da empresa](https://business.facebook.com/latest/settings/business_info) e se o número aparece como Online em [Contas do WhatsApp](https://business.facebook.com/latest/settings/whatsapp_account). 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](https://docs.crmspark.com.br/conceitos/modelos-de-mensagem.md) e [Disparos](https://docs.crmspark.com.br/conceitos/disparos.md). ## Próximos passos * [Receber chats, distribuir e filtrar](https://docs.crmspark.com.br/guia/atendimento-distribuicao-filtros.md) * [Atender pelo chat](https://docs.crmspark.com.br/guia/atender-pelo-chat.md) * [Ligações no WhatsApp](https://docs.crmspark.com.br/canais/ligacoes-whatsapp.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.