/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 “http://www.ejemplo.com/formResponse.php”, el sistema direccionara a las personas a una URL de este tipo:

http://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