Mettre à jour le statut du groupe d’abonnement de l’utilisateur (V2)

Utilisez cet endpoint pour mettre à jour en masse le statut d’abonnement jusqu’à 50 utilisateurs sur le tableau de bord de Braze.

Vous pouvez accéder au site subscription_group_id d’un groupe d’abonnement en accédant à la page Groupe d’abonnement.

Pour consulter des exemples ou tester cet endpoint pour les groupes d’abonnement par e-mail :

Pour consulter des exemples ou tester cet endpoint pour les groupes d’abonnement SMS :

Pour consulter des exemples ou tester cet endpoint pour les groupes WhatsApp :

Conditions préalables

Pour utiliser cet endpoint, il est nécessaire de disposer d’une clé API avec l’autorisationsubscription.status.setrequise.

Différences par rapport à la version 1

L’endpoint V2 diffère de l’endpoint V1 de la manière suivante :

• Groupes d’abonnement multiples : La version 2 vous permet de mettre à jour plusieurs groupes d’abonnement en une seule requête API, tandis que la version 1 ne prend en charge qu’un seul groupe d’abonnement par requête.
• Veuillez mettre à jour à la fois votre adresse e-mail et votre numéro de téléphone par SMS en un seul appel : Lorsque vous utilisez external_ids, vous pouvez mettre à jour les groupes d’abonnement par e-mail et par SMS pour les mêmes utilisateurs en un seul appel API. Avec la version 1, il est nécessaire d’effectuer des appels API distincts pour les groupes d’abonnement par e-mail et par SMS.
• Utilisation des identifiants de e-mail ou de téléphone : Si vous utilisezemails ouphones au lieu de external_ids, il n’est pas possible de mettre à jour à la fois les groupes d’abonnement par e-mail et par SMS dans la même requête. Il est nécessaire d’effectuer des appels API distincts : un pour les groupes d’abonnement par e-mail et un autre pour les groupes d’abonnement par SMS.

Limite de débit

Cet endpoint présente une limitation du débit de 5 000 requêtes par minute, partagées entre les endpoints /subscription/status/set et /v2/subscription/status/set, comme documenté dans Limites de débit de l’API.

Corps de la demande

1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY

1
2
3
4
5
6
7
8
9
10
11
{
  "subscription_groups":[
    {
      "subscription_group_id": (required, string),
      "subscription_state": (required, string)
      "external_ids": (required*, array of strings),
      "emails": (required*, array of strings),
      "phones": (required*, array of strings in E.164 format),
    }
  ]
}

Paramètres de demande

Exemple de requêtes

L’exemple suivant utiliseexternal_ids pour mettre à jour les groupes d’abonnement par e-mail et par SMS en un seul appel API. Cela n’est possible que lorsque vous utilisez external_ids— vous ne pouvez pas mettre à jour à la fois les groupes d’abonnement par e-mail et par SMS en un seul appel lorsque vous utilisezemailsou phones.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
curl --location --request POST 'https://rest.iad-01.braze.com/v2/subscription/status/set' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "subscription_groups":[
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "external_ids":["example-user","[email protected]"]
    },
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "external_ids":["example-user","[email protected]"]
    }
  ]
}

E-mail

1
2
3
4
5
6
7
8
9
10
11
12
13
curl --location --request POST 'https://rest.iad-01.braze.com/v2/subscription/status/set' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "subscription_groups":[
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "emails":["[email protected]","[email protected]"]
    }
  ]
}
'

SMS et WhatsApp

1
2
3
4
5
6
7
8
9
10
11
12
13
curl --location --request POST 'https://rest.iad-01.braze.com/v2/subscription/status/set' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "subscription_groups":[
    {
      "subscription_group_id":"subscription_group_identifier",
      "subscription_state":"subscribed",
      "phones":["+12223334444","+15556667777"]
    }
  ]
}
'