/form/create
Crea un formulario de suscripción.
| Parámetros | ||
|---|---|---|
| Nombre | Descripción | Formato |
| list_id string |
ID de list a. | String alfanumérico. |
| include_name boolean |
Si desea o no incluir el campo “nombre” en el formulario. | |
| response_url integer |
URL para redirigir una vez procesada la solicitud. | Formato válidos de URL. |
| Valores de retorno | |
|---|---|
| status | “success”. |
| form_html | HTML del formulario codificado en BASE64. |
| form_id | ID del formulario creado. |
| styler_url | URL del modulo para aplicar estilos al formulario. |
| Códigos de error | |
|---|---|
| F03301D | No se encontró la lista con el list_id indicado. |
| F03302D | La URL en ‘response_url” no es válida. |
Styler
Si lo desea puede utilizar nuestro modulo de estilos para aplicar estilos visuales al formulario. Ingrese a la URL devuelta en ‘styler_url” para cargar el formulario y podes aplicarle estilos.
Los estilos serán aplicados “inline” por lo que el formulario no requerirá de ningún archivo de estilos externo.
Puede copiar y pegar el código HTML resultante o bien obtenerlo vía javascript del elemento <textarea id=” form_html”>
Redireccionamiento
Por defecto, cuando una persona se suscriba vía formulario, será redirigida a una página genérica donde se informará el estado de su suscripción, por ejemplo si la suscripción se realizo o hay algún problema con los datos ingresados en el formulario.
De la misma manera, cuando la persona valide su dirección, también será dirigido a esta página genérica.
Si lo desea, puede indicar una URL en ‘response_url’ para que el sistema redirija a esa URL, y de esa manera las personas queden siempre en su sitio.
En esta URL le enviaremos datos adicionales de la operación, como ser la dirección de email y el código de respuesta. Estos datos son llamados Variables de retorno, y se adjuntara en la URL de la siguiente manera:
Si por ejemplo, su URL es «https://www.ejemplo.com/formResponse.php», el sistema direccionara a las personas a una URL de este tipo:
https://www.ejemplo.com/formResponse.php?Addr=miemai%40dominio.com&Resp=21
«Addr» será la dirección de email del suscriptor y «Resp» será el código de respuesta.
A continuación puede ver una tabla con los distintos códigos de respuesta y su significado:
- 1: No es posible procesar su solicitud.
- 2: Nombre requerido no ingresado.
- 3: La dirección de email ingresada no es correcta.
- 6: La dirección de email ingresada ya se encuentra en la lista.
- 8: La dirección de email a suscribir ya se encuentra en la lista esperando confirmación.
- 11: La dirección de email a suscribir fue desuscripta en el pasado.
- 21: Un email le ha sido enviado a su casilla %1 para confirmar la suscripción a la lista
- 23: La dirección %1 ha sido suscripta a la lista
- 25: Uno o mas datos requeridos no fueron ingresados