Phone Number01 · attention
registration pending
Número verificado, mas a operação não avança
O número existe no ambiente, mas o estado real precisa ser validado antes de mexer na estrutura.
Infraestrutura oficial da Meta
Implantação WhatsApp Cloud API para operações reais
Organizamos Business Portfolio, Meta App, WABA, número, System User, token, Graph API e webhooks para colocar o WhatsApp oficial em produção. Mais do que conectar um endpoint: deixamos ativos, permissões e eventos prontos para a operação.
Explorar a arquitetura MetaUma implantação que você consegue entender depois da call — do Business Portfolio ao evento chegando no sistema consumidor.
ativo empresarial
WABA
verificado
identidade técnica
System User
ativo
execução oficial
Graph API
200 OK
entrega de eventos
Webhook
eventos fluindo
ativos → autorização → execução → eventos
Superfície técnica que avaliamos
Business PortfolioMeta AppWABANúmeroSystem UserAccess TokenGraph APIWebhooksValidação em produção
Onde você está
O próximo passo depende do que está impedindo a operação.
Escolha o ponto de partida. Em seguida, reconheça estados que aparecem de verdade quando a estrutura da Meta não fecha.
Seu ponto de partida
Quero estruturar a operação oficial
Business Portfolio, Meta App, WABA, número e produção organizados com clareza.
- •Ainda não sei quais ativos criar
- •Preciso preparar um número para produção
- •Quero começar sem depender de tentativa e erro
- •Número verificado, mas ainda não registrado
Authorization02 · attention
asset mismatch
Token funciona no Explorer e falha na aplicação
Escopos, System User e assets atribuídos precisam apontar para o mesmo contexto de negócio.
Webhook03 · attention
0 events
Callback validado, mas nenhum evento chega
Callback, WABA subscription e sistema consumidor precisam fechar o ciclo de eventos.
Por que isso trava
O difícil não é chamar a API. É alinhar propriedade, identidade, permissões, ativos e eventos.
Uma chamada HTTP pode estar correta e ainda falhar porque o ativo está no lugar errado, a identidade técnica não recebeu acesso ou o evento não está inscrito. É essa cadeia que a implantação precisa organizar.
Do caos à clareza
A diferença não é “ter uma API”. É saber o que cada peça está fazendo.
O valor da implantação aparece quando o ambiente deixa de ser um conjunto de IDs, telas e erros soltos e passa a ter uma estrutura operacional legível.
before
Infraestrutura fragmentada
WABA ou Business ID??
Phone Number ID não localizado?
Token sem contexto claro?
Número preso a uma configuração anterior?
Webhook sem eventos?
→
after
Operação legível
Assetsmapeados
Identitydefinida
Phone Numbervalidado
Graph APItestada
Webhookentregando eventos
Arquitetura Meta
A estrutura certa separa propriedade, autorização, execução e eventos.
É assim que evitamos tratar System User como se fosse mais um elo da árvore de ativos. Cada relação tem uma responsabilidade diferente.
Explore a estrutura
Propriedade
Quem possui os ativos
O Business Portfolio governa os ativos do negócio. O Meta App e a WABA pertencem a essa estrutura; o Phone Number fica associado à WABA.
01Business Portfolio
02Meta App
03WABA
04Phone Number
O que fica resolvido
Da primeira configuração à validação em produção.
O trabalho é organizado por resultado operacional, não por uma lista genérica de features.
Setup do zero ou auditoria do ambiente existente
Organização de Business Portfolio, Meta App e WABA
Descoberta de Phone Number ID e registro do número
System User, asset assignment, permissões e token de produção
Validação de /register, /messages e respostas da Graph API
Webhook callback, inscrição da WABA e eventos inbound/outbound
Migração orientada de infraestrutura não oficial
Documentação e transferência de conhecimento
Prova técnica
Não basta saber o endpoint. É preciso saber o contexto.
A chamada é estática de propósito: o valor está em validar Phone Number ID, token, permissões, asset assignment e WABA.
Graph API · registro do número
POSTPOST /{PHONE_NUMBER_ID}/register
Authorization: Bearer ••••••••••••
Content-Type: application/json
{
"messaging_product": "whatsapp",
"pin": "••••••"
}Resposta
200{
"success": true
}O sucesso depende do contexto certo: Phone Number ID, identidade, token, permissões e assets atribuídos.
Phone Number IDSystem UserAccess TokenAssigned assets
Como a implantação avança
Um caminho visível, não uma sequência de cliques improvisados.
Cada etapa reduz uma classe diferente de incerteza: primeiro os ativos, depois o acesso, depois a execução e por fim a transferência para quem vai operar.
01
Mapeamos
ownership / assetsBusiness Portfolio, App, WABA, número e contexto atual da operação.
02
Autorizamos
identity / accessSystem User, assets atribuídos, permissões e token para produção.
03
Validamos
execution / events/register, /messages, webhook e entrega de eventos ao sistema consumidor.
04
Transferimos
handoff / knowledgeDocumentação, walkthrough e responsabilidades claras para quem vai operar depois.
Como podemos entrar
Uma expertise, três formas de contratação.
O ponto de entrada muda conforme a maturidade do ambiente. O método técnico continua o mesmo: entender estrutura, validar relações e deixar a operação legível.
Implementação assistida
Configuramos e validamos o ambiente junto com sua equipe, com checkpoints claros.
Troubleshooting e resgate
Investigamos estruturas existentes, números presos, permissões e eventos que não chegam.
Consultoria e enablement
Apoiamos desenvolvedores e times internos com arquitetura, documentação e transferência de conhecimento.
Necessidade
Implementação
Troubleshooting
Enablement
Estruturar do zero
✓
·
·
Diagnosticar ambiente
✓
✓
✓
Corrigir configuração
✓
✓
·
Validar integração
✓
✓
✓
Transferir conhecimento
✓
✓
✓
destination map
A infraestrutura oficial precisa terminar em algum lugar útil.
Preparamos a Cloud API para alimentar a ferramenta, o CRM ou o backend que realmente participa da operação.
official infrastructure
Meta Cloud API
Graph API + Webhooks
operation
Chatwoot
automation
n8n / CRM
custom app
Python / Node.js
internal stack
Sistema próprio
O que você recebe
A entrega não termina em “funcionou na call”.
O objetivo é deixar um ambiente entendível, validado e documentado para quem vai operar depois.
Mapa da arquitetura Meta e dos ativos
Estrutura de identidade técnica e permissões
Número e fluxo Graph API validados
Webhook e sistema consumidor testados
Documentação operacional e referências de troubleshooting
Walkthrough com o time interno e próximos responsáveis
Entrega que continua depois da call
A implantação não termina em “funcionou aqui”.
Organizamos o ambiente para que a empresa entenda o que foi configurado, quais ativos importam e como diagnosticar o fluxo depois da entrega. Quando o escopo pede, isso inclui documentação operacional e transferência de conhecimento.
Guia operacional
WhatsApp Cloud API
Estrutura, IDs, autenticação, endpoints e pontos de validação reunidos em um artefato que a equipe consegue consultar depois.
01Business Portfolio
02WABA e Phone Number ID
03System User e token
04Graph API
05Webhooks
06Troubleshooting
documentação pós-implantação
Proof of work
A prova pode estar no processo, não em um logo inventado.
Em vez de fabricar social proof, mostramos o tipo de evidência que uma implantação real produz: estado verificado, IDs localizados, API respondendo, eventos chegando e handoff documentado.
implementation trace
exemplo anonimizado de estados de entrega
01NúmeroVERIFICADO
02Phone Number IDLOCALIZADO
03/registerSUCCESS: TRUE
04WebhookVALIDADO
05HandoffDOCUMENTADO
Dúvidas frequentes
Clareza antes de mexer em produção.
O que é a WhatsApp Cloud API?
É a API oficial da Meta para conectar uma operação de WhatsApp a sistemas próprios, CRMs, plataformas de atendimento e automações. A implantação envolve mais do que uma chamada HTTP: envolve ativos, identidade, permissões e eventos.
É a API oficial do WhatsApp?
Sim. A Cloud API é a infraestrutura disponibilizada pela Meta. A WKing ajuda a organizar e validar o ambiente da empresa, sem afirmar parceria, certificação ou status que não estejam comprovados.
Preciso de BSP?
Nem toda operação precisa contratar um BSP para usar a Cloud API. A necessidade depende do desenho do negócio, do caminho de onboarding e dos serviços adicionais desejados. Avaliamos o cenário antes de recomendar uma rota.
Posso usar meu número atual?
Depende do estado atual do número, da conta associada e do caminho de migração disponível. Não prometemos reaproveitamento automático: primeiro mapeamos vínculos, histórico de configuração e requisitos da Meta.
Posso continuar usando WhatsApp Business no celular?
Isso depende de Coexistence e da elegibilidade do caso, que não deve ser confundida com uma migração comum. Tratamos o tema com cautela e validamos as condições atuais da Meta antes de definir o caminho.
Vou perder meu histórico?
Não assumimos preservação ou perda sem analisar o caso. Histórico, número e mudança de infraestrutura têm regras próprias; o diagnóstico vem antes de qualquer alteração.
Preciso verificar minha empresa na Meta?
Alguns recursos, limites e caminhos de configuração podem depender de Business Verification. A exigência varia conforme o contexto da conta e deve ser confirmada no Business Portfolio.
O que é WABA?
WABA é a conta do WhatsApp Business que organiza números e configurações da operação dentro da estrutura empresarial da Meta.
Qual a diferença entre WABA ID e Phone Number ID?
O WABA ID identifica a conta do WhatsApp Business. O Phone Number ID identifica o ativo de número usado em chamadas como /register, /messages e /deregister. Eles não são intercambiáveis.
O que é System User?
É uma identidade técnica não humana usada para conceder a uma aplicação acesso controlado a ativos do Business Portfolio. Ela não é o mesmo que o perfil pessoal do administrador.
O que é um token de produção?
É a credencial usada pela aplicação para autorizar chamadas à Graph API. A estrutura deve pertencer à empresa, ter escopos adequados e ser armazenada com segurança; não coletamos tokens no site.
A WKing pode integrar com Chatwoot, n8n, CRM, Python ou Node?
Sim. Podemos preparar a infraestrutura oficial e orientar ou executar a integração com ferramentas operacionais, backends Python ou Node.js e aplicações customizadas, conforme o escopo.
Vocês ajudam se meu número já estiver registrado?
Sim, podemos investigar vínculos, WABA, número, ativos e configuração anterior. O caminho depende do diagnóstico e não envolve prometer desbloqueio automático.
Vocês configuram webhooks?
Sim. Validamos callback, verificação, assinatura da WABA e entrega de eventos ao sistema consumidor, respeitando o desenho da integração.
Vocês treinam minha equipe técnica?
Sim. A entrega pode incluir walkthrough, documentação operacional e transferência de conhecimento sobre IDs, permissões, Graph API e webhooks.
A WKing hospeda minha operação depois da implantação?
A implantação pode preparar a infraestrutura e a integração. Hospedagem, sustentação contínua e desenvolvimento posterior são escopos que avaliamos separadamente.
Qual a diferença entre implantação, troubleshooting e consultoria?
Implantação estrutura um ambiente novo; troubleshooting investiga um ambiente existente e travado; consultoria e enablement ajudam o time técnico a operar e evoluir a estrutura com autonomia.
A API oficial impede banimentos ou permite disparo irrestrito?
Não. A infraestrutura oficial não elimina políticas, restrições, limites ou responsabilidades de uso. Também não oferecemos promessa de banimento zero ou disparo irrestrito.
Próximo passo
Você não precisa descobrir a arquitetura da Meta por tentativa e erro.
Converse sobre sua implantação, configuração travada ou integração e comece pelo ponto certo.