Actualizar el estado del grupo de suscripción del usuario

Utiliza este punto final para actualizar por lotes el estado de suscripción de hasta 50 usuarios en el panel de Braze.

Puedes acceder a la página subscription_group_id de un grupo de suscripción navegando a la página Grupo de suscripción.

Si quieres ver ejemplos o probar este punto final para Grupos de suscripción por correo electrónico:

Si quieres ver ejemplos o probar este punto final para Grupos de suscripción SMS y RCS:

Requisitos previos

Para utilizar este punto final, necesitarás una clave de API con el permiso subscription.status.set.

Límite de velocidad

Este punto final tiene un límite de velocidad de 5000 solicitudes por minuto compartido entre los puntos /subscription/status/set y /v2/subscription/status/set, tal y como se documenta en Límites de velocidad de la API.

Cuerpo de la solicitud

• sms y rcs
• correo electrónico

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

1
2
3
4
5
6
7
{
   "subscription_group_id": (required, string) the id of your subscription group,
   "subscription_state": (required, string) available values are "unsubscribed" (not in subscription group) or "subscribed" (in subscription group),
   "external_id": (required*, array of strings) the external ID of the user or users, may include up to 50 IDs,
   "phone": (required*, array of strings in E.164 format) The phone number of the user (must include at least one phone number and at most 50 phone numbers),
   // SMS and RCS subscription group - one of external_id or phone is required
 }

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

1
2
3
4
5
6
7
8
{
   "subscription_group_id": (required, string) the id of your subscription group,
   "subscription_state": (required, string) available values are "unsubscribed" (not in subscription group) or "subscribed" (in subscription group),
   "external_id": (required*, array of strings) the external ID of the user or users, may include up to 50 IDs,
   "email": (required*, array of strings) the email address of the user (must include at least one email and at most 50 emails),
   // Email subscription group - one of external_id or email is required
   // Note that sending an email address that is linked to multiple profiles will update all relevant profiles
 }

Esta propiedad no debe utilizarse para actualizar la información del perfil de un usuario. Utiliza en su lugar la propiedad /usuarios/seguimiento.

Parámetros de la solicitud

Ejemplos de solicitudes

Correo electrónico

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

SMS y RCS

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

Ejemplo de respuesta satisfactoria

El código de estado 201 podría devolver el siguiente cuerpo de respuesta.

1
2
3
{
    "message": "success"
}