Inscriptions depuis votre site ou votre système : formulaire et API

Activer les inscriptions

Chaque campagne a son onglet Formulaire et API. Cochez Recevoir des inscriptions de l’extérieur et la campagne reçoit un code de 10 lettres, utilisé par le formulaire et par l’API. Si vous les désactivez, le code est conservé : le formulaire déjà collé fonctionne de nouveau quand vous les réactivez.

Pour recevoir des inscriptions, Secuenza doit être enregistré : elles arrivent sur votre compte et passent de là au logiciel.

Le formulaire pour votre site

Secuenza génère le code HTML, sans scripts, à coller dans WordPress, Wix, Shopify ou une page faite à la main. Vous choisissez :

• Ce qu’il demande en plus de l’adresse e-mail (nom, entreprise, téléphone…) et ce qui est obligatoire.
• La langue de ses libellés, qui sera aussi celle des contacts qui arrivent par lui.
• Le texte du bouton.
• Votre politique de confidentialité, liée depuis la case de consentement. La case est obligatoire.
• La page de remerciement, où va celui qui s’inscrit. Si vous la laissez vide, Secuenza en affiche une avec votre nom et votre logo.
• Avec des styles de base ou sans, si vous préférez que votre site l’habille.

Aperçu vous montre le résultat. Cliquez sur Copier le code et collez-le dans votre page. Le formulaire contient un champ caché contre les robots et accepte dix inscriptions par adresse IP toutes les dix minutes.

L’API pour votre système

Pour inscrire depuis votre site, votre boutique ou votre CRM : une requête POST vers https://api.secuenza.com/v1/altas avec la personne en JSON et votre clé dans l’en-tête Authorization: Bearer sz_alta_….

Cliquez sur Créer la clé. C’est la même pour toutes vos campagnes : gardez-la sur votre serveur, jamais dans une page web, car celui qui l’a peut inscrire des personnes à vos campagnes. Si elle vous échappe, Changer la clé annule l’ancienne.

curl -X POST https://api.secuenza.com/v1/altas \
  -H "Authorization: Bearer sz_alta_…" \
  -H "Content-Type: application/json" \
  -d '{"campana":"abcdefghjk","email":"marie@exemple.fr","nombre":"Marie","empresa":"Conseil Nord","idioma":"fr","consentimiento":true}'

Seuls campana (le code) et email sont obligatoires. Elle accepte aussi nombre (prénom), apellidos (nom), empresa (entreprise), cargo (fonction), telefono (téléphone), ciudad (ville), pais (pays), web, idioma (es, en, fr, it ou de), consentimiento (true si la personne a accepté de recevoir vos e-mails) et campos, avec vos champs personnalisés par leur clé.

Elle répond 202 si elle l’a reçue, 400 si l’adresse manque ou n’est pas valide, 401 si la clé n’est pas valable, 404 si la campagne n’accepte pas d’inscriptions et 429 s’il en arrive trop d’affilée.

Quand elles arrivent dans le logiciel

Les inscriptions attendent dans Secuenza jusqu’à ce que le logiciel les récupère : toutes les 5 minutes pendant l’envoi, toutes les heures sinon, et à son ouverture. PC éteint, elles ne se perdent pas : elles arrivent quand vous l’allumez. Celles que personne ne récupère en 30 jours sont supprimées.

Ce qui se passe avec chaque inscription

• Si la personne n’était pas contact, elle est créée avec ce qu’apporte l’inscription et ajoutée à la campagne. Son origine indique « Formulaire web » ou « Inscription par l’API », et si elle a coché la case, son consentement est enregistré avec sa date.
• Si elle était déjà contact, seul ce qui manquait est complété et elle est ajoutée. Un contact inactif redevient actif.
• Elle n’est pas ajoutée si elle s’est désinscrite, si son adresse n’existe pas, si elle a signalé un e-mail comme spam ou si elle est sur la liste d’exclusion. Pour ceux qui ont demandé la suppression de leurs données, même l’adresse n’est pas enregistrée.
• Dans la version gratuite, une inscription qui ne tient pas dans la limite de contacts est notée « Ne tient pas dans la version gratuite ».

Dernières inscriptions, dans le même onglet, montre celles qui sont arrivées et ce qui a été fait avec chacune.

Secuenza n’envoie pas d’e-mail de confirmation avant d’inscrire quelqu’un (double opt-in). Si vous écrivez dans des pays où on l’attend, comme l’Allemagne, tenez-en compte : les envois conformes l’expliquent.