Como contratar a API oficial do WhatsApp para a loja virtual: passo a passo e o que preparar

Para contratar a API oficial do WhatsApp, a loja virtual escolhe um provedor parceiro da Meta, conecta o número pelo cadastro oficial da Meta, cadastra um cartão para pagar as mensagens e aprova os modelos de mensagem. Com um bom provedor, a parte técnica leva minutos; o que costuma atrasar é o que vem antes e depois: o número certo, os modelos aprovados e o limite de envio do começo.

Este artigo mostra o que preparar, o passo a passo da ativação, as regras que pegam quem está começando e as perguntas para fazer ao provedor antes de fechar. Quanto a API custa por mensagem está no artigo quanto custa a API oficial do WhatsApp.

Contratar a API oficial do WhatsApp, em resumo

Contratar a API oficial do WhatsApp é ligar o número da loja à infraestrutura de mensagens da Meta por meio de um provedor, que conecta essa API ao WooCommerce e dispara os avisos sozinho. O processo tem cinco partes:

1. Portfólio empresarial na Meta (o antigo Business Manager), gratuito.
2. Provedor que faz a ponte entre a API e a loja.
3. Número de telefone que a loja controla, com acesso ao código de verificação.
4. Cartão cadastrado na Meta, que cobra cada mensagem à parte da mensalidade do provedor.
5. Modelos de mensagem aprovados pela Meta antes do primeiro envio automático.

Por que não se contrata direto da Meta

A Meta oferece a API, mas não entrega um painel pronto para a loja mandar avisos de pedido. Há dois caminhos:

• Integração própria: um desenvolvedor cria um app no Meta for Developers, gera os tokens, recebe os eventos da Meta num servidor e programa cada aviso a partir do WooCommerce. Faz sentido para operações com equipe técnica.
• Provedor parceiro da Meta: empresas reconhecidas pela Meta como parceiras (Tech Provider ou parceiro de soluções) usam o cadastro incorporado oficial, o Embedded Signup, e já trazem os avisos de pedido prontos. É o caminho da maioria das lojas.

Nos dois casos a conta do WhatsApp fica no portfólio da sua empresa na Meta. O provedor recebe permissão para gerenciar mensagens e modelos, mas não deveria ficar com o número.

O que preparar antes de começar

A maior parte dos atrasos vem de um item que faltou no meio do cadastro. Separe antes:

• Acesso de administrador ao portfólio empresarial da loja no Meta Business Suite. Se a página do Facebook ou o Instagram da loja foram criados por uma agência, confirme quem é o administrador.
• O número que vai mandar as mensagens e um jeito de receber o código por SMS ou ligação durante a configuração.
• O nome de exibição, que é o nome que o cliente vê no WhatsApp. Use o nome da loja como ele aparece para o público.
• Um cartão de crédito para cadastrar na Meta, que cobra as mensagens.
• A lista de avisos que você quer mandar: pedido recebido, Pix gerado, pagamento aprovado, rastreio, carrinho abandonado. Ela define os modelos que vão para aprovação e a categoria de cada um.

Número novo ou o mesmo do WhatsApp Business?

Dá para usar o mesmo número que a loja já usa no aplicativo WhatsApp Business. A Meta chama isso de coexistência: o aplicativo continua no celular para o atendimento humano e a API manda os avisos automáticos pelo mesmo número.

Segundo a documentação da Meta, a coexistência exige o WhatsApp Business na versão 2.24.17 ou superior e muda algumas coisas no aplicativo:

• Listas de transmissão ficam somente leitura e não dá para criar novas.
• Mensagens temporárias, visualização única e localização em tempo real são desativadas nas conversas individuais.
• Aparelhos conectados são desconectados na ativação e podem ser conectados de novo; o WhatsApp para Windows não é compatível.
• Contatos e conversas individuais dos últimos 6 meses podem ser sincronizados com a API. Grupos não são.
• Mensagens mandadas pelo aplicativo continuam sem cobrança; só as mandadas pela API seguem a tabela da Meta.

Se a loja usa as listas de transmissão do aplicativo para divulgar promoções, esse é o ponto a pesar antes de ativar. Se o número já está ligado à API oficial de outro provedor, não é coexistência: é preciso migrar o número, e o provedor novo conduz essa troca com o antigo.

Passo a passo para ativar a API oficial

Com o provedor escolhido, a ativação segue o fluxo oficial da Meta. Os nomes das telas mudam de um provedor para outro, mas a ordem é esta:

1. Abra a conexão no painel do provedor. Uma janela da Meta aparece por cima da tela.
2. Entre com a conta do Facebook que administra o portfólio da loja e escolha esse portfólio.
3. Crie ou selecione a conta do WhatsApp Business, que guarda o número dentro da Meta. A maioria das lojas cria uma com o nome da loja.
4. Cadastre o número e digite o código que chegar por SMS ou ligação.
5. Defina o nome de exibição. A Meta revisa esse nome; se recusar, dá para corrigir seguindo as diretrizes dela.
6. Autorize o provedor a gerenciar mensagens e modelos dessa conta.
7. Cadastre o cartão na área de pagamentos do WhatsApp na Meta.
8. Conecte a loja. No WooCommerce, isso costuma ser um plugin que lê os eventos do pedido e avisa o provedor.
9. Crie os modelos, mande para aprovação e escolha qual evento dispara cada um.
10. Mande um teste para o seu próprio número antes de ligar os envios para os clientes.

No WhatsApp oficial da Rishi, por exemplo, a conexão usa esse cadastro oficial da Meta e a loja liga o WooCommerce instalando o plugin Automações para WhatsApp e colando um token gerado no painel. Não é preciso criar app no Meta for Developers.

Modelos de mensagem: aprovação e categoria

A API oficial só deixa a loja puxar a conversa com um modelo aprovado pela Meta. Mensagem livre só vale como resposta, dentro das 24 horas depois que o cliente escreveu.

Cada modelo tem nome, idioma, texto com campos variáveis (nome do cliente, número do pedido, código de rastreio) e, se quiser, botões. Na Rishi, as primeiras aprovações levam até 24 horas, e as seguintes costumam sair mais rápido. Três cuidados evitam recusa:

• Um modelo, uma informação. Aviso de pedido não leva oferta junto; uma frase de cupom pode fazer a Meta classificar o aviso como marketing, a categoria mais cara.
• Link em botão, não no meio do texto. E evite link para o próprio WhatsApp, que a Meta costuma recusar.
• Texto fixo suficiente para mostrar o contexto. Um modelo feito só de campos variáveis parece genérico e tende a ser recusado.

Os textos de lembrete de carrinho, que a Meta trata como marketing, estão em modelos de mensagem de carrinho abandonado.

O limite de envio do começo

Uma conta nova na API oficial começa com limite de 250 clientes diferentes a cada 24 horas para mensagens que a loja inicia, fora da janela de atendimento. O limite vale para o portfólio inteiro, não para cada número, segundo a documentação de limites da Meta.

Para subir para 2.000, a Meta aceita um destes caminhos:

• Verificar a empresa no portfólio, ou pedir ao provedor parceiro que faça a verificação.
• Entregar 2.000 mensagens fora da janela de atendimento, para números diferentes, em 30 dias, com modelos de boa qualidade.

Depois disso, o limite sobe sozinho para 10 mil, 100 mil e ilimitado quando a qualidade das mensagens está alta e a loja usou pelo menos metade do limite nos últimos 7 dias.

Na prática: uma loja que fatura 30 pedidos por dia não sente o limite de 250. Uma loja que pretende ativar a API em novembro e mandar o lembrete de carrinho na Black Friday, em 27 de novembro, pode bater no teto no pior dia. Ative e verifique a empresa com algumas semanas de folga; o checklist de Black Friday tem os outros itens dessa preparação.

Consentimento e qualidade do número

A Meta exige que o cliente tenha aceitado receber mensagens da loja antes do primeiro envio. A política de opt-in pede que fique claro o nome da empresa e que a pessoa está aceitando receber comunicações dela, e deixa o método a critério da empresa: site, telefone, SMS ou presencial.

Na loja virtual, isso costuma ser um texto curto perto do campo de telefone no checkout, com a opção de receber as notícias do pedido pelo WhatsApp. Também vale a LGPD: guarde quando e como o cliente aceitou.

A qualidade conta porque o cliente pode bloquear ou denunciar a loja no próprio WhatsApp. Qualidade baixa por muito tempo trava a subida do limite e pode reduzir a capacidade de envio. Avisos que o cliente espera, como pagamento aprovado e rastreio, raramente geram denúncia; campanha para quem nunca comprou, sim.

Perguntas para fazer ao provedor antes de contratar

O preço da mensalidade é só uma parte da escolha. Estas perguntas evitam surpresa depois:

Como referência, o WhatsApp oficial da Rishi custa R$ 149 por mês, com as mensagens cobradas pela Meta conforme a categoria. O plano inclui um número da loja, avisos por status do pedido, Pix copia e cola e link do boleto, rastreio e lembrete de carrinho. Disparos em massa ficam fora desse plano. A Rishi é Meta Tech Provider.

O que fazer agora

1. Liste os avisos que a loja vai mandar e marque quais são utilidade e quais são marketing.
2. Confirme quem administra o portfólio da loja na Meta.
3. Decida entre usar o número do WhatsApp Business atual ou um número novo, considerando as listas de transmissão.
4. Faça as perguntas da tabela a dois ou três provedores.
5. Ative, verifique a empresa e mande os modelos para aprovação o quanto antes, com folga antes da Black Friday.
6. Teste cada aviso com um pedido real antes de ligar para todos os clientes.

Depois da ativação, a página de obrigado e os avisos no WhatsApp trabalham juntos: um mostra o próximo passo na tela, o outro lembra o cliente quando ele já saiu da loja.