Passer au contenu principal
Le libellé que vos messages peuvent utiliser, et le moyen d’en demander davantage sans ouvrir le portail. Le frère de /secure/senders, et tout ce qui y est dit s’applique : quatre appels, la même enveloppe, et ce que vous écrivez est stocké en attente d’approbation et n’est pas utilisable tant que votre fournisseur n’a pas décidé.

Les quatre appels

Disponibles à partir de la passerelle 0.9.7. Le listing porte les mêmes champs que les sender IDs — y compris les quatre états, dont seul APPROVED est utilisable — avec une différence à remarquer : value est le libellé et label est le nom que vous lui avez donné.

En demander un

La grammaire des placeholders

Écrivez le message comme le régulateur l’écrit, avec un placeholder à la place de la partie qui change :
Tout ce qui est autour d’un placeholder est mis en correspondance à l’identique. Changez-en un mot et le message ne correspond plus au template.

Ce qui est refusé avant d’être stocké

Le libellé est vérifié par le même code qui le compilera s’il est approuvé, donc tout ce qui est accepté ici se chargera. Quatre refus, chacun avec une raison :
Refusé ici même si un template déjà stocké ainsi se charge encore. Avant que la ligne n’existe, être strict ne coûte rien, et l’accepter approuverait un template qui correspond à plus que ce que vous vouliez.
Plus long que tout message qu’un template pourrait approuver.
Un libellé sans aucun placeholder est légitime et constitue le template le plus strict qui soit : il approuve exactement un message et rien d’autre.

En modifier un

PUT remplace plutôt que de patcher — un champ que vous n’envoyez pas est effacé. Envoyez la ligne entière.
Le nom d’un template est jugé, contrairement au label d’un sender ID. Changer soit le libellé soit le nom d’un template approuvé le remet à PENDING et il cesse d’être accepté jusqu’à ce que votre fournisseur l’approuve à nouveau.L’asymétrie n’est pas arbitraire : le nom est ce sous quoi votre fournisseur a lu le libellé, donc un nom changé signifie que la décision portait sur autre chose. Le label d’un sender ID n’est mis en correspondance par rien et peut être changé librement.
Envoyez "confirm_suspend": true pour procéder à une modification qui suspendrait un template en production, et lisez le status de la réponse.

Erreurs

Le même ensemble que /secure/senders — 400, 404, 409, 412, 429 et 503, le message nommant lequel.

Voir aussi

Sender IDs

Les mêmes quatre appels pour les noms depuis lesquels vous envoyez.

Sender IDs et templates

La même chose via le portail.