Automatisez, via l’API, la modification des coordonnées des destinataires proposée à vos clients. Augmentez ainsi le taux d’AR de vos envois et proposez une solution rapide et simple pour permettre aux destinataires d’ouvrir leur courrier recommandé électronique.
L’envoi d’un courrier recommandé électronique eIDAS impose la vérification d’identité du destinataire du courrier. Le destinataire est amené à transmettre une pièce d’identité lors de cette vérification afin de s’assurer de la bonne identité de la personne qui souhaite réceptionner le courrier. Une comparaison du nom présent sur la pièce d’identité avec le nom apposé sur le courrier recommandé électronique est effectué lors de la vérification d’identité du destinataire. Il peut arriver qu’une différence entre les deux noms surviennent pour diverses raisons :
Lorsque ce cas de figure survient, AR24 va notifier l’expéditeur du courrier de cette différence entre les informations analysées sur la pièce d’identité et les coordonnées entrées par l’expéditeur. L’expéditeur peut alors effectuer deux actions sur le courrier :
Vous avez la possibilité de lister toutes les demandes de modification des coordonnées destinataire d’un expéditeur donné via la route /api/mail_recipients_update/list.
/api/mail_recipients_update/list
Les paramètres attendus sont les suivants :
token
id_user
Vous obtenez alors un retour de notre API avec le statut SUCCESS et la liste des demandes de modification de coordonnées destinataire. Dans le cas d’une erreur, vous retrouverez dans le retour une explication et un slug. Vous retrouverez dans notre documentation la liste des erreurs : https://developers.ar24.fr/doc/#get-list-all-recipient-update-for-a-specific-user
SUCCESS
Vous avez la possibilité d’accepter une demande de modification des coordonnées destinataire via la route /api/mail_recipients_update/valid.
/api/mail_recipients_update/valid
id_recipient_update
Vous obtenez alors un retour de notre API avec le statut SUCCESS et le destinataire du courrier recevra un email de notre part pour le notifier de cette mise à jour. Le destinataire pourra alors accuser réception de son courrier. Dans le cas d’une erreur, vous retrouverez dans le retour une explication et un slug. Vous retrouverez dans notre documentation la liste des erreurs : https://developers.ar24.fr/doc/#post-validate-a-recipient-update
Vous avez la possibilité d’accepter une demande de modification des coordonnées destinataire via la route /api/mail_recipients_update/refuse.
/api/mail_recipients_update/refuse
Vous obtenez alors un retour de notre API avec le statut SUCCESS et le destinataire du courrier recevra un email de notre part pour le notifier de cette mise à jour. Le destinataire sera invité à nous transmettre une nouvelle pièce d’identité portant le nom présent sur le courrier recommandé. Dans le cas d’une erreur, vous retrouverez dans le retour une explication et un slug. Vous retrouverez dans notre documentation la liste des erreurs : https://developers.ar24.fr/doc/#post-refuse-a-recipient-update
Si lors de l’envoi de votre courrier recommandé électronique eIDAS vous avez rempli le paramètre webhook ou si votre API possède une URL globale pour les webhooks ; vous serez automatiquement notifié d’une demande de modification des coordonnées destinataire du courrier.
webhook
Un appel sera fait sur le lien du webhook transmis avec les paramètres suivants :
new_state
recipient_update
id_mail
Avec l’identifiant du courrier recommandé électronique, vous pourrez facilement obtenir toutes les informations de la demande de modification de coordonnées destinataire en appelant la route /api/mail. Dans le résultat obtenu, les informations importantes seront disponibles dans l’attribut recipient_update. Cet attribut contient un tableau des modifications de coordonnées destinataire du courrier recommandé électronique. Vous y trouverez les informations suivantes :
/api/mail
date
status
pending
accepted
refused
new_to_firstname
new_to_lastname
new_to_company
Vérifier l’identité de l’expéditeur pour effectuer des envois eIDAS via l’API
Créer un compte expéditeur via l’API
Gestion des pièces jointes sur l’API
Envoyer un courrier recommandé eIDAS via l’API