WhatsApp Business API

Como conectar e configurar a API oficial do WhatsApp em minutos

Como conectar e configurar a API oficial do WhatsApp em minutos

A parte que trava a maioria das pessoas não é técnica, é o medo de perder a conta. Quando alguém nos procura querendo saber como conectar e configurar a API oficial do WhatsApp, a primeira pergunta quase sempre é: "vou perder minhas conversas?". Não. Com coexistência, o mesmo número continua funcionando no app do celular e passa a funcionar também pela API, ao mesmo tempo, sem apagar nada.

Isso muda todo o jogo. Você não precisa avisar cliente que "trocou de número", não perde histórico e não fica sem WhatsApp durante a migração. Vamos ao passo a passo de verdade, incluindo os pontos onde as pessoas costumam tropeçar.

Antes de conectar: o que você precisa em mãos

A configuração em si leva minutos. O que atrasa é chegar sem o básico preparado. Tenha à mão:

  • Um número de telefone com acesso ao celular (para receber o código de verificação). Pode ser o número que você já usa no WhatsApp Business.
  • Acesso a uma conta do Facebook/Meta que será o dono do Gerenciador de Negócios (ou uma conta de negócios já existente).
  • Dados da empresa: razão social, CNPJ e nome que aparecerá para o cliente.
  • Um cartão de crédito da empresa para cadastrar na conta da Meta (é a Meta quem cobra as conversas, não a covercut).

Uma coisa que vale deixar clara logo de cara: na covercut você não cria app na Meta nem mexe em painel de desenvolvedor. O processo de conexão (o Embedded Signup oficial da Meta) acontece direto pela plataforma, porque a covercut é parceira Meta para WhatsApp. Você clica, autoriza e pronto.

Coexistência: por que ela resolve o maior medo

Historicamente, migrar um número para a API significava perder o uso dele no app comum. Quem dependia do celular para responder no balcão travava por causa disso.

Com o modo de coexistência, o número continua ativo no app do WhatsApp Business no celular e, ao mesmo tempo, conectado à API oficial. Você atende manualmente pelo celular quando quiser e usa automação, integração e múltiplos atendentes pela API quando precisar. As conversas iniciadas pelo próprio celular, aliás, não têm custo.

Segundo a covercut, BSP oficial do WhatsApp, a coexistência é o que permite conectar a API sem apagar a conta, sem desinstalar o app e sem perder o histórico de conversas do número.

Um detalhe prático: a API oficial não tem um aplicativo de conversa próprio. Ela recebe e envia mensagens por integração. Ou seja, para operar de fato você vai plugar a API a uma plataforma de atendimento (como o Chatwoot) ou ao seu sistema via API REST. A coexistência não substitui isso, ela só garante que o celular continue funcionando em paralelo.

O passo a passo de conexão

1. Inicie a conexão pela plataforma

Dentro da covercut você aciona o fluxo de conexão. Ele abre o Embedded Signup, a tela oficial da Meta. É aqui que você faz login com a conta do Facebook que vai administrar o número e seleciona (ou cria) o Gerenciador de Negócios da empresa.

2. Escolha o número e o modo de coexistência

Você informa o número que quer conectar. Se ele já roda no app WhatsApp Business, o próprio fluxo oferece a coexistência. Confirme os dados do perfil comercial: nome de exibição, categoria e descrição. O nome de exibição segue regras da Meta, então evite algo que pareça enganoso ou que só repita palavras genéricas.

3. Verifique o número

A Meta envia um código por SMS ou ligação. Você digita o código e o número é vinculado à sua conta de WhatsApp Business na plataforma. Nesse ponto, o número já está tecnicamente na API.

4. Cadastre a forma de pagamento na Meta

Esse é o passo que muita gente esquece e depois descobre que o envio ativo não funciona. A cobrança das conversas é feita pela Meta, direto no cartão que você cadastra na conta da Meta. A covercut não cobra por mensagem, conversa ou template, e não repassa nada disso: a mensalidade da covercut é fixa, pela plataforma, conexão e suporte. A conta de conversas é entre você e a Meta.

5. Conecte a API à sua ferramenta de atendimento

Com o número ativo, o último passo é ligar a API a onde os atendentes vão trabalhar. Na prática, isso é apontar a integração para o Chatwoot ou para o seu CRM/sistema. É aqui que a operação ganha múltiplos atendentes, histórico centralizado e automações.

Configuração pós-conexão: o que faz o número não cair

Conectar é rápido. Manter o número saudável é onde mora o trabalho. Alguns ajustes que recomendamos fazer logo no início:

Faça a verificação da empresa

A Business Verification no Gerenciador de Negócios da Meta é o que destrava limites maiores de conversas iniciadas pela empresa. Quanto antes você enviar os documentos, antes sai da faixa inicial mais restrita. Deixe isso na fila logo no primeiro dia.

Entenda os limites e a qualidade

A Meta trabalha com tiers de mensagens: um teto diário de conversas iniciadas pela empresa que sobe conforme volume consistente, verificação e qualidade do número. Os patamares mudam com o tempo, então não vale decorar número: vale entender que o limite cresce com bom comportamento.

A qualidade do número é classificada em três faixas: alta (verde), média (amarela) e baixa (vermelha). Na prática, o que mais derruba a qualidade é disparar para gente que não pediu contato e mandar conteúdo que o usuário marca como bloqueio ou spam. Qualidade baixa reduz limites e pode restringir o número.

Cadastre e envie templates para aprovação

Toda mensagem que a empresa inicia fora da janela de 24 horas precisa de um template aprovado pela Meta. As categorias hoje são marketing, utilidade (utility) e autenticação. Quando um cliente nos chega com template rejeitado, quase sempre é por dois motivos: escolheu a categoria errada (mandou promoção como utilidade) ou escreveu um texto vago demais nas variáveis. Seja claro sobre o que a mensagem faz e classifique certo.

Respeite a janela de 24 horas e o opt-in

Depois que o cliente te envia uma mensagem, você tem 24 horas para responder livremente, com texto normal, sem template. Passou disso, só com template. E para iniciar conversa com alguém você precisa de opt-in, o consentimento da pessoa em receber suas mensagens. Isso não é burocracia: é o que segura a qualidade lá em cima.

Erros comuns que atrasam a ativação

  • Usar conta pessoal do Facebook sem Gerenciador de Negócios. Organize o Business Manager antes; é ele que abriga tudo.
  • Deixar o pagamento da Meta para depois. Sem cartão cadastrado na Meta, o envio ativo não sai.
  • Esperar um "app da API". Não existe. A API precisa estar conectada a uma plataforma de atendimento para virar operação de verdade.
  • Começar disparando marketing em massa. Número novo, com pouca reputação e teto baixo, é o cenário perfeito para cair de qualidade logo na primeira semana.

O caminho mais seguro é conectar com coexistência, verificar a empresa, subir poucos templates bem categorizados e crescer o volume de forma gradual. Se você já tem o número e o cartão da Meta em mãos, a conexão em si é questão de minutos no fluxo oficial. O próximo passo concreto é iniciar a conexão pela covercut e deixar a verificação de empresa rodando em paralelo, para não perder tempo esperando os limites subirem depois.

Perguntas frequentes

Preciso apagar minha conta do WhatsApp Business para usar a API oficial?

Não. Com o modo de coexistência, o mesmo número continua funcionando no app do celular e passa a funcionar também pela API, ao mesmo tempo. Você não desinstala o app nem perde o histórico de conversas.

Quanto tempo leva para conectar e configurar a API oficial do WhatsApp?

A conexão em si leva minutos pelo fluxo oficial da Meta (Embedded Signup) dentro da covercut, desde que você já tenha o número, a conta de negócios e o cartão em mãos. O que pode demorar é a verificação da empresa pela Meta, que roda em paralelo e destrava limites maiores.

Quem cobra pelas mensagens, a covercut ou a Meta?

Quem cobra as conversas é a Meta, direto no cartão que você cadastra na conta dela. A covercut cobra apenas uma mensalidade fixa pela plataforma, conexão e suporte, e não cobra por mensagem, conversa ou template.

Por que preciso de templates aprovados?

Porque toda mensagem iniciada pela empresa fora da janela de 24 horas exige um modelo aprovado pela Meta, nas categorias marketing, utilidade ou autenticação. Dentro das 24 horas após o cliente te escrever, você responde com texto livre, sem template.

Preciso criar um app na Meta ou mexer em painel de desenvolvedor?

Não. Na covercut você não cria app nem entra em painel de desenvolvedor. O Embedded Signup acontece direto pela plataforma, porque a covercut é parceira Meta para WhatsApp; você só faz login, autoriza e verifica o número.

Pronto para usar a API oficial do WhatsApp?

A covercut é BSP oficial da Meta. Conecte seu número e comece a enviar em minutos.

Ver planos

Receba as novidades por e-mail

Sempre que publicarmos algo novo sobre a API oficial do WhatsApp, você recebe no seu e-mail. Sem spam.

Ao assinar, você concorda em receber e-mails do blog da covercut. Cancele quando quiser.