API de Live Activities do iOS

Documentação da Apple:

• Sobre Live Activities
• Atualizando e encerrando Live Activities com notificações push do ActivityKit

startLiveActivity

POST https://api.pushwoosh.com/json/1.3/startLiveActivity

Permite criar Live Activities do iOS.

Corpo da solicitação

Parâmetro	Tipo	Obrigatório/Opcional	Descrição
application	String	Obrigatório	Código de aplicação Pushwoosh
auth	String	Obrigatório	Token de acesso à API do Painel de Controle da Pushwoosh.
notifications	Array	Obrigatório	Array JSON de parâmetros de mensagem. Veja os detalhes na tabela de Notificações abaixo.

Notificações

Parâmetros usados no array notifications:

Parâmetro	Tipo	Obrigatório/Opcional	Descrição
content	String	Obrigatório	Conteúdo de fallback para dispositivos com versões do iOS anteriores à 16.1 que não suportam Live Activity. No iOS 16.1+ (com suporte a Live Activity), o conteúdo é obtido do campo live_activity.
title	String	Opcional	O título da mensagem de notificação.
live_activity	Object	Obrigatório	Dados da Live Activity para criar uma Live Activity no iOS.
live_activity.content-state	Object	Obrigatório	Conteúdo para a notificação da Live Activity.
live_activity.attributes-type	String	Obrigatório	O tipo de atributos usados na Live Activity.
live_activity.attributes	Object	Obrigatório	Atributos para a Live Activity.
live_activity_id	String	Obrigatório	Um identificador único para a Live Activity. Usado para direcionar esta atividade ao chamar updateLiveActivity. Deve ser único por sessão de atividade.
filter	String	Opcional	O nome de um filtro (segmento) da Pushwoosh. Consulte Nome do Segmento / Filtro. A Live Activity será iniciada em todos os dispositivos que correspondem a este filtro.
devices	Array de Strings	Opcional	Uma lista de tokens de dispositivo. A Live Activity será iniciada apenas nos dispositivos especificados.
send_date	String	Opcional	Agenda o push que inicia a Live Activity para uma data e hora específicas — funciona com o direcionamento por filter ou devices. Use o formato YYYY-MM-DD HH:mm, ou now para iniciar imediatamente (este também é o padrão quando o parâmetro é omitido). Não deve ser mais de 1 dia no passado ou 30 dias no futuro, caso contrário, a solicitação é rejeitada com um erro de validação.
timezone	String	Opcional	O fuso horário usado para interpretar send_date. Se omitido, send_date é interpretado em UTC.

Cuidado

O início remoto de uma Live Activity via startLiveActivity requer iOS 17.2+ no dispositivo — versões anteriores não suportam a API pushToStartTokenUpdates da qual este endpoint depende. Consulte Iniciar Live Activity com uma notificação push remota.

Ao direcionar um filter (segmento), o horário de envio agendado é quando a Pushwoosh começa a despachar o push, não um instante de entrega garantido — para grandes audiências, a entrega para dispositivos individuais pode atrasar alguns minutos em relação a send_date, já que a taxa de envio para pushes de Live Activity não pode ser personalizada com send_rate.

Exemplo de solicitação

Com filtro

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "SECRET_API_TOKEN",
    "notifications": [
      {
        "content": "Your order is being prepared",
        "title": "Food Delivery",
        "live_activity": {
          "event": "start",
          "title": "Order status",
          "content-state": {
            "status": "Third",
            "estimatedTime": "37 min",
            "emoji": "👨‍🍳"
          },
          "attributes-type": "FoodDeliveryAttributes",
          "attributes": {}
        },
        "live_activity_id": "FIRST_LIVE_ACTIVITY",
        "filter": "FILTER_NAME_1"
      }
    ]
  }
}

Com dispositivos

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "SECRET_API_TOKEN",
    "notifications": [
      {
        "content": "Your order is being prepared",
        "title": "Food Delivery",
        "live_activity": {
          "event": "start",
          "title": "Order status",
          "content-state": {
            "status": "Third",
            "estimatedTime": "37 min",
            "emoji": "👨‍🍳"
          },
          "attributes-type": "FoodDeliveryAttributes",
          "attributes": {}
        },
        "live_activity_id": "SECOND_LIVE_ACTIVITY",
        "devices": ["first_third", "second_device"]
      }
    ]
  }
}

Início agendado

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "SECRET_API_TOKEN",
    "notifications": [
      {
        "content": "Your order is being prepared",
        "title": "Food Delivery",
        "live_activity": {
          "event": "start",
          "title": "Order status",
          "content-state": {
            "status": "Third",
            "estimatedTime": "37 min",
            "emoji": "👨‍🍳"
          },
          "attributes-type": "FoodDeliveryAttributes",
          "attributes": {}
        },
        "live_activity_id": "THIRD_LIVE_ACTIVITY",
        "filter": "FILTER_NAME_1",
        "send_date": "2026-06-16 16:00"
      }
    ]
  }
}

Exemplo de resposta

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "XXXXX-XXXXXXXX-XXXXXXXX"
    ]
  }
}

Nota:

Leia este artigo para saber mais sobre como trabalhar com Live Activities usando o SDK do iOS da Pushwoosh.

updateLiveActivity

POST https://api.pushwoosh.com/json/1.3/updateLiveActivity

Permite atualizar e encerrar Live Activities do iOS

Corpo da solicitação

Parâmetro	Tipo	Obrigatório/Opcional	Descrição
auth	String	Obrigatório	Token de acesso à API do Painel de Controle da Pushwoosh.
application	String	Obrigatório	Código de aplicação Pushwoosh
notifications	Array	Obrigatório	Array JSON de parâmetros de mensagem. Veja os detalhes na tabela de Notificações abaixo.

Notificações

Parâmetros usados no array notifications:

Parâmetro	Tipo	Obrigatório/Opcional	Descrição
live_activity	Object	Obrigatório	Dados da Live Activity para atualizar uma Live Activity no iOS.
live_activity.event	String	Obrigatório	Especifica o tipo de evento. Use "update" para atualizar a Live Activity ou "end" para fechá-la.
live_activity.content-state	Object	Obrigatório	Objeto com pares de chave-valor usado para passar dados para a Live Activity para atualizar seu conteúdo.
live_activity.dismissal-date	Integer	Opcional	O tempo (em segundos) em que a Live Activity deve terminar.
live_activity_id	String	Obrigatório	O identificador único da Live Activity a ser atualizada. Deve corresponder ao live_activity_id usado em startLiveActivity. A atualização será entregue a todos os dispositivos nos quais esta atividade foi iniciada.
live_activity.relevance-score	Integer	Opcional	Informa ao sistema iOS qual Live Activity tem prioridade maior que as outras. Aceita valores de 1 ao infinito (valores até 100 são recomendados).
live_activity.stale-date	Integer	Opcional	O tempo (em segundos) que representa a data em que uma Live Activity se torna obsoleta ou desatualizada.

Exemplo de solicitação

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "SECRET_API_TOKEN",
    "notifications": [
      {
        "live_activity": {
          "event": "update",
          "title": "Live Activity Update",
          "content-state": {
            "status": "second 66",
            "estimatedTime": "66 min",
            "emoji": "👨‍"
          },
          "relevance-score": 60
        },
        "live_activity_id": "FIRST_LIVE_ACTIVITY"
      }
    ]
  }
}

Exemplo de resposta

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "Messages": [
      "XXXXX-XXXXXXXX-XXXXXXXX"
    ]
  }
}

Leia este artigo para saber mais sobre como trabalhar com Live Activities usando o SDK do iOS da Pushwoosh.

Múltiplas atividades por dispositivo

Você pode iniciar múltiplas Live Activities no mesmo dispositivo chamando startLiveActivity várias vezes com valores diferentes de live_activity_id.

Por exemplo, se você iniciar duas atividades: FIRST_LIVE_ACTIVITY com filter: FILTER_NAME_1 e SECOND_LIVE_ACTIVITY com filter: FILTER_NAME_2, um dispositivo que corresponda a ambos os filtros terá ambas as atividades em execução simultaneamente.

Para atualizar uma delas, passe seu live_activity_id para updateLiveActivity. A atualização é entregue a todos os dispositivos onde essa atividade foi criada. A outra atividade não é afetada.

O parâmetro relevance-score controla a prioridade de exibição quando múltiplas Live Activities estão ativas no mesmo dispositivo. Se o espaço na tela for limitado ou as atividades estiverem agrupadas, a atividade com um valor maior é mostrada com maior prioridade.