O que é a API Oficial do WhatsApp
A API Oficial do WhatsApp Business é o jeito aprovado pela Meta de uma empresa usar o WhatsApp por meio de um sistema. Ela roda na nuvem da própria Meta e é o que permite mandar mensagens para muitos clientes, ligar um robô de atendimento e ter várias pessoas atendendo o mesmo número.
O app WhatsApp Business do celular continua existindo e é ótimo para uma pessoa atender por vez. A API entra quando o atendimento cresce: equipe, automação, IA, transmissões com relatório e integração com outros sistemas.
O que você precisa
- Uma conta no Facebook com acesso ao portfólio empresarial da sua empresa na Meta. Se não tiver, dá para criar durante a conexão.
- Um número que receba SMS ou ligação para o código de confirmação.
- Uma forma de pagamento na sua conta da Meta, para as mensagens que ela cobra.
- Contatos que deram permissão (opt-in) para receber mensagens da sua empresa.
Como conectar no InvestCRM
- Crie a sua conta grátis no InvestCRM e confirme o e-mail.
- Em Conexões, escolha conectar um número novo ou o Modo Coexistência WhatsApp Business (para o número que já está no app do celular).
- Na janela da Meta, entre com o Facebook, escolha ou crie o portfólio da empresa e a conta do WhatsApp e informe o número.
- Confirme o número com o código (número novo) ou leia o QR Code com o app WhatsApp Business (Coexistência).
- Pronto: o número aparece conectado e as conversas chegam na caixa de entrada do InvestCRM.
Você não precisa criar aplicativo nem mexer em configuração técnica da Meta: o InvestCRM é Tech Provider e faz essa parte.
Modelos de mensagem e categorias
Para falar primeiro com alguém, ou depois de 24 horas sem resposta, a mensagem precisa ser um modelo aprovado pela Meta. Cada modelo tem uma categoria, e a categoria define o preço:
- Marketing: ofertas, convites, novidades, carrinho abandonado.
- Utilidade: algo que o cliente pediu ou combinou com você, como confirmação de pedido, lembrete de horário ou aviso de pagamento. Sem oferta junto.
- Autenticação: códigos de acesso e de confirmação, no texto padrão da Meta.
Se o texto não bater com a categoria escolhida, a Meta pode mudar a categoria (e o preço). O InvestCRM avisa quando isso acontece.
Quer exemplos prontos para copiar? Veja os modelos de mensagem
A janela de 24 horas
Quando o cliente manda uma mensagem, abre uma janela de 24 horas. Dentro dela você responde com mensagens comuns: texto, foto, áudio, documento e botões. Cada nova mensagem do cliente recomeça a contagem. Fora da janela, só dá para mandar modelo aprovado.
Quanto a Meta cobra
A Meta cobra por mensagem entregue, com preço por categoria (marketing é a mais cara) e pelo país de quem recebe. Desde 1º de outubro de 2026, as respostas comuns dentro da janela de 24 horas (a categoria serviço) também são cobradas, depois de 1.000 grátis por número a cada mês. As mensagens que o cliente manda são grátis.
Quanto custa cada categoria em reais: veja a tabela completa e um exemplo de conta
Faça a conta do seu mês: abrir a calculadora de custo
Fonte: preços da Meta
Cartão recusado na Meta: o que para e quando
A Meta cobra as mensagens na forma de pagamento da sua conta do WhatsApp na Meta. Quando a cobrança não passa (um cartão sem saldo, por exemplo), ela recusa o envio com o erro 131042, que vale para a conta inteira, e não para um contato. Na lista da Meta também entram: conta de pagamento não ligada à conta do WhatsApp, linha de crédito acima do limite ou não ativada, e fuso horário ou moeda não definidos.
- Param os modelos de marketing, utilidade e autenticação, que a Meta cobra a cada entrega. Isso inclui as transmissões e qualquer automação ou sequência que mande um modelo.
- As respostas de atendimento dentro da janela de 24 horas param depois das 1.000 grátis do mês: desde 1º de outubro de 2026, sem forma de pagamento, a Meta entrega só essas 1.000 de cada número e não entrega as seguintes.
O que o InvestCRM faz: no primeiro erro 131042, ele pausa as transmissões em andamento daquele número, para ninguém da fila virar falha, e abre um aviso no painel. Depois de acertar o pagamento na Meta, clique em Retomar: o sistema manda 1 mensagem de teste, no máximo 1 a cada 10 minutos. Se ela passar, o aviso some e o envio volta ao ritmo normal; se a Meta recusar de novo, a transmissão pausa outra vez.
Fonte: códigos de erro da Meta (131042)
Qualidade do número e limite de envio
A Meta acompanha como as pessoas reagem às suas mensagens. Muitos bloqueios e denúncias derrubam a qualidade do número e podem levar a restrições. Ela também limita quantas pessoas diferentes você alcança com modelos por dia, e esse limite sobe conforme você envia com qualidade.
No InvestCRM você confirma o opt-in do público antes de cada transmissão, quem pede para sair é tirado na hora e a nota do número fica à vista para você agir antes de um problema.
Coexistência: o app e a API no mesmo número
Com a Coexistência, o número continua no app WhatsApp Business do celular e também fica na API. Você segue atendendo pelo celular e as conversas aparecem no InvestCRM. Na conexão, dá para trazer os contatos e até 6 meses de conversas individuais.
- O envio fica limitado a 20 mensagens por segundo.
- O app perde mensagens temporárias, ver uma vez, localização em tempo real e listas de transmissão (as que existem ficam só para leitura).
- Os aparelhos vinculados são desconectados.
Por isso a Coexistência é para atendimento. Para transmissões grandes, o melhor é um número só na API.
Quer entender melhor? Leia o artigo sobre Coexistência
Erros comuns e o que fazer
| Código | O que é | O que fazer |
|---|---|---|
| 131042 | Problema na forma de pagamento ou na configuração de cobrança da conta do WhatsApp na Meta. | Acerte o pagamento na Meta e retome a transmissão: o InvestCRM manda 1 mensagem de teste antes de voltar ao ritmo normal. |
| 131047 | Passaram mais de 24 horas desde a última mensagem do cliente. | Retome a conversa com um modelo aprovado. |
| 131026 | A mensagem não pôde ser entregue. | Confira se o número está certo e tem WhatsApp; o app da pessoa pode estar desatualizado. |
| 131049 | A Meta segurou uma mensagem de marketing para não cansar a pessoa. | Espere pelo menos 24 horas antes de mandar outro modelo de marketing para essa pessoa (orientação da Meta). |
| 131051 | O cliente mandou um tipo de mensagem que a API não lê. | Nada a fazer do seu lado; peça para ele mandar em texto, se precisar. |
Fonte: códigos de erro da Meta