Objet Planification

Les paramètres des points de terminaison de la campagne et de la création de la planification Canvas reflètent ceux du point de terminaison d’envoi et ajoutent le paramètre schedule, qui vous permet de spécifier le moment où vous souhaitez que les utilisateurs ciblés reçoivent votre message. Si vous n’incluez que le paramètre time dans l’objet schedule, Braze envoie des messages à tous vos utilisateurs à ce moment-là.

Si vous définissez in_local_time comme étant true, vous obtenez une réponse d’erreur si le paramètre de temps est passé dans tous les fuseaux horaires. Si vous attribuez la valeur “true” à at_optimal_time, vos utilisateurs recevront le message à la date désignée et à l’heure optimale (quelle que soit l’heure que vous avez indiquée). Lorsque vous utilisez l’envoi de l’heure locale ou optimale, n’indiquez pas les désignateurs de fuseaux horaires dans la valeur du paramètre de temps (par exemple, utilisez "2015-02-20T13:14:47" au lieu de "2015-02-20T13:14:47-05:00").

La réponse vous fournit une adresse schedule_id que vous devriez enregistrer au cas où vous auriez besoin d’annuler ou de mettre à jour le message que vous avez planifié :

Corps de l’objet

Insérez cet objet si nécessaire pour planifier vos messages.

1
2
3
4
5
"schedule": {
  "time": (required, datetime as ISO 8601 string) time to send the message in UTC,
  "in_local_time": (optional, bool),
  "at_optimal_time": (optional, bool),
}

Réponse de l’ID de planification

Vous recevez une adresse schedule_id pour l’envoi du message planifié que vous avez créé.

1
2
3
{
  "schedule_id" : (required, string) identifier for the scheduled message you created
}

Si vous utilisez l’API pour des appels de serveur à serveur, il se peut que vous deviez ajouter à votre liste blanche l’URL d’API appropriée si vous travaillez derrière un pare-feu.

Les réponses du point de terminaison de planification des messages comprennent le site dispatch_id, qui renvoie à l’envoi du message. Le dispatch_id est l’identifiant de la transmission du message (ID unique pour chaque « dispatch » envoyé par Braze).