Páginas de suscripción | AgentsMail.io Documentation

Una página de suscripción es una página que AgentsMail aloja por ti en una dirección pública. Los visitantes dejan en ella su dirección de correo y se convierten en contactos de una lista. Estos endpoints crean, leen, modifican y eliminan esas páginas: los mismos objetos que gestiona la pantalla Audiencia → Páginas de captación. Una página es un tema más un puñado de ajustes con nombre. Aquí no hay constructor de páginas y no hace falta: content es el HTML de la página, y todo lo demás es un campo.

GETList sign-up pages/api/v1/signup-pages POSTCreate a sign-up page/api/v1/signup-pages GETGet a sign-up page/api/v1/signup-pages/{id}PATCHUpdate a sign-up page/api/v1/signup-pages/{id}DELETEDelete a sign-up page/api/v1/signup-pages/{id}GETBrowse the theme catalogue/api/v1/signup-page-templates

Las dos cosas que una página siempre necesita

Una lista. listId indica adónde van las direcciones, y debe ser una lista de tu organización: una página alimenta exactamente una lista. Obtén el id con listar las listas.
{{form}} en el HTML. Es el marcador que sustituye el propio formulario. Sin él, la página se mostraría sin ningún campo que rellenar, así que el guardado se rechaza con 400 y el mensaje nombra el marcador que falta.

Los demás marcadores son opcionales: {{heroTitle}}, {{heroSubtitle}}, {{organizationName}} y {{poweredBy}}. Si omites uno, el texto correspondiente simplemente no se muestra.

Publicada o borrador

status es draft o published. Una página publicada responde en su dirección pública; una página en borrador responde con una página de no encontrado y no recoge nada. Si creas sin status, obtienes un borrador: aprovisionar una página nunca pone una dirección en línea por accidente. La dirección pública es https://www.agentsmail.io/public/{organizationSlug}/subscribe/{slug}, donde slug es el campo que defines en la página.

Partir de un tema

Explorar el catálogo de temas devuelve los temas que mantenemos. Elegir uno es una copia: toma su content, envíalo como content de tu página y pon su name en sourceTemplateName para que la pantalla pueda indicar de dónde viene la página. Nada de lo que le ocurra después al catálogo cambia una página que ya creaste.

Qué se rechaza

Un slug ya usado por otra de tus páginas: 409, y el mensaje nombra la página que ocupa la dirección.
HTML sin {{form}}: 400.
Un listId que pertenece a otra organización: 404, exactamente como una lista desconocida.
Un redirectUrl que no es http:// ni https://: 400.

Consulta Páginas de suscripción para ver qué ve un visitante y qué ocurre cuando alguien se suscribe.