# 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.