Skip to main content
Escolher o modo é como escolher estrada ou atalho: a oficial segue as regras da Meta com mais previsibilidade; a não oficial é mais rápida para testar, mas com mais risco.

​
Oficial ou não oficial?

Cada número conectado no Notifique usa um dos dois modos. Não dá para alternar na mesma instância: se precisar mudar, crie uma nova.

​
Quando usar a oficial

  • Produto no ar atendendo clientes de verdade
  • Códigos de verificação, confirmação de pedido, marketing com template aprovado
  • Botões, listas e carrossel dentro das regras da Meta

​
Quando usar a não oficial

  • Validar ideia, montar protótipo ou integrar pela primeira vez
  • Precisar de grupos, editar/apagar mensagem ou baixar mídia recebida
  • Ainda não está pronto para a burocracia da conta Meta
A conexão não oficial não substitui a oficial em produção. Use para aprender e testar; para clientes reais em escala, migre para a oficial.
Em ambos os modos, você precisa de opt-in do destinatário, conteúdo permitido e respeito às políticas da Meta e aos Termos da Notifique.

​
Templates em vários números

Os dois modos permitem reutilizar templates em mais de um número, mas de formas diferentes: Mais sobre templates oficiais: Templates oficiais Meta.

​
Cobrança

Na oficial existem dois modelos, e o que muda tudo é quem paga a Meta: No caminho padrão (você conecta sua conta Meta pelo login no painel), a Notifique cobra o mesmo valor para qualquer país e qualquer categoria. As conversas em si aparecem na sua fatura da Meta, não na da Notifique.
Sem cartão ativo no gerenciador do WhatsApp, o primeiro envio é recusado com 402 (META_PAYMENT_METHOD_REQUIRED): “Add a payment method in WhatsApp Manager (Meta) for this WABA before sending.” Cadastre o cartão na Meta e confirme o pagamento no painel antes de enviar em produção.
Por que os dois modelos têm preços tão diferentes: a tabela por país já embute a tarifa da Meta. Cobrá-la de quem paga a Meta direto seria cobrar duas vezes o mesmo custo, uma na fatura da Meta e outra na da Notifique. Por isso a tabela por país vale só no BSP, onde é a Notifique que paga.
Vale nos dois modelos: o país sai do número, a categoria sai do template e marketing para números dos EUA é recusado antes de cobrar.

​
Comparativo completo

* Na oficial, fora da conversa recente, use template aprovado. Na não oficial, mensagem livre sem essa janela. ** Com template aprovado pela Meta. ⚠️ = funciona com formato ou regra específica. ⚠️ na não oficial (botões e carrossel): disponível via API, mas pode deixar de funcionar a qualquer momento (depende do WhatsApp). Em produção estável, prefira a oficial.
Não dá para converter uma instância de um modo para o outro. Crie outra instância no modo certo.
Integrando só pela API (sem browser no servidor)? Use mode: "OFFICIAL" (ou mode: "UNOFFICIAL") com generateShareableLink: true em POST /v1/whatsapp/instances para receber um link que o cliente abre e conclui a conexão (QR ou login Meta). Detalhes no Quick Start.

​
Resumo: qual escolher?

​
Próximos passos