Iniciar actividad en vivo

Utiliza este endpoint para iniciar de forma remota actividades en vivo que se muestran en tu aplicación iOS. Este endpoint requiere una configuración adicional.

Después de crear una actividad en vivo, realiza una solicitud POST dirigida a un segmento, a una audiencia conectada o a usuarios específicos. Identifica a usuarios específicos por ID de usuario externo, alias de usuario o ambos. Para obtener más información sobre las actividades en vivo de Apple, consulta Starting and updating Live Activities with ActivityKit push notifications.

Si content-available no está configurado, la prioridad predeterminada del servicio de notificaciones push de Apple (APN) es 10. Si content-available está configurado, esta prioridad es 5. Para obtener más información, consulta el objeto push de Apple.

Importante

Después de una solicitud /messages/live_activity/start correcta, espera al menos 5 minutos antes de enviar la primera solicitud /messages/live_activity/update para el mismo activity_id. Este intervalo da tiempo a Braze y a los APN para registrar la nueva actividad en vivo y el mapeado de su token. Si envías la primera actualización demasiado pronto, es posible que esa actualización no se aplique a la actividad.

Consejo

Para finalizar una actividad en vivo, utiliza el endpoint /messages/live_activity/update con end_activity establecido en true.

Programar el descarte automático

Para programar el descarte automático después de que se inicie una actividad en vivo, programa una solicitud de seguimiento al endpoint de actualización desde tu backend.

1. Envía una solicitud /messages/live_activity/start con un activity_id que puedas reutilizar más adelante.
2. Almacena ese activity_id y la hora de finalización prevista en el programador de tu backend.
3. A la hora de finalización prevista, envía una solicitud /messages/live_activity/update con end_activity establecido en true.
4. Configura el comportamiento de descarte en la misma solicitud de actualización. Para más detalles, consulta el endpoint /messages/live_activity/update.
5. Verifica los eventos de envío y resultado en el Registro de actividad de mensajes.

Puedes descargar el documento OpenAPI y usarlo para validar esquemas. Para saber cómo hacerlo, consulta Usar esquemas OpenAPI para validar solicitudes.