Dépannage

Trouvez ce qui ne va pas et remettez votre formulaire en marche. Chaque section part de ce que vous voyez, montre comment le vérifier et donne la solution. Formerie renvoie des codes stables, et cette page utilise leurs noms exacts.

Les sections :

• Mon courriel n’est pas arrivé
• Une soumission a été refusée
• Le formulaire ne s’affiche pas
• Une erreur CORS ou d’origine
• La vérification a échoué

Mon courriel n’est pas arrivé

Symptôme : quelqu’un a rempli le formulaire, et le courriel n’est jamais arrivé.

Comment vérifier : ouvrez Livraisons dans l’application et trouvez la réponse par formulaire et par date. Chaque ligne donne un état et un diagnostic, avec un code, un résumé et une prochaine étape. Les mêmes détails se trouvent sur la réponse elle-même, sous Soumissions. Cherchez ensuite ce que vous voyez dans ce tableau.

Les codes de diagnostic de livraison

Livré, mais pas dans la boîte de réception

Livrée veut dire que le fournisseur a pris le courriel. Cela ne prouve pas qu’il s’est rendu à la boîte de réception.

1. Demandez au destinataire de regarder dans ses courriels indésirables.
2. Si vous utilisez votre propre fournisseur de courriel, cherchez le message dans ses journaux.
3. Ouvrez l’onglet Livraison du formulaire et assurez-vous que cette adresse s’y trouve.
4. Ouvrez Destinataires et regardez cette adresse. Un destinataire En attente, Désactivé ou Supprimé ne reçoit rien. Une adresse supprimée a habituellement rebondi ou marqué un message comme indésirable.

Seulement certaines personnes l’ont reçu

Un destinataire avec une condition reçoit seulement les réponses qui y correspondent. Comparez la condition, dans l’onglet Livraison, avec les réponses reçues. Si une condition ne laisse personne à qui envoyer, la réponse est conservée et aucun courriel ne part, sans que ce soit compté comme un échec.

Réessayer une livraison

Corrigez d’abord la cause, car la plupart des échecs se répètent autrement. Ouvrez ensuite la réponse sous Soumissions et choisissez Réessayer l’envoi. Un vrai courriel part, avec les réglages de livraison actuels du formulaire, et la réponse ne change pas.

Un courriel de test ne part pas

Une soumission a été refusée

Symptôme : le visiteur voit une erreur, ou votre code obtient ok: false.

Comment vérifier : une soumission refusée n’est pas conservée, donc elle n’apparaît jamais sous Soumissions. Lisez plutôt le code dans la réponse, dans le panneau réseau de votre navigateur ou dans result.error.code avec le SDK. Il ressemble à ceci :

{
  "ok": false,
  "error": {
    "code": "SPAM_REJECTED",
    "message": "The submission was rejected."
  }
}

Le serveur fait ses vérifications dans l’ordre et s’arrête à la première qui échoue : origine, disponibilité, limite de débit des routes publiques, fenêtre de réponse, taille, format, envoi répété, limites de soumission, vérifications antipourriel, vérification humaine, réponses et quota.

Les réponses refusées

VALIDATION_FAILED énumère chaque problème dans error.fields et error.issues, avec un chemin, un code et un message :

{
  "ok": false,
  "error": {
    "code": "VALIDATION_FAILED",
    "message": "The submitted form contains invalid fields.",
    "fields": {
      "contact.email": [
        {
          "path": "contact.email",
          "code": "FIELD_EMAIL_INVALID",
          "message": "Invalid email address.",
          "rule": "email",
          "params": {}
        }
      ]
    },
    "issues": [
      {
        "path": "contact.email",
        "code": "FIELD_EMAIL_INVALID",
        "message": "Invalid email address.",
        "rule": "email",
        "params": {}
      }
    ]
  }
}

Affichez chaque message à côté de son champ. Les pages hébergées et les intégrations le font pour vous. Les codes sont présentés par type de champ dans la Référence de la définition de formulaire, et vos propres validateurs renvoient le code que vous leur avez donné.

Un champ obligatoire mais masqué ne peut pas échouer, parce que le serveur ignore les champs masqués. Si un champ obligatoire échoue sans arrêt, vérifiez que votre interface l’envoie sous son nom exact, avec les groupes sous forme d’objets imbriqués.

Refusée comme pourriel

La réponse ne dit pas quelle vérification l’a bloquée. Passez donc les trois en revue sous Paramètres, dans Antipourriel :

Trop de soumissions

RATE_LIMITED vient de l’un de ces deux endroits :

• Limites de soumission, sous Paramètres. Les nouveaux formulaires permettent 10 soumissions par visiteur toutes les 10 minutes, et 300 pour tout le formulaire chaque heure. Augmentez-les si votre formulaire connaît de vrais pics. Les gens d’un même réseau, comme un bureau, partagent la limite par visiteur.
• Une limite à court terme sur les routes publiques, que vous ne pouvez pas changer. Elle envoie Retry-After, en secondes.

Dites au visiteur de patienter, et gardez ses réponses à l’écran.

Les envois répétés

DUPLICATE_SUBMISSION veut dire que le premier envoi a fonctionné : c’est une bonne nouvelle. Affichez votre message de réussite. Envoyez un nouveau metadata.idempotencyKey pour chaque nouvelle soumission, et réutilisez une clé seulement pour réessayer la même soumission.

Le formulaire ne s’affiche pas

Symptôme : le lien affiche une erreur, ou la page où vous avez intégré le formulaire est vide.

Comment vérifier : ouvrez l’URL hébergée du formulaire dans une fenêtre privée. Si elle fonctionne, le formulaire est correct et le problème vient de la page autour. Si vous voyez une ligne de JSON, lisez son code.

Une intégration n’affiche rien

• Le script ajoute son iframe à l’endroit exact de la balise. Avec data-formerie-target, le sélecteur doit correspondre à un élément de la page au moment où le script s’exécute.
• data-formerie-form doit être identifiant-espace/identifiant-formulaire, comme dans le Code d’intégration. Une mauvaise valeur affiche FORM_NOT_FOUND dans l’iframe.
• Si votre site définit une politique de sécurité du contenu (CSP), autorisez https://forms.formerie.com comme source de cadre et de script, et https://cdn.formerie.com comme source de script.

Un montage dans le navigateur n’affiche rien

Le montage dans le navigateur charge le formulaire avec un appel à partir de votre page. Sans l’adresse de votre site dans les origines autorisées, cet appel échoue. Consultez la prochaine section.

Une erreur CORS ou d’origine

Symptôme : la console de votre navigateur affiche blocked by CORS policy, votre code obtient une erreur réseau comme Failed to fetch ou le NETWORK_ERROR du SDK, et la requête apparaît en 403 ou 404 dans le panneau réseau. Votre code ne peut pas lire de code Formerie, parce qu’une requête de navigateur refusée revient sans les en-têtes qui le permettraient.

Comment vérifier : cela arrive seulement quand le code du navigateur sur votre site appelle Formerie, c’est-à-dire avec le montage dans le navigateur, un paquet de framework utilisé dans le navigateur ou votre propre fetch. Un lien hébergé et une intégration par script n’appellent rien à partir de votre site, donc ils ne peuvent pas la causer.

Ouvrez la requête en échec dans le panneau réseau. C’est souvent la requête OPTIONS, et sa réponse indique FORBIDDEN_ORIGIN ou FORM_NOT_FOUND. Comparez l’en-tête Origin de la requête avec votre liste.

Le code sur votre propre serveur n’a besoin de rien de tout ça, sauf s’il transmet un en-tête Origin. Sans cet en-tête, la vérification ne s’applique pas. Consultez Origines autorisées.

La vérification a échoué

Symptôme : une soumission renvoie TURNSTILE_FAILED. C’est le même code pour Cloudflare Turnstile et pour reCAPTCHA, et la réponse ne donne pas de raison.

Comment vérifier : regardez les réglages de Vérification humaine du formulaire sous Paramètres, puis passez ces causes en revue.

Quel domaine ajouter à votre widget

Avec vos propres clés, la console du fournisseur énumère les domaines où votre widget fonctionne. Ajoutez le domaine où le widget se charge :

La vérification en passant par votre serveur

Un jeton obtenu sur votre page et transmis par votre propre serveur peut échouer à la vérification du domaine. Sans en-tête Origin, Formerie compare le domaine du jeton avec le sien. Pour que ça passe, transmettez l’en-tête Origin du visiteur avec la requête, et ajoutez aussi ce site aux origines autorisées.