Aller au contenu principal

Mettre à jour les préférences de communication d'un client

PUT

https://api-v2.test.eldowallet.fr/clients/:clientId/communication-preferences

Met à jour les préférences de communication d'un client, au nom d'un gestionnaire. Seuls les types de notification et les canaux envoyés sont modifiés. Renvoie les préférences à jour.

À retenir
  • Mise à jour partielle malgré le PUT : seuls les types de notification listés dans communicationPreferences changent, et un canal omis garde sa valeur. Chaque changement effectif est ajouté à l'historique et envoyé en POST aux URL de webhook du wallet (client, changedBy, managerId, changedAt, changes).

Requête​

path parameters
  • clientId string required
    Identifiant du client (ObjectId de 24 caractères hexadécimaux).
header parameters
  • x-lang string
    Langue des messages d'erreur et des textes renvoyés : `fr` ou `en`.
    enum: en, frdefault: "en"
Body application/json required
  • communicationPreferences object[]
    • notificationType string requiredenum: NEW_LOYALTY, UPDATE_LOYALTY, REMINDER_LOYALTY, EARNINGS_UPDATE, NEW_COMMUNICATION, EXPIRED_COMMUNICATION, NEW_EVENT, UPDATE_EVENT, NEW_COUPON, UPDATE_COUPON, WELCOME_INTERNAL_CLIENTS, WELCOME_CRM_CLIENTS, WELCOME_EXTERNAL_CLIENTS, WELCOME_COUPON, EXPIRED_COUPON, TRANSIT_TICKET, UPDATE_TRANSIT, HOTEL_RESERVATION, UPDATE_HOTEL_RESERVATION, CINEMA_TICKET
    • sms boolean
    • email boolean
    • notification boolean
  • pushInformativeEnabled boolean
  • pushCommercialEnabled boolean

Réponses​

Schéma application/json
  • communicationPreferences object[] required
    • notificationType string requiredenum: NEW_LOYALTY, UPDATE_LOYALTY, REMINDER_LOYALTY, EARNINGS_UPDATE, NEW_COMMUNICATION, EXPIRED_COMMUNICATION, NEW_EVENT, UPDATE_EVENT, NEW_COUPON, UPDATE_COUPON, WELCOME_INTERNAL_CLIENTS, WELCOME_CRM_CLIENTS, WELCOME_EXTERNAL_CLIENTS, WELCOME_COUPON, EXPIRED_COUPON, TRANSIT_TICKET, UPDATE_TRANSIT, HOTEL_RESERVATION, UPDATE_HOTEL_RESERVATION, CINEMA_TICKET
    • sms boolean required
    • email boolean required
    • notification boolean required
  • pushInformativeEnabled boolean required
  • pushCommercialEnabled boolean required
  • consentLink string
    URL de la page publique de gestion des consentements (`/consent/:token`), sans connexion, sur laquelle le client gère lui-même ses préférences. Absente si le client n'a pas de carte de fidélité.

Les nouveautés de l'API, une fois par mois

Nouveaux endpoints, changements à prévoir, guides et cas d'usage. Pas de spam, désinscription en un clic.

Signaler un problème technique

Une erreur de l’API, un pass qui ne se met pas à jour, un e-mail qui n’arrive pas ? Décrivez le problème : notre équipe technique vous répond.

Pour une réponse rapide, indiquez :

  • La méthode et l’endpoint (ex. POST /clients)
  • Le code d’erreur renvoyé (errorCode) et le corps envoyé
  • La date et l’heure de l’appel
  • Les identifiants concernés (client, modèle, pass)

N’y mettez jamais de jeton d’API ni de mot de passe.

Assistant IA

Beta

Chargement…

Réponses générées par IA (Claude) : vérifiez les points importants.

Connectez-vous pour utiliser l'assistant