Si vous souhaitez bloquer temporairement la réception de messages pour l'un de vos contact, vous pouvez le faire en utilisant la fonction de blocage gérée par notre API. Contactez votre gestionnaire pour en demander l'activation sur votre compte.
Lorsque vous bloquez un contact, vous devez fixer une date de fin de blocage et jusqu'à cette date, aucun message ne lui sera envoyé. Vous pouvez retirer un blocage si nécessaire.
Mise en place
Pour bloquer un contact, utilisez la méthode suivante :
PUT /{customerid}/lists/contacts/tempblock
Vous pouvez trouver un contact à l'aide de :
- ORIGINALID
- EMAILADDRESS
Et préciser où le contact est stocké (sur quelle liste) :
- <listId> (une liste spécifique)
- -1 (n'importe quelle liste)
Ajoutez ensuite la valeur de recherche unique (l'identifiant unique du contact ou son adresse courriel) et la date de fin du blocage.
Exemple DTO 1
Rechercher un Original Id / Identifiant unique spécifique (111) dans toutes les listes (-1) et bloquer le récipient jusqu'au 1er février 2020 (année-mois-jour).
{
"findBy":"ORIGINALID",
"listId":"-1",
"searchValue":"111",
"blockUntil":"2020-02-01"
}
Exemple DTO 2
Rechercher un Original Id / Identifiant unique spécifique (111) dans la liste avec le ID 42 et bloquer le récipient jusqu'au 1er février 2020 (année-mois-jour).
{
"findBy":"ORIGINALID",
"listId":"42",
"searchValue":"111",
"blockUntil":"2020-02-01"
}
Exemple DTO 3
Rechercher un emailaddress / adresse courriel spécifique (lady_gaga@example.com) dans toutes les listes (-1) et bloquer le récipient jusqu'au 1er février 2020 (année-mois-jour).
{
"findBy":"EMAILADRESS",
"listId":"-1",
"searchValue":"lady_gaga@example.com",
"blockUntil":"2020-02-01"
}
Exemple DTO 4
Rechercher un emailaddress / adresse courriel spécifique (lady_gaga@example.com) dans la liste avec le ID 42 et bloquer le récipient jusqu'au 1er février 2020 (année-mois-jour).
{
"findBy":"EMAILADRESS",
"listId":"42",
"searchValue":"lady_gaga@example.com",
"blockUntil":"2020-02-01"
}
Retirer un blocage
Pour retirer un blocage, vous devez simplement faire un POST d'un des DTO précédants et laisser blockUntil vide.
{
"findBy":"EMAILADRESS",
"listId":"42",
"searchValue":"lady_gaga@example.com",
"blockUntil":""
}
Obtenir un statut de blocage
Pour obtenir des informations sur le statut de blocage d'un récipient, vous pouvez utiliser cette méthode :
GET /{customerid}/lists/contacts/tempblock
et un des DTO précédents mais en retirant blockUntil.
{
"findBy":"EMAILADRESS",
"listId":"42",
"searchValue":"lady_gaga@example.com",
}