Comparativo
Quando usar não oficial
- Você quer testar rápido com um número pessoal ou de teste
- Precisa enviar para grupos do WhatsApp
- Não quer custo adicional por mensagem
- Está construindo um MVP ou prova de conceito
- O volume de envio é moderado (centenas por dia, não milhares)
Quando usar WABA
- Precisa de estabilidade máxima e não pode arriscar o número
- Compliance e governança são requisitos (empresas maiores, saúde, financeiro)
- Quer usar templates de mensagem aprovados pela Meta
- O volume é alto e precisa de garantia de entrega
- Quer evitar qualquer risco de banimento
Sobre custo
Instâncias não oficiais não têm custo por mensagem além do plano da Zapster. Instâncias WABA seguem a tabela de preços da Meta, que cobra por conversa (não por mensagem). O preço varia por:- Categoria: marketing é mais caro que utility, que é mais caro que authentication
- País do destinatário: cada país tem uma faixa de preço diferente
- Quem inicia: se o cliente inicia a conversa, a primeira janela de 24h pode ser gratuita
Posso ter os dois tipos na mesma conta?
Sim. Você pode ter instâncias oficiais e não oficiais na mesma conta da Zapster, cada uma com seus webhooks e configurações. A API funciona da mesma forma para ambos os tipos.Migração entre tipos
É possível converter uma instância não oficial para WABA, ou o contrário, sem perder o ID da instância, os webhooks cadastrados nem as configurações. Migrar para WABA exige o objetowaba com access_token, phone_number_id e waba_id; migrar para não oficial não exige credenciais.
Antes de migrar, revise os eventos de webhook assinados na instância. Os dois tipos de conexão suportam conjuntos diferentes de eventos, e a API oficial suporta um conjunto menor: se algum webhook estiver inscrito em um evento que o tipo de destino não emite, a migração é rejeitada até você ajustar as inscrições. É uma ação disruptiva, então migrar uma instância que já está em uso exige uma confirmação explícita antes de seguir.
Veja o passo a passo completo, os requisitos de cada sentido e o fluxo de confirmação na referência do endpoint de migração.
Próximos passos
- Como conectar uma instância WABA
- Enviar mensagens para BSUID para responder a usuários com telefone oculto no canal oficial
- Cobrança de mensagens no WhatsApp oficial (WABA)
- Boas práticas de envio
- Criar instância via API
- Migrar o tipo de conexão via API