Para contratar a API oficial do WhatsApp para e-commerce, a loja escolhe um fornecedor conectado à Meta, autoriza o acesso pelo cadastro integrado e registra o número comercial. Antes do aceite, confira quem fica dono da conta e do número, quem cobra as mensagens, o que acontece com o número atual e se uma conversa de teste chega à pessoa certa.
A API oficial, chamada WhatsApp Business Platform, permite conectar o WhatsApp a um software de atendimento. A Meta oferece a infraestrutura de mensagens. O painel que sua equipe usa, as regras da IA e a conexão com os dados da loja dependem da solução contratada.
A API oficial, que a Meta chama de WhatsApp Business Platform, não tem aplicativo próprio. A Meta oferece a infraestrutura de mensagens. O painel que a equipe usa, as regras da IA e a conexão com os dados da loja vêm da solução contratada. Por isso, duas propostas de "API oficial" podem entregar coisas bem diferentes.
No ChatFunnel, o WhatsApp oficial entra no mesmo atendimento do agente de IA e da equipe. As conversas podem ser atribuídas e transferidas, e grupos de permissão definem o que cada função acessa. Na demonstração, peça para ver o tipo de conversa que a sua loja precisa atender, com os dados que a conexão vai liberar.
Se você ainda está decidindo se precisa sair do aplicativo, leia a comparação entre WhatsApp Business e API oficial. Para ver a rotina depois da troca, consulte o que muda no atendimento com a API oficial. Aqui, o ponto de partida é a contratação: você já escolheu a API e quer conferir o que vai receber.
A API oficial do WhatsApp é o canal das etapas em que a loja fala com o cliente pelo WhatsApp. Em conversas, as mensagens chegam ao painel e seguem para a IA ou para a equipe. Na escolha do produto, a conversa tira dúvidas e retoma o carrinho. No Pedido pago e no Pós-compra, templates confirmam a compra e avisam sobre o envio. Na Recompra, campanhas chegam a quem aceitou receber mensagens. Uma falha na contratação aparece em todas essas etapas de uma vez.
Como escolher um software para utilizar a API do WhatsApp
A API oficial não tem tela própria. A equipe atende, a IA responde e as automações rodam dentro do software que a loja contrata, também chamado de plataforma de atendimento. Por isso, escolher a API do WhatsApp é, na prática, escolher esse software. A lista de recursos no site do fornecedor ajuda pouco nessa decisão: o que conta é ver a ferramenta funcionando com os dados e as conversas da sua loja.
Para um e-commerce, estes critérios separam as opções:
| Critério | O que perguntar | Como conferir na demonstração |
|---|---|---|
| Conexão oficial | O software usa a WhatsApp Business Platform? Qual é o papel do fornecedor junto à Meta? | Ver o cadastro integrado da Meta e onde a conta fica registrada |
| Integração com a loja | Quais dados chegam da plataforma: catálogo, estoque, carrinho, pedido e pagamento? | Perguntar sobre um produto real e ver se a resposta usa o dado da loja |
| IA no atendimento | De onde a IA tira as respostas, quem revisa esse conteúdo e o que ela faz quando não sabe? | Fazer uma pergunta fora da base e acompanhar a passagem para a equipe |
| Trabalho em equipe | Várias pessoas atendem o mesmo número? Há atribuição, transferência e permissões por função? | Transferir uma conversa e conferir se o histórico vai junto |
| Automações e templates | Há fluxos de carrinho, Pix e status do pedido? Campanhas usam template aprovado? | Ver um fluxo que para quando a compra é confirmada |
| Acompanhamento | O que os relatórios mostram: conversas, envios, entregas, leituras e erros? | Abrir o relatório de uma campanha de teste |
| Custo e saída | Como são cobrados software, implantação e mensagens? O que dá para exportar ao sair? | Pedir as respostas por escrito na proposta |
Comece pelo que a loja precisa no primeiro mês, como responder dúvidas de produto ou recuperar carrinhos, e deixe o restante para uma segunda fase. Uma ferramenta com muitos recursos que a equipe não vai configurar pesa no custo sem ajudar a vender. Se a dúvida principal é o tipo de automação, o guia sobre como escolher um chatbot para e-commerce compara menu, agente de IA e modelo híbrido.
Recursos de um bom software para a API do WhatsApp
Um software pensado para loja virtual faz mais do que receber mensagens. Ele liga a conversa ao catálogo, ao pedido e ao histórico do cliente. A tabela reúne os recursos que mais pesam no dia a dia de um e-commerce e mostra como cada um funciona no ChatFunnel, para servir de referência na comparação.
| Recurso | Para que serve na loja | Como funciona no ChatFunnel |
|---|---|---|
| Integração com a plataforma da loja | A IA e a equipe respondem com dados, sem abrir outro sistema | Conecta VTEX, Loja Integrada, Nuvemshop, Tray, WooCommerce, Shopify e Yampi. A conexão leva catálogo, estoque, carrinho, pedido e pagamento para o atendimento |
| Agente de IA ligado ao catálogo | Tira dúvidas, recomenda e ajuda a fechar a compra, inclusive à noite e no fim de semana | O agente consulta catálogo e estoque, sugere produtos e monta o carrinho. A loja define quais produtos ele indica, quais ações executa e quando uma pessoa assume |
| Base de conhecimento revisada | A IA responde sobre trocas, prazos e entrega com conteúdo aprovado pela loja | A equipe revisa as versões e escolhe quais agentes usam cada material. Dúvidas resolvidas pela equipe viram sugestões, que alguém aprova antes do uso |
| Teste antes de ativar | Evita colocar respostas erradas no ar | Você simula uma compra, confere as respostas e ajusta as instruções antes de a IA atender clientes |
| Equipe e canais na mesma caixa de entrada | Acaba com um número em cada celular e com o histórico espalhado | WhatsApp, Instagram e chat do site ficam na mesma tela. A equipe usa um número só, com atribuição, transferência e grupos de permissão por função |
| Recuperação de carrinho, Pix e boleto | Retoma a venda parada enquanto o cliente ainda tem interesse | Lembretes pelo WhatsApp com o link do carrinho, o Pix ou o boleto do pedido. Quando a compra é paga, os lembretes param |
| Status do pedido na conversa | Responde "onde está meu pedido?" sem a equipe procurar em planilha | Pagamento, envio e entrega aparecem na conversa, puxados da plataforma, e o status sincroniza no CRM |
| CRM com histórico de compras | Ajuda a vender de novo para quem já comprou | Cada contato guarda conversas, pedidos, pagamento e origem da venda, com funil, tags, segmentos e o valor acumulado do cliente (LTV) |
| Campanhas com template aprovado | Leva novidades e ofertas para quem aceitou receber mensagens | Disparos para um segmento, com envios, entregas, leituras e erros. O resumo do disparo mostra o custo estimado conforme a categoria |
| Automações e integrações técnicas | Liga o atendimento a outros processos da loja | Flows reagem a mensagens, botões, tags e mudanças no CRM. Há API REST, webhooks, chamada HTTP, MCP, n8n e Google Calendar |
| Suporte em português | Ajuda na configuração e no dia a dia | Chat, e-mail ou WhatsApp, conforme o plano, além de central de ajuda e tutoriais |
O que cada recurso entrega depende da plataforma da loja e da configuração de cada integração. Na demonstração do ChatFunnel, você vê esses recursos funcionando com o catálogo da sua loja conectado.
Peça uma proposta que descreva a entrega
"WhatsApp conectado" deixa muita coisa em aberto. Uma proposta útil diz onde as mensagens vão aparecer, quem pode responder e o que acontece quando a IA passa a conversa para uma pessoa. Também separa os recursos incluídos no plano do trabalho de configuração cobrado à parte.
Para uma loja de roupas, a primeira entrega pode ser responder às dúvidas de tamanho com uma base revisada e encaminhar pedidos de troca para a equipe. Consultar o pagamento de um pedido é outra tarefa: depende de uma fonte de dados e de uma conexão que associe a compra ao cliente certo.
Peça que cada consulta prometida venha com o sistema de origem e o tratamento de falha. Se o fornecedor disser que a IA consulta pedidos, pergunte qual campo ela recebe e o que responde quando esse dado falta. A avaliação de CRM para e-commerce no WhatsApp aprofunda essa ligação entre conversa, cliente e compra.
A lista comercial de integrações é só o ponto de partida. Um conector que recebe a atualização de pagamento pode cobrir menos do que outro que também consulta produtos e estoque. O escopo contratado precisa dizer o que a conexão com a sua plataforma entrega e quais permissões ela pede.
Como ativar a conexão do WhatsApp na API oficial
A ativação segue uma ordem: conferir se a empresa está verificada na Meta, preparar o número e o nome de exibição, conectar o número ao software escolhido e, por fim, confirmar que a loja enxerga a conta. Pular a primeira etapa costuma aparecer depois, na forma de limites de envio que travam a operação.
1. Confira se a empresa está verificada na Meta
A verificação da empresa confirma à Meta que o portfólio empresarial, o antigo Business Manager (BM), pertence a uma empresa real e que você pode representá-la. Para conferir, entre na Central de Segurança do Meta Business Suite com um perfil que administre o portfólio da loja. A seção de verificação mostra se a empresa já está verificada, se você pode iniciar o processo ou se o portfólio ainda não se qualifica.
A Meta permite conectar o número sem a verificação, mas com limites que pesam para uma loja. Por isso, recomendamos verificar antes de ativar:
| Recurso | Empresa não verificada | Empresa verificada |
|---|---|---|
| Mensagens iniciadas pela loja fora da janela de atendimento | Até 250 números diferentes em 24 horas | Sobe para 2.000 e pode aumentar conforme a qualidade dos envios |
| Números de WhatsApp no portfólio | Até 2 | Até 20 |
| Conta comercial oficial | Não pode ser solicitada | Pode ser solicitada depois de 30 dias na plataforma, com outros requisitos |
Os números estão na documentação da Meta sobre limites de mensagens, números comerciais e contas comerciais oficiais. Uma campanha de lançamento ou os avisos de pedido de uma semana movimentada passam facilmente de 250 pessoas, então a verificação entra no cronograma antes da conexão.
2. Verifique a empresa na META, se ainda não fez
Quem tem controle total do portfólio inicia o processo na Central de Segurança, em "Iniciar verificação". A Meta pede a razão social registrada, um telefone ou endereço oficial e uma prova de que você representa a empresa: um código enviado ao telefone ou ao e-mail da empresa, ou a verificação do domínio do site. Preencha os dados exatamente como estão no CNPJ. As regras estão na página da Meta sobre a verificação da empresa.
O passo a passo com as telas está no tutorial como verificar uma Business Manager (BM) na Meta, da Central de Ajuda do ChatFunnel. A Meta informa que a análise pode levar até 14 dias úteis. Se o portfólio aparecer como "Não se qualifica para verificação", o tutorial mostra os motivos mais comuns, como conta criada há pouco tempo ou restrição por anúncio fora das políticas.
3. Prepare o número e o nome de exibição
O número precisa ser da empresa, ter código de país e de área e conseguir receber SMS ou ligação, porque a Meta envia o código de confirmação por esse caminho. Os requisitos de números comerciais estão na documentação da Meta. Se o número já está no WhatsApp Business App, combine com o fornecedor se ele vai manter o aplicativo, pela coexistência, ou sair dele. A seção sobre o número, mais abaixo, mostra o que muda em cada caso.
Defina também o nome de exibição, que aparece no perfil do WhatsApp da loja e pode aparecer no topo das conversas. Use o nome pelo qual o cliente reconhece a marca, coerente com o cadastro da empresa.
4. Conecte o número pelo software escolhido
Com a empresa verificada e o número pronto, entre no software escolhido e inicie a conexão do WhatsApp. Ela abre o cadastro integrado da Meta, chamado Embedded Signup. Nesse fluxo, você entra com a conta do Facebook ou da Meta, aceita os termos, escolhe ou cria o portfólio e a conta WhatsApp Business, informa o número, digita o código recebido e preenche o nome de exibição. Por último, autoriza o aplicativo do fornecedor a acessar esses ativos, conforme a documentação do Embedded Signup.
Faça a conexão com um perfil que administre o portfólio da loja, e não com o perfil pessoal de alguém do fornecedor. É isso que mantém a conta em nome da empresa. Concluída a conexão, o número passa a funcionar pela API, e a equipe começa a usar os recursos da plataforma contratada, como o atendimento compartilhado, a IA, as automações e os templates aprovados.
5. Confirme que a loja enxerga a conta
Peça a um administrador da loja que abra o Gerenciador do WhatsApp e confira se o número, a conta WhatsApp Business e os templates aparecem ali. Se a conexão já está pronta e ninguém da loja consegue ver a conta, peça ao fornecedor que mostre os ativos e explique o vínculo. Resolva isso antes de ligar campanhas ou concentrar todo o atendimento nesse número.
Seu cadastro da API Oficial do WhatsApp precisa continuar sob sua responsabilidade
A conexão usa cadastros diferentes, e a loja precisa saber onde fica cada um. O portfólio empresarial da Meta reúne os ativos da empresa. A conta WhatsApp Business, também chamada de WABA, guarda os recursos do canal, como os templates. O número comercial e o nome de exibição ficam ligados a essa conta. O fornecedor recebe acesso a esses ativos, e esse acesso precisa estar claro para quem administra a empresa.
Pela documentação do Embedded Signup, a empresa cadastrada por esse fluxo é dona de todos os ativos do WhatsApp e tem acesso completo ao Gerenciador do WhatsApp. O software parceiro não pode restringir esse acesso.
Uma ficha simples evita depender da memória de quem fez a implantação:
| Item | O que registrar | O que a loja precisa conferir |
|---|---|---|
| Portfólio empresarial | Nome e identificador | Um responsável da loja consegue acessá-lo |
| Conta WhatsApp Business | Nome e identificador da WABA | O cadastro corresponde à empresa contratante |
| Número comercial | Número, nome de exibição e responsável pela linha | A loja sabe quem pode validar e manter esse número |
| Acesso do fornecedor | Empresa ou aplicativo autorizado e finalidade | A permissão corresponde ao serviço contratado |
| Cobrança | Quem cobra a plataforma e quem cobra as mensagens | A equipe sabe onde conferir consumo e pendências |
Guarde essa ficha em um lugar acessível aos responsáveis. Ela não deve conter senha, código de verificação ou token. O identificador de uma conta ajuda o suporte a localizar o cadastro; uma credencial pode permitir agir em nome da empresa.
Calcule o custo da API oficial com as regras de outubro de 2026
A conta da API oficial tem três parcelas: a assinatura do software, os serviços de implantação e as mensagens cobradas pela Meta. Peça cada uma separada na proposta. Um preço "com API inclusa" esconde justamente a parte que cresce com o volume.
A Meta cobra por mensagem entregue, com tarifa que varia pela categoria e pelo país do destinatário. Templates de marketing, utilidade e autenticação são cobrados. Uma exceção é a janela gratuita de 72 horas aberta quando o cliente chega por um anúncio que leva ao WhatsApp. As regras estão na página de preços da Meta.
Desde 1º de outubro de 2026, as respostas livres dentro da janela de 24 horas também entram na conta, depois de mil mensagens gratuitas por mês em cada número. Os templates de utilidade enviados dentro da janela deixaram de ser gratuitos. O artigo sobre a cobrança das mensagens de serviço mostra como estimar o impacto.
Leve ao fornecedor um mês típico da loja: quantas conversas chegam, quantas respostas a equipe e a IA enviam e quantos avisos de pedido saem por template. Peça a simulação da fatura com esses números e confira a tabela vigente ao fechar o orçamento.
Confira o número antes de mudar qualquer coisa
Informe ao fornecedor se o número está no WhatsApp Business App, em outra plataforma ou ainda sem uso comercial. Peça que ele descreva o caminho compatível com essa situação, incluindo o que acontece com o atendimento durante a mudança.
Para números que já estão no aplicativo, a Meta tem um fluxo de coexistência: o mesmo número continua no WhatsApp Business App e passa a funcionar também pela API. Segundo a documentação da Meta sobre usuários do app, os contatos e as conversas individuais dos últimos seis meses podem ser sincronizados. Conversas em grupo ficam de fora, e as mensagens temporárias são desativadas nas conversas individuais.
Se você utiliza o ChatFunnel como solução o canal de atendimento de WhatsApp no seu e-commerce, você pode fazer a conexão via coexistência, confira o tutorial.
O fornecedor precisa oferecer esse fluxo. Não conclua que qualquer ferramenta faz o mesmo, nem apague a conta do aplicativo seguindo um tutorial genérico.
Se o número vai sair do aplicativo e funcionar só pela API, peça por escrito o que será preservado, o que precisará ser exportado e o que não estará disponível no destino. Uma resposta vaga como "migra tudo" precisa virar uma lista antes de você autorizar a mudança. Combine também um horário e um responsável para acompanhar a conexão, além do canal alternativo que a equipe vai oferecer se as mensagens pararem de chegar.
Permissões da conta e da equipe são decisões distintas
A tela de autorização da Meta trata do acesso da ferramenta aos ativos do WhatsApp. O painel de atendimento define o que cada pessoa da loja pode fazer nas conversas e nas configurações. Confira as duas camadas na implantação.
Na autorização, veja qual empresa ou aplicativo vai receber acesso e peça a explicação de cada permissão. A documentação do Embedded Signup separa a permissão de gerenciar a conta e os templates da permissão de enviar e receber mensagens. O fornecedor deve saber justificar o que pede.
No painel, cadastre cada integrante da equipe com acesso próprio. Quem atende uma troca precisa consultar o histórico e responder ao cliente. Quem altera configurações do canal ou prepara campanhas tem outra responsabilidade. Os grupos de permissão do ChatFunnel controlam módulos e ações por função; peça que a demonstração mostre os perfis que a sua equipe vai usar.
Defina quem revisa os acessos quando alguém sai da equipe. Se trocar de fornecedor, combine como encerrar os acessos antigos e quais registros poderão ser exportados, com formato, prazo e possíveis custos de saída. Ter a conta em nome da loja não faz o histórico de um software aparecer sozinho em outro.
Teste uma conversa inteira antes de dar o aceite
Este é um roteiro sugerido para acompanhar a implantação. Use um contato de teste autorizado, com mensagens identificadas como teste, e registre o que aconteceu em cada etapa. O roteiro não descreve um teste já executado.
Imagine a Loja Aurora, fictícia, que vende tênis de corrida. O contato de teste pergunta: "Tem o Aurora Run no 38?". O catálogo conectado informa a numeração disponível, e a resposta deve usar esse dado. Depois, o contato pergunta se a palmilha é removível, informação que não está na base, e pede para falar com uma pessoa.
Acompanhe o percurso completo:
- Envie a pergunta pelo contato de teste e confira se ela aparece no painel, no número certo e com o remetente correto.
- Confira se a resposta usa o dado do catálogo e chega ao celular de teste. Ver a mensagem escrita no painel, sozinha, não encerra a conferência.
- Acione a passagem para uma pessoa e veja quem recebeu o atendimento. O histórico precisa permitir que ela continue sem pedir tudo de novo.
- Peça ao fornecedor uma simulação controlada de falha, sem afetar clientes. Confira onde o erro aparece e quem recebe o aviso.
- Registre o responsável pelo suporte, o canal de contato e a evidência de cada etapa aceita. O que falhou vira pendência, com responsável e data para nova conferência.
O momento da passagem para uma pessoa merece regra própria. O artigo sobre quando a IA deve transferir o atendimento ajuda a definir esse ponto antes do teste.
Se a contratação inclui avisos iniciados pela loja, teste esse fluxo à parte. A política de mensagens do WhatsApp Business exige templates aprovados para iniciar conversas e permite respostas livres nas 24 horas seguintes à última mensagem do cliente. A loja também precisa respeitar a permissão para contato e os pedidos para parar de receber mensagens. A mesma política admite limitar ou retirar o acesso em caso de descumprimento, então promessas de envio sem limite ou sem bloqueio não servem como critério de compra.
Depois do aceite, acompanhe as primeiras conversas. A pergunta que ficou sem resposta mostra o que falta na base, e uma transferência sem responsável pede ajuste na distribuição.
Aceite a API oficial do WhatsApp como facilitador do seu e-commerce
O selo de "conectado" mostra apenas que o número está ligado à Meta. A contratação termina quando a loja enxerga os próprios ativos, sabe quem cobra cada mensagem, entende o que aconteceu com o número e viu uma conversa de teste sair do cliente e chegar à pessoa certa. O que ficou de fora entra na ficha como pendência, com nome e data.
No ChatFunnel, o WhatsApp oficial recebe mensagens, mídia, botões e templates no mesmo painel em que trabalham o agente de IA e a equipe. O agente responde com a base de conhecimento revisada pela loja, e a equipe define quando uma pessoa assume, com o histórico junto. As conversas podem ser atribuídas e transferidas, e grupos de permissão controlam o que cada função acessa.
A conexão com VTEX, Loja Integrada, Nuvemshop, Tray, WooCommerce, Shopify ou Yampi leva ao atendimento os dados que a plataforma libera, conforme o escopo autorizado em cada integração. As campanhas com template aprovado mostram envios, entregas, leituras e erros, e o resumo do disparo traz o custo estimado conforme a categoria. Leve a ficha deste artigo e uma conversa real da sua loja para a demonstração e veja esse percurso funcionando antes de decidir.
Conheça o ChatFunnel, a IA nº 1 para Lojas Online
Perguntas frequentes sobre a API oficial do WhatsApp
Como contratar a API oficial do WhatsApp?
Verifique a empresa na Meta, escolha um fornecedor que trabalhe com a WhatsApp Business Platform e conecte o número comercial pelo cadastro integrado da Meta, com a conta da empresa. A loja precisa sair do processo como dona do portfólio, da conta WhatsApp Business e do número. Antes do aceite, teste uma conversa completa, do cliente até a pessoa da equipe.
Quanto custa a API oficial do WhatsApp?
O custo soma a assinatura do fornecedor, a implantação e as mensagens cobradas pela Meta. A Meta cobra por mensagem entregue, com tarifa definida pela categoria e pelo país do destinatário, conforme a tabela de preços da Meta. Desde 1º de outubro de 2026, as respostas dentro da janela de 24 horas também são cobradas depois das mil primeiras do mês em cada número.
A API do WhatsApp é gratuita?
Não. Fora exceções como a janela de 72 horas para quem chega por anúncio, a Meta cobra por mensagem entregue: os templates e, desde outubro de 2026, as respostas livres que passam de mil por mês em cada número. O fornecedor também cobra pelo painel e pelos serviços. As mensagens que o cliente envia para a loja não têm tarifa da Meta.
Qual é a melhor API oficial do WhatsApp?
Existe uma só API oficial: a WhatsApp Business Platform, da Meta. O que muda entre as ofertas é o fornecedor, com painel, integrações, suporte e forma de cobrança diferentes. A melhor escolha é a que passa no teste com uma conversa real da sua loja e deixa a conta em nome da empresa. Serviços que não usam a plataforma da Meta não são a API oficial, mesmo que tenham "API" no nome.
Posso usar o mesmo número do WhatsApp Business na API oficial?
Sim. Na coexistência, o número continua no WhatsApp Business App e passa a funcionar também pela API, com sincronização dos contatos e das conversas individuais dos últimos seis meses. Conversas em grupo não são sincronizadas. O fornecedor precisa oferecer esse fluxo, então confirme antes de iniciar a conexão.
Preciso verificar a empresa na Meta para usar a API oficial?
Não é obrigatório para conectar, mas é recomendado. Sem a verificação, a loja pode enviar mensagens que ela inicia para até 250 números diferentes em 24 horas e registrar até 2 números. Com a empresa verificada, os limites sobem para 2.000 envios e 20 números, segundo a documentação de limites da Meta. A análise pode levar até 14 dias úteis, então comece antes da implantação.
Posso usar IA no atendimento pela API oficial do WhatsApp?
Sim, quando a IA atende os clientes da própria loja.
