# Consentements

Les champs de consentement se répartissent en familles portant sur des finalités distinctes ; l'état d'une finalité n'a pas d'incidence sur celui d'une autre. Selon la finalité, ils sont portés par le contact ou par son intérêt sur un programme.

Tous ces champs sont de type boolean. Une finalité ne dispose pas nécessairement d'un champ optout_* : en son absence, seul l'optin fait foi.

# Consentement à être contacté

Porté par le contact. Porte sur le fait d'adresser des communications commerciales à la personne, canal par canal.

Champ Description
optin_email Consentement - canal e-mail
optin_phone Consentement - canal téléphone
optin_sms Consentement - canal SMS
optout_email Opposition - canal e-mail
optout_phone Opposition - canal téléphone
optout_sms Opposition - canal SMS

Pour un même canal, un optout a priorité sur un optin.

Ces champs valent pour tous les programmes. Le consentement à être contacté dans le cadre d'un projet précis relève d'un champ distinct - Consentement programme.

# Consentement au suivi des e-mails

Porté par le contact. Porte sur la mesure de l'ouverture des e-mails et des clics sur leurs liens. Cette finalité est distincte de celle de optin_email : le consentement à recevoir des e-mails ne vaut pas consentement à être mesuré.

Champ Description
optin_email_tracking Consentement à la mesure de l'ouverture et des clics
optout_email_tracking Opposition explicite à cette mesure - distincte d'une simple absence de consentement

Ces deux champs acceptent la valeur null et valent false par défaut : un contact dont le consentement n'est pas connu n'est pas mesuré.

Poser optout_email_tracking à true bascule simultanément optin_email_tracking à false, dans la même requête.

# Consentement programme

Porté par l'intérêt, et non par le contact. Porte sur le fait de contacter la personne au sujet du projet que représente son intérêt sur un programme.

Champ Description
optin Consentement à être contacté dans le cadre de son projet

Un même lead peut donc consentir sur un programme et pas sur un autre, alors que les champs de canal du contact valent pour l'ensemble des programmes. Les deux finalités se cumulent : le canal indique par quel moyen la personne accepte d'être contactée, l'optin de l'intérêt au sujet de quel projet.

Ce champ vaut true à la création de l'intérêt et n'a pas de pendant optout. Il se consulte et se modifie sur la route dédiée à l'intérêt - Consulter l'intérêt / Modifier l'intérêt.

# Champs acceptés en écriture

Route optin_email optin_phone optin_sms optout_email optout_phone optout_sms optin_email_tracking optout_email_tracking optin
Créer un contact
Modifier un contact
Ajouter un lead sur un programme
Ajouter un lead sans programme
Modifier l'intérêt

Les routes d'ajout de lead n'acceptent aucun champ optout_* : ce n'est pas un oubli, mais le contrat existant.