Actualizar Campaigns programadas activadas por API

Usa este punto de conexión para actualizar las Campaigns programadas activadas por API creadas en el dashboard, lo que te permite decidir qué acción debe desencadenar el envío del mensaje.

Puedes pasar trigger_properties que Braze incluye como plantilla en el propio mensaje.

Ten en cuenta que para enviar mensajes con este punto de conexión, debes tener un ID de Campaign, creado al crear una Campaign activada por API.

Cualquier programación sobrescribe completamente la que proporcionaste en la solicitud de creación de programación o en las solicitudes de actualización de programación anteriores. Por ejemplo, si originalmente estableces la programación en "schedule" : {"time" : "2015-02-20T13:14:47", "in_local_time" : true} y más tarde la actualizas a "schedule" : {"time" : "2015-02-20T14:14:47"}, Braze envía el mensaje a la hora especificada en UTC, no en la hora local del usuario.

Los desencadenantes programados que se actualizan cerca de la hora a la que debían enviarse, o durante la misma, se actualizan con el máximo esfuerzo para que Braze pueda aplicar los cambios de último momento a todos, algunos o ninguno de tus usuarios objetivo. Las actualizaciones no se aplican si la programación original utilizaba la hora local y la hora original ya ha pasado en cualquier zona horaria.

Requisitos previos

Para utilizar este punto de conexión, necesitarás una clave de API con el permiso campaigns.trigger.schedule.update.

Límite de velocidad

Aplicamos el límite de velocidad predeterminado de Braze de 250 000 solicitudes por hora a este punto de conexión, como se documenta en Límites de velocidad de la API.

Cuerpo de la solicitud

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

1
2
3
4
5
6
7
{
  "campaign_id": (required, string) see campaign identifier,
  "schedule_id": (required, string) the `schedule_id` to update (obtained from the response to create schedule),
  "schedule": {
    // required, see create schedule documentation
  }
}

Parámetros de la solicitud

Ejemplo de solicitud

1
2
3
4
5
6
7
8
9
10
11
curl --location --request POST 'https://rest.iad-01.braze.com/campaigns/trigger/schedule/update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "campaign_id": "campaign_identifier",
  "schedule_id": "schedule_identifier",
  "schedule": {
    "time": "2017-05-24T21:30:00Z",
    "in_local_time": true
  }
}'