Formularios de suscripción
Cada comando de los formularios de suscripción y de las personas que los rellenan, con ejemplos prácticos.
Cómo encaja todo
Un formulario de suscripción añade a tus audiencias a las personas que lo rellenan. Guarda un borrador y una copia activa: update cambia el borrador y los ajustes, y publish activa el borrador. Leer requiere forms:read y cambiar requiere forms:write. resend-confirmation, así como cualquier cambio que haga que el formulario envíe correo, también requiere emails:send.
openemail forms create --name "Newsletter sign-up" --starter newsletter --publishopenemail forms list-submissions frm_3b9d2e7a1c4f80d56e2a9b14 --status pendingopenemail forms analytics frm_3b9d2e7a1c4f80d56e2a9b14 --days 30Formularios
| Comando | Qué hace |
|---|---|
| openemail forms list | Una página de los formularios, del más reciente al más antiguo, con su estado y sus cifras |
| openemail forms create --name <value> | Crear un borrador a partir de --starter, de un archivo --document o de un solo campo de correo. --publish lo activa al momento |
| openemail forms get <id> | Un formulario con su borrador, su copia activa y sus ajustes |
| openemail forms update <id> | Cambiar el nombre, el borrador de --document o cualquier ajuste, como --settings-double-opt-in, en una sola llamada |
| openemail forms publish <id> | Activar el borrador |
| openemail forms pause <id> | Hacer que un formulario publicado deje de aceptar suscripciones |
| openemail forms resume <id> | Volver a abrir un formulario en pausa |
| openemail forms duplicate <id> | Copiar un formulario en un borrador nuevo, sin sus suscripciones |
| openemail forms delete <id> | Eliminar un formulario y sus suscripciones después de que confirmes. Un inicio de sesión con el navegador también pide un código de verificación |
| openemail forms list-starters | Los puntos de partida desde los que puede empezar un formulario nuevo |
| openemail forms get-starter <slug> | Un punto de partida con su documento |
| openemail forms analytics <id> | Vistas, suscripciones y personas añadidas en un periodo, de 30 días salvo que --days o --minutes indiquen otra cosa |
Envíos
| Comando | Qué hace |
|---|---|
| openemail forms list-submissions <id> | Una página de suscripciones, de la más reciente a la más antigua. --q busca en las direcciones de correo, y --status elige pending o added |
| openemail forms get-submission <id> <submission-id> | Una suscripción con todas sus respuestas |
| openemail forms delete-submission <id> <submission-id> | Eliminar una suscripción después de que confirmes. La persona sigue en tus contactos |
| openemail forms delete-submissions <id> <submission-ids...> | Eliminar hasta 200 suscripciones después de que confirmes |
| openemail forms approve-submission <id> <submission-id> | Añadir una suscripción pendiente sin su confirmación. También requiere contacts:write |
| openemail forms resend-confirmation <id> <submission-id> | Enviar por correo un enlace de confirmación nuevo a una suscripción pendiente, salvo que ya haya salido uno en los últimos diez minutos. También requiere emails:send |
Suscribir a alguien
subscribe envía datos por POST a un formulario publicado, como hace su página. No necesita clave ni inicio de sesión, así que funciona sin sesión iniciada. Pasa las demás respuestas como JSON con --data, y la página en la que estaba el formulario con --oe-source.
openemail forms subscribe frm_3b9d2e7a1c4f80d56e2a9b14 --email [email protected] --data '{"first_name":"Ann","consent":true}'Una respuesta que falta o es incorrecta sale con el código 7 y lista cada campo con su motivo. Un formulario en pausa sale con 6, y demasiadas suscripciones desde una misma red, con 8.
