Pages d'inscription

Une page d'inscription est une page qu'AgentsMail héberge pour vous à une adresse publique. Les visiteurs y laissent leur adresse e-mail et deviennent des contacts dans une liste. Ces endpoints créent, lisent, modifient et suppriment ces pages — les mêmes objets que gère l'écran Audience → Pages de capture. Une page, c'est un thème plus une poignée de réglages nommés. Il n'y a pas de constructeur de pages ici, et il n'en faut pas : content est le HTML de la page, et tout le reste est un champ.

Les deux choses dont une page a toujours besoin

  1. Une liste. listId indique où vont les adresses, et ce doit être une liste de votre organisation — une page alimente exactement une liste. Obtenez l'identifiant avec Lister les listes.
  2. {{form}} dans le HTML. C'est l'emplacement que remplace le formulaire lui-même. Sans lui, la page s'afficherait sans aucun champ à remplir : l'enregistrement est donc refusé avec 400, et le message nomme l'emplacement manquant.
Les autres emplacements sont facultatifs : {{heroTitle}}, {{heroSubtitle}}, {{organizationName}} et {{poweredBy}}. Omettez-en un et le texte correspondant n'est tout simplement pas affiché.

Publiée ou brouillon

status vaut draft ou published. Une page publiée répond à son adresse publique ; une page brouillon répond par une page introuvable et ne collecte rien. Créez sans status et vous obtenez un brouillon — provisionner une page ne met jamais une adresse en ligne par accident. L'adresse publique est https://www.agentsmail.io/public/{organizationSlug}/subscribe/{slug}, où slug est le champ que vous définissez sur la page.

Partir d'un thème

Parcourir le catalogue de thèmes renvoie les thèmes que nous maintenons. En choisir un, c'est faire une copie : prenez son content, envoyez-le comme content de votre page, et mettez son name dans sourceTemplateName pour que l'écran puisse dire d'où vient la page. Rien de ce qui arrive ensuite au catalogue ne modifie une page déjà créée.

Ce qui est refusé

  • Un slug déjà utilisé par une autre de vos pages — 409, et le message nomme la page qui occupe l'adresse.
  • Un HTML sans {{form}} — 400.
  • Un listId qui appartient à une autre organisation — 404, exactement comme une liste inconnue.
  • Un redirectUrl qui n'est ni http:// ni https:// — 400.
Voir Pages d'inscription pour ce que voit un visiteur et ce qui se passe quand quelqu'un s'inscrit.