No WhatsApp Oficial (Cloud API da Meta), você não pode escrever qualquer texto para quem não falou com você recentemente. Fora da janela de 24 horas, só sai modelo aprovado — o que a Meta chama de template ou HSM.
Isto não se aplica a números conectados por QR Code, que enviam texto livre. Modelo é exigência
do canal Oficial.
Os dois canais
O channel aparece em whatsapp_instances de um disparo. É a forma de descobrir, pela API, qual canal um número usa.
Um disparo não pode misturar os dois canais: 422 MIXED_PROVIDERS.
Onde os modelos aparecem
Os dois usam formatos diferentes. No envio avulso, template_components segue o formato bruto da
Meta. Nos disparos, cloudTemplate.variables é o mapeamento da SocialSell, que resolve o valor de cada
variável por contato.
Pré-requisitos
Para qualquer um dos dois caminhos, o modelo precisa:
- Existir na organização e estar vinculado àquele número
- Estar com status
APPROVED na Meta
- Bater exatamente com o idioma informado
Falhando qualquer um: 422 TEMPLATE_NOT_FOUND (ou TEMPLATE_NOT_APPROVED, em disparos).
A criação e a submissão de modelos para aprovação acontecem no painel — não há endpoint público para
isso na v1. A API consome modelos já aprovados.
Variáveis em disparos
Cada variável do modelo precisa resolver para algum texto, em todo contato da audiência.
Com sourceType: "contact_field", fallback é obrigatório. Sem ele, um contato sem o dado
receberia a mensagem com um buraco: “Olá , temos uma novidade”. A validação recusa o disparo antes de
isso acontecer.
Categoria e custo
A categoria do modelo (marketing, utilidade, autenticação) define o custo da mensagem na Meta e se vale a política de descadastro.
Ao estimar audiência, informe cloudTemplate. Sem ele, a
estimativa ignora a política de marketing e mostra mais gente do que o disparo vai atingir. cloud_template.category no objeto do disparo.
Cobrança
As mensagens do canal Oficial são cobradas pela Meta, direto na conta do cliente — não passam pela SocialSell e não consomem créditos da plataforma.
Sem moeda e forma de pagamento configuradas no portfólio de negócios da Meta, a Meta aceita o envio
e recusa todas as entregas depois (erro 131042). A mensagem aparece como enviada e nunca chega.
Ver o passo a passo. Erros
