Verificació de correu: advertències i codis de risc

La funcionalitat de Verificació de correu electrònic emet advertències sempre que s’activa un senyal de risc en el flux d’OTP o en la mateixa adreça: una filtració de dades coneguda, un proveïdor d’un sol ús, una bústia a la qual no es pot lliurar correu, un límit d’intents d’OTP o una coincidència amb la teva llista de bloqueig o amb una altra verificació aprovada. Aquesta pàgina enumera cada codi, què l’activa i com configurar la resposta del flux de treball.

Visió general

Les advertències s’etiqueten amb la funcionalitat EMAIL. Apareixen a l’informe a email_verifications[].warnings[] i segueixen l’estructura estàndard de l’objecte d’advertència (feature, risk, additional_data, log_type, short_description, long_description, node_id). Cada advertència també s’encamina al registre per sessió perquè aparegui a la Business Console sota la secció de correu electrònic. Algunes advertències són activadors de rebuig automàtic estricte: sempre estableixen l’estat de la funcionalitat a Declined i inclouen log_type: "error". Les altres es mapen a una acció configurable (DECLINE, REVIEW o el valor predeterminat NO_ACTION) definida per node del flux de treball o per crida a l’API, de manera que el mateix codi de risc pot rebutjar un flux de treball mentre que en un altre només genera una advertència. L’acció configurada també defineix la gravetat: DECLINE → error, REVIEW → warning, NO_ACTION → information.

Condicions de rebuig automàtic

Les següents advertències sempre rebutgen el pas de Verificació de correu electrònic independentment de la configuració:

EMAIL_CODE_ATTEMPTS_EXCEEDED — l’usuari ha esgotat el límit d’intents d’OTP: 2 entrades de codi incorrectes (email_max_check_attempts) o 2 enviaments d’OTP —l’enviament inicial més un reenviament (email_max_retries)— per defecte.
EMAIL_IN_BLOCKLIST — l’adreça es troba en una llista de bloqueig gestionada mitjançant la Lists API, o ha coincidit amb una verificació de correu electrònic prèviament aprovada que s’ha afegit a la llista de bloqueig.
UNDELIVERABLE_EMAIL_DETECTED — l’adreça no pot rebre correu: sintaxi no vàlida, un domini inexistent, absència de registres DNS (MX) o el correu electrònic d’OTP no s’ha pogut lliurar. El pas finalitza com a Declined immediatament; no s’arriba a executar cap comprovació de codi. Excepció: quan l’usuari ha escrit l’adreça ell mateix (no s’ha emplenat prèviament en crear la sessió), un enviament que no es pot lliurar retorna un error en línia perquè pugui reintentar-ho amb una adreça diferent en lloc de ser rebutjat.

Riscos configurables

Cadascun dels següents riscos es mapeja a un paràmetre de configuració (per node del flux de treball, o per crida a l’endpoint de comprovació independent) que pots configurar com a DECLINE, REVIEW o NO_ACTION:

Configuració	Codi de risc	Comportament per defecte
`breached_email_action`	`BREACHED_EMAIL_DETECTED`	`NO_ACTION` — mostra els detalls de la filtració a nivell `information` sense canviar l’estat.
`disposable_email_action`	`DISPOSABLE_EMAIL_DETECTED`	`NO_ACTION` — marca el proveïdor d’un sol ús a nivell `information` sense canviar l’estat.
`duplicated_email_action`	`DUPLICATED_EMAIL`	`NO_ACTION` — registra el duplicat a nivell `information`. S’omet quan l’adreça és a la llista d’admesos.

La detecció de duplicats només té en compte les verificacions de correu electrònic prèviament aprovades a la mateixa aplicació, agrupades per vendor_data: les verificacions que comparteixen el mateix vendor_data es tracten com un únic usuari final i s’exclouen. Si deixes vendor_data buit, cada sessió es tracta com un usuari diferent. Si l’adreça és a la teva llista d’admesos de correu electrònic, s’omet l’acció de duplicat i s’emet EMAIL_IN_ALLOWLIST en el seu lloc.

Límits d’intents de verificació

La funcionalitat de Verificació de correu electrònic aplica un límit estricte als intents d’OTP per evitar abusos:

Intents d’introducció de codi — email_max_check_attempts, per defecte 2: el segon intent amb un codi incorrecte (o caducat) finalitza el pas.
Intents d’enviament — email_max_retries, per defecte 2 enviaments en total (l’enviament inicial més un reenviament): una sol·licitud de reenviament addicional finalitza el pas.

Superar qualsevol dels dos límits genera EMAIL_CODE_ATTEMPTS_EXCEEDED i rebutja automàticament. Pots ajustar ambdós límits per cada node del flux de treball.

Advertències generades

Etiqueta	Gravetat	Descripció
`EMAIL_CODE_ATTEMPTS_EXCEEDED`	`error`	L’usuari ha superat el límit d’introducció de codis o d’enviaments. Es rebutja automàticament.
`EMAIL_IN_BLOCKLIST`	`error`	L’adreça és present en una llista de bloqueig creada mitjançant la Lists API o ha coincidit amb una verificació aprovada present a la llista de bloqueig. Es rebutja automàticament. `additional_data` inclou `blocklisted_session_id`, `blocklisted_session_number` i `api_service` (tots `null` en cas de coincidència exclusiva amb la llista).
`EMAIL_IN_ALLOWLIST`	`information`	L’adreça ha coincidit amb una llista d’admesos creada mitjançant la Lists API, per la qual cosa s’ha omès l’acció per a correus duplicats.
`BREACHED_EMAIL_DETECTED`	Segons `breached_email_action` (`information` per defecte)	L’adreça s’ha trobat en una o més filtracions de dades conegudes. La matriu `breaches[]` de l’informe inclou el servei afectat, la data i les classes de dades.
`DISPOSABLE_EMAIL_DETECTED`	Segons `disposable_email_action` (`information` per defecte)	El domini és un proveïdor d’un sol ús o d’adreces temporals conegut que s’acostuma a utilitzar per eludir la traçabilitat.
`UNDELIVERABLE_EMAIL_DETECTED`	`error`	L’adreça no pot rebre correus (sintaxi no vàlida, domini inexistent, registres MX absents o lliurament fallit). Es rebutja automàticament.
`DUPLICATED_EMAIL`	Segons `duplicated_email_action` (`information` per defecte)	L’adreça coincideix amb una verificació de correu electrònic aprovada anteriorment que pertany a un usuari final diferent (agrupat per `vendor_data`). `additional_data` inclou `duplicated_session_id`, `duplicated_session_number` i `api_service`.

Com a màxim s’activa un d’entre EMAIL_IN_BLOCKLIST, DUPLICATED_EMAIL i EMAIL_IN_ALLOWLIST per intent: la llista de bloqueig té prioritat sobre el duplicat, que al seu torn té prioritat sobre la llista d’admesos.

Coincidències entre sessions

Quan es detecta una adreça en verificacions de correu electrònic aprovades anteriorment o a la teva llista de bloqueig, aquestes coincidències també apareixen a email_verifications[].matches[] (amb un límit de 5 entrades). Cada coincidència inclou session_id, session_number, vendor_data, verification_date, email, status, is_blocklisted, api_service, i un source de session (una altra verificació aprovada) o list_entry (una entrada de la llista de bloqueig). Si l’adreça actual és a la teva llista d’admesos de correu electrònic, Didit conserva l’evidència de la coincidència però emet EMAIL_IN_ALLOWLIST en lloc d’aplicar l’acció per a correus duplicats. Consulta l’informe de Verificació de correu electrònic per veure l’esquema complet de coincidències.

Exemple

{
  "warnings": [
    {
      "feature": "EMAIL",
      "risk": "EMAIL_IN_BLOCKLIST",
      "additional_data": {
        "blocklisted_session_id": null,
        "blocklisted_session_number": null,
        "api_service": null
      },
      "log_type": "error",
      "short_description": "Email in blocklist",
      "long_description": "The system detected that the email is in the blocklist, which is not allowed.",
      "node_id": "feature_email_1"
    },
    {
      "feature": "EMAIL",
      "risk": "DISPOSABLE_EMAIL_DETECTED",
      "additional_data": null,
      "log_type": "information",
      "short_description": "Disposable email detected",
      "long_description": "The system detected that the email is disposable, which is not allowed.",
      "node_id": "feature_email_1"
    }
  ]
}

Tipus d’advertència

A cada risc se li assigna una gravetat en funció de la configuració de la teva aplicació. Les gravetats es divideixen en tres categories:

Relacionat

Visió general de la Verificació de correu electrònic — comportament de la funcionalitat i preus.
Informe de Verificació de correu electrònic — estructura completa de la resposta, inclosos lifecycle[] i matches[].
Models de dades — verificació de correu electrònic — esquema canònic camp per camp.
Management API — Llistes — gestiona la llista de bloqueig de correus electrònics que utilitza EMAIL_IN_BLOCKLIST.

Autenticació

Verificació

Monitoratge

Plataforma

Verificació de correu: advertències i codis de risc

Visió general

Condicions de rebuig automàtic

Riscos configurables

Límits d’intents de verificació

Advertències generades

Coincidències entre sessions

Exemple

Tipus d’advertència

Relacionat

​Visió general

​Condicions de rebuig automàtic

​Riscos configurables

​Límits d’intents de verificació

​Advertències generades

​Coincidències entre sessions

​Exemple

​Tipus d’advertència

​Relacionat

Visió general

Condicions de rebuig automàtic

Riscos configurables

Límits d’intents de verificació

Advertències generades

Coincidències entre sessions

Exemple

Tipus d’advertència

Relacionat