Enviar una plantilla con variables

Cómo se emparejan los parámetros

Por posición y no por nombre. El primer parámetro de la lista del cuerpo rellena el primer marcador, el segundo rellena el segundo, y así sucesivamente. No hay forma de nombrar una variable, e intercambiar dos parámetros produce un mensaje que se envía con éxito y con los valores en los lugares equivocados.

Ese último caso es el peligroso, porque nada falla. Un cliente recibe una confirmación de pedido con la fecha donde debería ir el importe, y no se registra ningún error en ninguna parte.

Los componentes son listas separadas

Una variable de encabezado y una variable de cuerpo no comparten la misma lista. Cada componente lleva sus propios parámetros, y juntarlos produce una discrepancia de recuento.

• Los parámetros de encabezado van en un componente de encabezado, y hay como mucho uno.
• Los parámetros de cuerpo van en un componente de cuerpo, en orden.
• Los parámetros de URL de botón van en un componente de botón, indexados por botón.
• Enviar una sola lista plana con todos ellos devuelve el error 132000.

Acertar con el idioma

Una plantilla se identifica por nombre e idioma juntos, así que el mismo nombre en dos idiomas son dos plantillas. Enviar en donde la plantilla se creó como en_US no hace fallback: falla con el error 132001, que se lee como si la plantilla no existiera.

Lista las plantillas del número y copia la cadena de idioma exacta, en lugar de suponer su forma. Este es el error de plantilla más común de todos y el menos descriptivo.

Parámetros tipados

La mayoría de los parámetros son texto simple. Algunos no lo son, y enviarlos como texto falla con el error 132012.

• Los parámetros de moneda llevan un importe, un código de moneda y una cadena de fallback.
• Los parámetros de fecha y hora llevan un objeto estructurado con un fallback.
• Los parámetros de encabezado multimedia llevan un id de medio o un enlace, no un nombre de archivo.
• La cadena de fallback es lo que se muestra si la app del destinatario no consigue formatear el valor.

Qué significa cada error

Los tres fallos se distinguen entre sí, lo que ahorra muchas conjeturas si se registran por separado en lugar de agruparse como un error de plantilla.

El error 132001 significa que el par de nombre e idioma no resolvió, así que revisa primero el idioma. El error 132000 significa que el recuento está mal, así que compáralo con la definición de la propia plantilla. El error 132012 significa que el formato de un valor está mal, lo que suele ser un parámetro tipado enviado como cadena simple.

Errores comunes

• Suponer que en hace fallback a en_US. No lo hace, y el error se lee como plantilla inexistente.
• Juntar los parámetros de encabezado y de cuerpo en una sola lista. Son componentes separados.
• Enviar una moneda o una fecha como texto simple. Los parámetros tipados tienen una forma definida.

Preguntas frecuentes

Sigue leyendo