Aller au contenu

Vérifier les adresses email de vos utilisateurs Clerk

Intégration Inscriptions et authentification

Exportez vos utilisateurs Clerk, vérifiez le fichier dans PricklyMails, puis supprimez les comptes dont l'adresse ne reçoit plus d'emails. Pas à pas.

Il n'existe pas de connecteur natif avec Clerk : vous exportez la liste, PricklyMails la vérifie, et vous ramenez le résultat dans Clerk. Les nouvelles adresses, elles, peuvent passer par l'API avant d'entrer dans Clerk.

Vérifier gratuitement

Pas à pas

Nettoyer votre liste en trois étapes

  1. Dans Clerk

    Exporter vos utilisateurs depuis Clerk

    Avant de commencer

    L'export des utilisateurs est réservé aux administrateurs de votre espace de travail Clerk, ou à un espace de travail personnel.

    1. Dans le Clerk Dashboard, ouvrez l'instance qui contient vos utilisateurs, puis ses Settings.
    2. Dans la section User exports, sélectionnez Export users.
    3. Quand la nouvelle entrée apparaît dans l'historique des exports, sélectionnez Download pour enregistrer le fichier CSV.
    4. Ouvrez le fichier dans un tableur et supprimez toutes les colonnes sauf celle des adresses email.
    5. Enregistrez le résultat dans un nouveau fichier CSV, puis supprimez l'export téléchargé.

    Attention

    L'export de Clerk contient le mot de passe haché de chaque utilisateur. N'envoyez à PricklyMails que le nouveau fichier, jamais l'export lui-même, et supprimez l'export une fois la colonne des emails enregistrée.

    À noter

    La documentation de Clerk n'existe qu'en anglais : les libellés cités sur cette page sont ceux qu'elle donne.

    SourceAide officielle de Clerk
  2. Dans PricklyMails

    Vérifier le fichier dans PricklyMails

    1. Dans le tableau de bord, ouvrez Lots et cliquez sur Nouveau lot.
    2. Déposez le fichier exporté depuis Clerk : un .csv ou un .txt, avec une adresse par ligne, sans ligne d'en-tête ni guillemets. Une ligne d'en-tête compterait comme une adresse dans l'estimation, sans jamais être facturée, et une adresse entre guillemets ne serait pas vérifiée : le rapport les signale toutes deux comme mal formées. Vous pouvez aussi coller la liste.
    3. Le tableau de bord compte les adresses et affiche le coût estimé en jetons avant tout envoi, puis vous cliquez sur Envoyer le lot. Un lot compte au moins 20 adresses, et sa taille maximale dépend de votre abonnement.
    4. La liste est vérifiée en arrière-plan. Une fois le lot terminé, ouvrez-le et cliquez sur Télécharger le rapport : vous obtenez un CSV avec une ligne par adresse de votre fichier, qui donne son verdict, sa raison, son score et sa recommandation, avec les libellés du tableau de bord.

    À noter

    Téléchargez le rapport depuis le navigateur qui a envoyé la liste : c'est lui qui garde les adresses, pour les 16 derniers lots au plus. Nos serveurs, en Allemagne, n'en conservent qu'une empreinte à sens unique.
    Ce que dit le rapport

    Chaque adresse reçoit une recommandation : l'action à mener. Le rapport l'écrit avec le libellé du tableau de bord ; l'API en renvoie une forme courte.

    À envoyer
    L'adresse est valide, ou hébergée chez un grand fournisseur qui accepte toutes les adresses sans rien confirmer. Vous envoyez normalement.
    À revoir
    Domaine qui accepte tout (catch-all), adresse générique comme contact@, boîte pleine, ou serveur qui n'a pas répondu, ou a refusé de répondre. Un coup d'œil s'impose avant l'envoi.
    À retirer
    L'adresse n'existe pas, son domaine ne reçoit pas d'email, elle est jetable, contient une faute de frappe ou est mal formée. Vous la retirez.

    À noter

    Une adresse mal formée n'est jamais vérifiée : le lot la compte dans « Adresses mal formées », et le rapport la reprend quand même, avec le verdict « Invalide », la raison « Adresse mal formée » et la recommandation « À retirer » : vous la retirez de Clerk avec les autres. Une adresse en double, comptée dans « Doublons retirés », n'y figure qu'une fois.

    Derrière chaque recommandation, il y a un verdict (Valide, Risqué, Invalide ou Non vérifiable), une raison et un score de 0 à 100, chacun dans sa colonne du rapport. Quand un serveur ne répond pas, l'adresse revient « Non vérifiable » et les tests restés sans réponse vous sont rendus.

  3. Dans Clerk

    Ramener le résultat dans Clerk

    Ouvrez le rapport dans un tableur et filtrez la colonne Recommandation.

    À retirer

    Leurs utilisateurs sont supprimés un par un depuis la page Users : Clerk ne propose pas de suppression en masse.

    La liste de suppression de Clerk ne peut pas les accueillir : Clerk y inscrit une adresse après un rebond ou un signalement de spam, et le Dashboard ne permet pas d'en ajouter une vous-même.

    1. Dans le Clerk Dashboard, ouvrez Users.
    2. Sélectionnez l'utilisateur dont l'adresse est à retirer, pour ouvrir son profil.
    3. Ouvrez le menu Actions, puis sélectionnez Delete user.
    4. Recommencez pour chaque adresse à retirer.
    À revoir

    Elles méritent un coup d'œil avant d'écrire à vos utilisateurs. Dans Clerk, filtrez Email logs sur chaque adresse : un événement bounced signifie que le serveur du destinataire a déjà renvoyé un email de Clerk, et que Clerk a peut-être cessé de lui écrire. Le profil de l'utilisateur montre ses autres identifiants, comme un numéro de téléphone ou un compte connecté.

    À envoyer

    Leurs utilisateurs restent tels quels : rien à faire.

    Astuce

    Pour vous passer du profil, sélectionnez l'icône de menu à droite de la ligne de l'utilisateur dans Users, puis Delete user.

    SourceAide officielle de Clerk

Vérifier chaque adresse avant qu'elle n'entre dans Clerk

Votre backend crée des utilisateurs avec l'API Backend de Clerk, par l'appel createUser() (nouvel onglet), pour les importer ou les ajouter vous-même ? Interrogez PricklyMails juste avant : Clerk marque comme vérifiées par défaut les adresses créées de cette façon. Si la recommandation est remove, ne créez pas l'utilisateur.

Un appel lance la vérification et signale déjà une faute de frappe probable, un second lit le verdict. Selon votre abonnement, un webhook signé peut aussi vous l'envoyer dès qu'il est prêt.

Requête
curl -s https://api.pricklymails.com/api/verify \
  -H "Authorization: Bearer pm_live_9f3a..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "ana.silva@gmail.con" }' \
  | jq '{job_uuid, suggestion}'
Réponse
{
  "job_uuid": "8f1c2a9e-4b7d-4e2a-9c61-3d5f0b7a2e18",
  "suggestion": "ana.silva@gmail.com"
}
Requête
curl -s https://api.pricklymails.com/api/verify/$JOB_UUID \
  -H "Authorization: Bearer pm_live_9f3a..." \
  | jq '.verifications[0] | {status, reason, score, recommendation}'
Réponse
{
  "status": "invalid",
  "reason": "no_mx_records",
  "score": 0,
  "recommendation": "remove"
}
Lire la documentation de l'API

Questions fréquentes

Clerk vérifie les adresses à l'inscription, pourquoi vérifier mes utilisateurs ?

Par défaut, Clerk exige qu'un utilisateur vérifie son adresse avant que son inscription n'aboutisse. Les utilisateurs créés par l'API Backend échappent à cette étape : Clerk marque leurs adresses comme vérifiées par défaut, et l'outil de migration de Clerk, comme la plupart des imports depuis un autre système, crée les utilisateurs par cette même API. Une adresse valide à l'inscription peut aussi cesser de recevoir des emails plus tard. Dès qu'elle rebondit, Clerk peut l'inscrire sur sa liste de suppression, et ne lui envoie alors plus rien, emails de vérification compris, tant que vous ne l'en retirez pas. Vérifier vos utilisateurs repère ces adresses avant le rebond.

SourceAide officielle de Clerk

Faut-il supprimer ou bannir un utilisateur Clerk dont l'adresse ne reçoit plus d'emails ?

Supprimer retire l'utilisateur de votre instance. Le bannir, depuis son profil, le garde dans votre instance, marqué comme banni : Clerk révoque toutes ses sessions et ne le laisse plus se connecter. Dans les deux cas, Clerk traite un utilisateur à la fois : sa documentation indique que la suppression en masse n'est pour l'instant possible ni depuis le Dashboard ni par programmation, et renvoie vers son support pour la demander.

SourceAide officielle de Clerk

Clerk peut bloquer les adresses jetables : cela remplace-t-il la vérification ?

Les deux se complètent. Sur la page Protections, l'option Block sign-ups that use disposable email addresses empêche toute adresse connue comme jetable de s'inscrire ou d'être ajoutée à un compte : activez-la. Elle agit sur les nouvelles adresses, à l'inscription ou à l'ajout. Vérifier vos utilisateurs couvre le reste : ceux qui figuraient déjà dans votre instance avant que vous l'activiez, et les adresses qui ont cessé de recevoir des emails depuis leur inscription.

SourceAide officielle de Clerk

PricklyMails se connecte-t-il directement à Clerk ?

Non, il n'existe pas de connecteur natif : vous passez par un export de fichier, comme ci-dessus. Vous pouvez aussi appeler l'API de PricklyMails depuis votre propre code avant qu'une adresse n'entre dans Clerk.

Ces marques appartiennent à leurs propriétaires respectifs. Les citer n'implique aucun partenariat.

Vérifiez votre liste avant votre prochain envoi.

1 000 jetons offerts à l'inscription, sans carte bancaire. Ensuite, vous ne payez que les réponses.

Vérifier gratuitement Voir les tarifs