Ir para o conteúdo
View in Postman (opens in new tab)

Iniciar atividade ao vivo

post

/messages/live_activity/start

Use esse endpoint para iniciar remotamente Live Activities exibidas no seu app para iOS. Esse endpoint requer configuração adicional.

Depois de criar uma Live Activity, faça uma solicitação POST para direcionar um segmento, um público conectado ou usuários específicos. Identifique usuários específicos por ID de usuário externo, alias de usuário ou ambos. Para saber mais sobre as Live Activities da Apple, consulte Como iniciar e atualizar Live Activities com notificações por push do ActivityKit.

Se content-available não estiver definido, a prioridade padrão do serviço de Notificações por Push da Apple (APN) é 10. Se content-available estiver definido, essa prioridade é 5. Para saber mais, consulte objeto de push da Apple.

Como configurar o encerramento automático

Para configurar o encerramento automático após o início de uma Live Activity, agende no seu backend uma solicitação posterior para o endpoint de atualização.

  1. Envie uma solicitação /messages/live_activity/start com um activity_id que você possa reutilizar depois.
  2. Armazene esse activity_id e o horário de encerramento desejado no agendador do seu backend.
  3. No horário de encerramento desejado, envie uma solicitação /messages/live_activity/update com end_activity definido como true.
  4. Configure o comportamento de encerramento na mesma solicitação de atualização. Para mais detalhes, consulte o endpoint /messages/live_activity/update.
  5. Verifique os eventos de envio e resultado no Registro de atividades de mensagens.

Você pode baixar o documento OpenAPI e usá-lo para validar esquemas. Para saber como, consulte Usar esquemas OpenAPI para validação de solicitações.

New Stuff!