Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Démarrer une activité en direct

post

/messages/live_activity/start

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.

Envoyez une requête /messages/live_activity/start avec un activity_id que vous pourrez réutiliser ultérieurement.
Stockez cet activity_id et l’heure de fin souhaitée dans le planificateur de votre backend.
À l’heure de fin prévue, envoyez une requête /messages/live_activity/update avec end_activity défini sur true.
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.
Vérifiez les événements d’envoi et de résultat dans le journal d’activité des messages.

See me in Postman

Endpoint reference

This reference is generated from the OpenAPI specification for this endpoint. To run the endpoint, copy the generated cURL example and send it from your terminal or Postman. You can also download the raw OpenAPI spec for this page at /docs/fr/assets/api/openapi/messaging_live_activity_start.yaml. Use this spec to validate that your requests include the correct parameters, fields, and structure before you send them. To learn how, see Use OpenAPI schemas for request validation.

New Stuff!