Altas desde tu web o tu sistema: formulario y API

Encender las altas

Cada campaña tiene su pestaña Formulario y API. Marca Recibir altas desde fuera y la campaña recibe un código de 10 letras, que llevan el formulario y la API. Si las apagas, el código se guarda: el formulario que ya pegaste vuelve a valer al encenderlas.

Para recibir altas, Secuenza tiene que estar registrado: llegan a tu cuenta y de ahí pasan al programa.

El formulario para tu web

Secuenza te genera el código HTML, sin scripts, para pegarlo en WordPress, Wix, Shopify o una página hecha a mano. Tú eliges:

• Qué pide además del correo (nombre, empresa, teléfono…) y qué es obligatorio.
• El idioma de las etiquetas, que será también el de los contactos que lleguen por él.
• El texto del botón.
• Tu política de privacidad, que se enlaza en la casilla de consentimiento. La casilla es obligatoria.
• La página de gracias, adonde va quien se apunta. Si la dejas vacía, Secuenza enseña una con tu nombre y tu logo.
• Con estilos básicos o sin ellos, si prefieres que lo vista tu web.

Así se ve te enseña el resultado. Pulsa Copiar el código y pégalo en tu página. El formulario lleva un campo oculto contra los robots y admite diez altas por dirección IP cada diez minutos.

La API para tu sistema

Para dar de alta desde tu web, tu tienda o tu CRM: una petición POST a https://api.secuenza.com/v1/altas con la persona en JSON y tu clave en la cabecera Authorization: Bearer sz_alta_….

Pulsa Crear la clave. Es la misma para todas tus campañas: guárdala en tu servidor, nunca en una página web, porque quien la tenga puede dar de alta en tus campañas. Si se te escapa, Cambiar la clave anula la anterior.

curl -X POST https://api.secuenza.com/v1/altas \
  -H "Authorization: Bearer sz_alta_…" \
  -H "Content-Type: application/json" \
  -d '{"campana":"abcdefghjk","email":"ana@ejemplo.com","nombre":"Ana","empresa":"Asesoría Norte","idioma":"es","consentimiento":true}'

Solo campana (el código) y email son obligatorios. También admite nombre, apellidos, empresa, cargo, telefono, ciudad, pais, web, idioma (es, en, fr, it o de), consentimiento (true si aceptó recibir tus correos) y campos, con tus campos propios por su clave.

Responde 202 si la ha recibido, 400 si falta la dirección o no es válida, 401 si la clave no vale, 404 si la campaña no admite altas y 429 si llegan demasiadas seguidas.

Cuándo llegan al programa

Las altas esperan en Secuenza hasta que el programa las recoge: cada 5 minutos mientras envía, cada hora si no, y al abrirlo. Con el PC apagado no se pierden: llegan al encenderlo. Las que nadie recoge en 30 días se borran.

Qué se hace con cada alta

• Si no era contacto, se crea con lo que trae y se apunta a la campaña. Su origen dice «Formulario web» o «Alta por la API», y si marcó la casilla, el consentimiento queda guardado con su fecha.
• Si ya era contacto, solo se rellena lo que le faltaba y se apunta. Un inactivo vuelve a activo.
• No se apunta a quien se dio de baja, cuya dirección no existe, marcó un correo como spam o está en la lista de supresión. A quien pidió que se borrasen sus datos ni siquiera se le guarda la dirección.
• En la versión gratuita, el alta que no cabe en el límite de contactos queda apuntada como «No cabe en la versión gratuita».

Últimas altas, en la misma pestaña, enseña las que han llegado y qué se ha hecho con cada una.

Secuenza no manda un correo de confirmación antes de apuntar a nadie (doble opt-in). Si escribes a países donde se espera, como Alemania, tenlo en cuenta: lo explican las buenas prácticas legales.