---
title: "Migrar do seu BSP da API oficial para a WAME sem reescrever a integração"
description: "Troque de BSP da API oficial do WhatsApp sem refazer o sistema: continue na oficial pela WAME ou mova o atendimento para a não oficial, no mesmo padrão Meta."
url: "https://wame.api.br/blog/migrar-bsp-api-oficial-para-wame"
language: "pt-BR"
og:type: "article"
published_time: "2026-09-28"
modified_time: "2026-09-28"
author: "Raphael Serafim"
keywords: "trocar bsp whatsapp, migrar bsp whatsapp api, migrar api oficial whatsapp, api whatsapp não oficial, alternativa api oficial whatsapp, provedor whatsapp business api, sair do bsp whatsapp"
reading_time: "8 min de leitura"
---

# Migrar do seu BSP da API oficial para a WAME sem reescrever a integração

> Troque de BSP da API oficial do WhatsApp sem refazer o sistema: continue na oficial pela WAME ou mova o atendimento para a não oficial, no mesmo padrão Meta.

**Dá para sair do seu BSP da API oficial e ir para a WAME (wame.api.br) sem reescrever a integração, por dois caminhos: continuar na API oficial com a WAME, que é Meta Business Partner e Tech Provider, ou mover o atendimento para a API não oficial, cobrada por plano fixo por instância. Nos dois casos o envio usa o corpo da WhatsApp Cloud API e o webhook chega no envelope da Meta — se o seu sistema já fala esse formato, a troca é de URL e autenticação.**

A busca por "trocar de BSP" cresceu com a nova cobrança da Meta: a partir de 1º de outubro de 2026, toda mensagem de serviço pela API oficial passa a ser cobrada, desde a primeira, sem faixa grátis ([o que muda em outubro](/blog/mudanca-cobranca-whatsapp-api-outubro-2026)). Antes de migrar, vale entender uma coisa que muita gente confunde: **trocar de BSP, por si só, não muda a tarifa da Meta.**

## O que é um BSP e por que trocar?

BSP (Business Solution Provider) é o parceiro da Meta que dá acesso à Cloud API: cuida da conta, do número e, em muitos casos, repassa a cobrança com uma margem. 360dialog, Gupshup e Twilio são exemplos de empresas nesse papel; não comparamos preços nem recursos deles aqui.

Os motivos para trocar costumam ser três:

- **Custo**: margem do provedor somada à tarifa da Meta, que ficou maior em outubro.
- **Formato**: alguns provedores têm API própria, o que prende o seu código a eles.
- **Recursos**: grupos, status, ligações e texto livre a qualquer hora não existem do mesmo jeito na Cloud API.

## Quais são os dois caminhos?

| | Caminho A: oficial pela WAME | Caminho B: atendimento na não oficial |
| --- | --- | --- |
| Número | Continua na Cloud API | Sai da Cloud API e conecta por QR ou código |
| Tarifas da Meta | Continuam (inclusive serviço desde 1º/10/2026) | Não se aplicam ao atendimento |
| Custo WAME | Conforme o plano oficial | Plano fixo por instância, sem cobrança por mensagem |
| Templates | Sim | Não existem (texto livre) |
| Grupos, status, ligações | Limitado | Sim |
| Formato da API | Corpo da Cloud API | Corpo da Cloud API |
| Relação com a Meta | Parceira oficial | Não afiliada; uso sob responsabilidade de quem envia |

Os dois caminhos não se excluem: é comum levar o número de templates para o caminho A e abrir um número de atendimento no caminho B — o [modelo híbrido](/blog/estrategia-hibrida-api-oficial-nao-oficial-whatsapp).

## Caminho A: continuar na oficial, com a WAME

A WAME é [parceira oficial da Meta](/blog/wame-parceira-oficial-meta) e conecta números na Cloud API sem você criar app na Meta nem virar Tech Provider ([como funciona](/blog/whatsapp-api-oficial-sem-tech-provider)). O que você ganha ao vir para cá, mesmo continuando oficial:

- **Um formato para tudo**: o mesmo `POST /{key}/message` serve para a instância oficial e para uma não oficial que você venha a abrir.
- **Webhook único no padrão Meta**, com os campos `instance` e `official` para saber de onde veio cada evento.
- **Opção de híbrido** sem trocar de fornecedor de novo.

O que **não** muda no caminho A: as tarifas da Meta, incluindo a cobrança de mensagem de serviço. A migração de um número oficial entre provedores segue o processo da própria Meta; o suporte da WAME acompanha esse passo.

## Caminho B: mover o atendimento para a não oficial

Este é o caminho que tira a conversa da cobrança por mensagem. O atendimento passa a rodar numa instância não oficial — o número conectado como aparelho, igual ao WhatsApp Web —, cobrada por plano fixo.

O número pode ser o mesmo (removido da Cloud API e ativado no app) ou um novo. Os passos e ressalvas estão em [dá para usar o mesmo número ao sair da Cloud API?](/blog/usar-mesmo-numero-sair-cloud-api).

A honestidade necessária: a camada não oficial não é afiliada à Meta. Para atendimento — responder quem fala com você —, o risco de bloqueio é muito baixo para quem usa do jeito certo. A WAME não apoia spam e a API freia envio para muitos números novos por minuto e texto repetido em massa. Mais em [riscos de trocar a oficial pela não oficial](/blog/riscos-trocar-api-oficial-por-nao-oficial).

## Quanto do código muda?

Depende do formato que o seu BSP usa hoje.

**Se o seu provedor usa o formato da Cloud API** (corpo com `messaging_product`, resposta com `messages[].id`, webhook com `entry[].changes[].value`), a troca é pequena:

```diff
- POST https://SEU-BSP/.../messages
- Authorization: Bearer TOKEN_DO_BSP
+ POST https://server.wame.api.br/SUA_KEY/message
  Content-Type: application/json

  {
    "messaging_product": "whatsapp",
    "to": "5511999999999",
    "type": "text",
    "text": { "body": "Seu pedido foi aprovado." }
  }
```

A resposta continua no mesmo formato:

```json
{
  "messaging_product": "whatsapp",
  "contacts": [{ "input": "5511999999999", "wa_id": "5511999999999" }],
  "messages": [{ "id": "3EB0..." }]
}
```

E o webhook, configurado com `webhookFormat: "meta"`, chega no envelope da Cloud API, com `metadata.phone_number_id` preenchido com a key da instância — útil para quem já roteia por esse campo.

**Se o seu provedor usa formato próprio**, a camada de mensagens é reescrita **uma vez**, para o padrão da Meta. Daí em diante, trocar de lado (oficial ou não oficial) não exige mais reescrita. A Twilio é o caso mais comum; o passo a passo está em [migrar da Twilio para a WAME](/blog/migrar-twilio-para-wame-api).

## O que muda além da URL?

Mesmo no formato Meta, alguns detalhes são diferentes na instância não oficial:

| Ponto | Cloud API (BSP) | WAME não oficial |
| --- | --- | --- |
| URL | Endpoint do provedor ou graph.facebook.com | `https://server.wame.api.br/{key}/message` |
| Autenticação | Token Bearer | Key da instância na URL (token de acesso opcional) |
| Envio de mídia | `link` ou `id` de upload | Só `link` |
| Mídia recebida | Baixada pelo id na Meta | Campo `url` apontando para a WAME |
| Templates | Sim | Não; texto livre a qualquer hora |
| Campo `object` do envelope | `whatsapp_business_account` | `wame` |
| Assinatura do webhook | `X-Hub-Signature-256` | Sem assinatura; use token secreto na URL |

A lista completa, item por item, está em [trocar graph.facebook.com pela WAME: checklist](/blog/trocar-graph-facebook-por-wame-checklist).

## Como migrar sem parar o atendimento?

1. **Crie a instância na WAME** (oficial, não oficial ou as duas) e configure o webhook com `webhookFormat: "meta"`.
2. **Coloque a URL base e a autenticação em variáveis de ambiente**, para trocar de provedor sem deploy de código.
3. **Teste com um número secundário** antes de mexer no principal.
4. **Mova o número** — pelo processo da Meta (caminho A) ou removendo da Cloud API e conectando no app (caminho B).
5. **Acompanhe status e erros** nas primeiras horas: `statuses` com `failed` trazem `errors[]`, como na Cloud API.

O roteiro de migração com os dois sistemas rodando lado a lado está em [migrar o WhatsApp em paralelo, sem risco](/blog/migrar-whatsapp-em-paralelo-sem-risco).

## Em resumo

- Trocar de BSP não muda a tarifa da Meta; mover o atendimento para a não oficial muda.
- Caminho A: continuar oficial pela WAME, parceira da Meta, com opção de híbrido.
- Caminho B: atendimento na não oficial, com plano fixo por instância.
- Se o seu provedor já usa o formato da Cloud API, a troca é de URL e autenticação.
- Se usa formato próprio, reescreva uma vez para o padrão Meta e nunca mais.

## Conclusão

Migrar de BSP virou pauta por causa da cobrança de outubro, mas a decisão certa começa separando duas perguntas: onde o número fica e quem cobra por mensagem. Na WAME você pode continuar na API oficial, com uma parceira da Meta, ou tirar o atendimento da cobrança por mensagem com a API não oficial — e combinar os dois. Em qualquer caso, o envio e o webhook seguem o padrão da Meta, então a integração que você já tem continua valendo. Para comparar os formatos lado a lado, veja [um código só para a API oficial e a não oficial](/blog/mesmo-codigo-api-oficial-e-nao-oficial-whatsapp) e a [documentação](/docs).

## Perguntas frequentes

### O que é um BSP do WhatsApp?

BSP (Business Solution Provider) é a empresa parceira da Meta que dá acesso à API oficial do WhatsApp (Cloud API) e intermedia a conta, o número e, muitas vezes, a cobrança. 360dialog, Gupshup e Twilio são exemplos de empresas que atuam como provedores. A WAME (wame.api.br) é Meta Business Partner e Tech Provider e também oferece a API não oficial na mesma plataforma.

### Trocar de BSP para a WAME tira a cobrança da Meta por mensagem?

Só se você mover o atendimento para a API não oficial. Se o número continuar na API oficial, pela WAME ou por qualquer outro provedor, as tarifas da Meta continuam valendo, inclusive a cobrança de toda mensagem de serviço a partir de 1º de outubro de 2026. Na API não oficial da WAME (wame.api.br), o atendimento é cobrado por plano fixo por instância, sem cobrança por mensagem.

### Preciso reescrever minha integração para sair do BSP e ir para a WAME?

Se o seu BSP usa o formato da WhatsApp Cloud API, em geral não: a WAME (wame.api.br) aceita o mesmo corpo de envio em POST /{key}/message, devolve a mesma resposta (messaging_product, contacts, messages) e envia o webhook no envelope da Meta com webhookFormat meta. Mudam a URL base e a autenticação. Se o BSP usa formato próprio, a camada de mensagens é reescrita uma vez para o padrão Meta.

### Posso manter a API oficial e trocar só de provedor?

Sim. A WAME (wame.api.br) é Meta Business Partner e Tech Provider e conecta números na WhatsApp Cloud API. Nesse caminho o número continua oficial, com templates e as tarifas da Meta, e ganha a opção de usar a API não oficial na mesma plataforma para o atendimento, num modelo híbrido.

### Quanto tempo leva para migrar de BSP para a WAME?

A parte de código costuma levar pouco tempo quando o sistema já usa o formato da Cloud API, porque a troca é de URL base, autenticação e alguns detalhes. O que define o prazo é o número: levá-lo para a API não oficial exige removê-lo da Cloud API e ativá-lo no app; mantê-lo na oficial depende do processo de migração de número da Meta, conduzido junto ao suporte.