Démarrer une activité en direct

Utilisez cet endpoint pour démarrer à distance les activités en direct affichées dans votre application iOS. Cet endpoint nécessite une configuration supplémentaire.

Après avoir créé une activité en direct, envoyez une requête POST pour cibler un segment, une audience connectée ou des utilisateurs spécifiques. Identifiez les utilisateurs spécifiques par leur ID utilisateur externe, leur alias d’utilisateur, ou les deux. Pour en savoir plus sur les activités en direct d’Apple, consultez Starting and updating Live Activities with ActivityKit push notifications.

Si content-available n’est pas défini, la priorité par défaut du service Apple Push Notification (APNs) est de 10. Si content-available est défini, cette priorité est de 5. Pour plus d’informations, consultez l’objet push Apple.

Important

Après une requête /messages/live_activity/start réussie, attendez au moins 5 minutes avant d’envoyer la première requête /messages/live_activity/update pour le même activity_id. Ce délai laisse à Braze et aux APNs le temps d’enregistrer la nouvelle activité en direct et le mappage de son jeton. Si vous envoyez la première mise à jour trop tôt, elle risque de ne pas s’appliquer à l’activité.

Conseil

Pour mettre fin à une activité en direct, utilisez l’endpoint /messages/live_activity/update avec end_activity défini sur true.

Planifier la fermeture automatique

Pour planifier la fermeture automatique d’une activité en direct après son démarrage, programmez depuis votre backend une requête de suivi vers l’endpoint de mise à jour.

1. Envoyez une requête /messages/live_activity/start avec un activity_id que vous pourrez réutiliser ultérieurement.
2. Stockez cet activity_id et l’heure de fin souhaitée dans le planificateur de votre backend.
3. À l’heure de fin prévue, envoyez une requête /messages/live_activity/update avec end_activity défini sur true.
4. Configurez le comportement de fermeture dans cette même requête de mise à jour. Pour plus de détails, consultez l’endpoint /messages/live_activity/update.
5. Vérifiez les événements d’envoi et de résultat dans le journal d’activité des messages.

Vous pouvez télécharger le document OpenAPI et l’utiliser pour valider les schémas. Pour savoir comment procéder, consultez Utiliser les schémas OpenAPI pour la validation des requêtes.