Enviando um template com variáveis
As variáveis de template são posicionais, não nomeadas. Você envia uma lista de parâmetros por componente, em ordem, e a contagem tem que bater exatamente com o que o template define. Três erros diferentes nascem de errar isso, e cada um aponta para um engano distinto.
O erro para uma contagem de parâmetros que não bate com o template.
O erro para parâmetros cujo formato não corresponde.
O erro quando o nome e o idioma do template não resolvem.
Como os parâmetros são associados
Por posição, e não por nome. O primeiro parâmetro da lista do corpo preenche o primeiro marcador, o segundo preenche o segundo, e assim por diante. Não existe forma de nomear uma variável, e trocar dois parâmetros de lugar produz uma mensagem que é enviada com sucesso e com os valores nos lugares errados.
Esse último caso é o perigoso, porque nada falha. Um cliente recebe uma confirmação de pedido com a data onde deveria estar o valor, e nenhum erro é registrado em lugar nenhum.
Componentes são listas separadas
Uma variável de cabeçalho e uma variável de corpo não compartilham a mesma lista. Cada componente carrega os próprios parâmetros, e juntá-los produz uma divergência de contagem.
- Os parâmetros de cabeçalho vão num componente de cabeçalho, e existe no máximo um.
- Os parâmetros de corpo vão num componente de corpo, em ordem.
- Os parâmetros de URL de botão vão num componente de botão, indexados por botão.
- Enviar uma lista única e achatada com todos eles devolve o erro 132000.
Acertando o idioma
Um template é identificado por nome e idioma juntos, então o mesmo nome em dois idiomas são dois templates. Enviar en onde o template foi criado como en_US não faz fallback: falha com o erro 132001, que se lê como se o template não existisse.
Liste os templates do número e copie a string de idioma exata, em vez de supor o formato dela. Este é o erro de template mais comum de todos e o menos descritivo.
Parâmetros tipados
A maior parte dos parâmetros é texto simples. Alguns não são, e enviá-los como texto falha com o erro 132012.
- Parâmetros de moeda carregam um valor, um código de moeda e uma string de fallback.
- Parâmetros de data e hora carregam um objeto estruturado com um fallback.
- Parâmetros de cabeçalho de mídia carregam um id de mídia ou um link, não um nome de arquivo.
- A string de fallback é o que aparece se o app do destinatário não conseguir formatar o valor.
O que cada erro significa
As três falhas são distinguíveis, o que poupa muita adivinhação se forem registradas separadamente em vez de agrupadas como um erro de template.
O erro 132001 significa que o par de nome e idioma não resolveu, então confira o idioma primeiro. O erro 132000 significa que a contagem está errada, então compare com a definição do próprio template. O erro 132012 significa que o formato de um valor está errado, o que normalmente é um parâmetro tipado enviado como string simples.
Erros comuns
- Supor que en faz fallback para en_US. Não faz, e o erro se lê como template inexistente.
- Juntar os parâmetros de cabeçalho e de corpo numa lista só. Eles são componentes separados.
- Enviar uma moeda ou uma data como texto simples. Parâmetros tipados têm um formato definido.
A EasyCoexistence lista os templates com seus nomes e códigos de idioma exatos pelo painel e pelo conector MCP, então um envio usa os valores que a Meta realmente guardou.
Perguntas frequentes
As variáveis de template são nomeadas?
Não. Elas são posicionais, então a ordem dos parâmetros é todo o contrato.
Por que meu template não existe?
Normalmente é o código de idioma. Um template é identificado por nome e idioma juntos, e não há fallback.
E se eu enviar parâmetros demais?
Erro 132000. Parâmetros demais falham do mesmo jeito que parâmetros de menos.
Como eu envio um valor em dinheiro?
Como um parâmetro de moeda, com um valor, um código de moeda e uma string de fallback, e não como texto simples.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em