Ir para o conteúdo
Wiz Message
Compatível com a Cloud API

Já construiu na WhatsApp Cloud API? Troque o host e o token.

Isto não é "nós também temos uma API". É a mesma API. As rotas batem com as da Meta, os corpos de requisição batem, as respostas batem, e os erros voltam no envelope da própria Meta — então o tratamento de erro que você já escreveu continua valendo. Aponte seu cliente para outro host, troque o token, e pare por aí.

Incluído emWiz BotWiz CampaignWiz Pro

Ver planosVer preços
Um host e um token. O resto da sua integração fica intocado
Duas mudanças
As falhas voltam no envelope de erro da própria Meta, então o tratamento atual continua se aplicando
Os mesmos erros
A versão fixada na sua URL continua funcionando depois que a Meta aposentá-la
À prova de versão

Para quem é

A empresa ou agência que já pagou um desenvolvedor para integrar a Cloud API da Meta e não vai pagar de novo para migrar.

A dúvida que resolve

"Trocar de plataforma significa reintegrar." Não quando os endpoints, os payloads e os formatos de erro são idênticos.

Como a migração funciona

  1. Crie uma chave

    Gere uma chave de API no painel. Ela é apresentada no mesmo formato de cabeçalho de um token da Meta.

  2. Mude a URL base

    Aponte seu cliente atual para o host compatível em vez do da Meta.

  3. Troque o token

    Use sua chave como token bearer. Nada na forma de montar as requisições muda.

  4. Rode seus testes atuais

    As mesmas rotas, os mesmos corpos, as mesmas respostas, o mesmo envelope de erro — sua suíte de testes é a verificação da migração.

O que está espelhado

Os endpoints que as integrações realmente usam, nas rotas que a Meta documenta.

  • Envio de mensagens no mesmo endpoint de mensagens que você já chama
  • Marcar mensagens como lidas e enviar indicadores de digitação, com o mesmo corpo de requisição
  • Upload de mídia, devolvendo um id no formato que você já interpreta
  • Listagem de modelos de mensagem
  • Metadados de mídia, download e exclusão — os metadados devolvem uma URL funcional que seu cliente busca sem saber de quem é
  • Um repasse com lista de permissões para as demais rotas documentadas
  • Erros no envelope da própria Meta, então o tratamento de erro atual continua funcionando

Fixar versão de um jeito que sobrevive às aposentadorias da Meta

O segmento de versão na URL é aceito e depois ignorado. Parece atalho e na verdade é um benefício que vale dizer em voz alta: um cliente fixado numa versão antiga continua funcionando depois que a Meta a aposenta, e fixar uma mais nova não te coloca num comportamento que não está no ar. A versão no seu código deixa de ser tarefa de manutenção.

Uma lista de permissões, não um proxy cego

Só existem as rotas documentadas, e cada uma confere que o identificador na rota pertence à chave que está chamando. Isso mantém a superfície auditável — você consegue dizer exatamente até onde este endpoint alcança — e significa que um erro no seu cliente recebe uma resposta honesta em vez de ser encaminhado para um lugar inesperado. Todo envio ainda passa pela plataforma, então valem as mesmas limitações de ritmo e proteções de conta de qualquer outro lugar.

Bom saber

Até onde este recurso vai, em palavras claras — para que nada aqui surpreenda você depois da contratação.

  • Requer assinatura ativa e passa pelas mesmas verificações de direito e limite de ritmo do resto da API.
  • Isto é uma lista de permissões, não um proxy aberto. Só existem as rotas documentadas, e cada uma confere que o identificador da rota pertence à sua chave.
  • O segmento de versão é reconhecido e então ignorado — as chamadas sempre vão para a versão configurada da plataforma. É proposital, e é por isso que uma versão antiga continua funcionando.
  • Apenas GET, POST e DELETE. Não há PUT nem PATCH, porque responder a eles com um erro convincente seria menos honesto do que um 404.
  • Os envios continuam passando pelo gateway da plataforma em vez de sair direto, então as limitações de ritmo e proteções no nível da conta continuam valendo.

Incluído em

Este recurso faz parte dos planos abaixo.

  • Wiz Bot
  • Wiz Campaign
  • Wiz Pro
Comparar planos e preços
FAQ

Perguntas frequentes

Quanto do meu código precisa mudar?

A URL base e o token. Rotas, corpos de requisição, respostas e formatos de erro são os mesmos — que é justamente o ponto do recurso.

É mesmo a mesma API, ou só parecida?

As mesmas rotas, os mesmos corpos de requisição, as mesmas respostas e o mesmo envelope de erro. "Parecida" ainda te custaria uma reescrita; isto foi feito para que seus testes atuais passem sem mudança.

E o número de versão nas minhas URLs?

É aceito e ignorado, então um cliente fixado numa versão antiga continua funcionando depois que a Meta a aposenta. Você não precisa correr atrás de descontinuações.

Quais métodos HTTP são suportados?

GET, POST e DELETE. Não há PUT nem PATCH — preferimos devolver um 404 honesto a um erro convincente para algo que não existe.

Tudo o que a Meta oferece está disponível?

Não. Esta é uma lista de permissões proposital das rotas documentadas, não um proxy cego, para que a superfície siga auditável.

Continuo tendo os recursos próprios da plataforma?

Sim. Os envios passam pela mesma plataforma que seu painel usa, então a caixa de entrada, as análises, as proteções de conta e as limitações de ritmo continuam valendo.

Mude sem reintegrar

Troque o host, troque o token e rode seus testes atuais.

Ver planos

Explore Mais Funcionalidades

Descubra outras ferramentas que fazem do WizMessage a plataforma completa de WhatsApp.