Enviar um template com variáveis
As variáveis do template são posicionais, não nomeadas. Envia-se uma lista de parâmetros por componente, pela ordem, e a contagem tem de corresponder exatamente ao que o template define. Há três erros diferentes quando isto é feito incorretamente, e cada um aponta para uma falha distinta.
O erro quando a contagem de parâmetros não corresponde ao template.
O erro quando o formato dos parâmetros não corresponde.
O erro quando o nome e o idioma do template não são resolvidos.
Como os parâmetros são associados
Por posição, não pelo nome. O primeiro parâmetro da lista do corpo preenche o primeiro marcador, o segundo preenche o segundo, e assim sucessivamente. Não é possível atribuir um nome a uma variável, e trocar dois parâmetros produz uma mensagem enviada com sucesso, mas com os valores nos locais errados.
Este último caso é perigoso, porque nada falha. Um cliente recebe uma confirmação de encomenda com a data no lugar do montante, e não é registado qualquer erro.
Os componentes são listas separadas
Uma variável do cabeçalho e uma variável do corpo não partilham uma lista. Cada componente transporta os seus próprios parâmetros, e juntá-los provoca uma incompatibilidade na contagem.
- Os parâmetros do cabeçalho ficam num componente de cabeçalho, e existe no máximo um.
- Os parâmetros do corpo ficam num componente de corpo, pela ordem.
- Os parâmetros do URL do botão ficam num componente de botão, indexados pelo botão.
- Enviar uma única lista plana para todos devolve o erro 132000.
Definir corretamente o idioma
Um template é identificado pelo nome e pelo idioma em conjunto, por isso o mesmo nome em dois idiomas corresponde a dois templates. Enviar en quando o template foi criado como en_US não faz fallback: falha com o erro 132001, que indica que o template não existe.
Liste os templates no número e copie a string exata do idioma, em vez de assumir o seu formato. Este é o erro de template mais comum e o menos descritivo.
Parâmetros tipados
A maioria dos parâmetros é texto simples. Alguns não são, e enviá-los como texto falha com o erro 132012.
- Os parâmetros de moeda transportam um montante, um código de moeda e uma string de fallback.
- Os parâmetros de data e hora transportam um objeto estruturado com um fallback.
- Os parâmetros de multimédia do cabeçalho transportam um ID de multimédia ou uma ligação, não um nome de ficheiro.
- A string de fallback é apresentada se a aplicação do destinatário não conseguir formatar o valor.
O que significa cada erro
As três falhas distinguem-se, o que reduz bastante as tentativas ao acaso se forem registadas separadamente, em vez de agrupadas como um erro de template.
O erro 132001 significa que o par nome e idioma não foi resolvido, por isso verifique primeiro o idioma. O erro 132000 significa que a contagem está errada, por isso compare-a com a própria definição do template. O erro 132012 significa que o formato de um valor está errado, normalmente porque um parâmetro tipado foi enviado como string simples.
Erros comuns
- Assumir que en faz fallback para en_US. Não faz, e o erro indica que falta o template.
- Juntar os parâmetros do cabeçalho e do corpo numa única lista. São componentes separados.
- Enviar uma moeda ou uma data como texto simples. Os parâmetros tipados têm um formato definido.
O EasyCoexistence apresenta os templates com os nomes e códigos de idioma exatos através do painel e do conector MCP, para que o envio use os valores realmente armazenados pela Meta.
Perguntas frequentes
As variáveis do template têm nome?
Não. São posicionais, por isso a ordem dos parâmetros é todo o contrato.
Porque é que o meu template não existe?
Normalmente, por causa do código de idioma. Um template é identificado pelo nome e pelo idioma em conjunto, e não há fallback.
O que acontece se enviar demasiados parâmetros?
Erro 132000. Enviar demasiados falha da mesma forma que enviar poucos.
Como envio um montante?
Como parâmetro de moeda, com um montante, um código de moeda e uma string de fallback, não como texto simples.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em