Estatísticas de mensagens

messages:list

Exibe a lista de mensagens enviadas.

POST https://api.pushwoosh.com/api/v2/messages:list

Cabeçalhos

Nome	Obrigatório	Descrição
`Authorization`	Sim	Token da API do servidor. Deve ser fornecido no seguinte formato: `Authorization: Api <Server Key>`.

Parâmetros do corpo da solicitação

Nome	Obrigatório	Tipo	Descrição
`platforms`	Não	Array	Plataformas de mensagens. Valores possíveis: `"IOS"`, `"ANDROID"`, `"OSX"`, `"WINDOWS"`, `"AMAZON"`, `"SAFARI"`, `"CHROME"`, `"FIREFOX"`, `"IE"`, `"EMAIL"`, `"HUAWEI_ANDROID"`, `"SMS"`.
`date_range`	Não	Object	Período do relatório, filtrado pela data de criação da mensagem. `date_from` e `date_to` devem seguir o formato `YYYY-MM-DD` (por exemplo, `"2000-01-01"`); ambos os dias são incluídos integralmente, então `date_from` e `date_to` definidos para a mesma data retornam aquele dia inteiro.
`campaign`	Não	String	Código da campanha
`filters`	Sim	Object	Filtros de mensagem.
`source`	Não	String	Origem da mensagem. Por exemplo: `AB_TEST`, `API`, `AUTO_PUSH`, `CP`, `CSV`, `CUSTOMER_JOURNEY`, `EMAIL_API`, `EMAIL_CP`, `GEO_ZONE`, `PUSH_ON_EVENT`, `RSS`.
`messages_codes`	Não	Array	Códigos de mensagem obtidos das respostas da API `/createMessage`.
`messages_ids`	Não	Array	IDs de mensagem obtidos do Histórico de Mensagens
`params`	Não	Object	Especifique se deseja mostrar detalhes e métricas da mensagem. Defina `with_details: true` para incluir o objeto `"details"` e `with_metrics: true` para incluir o objeto `"metrics"` na resposta.
`application`	Sim	String	Código da aplicação Pushwoosh.
`per_page`	Não	Integer	Número de resultados por página, de `1` a `499`. Omita o parâmetro para obter o tamanho de página padrão de 500 resultados; passar `500` ou mais explicitamente é rejeitado com `400`.
`page`	Não	Integer	Número da página baseado em zero para paginação. Veja o limite de paginação profunda abaixo.

Exemplo de solicitação

{
    "filters": {
      "platforms": [],                  // IOS, ANDROID, OSX, WINDOWS, AMAZON, SAFARI, CHROME, FIREFOX, IE, EMAIL, HUAWEI_ANDROID, SMS
      "date_range": {
        "date_from": "string",          // Formato obrigatório: 2000-01-01
        "date_to": "string"             // Formato obrigatório: 2000-01-01
      },
      "source": "API",                  // AB_TEST, API, AUTO_PUSH, CP, CSV, CUSTOMER_JOURNEY, EMAIL_API, EMAIL_CP, GEO_ZONE, PUSH_ON_EVENT, RSS
      "campaign": "string",             // Código da campanha
      "messages_ids": [],               // IDs de mensagem
      "messages_codes": [],             // Códigos de mensagem
      "application": "string"           // Código da aplicação Pushwoosh
    },
    "params": {
      "with_details": true,             // Adicionar detalhes da mensagem à resposta (objeto "details")
      "with_metrics": true              // Adicionar métricas da mensagem à resposta (objeto "metrics")
    },
    "per_page": 20,                     // <= 499
    "page": 0
}

Códigos de resposta e exemplos

{
  "total": 0,
  "items": [{
    "id": 0,
    "code": "string",
    "created_date": "string",
    "send_date": "string",
    "status": "string",
    "platforms": [],
    "source": "string",
    "push_info": {
      "details": {
        "title": "string",
        "filter_name": "string",
        "filter_code": "string",
        "content": {
          "key": "value"
        },
        "platform_parameters": {
          "android_header": "string",
          "android_root_params": {
            "key": "value"
          },
          "ios_title": "string",
          "ios_subtitle": "string",
          "ios_root_params": {
            "key": "value"
          },
          "chrome_header": "string",
          "chrome_root_params": {
            "key": "value"
          },
          "firefox_header": "string",
          "firefox_root_params": {
            "key": "value"
          },
          "conditions": [               // condições de tag (veja /developer/api-reference/messages-api/#tag-conditions)
            TAG_CONDITION1,
            TAG_CONDITION2,
            ...,
            TAG_CONDITIONN
          ],
          "conditions_operator": "AND", // operador lógico para arrays de condições; valores possíveis: AND, OR
          "data": {
            "key": "value"
          }
        },
        "follow_user_timezone": true
      },
      "metrics": [{
        "sends": 0,
        "opens": 0,
        "deliveries": 0,
        "inbox_opens": 0,
        "unshowable_sends": 0,
        "errors": 0,
        "platform": 0
      }]
    },
    "email_info": {
      "details": {
        "template": "string",
        "filter_name": "string",
        "filter_code": "string",
        "subject": {
          "key": "value"
        },
        "from_name": "string",
        "from_email": "string",
        "reply_name": "string",
        "reply_email": "string",
        "follow_user_timezone": true,
        "conditions": [              // condições de tag (veja Messages-api - tag-conditions)
          TAG_CONDITION1,
          TAG_CONDITION2,
          ...,
          TAG_CONDITIONN
        ],
        "conditions_operator": "AND" // operador lógico para arrays de condições; valores possíveis: AND, OR
      },
      "metrics": [{
        "sends": 0,
        "opens": 0,
        "deliveries": 0,
        "hard_bounces": 0,
        "soft_bounces": 0,
        "rejects": 0,
        "confirmed_sends": 0,
        "unsubs": 0,
        "complaints": 0,
        "errors": 0
      }]
    }
  }]
}

date_range abrange mais de 30 dias:

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

page × per_page excede o limite de paginação profunda:

{
  "error": "requested result window is too large, narrow the date range"
}

{
  "error": "account not found"
}

totalsByIntervals

Retorna métricas e dados de conversão com base no código da mensagem, agregados por hora.

POST https://api.pushwoosh.com/api/v2/statistics/messages/totalsByIntervals

Autorização

A autorização é tratada através do Token de Acesso à API no cabeçalho da solicitação.

Parâmetros do corpo da solicitação

Nome do Parâmetro	Tipo	Descrição	Obrigatório
`message_code`	string	Código da mensagem obtido das respostas da API `/createMessage`.	Sim
`platforms`	[int]	Plataformas	Não

Exemplo de solicitação

{
  "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // obrigatório. Identificador único da mensagem
  "platforms": [1, 3, 7, 10, 11, 12]          // opcional. Lista de códigos de plataforma
}

Campos da resposta

Nome	Tipo	Descrição
`metrics`	array	Contém um array de métricas de mensagem
`timestamp`	string	A hora da métrica.
`platform`	int	O código da plataforma (por exemplo, iOS, Android).
`sends`	string	O número de mensagens enviadas.
`opens`	string	O número de mensagens abertas.
`deliveries`	string	O número de mensagens entregues.
`inbox_opens`	string	O número de aberturas na caixa de entrada.
`unshowable_sends`	string	O número de mensagens enviadas que não puderam ser exibidas.
`errors`	string	O número de erros.
`conversion`	object	Contém dados de conversão
`sends`	string	O número total de mensagens enviadas.
`opens`	string	O número total de mensagens abertas.
`events`	array	Um array de eventos com suas estatísticas
`name`	string	O nome do evento (por exemplo, adição ao carrinho).
`hits`	string	O número de ocorrências.
`conversion`	float	A taxa de conversão relativa às aberturas.
`revenue`	float	A receita (apenas para eventos com atributos `__amount` e `__currency`).

Exemplo de resposta

{
  "metrics": [{
    "timestamp": "2024-08-03 15:00:00",  // Timestamp das métricas no formato "YYYY-MM-DD HH:MM:SS"
    "platform": 3,                       // Código da plataforma
    "sends": "55902",                    // Número de mensagens enviadas
    "opens": "382",                      // Número de mensagens abertas
    "deliveries": "22931",               // Número de mensagens entregues
    "inbox_opens": "0",                  // Número de mensagens abertas na caixa de entrada
    "unshowable_sends": "2",             // Número de mensagens que não puderam ser exibidas
    "errors": "0"                        // Número de erros encontrados
  }],
  "conversion": {
    "sends": "55902",                    // Número total de mensagens enviadas
    "opens": "772",                      // Número total de mensagens abertas
    "events": [{
      "name": "cart_add",                // Nome do evento
      "hits": "96",                      // Número de ocorrências para o evento
      "conversion": 0.12,                // Taxa de conversão relativa às aberturas
      "revenue": 0                       // Receita gerada pelo evento (apenas para eventos com atributos de valor/moeda)
    }]
  }
}

getDeliveryFunnel

Retorna o funil de entrega para uma única mensagem, dividido por canal: audiência → enviado → erros → entregas → aberto, mais interações para transmissões de e-mail. Inclui uma análise de onde a audiência de cada canal é perdida em cada estágio.

POST https://api.pushwoosh.com/api/v2/statistics/messages/getDeliveryFunnel

Cabeçalhos

Nome	Obrigatório	Descrição
`Authorization`	Obrigatório	Token de acesso à API do Painel de Controle da Pushwoosh.

Parâmetros do corpo da solicitação

Nome	Obrigatório	Tipo	Descrição
`message_code`	Sim	String	Código da mensagem obtido das respostas da API `/createMessage`.
`platforms`	Não	Array de Inteiro	Filtro opcional de ID da plataforma.

Não há parâmetro de intervalo de tempo: o funil não tem eixo de tempo, então o servidor deriva a janela dos próprios dados de envio e confirmação da mensagem (retornados como window_from/window_to).

Exemplo de solicitação

{
  "message_code": "A444-AAABBBCC-00112233",  // obrigatório, código da mensagem obtido da resposta /createMessage
  "platforms": [1, 3, 7]                     // opcional, lista de códigos de plataforma
}

Campos da resposta

Nome	Tipo	Descrição
`channels`	array	Uma entrada por canal com dados para esta mensagem. Um canal que a mensagem nunca usou é omitido — sua ausência significa “sem dados”, não zero.
`channels[].channel`	string	`CHANNEL_MOBILE_PUSH` (iOS, OSX, Android, Amazon, Huawei), `CHANNEL_WEB_PUSH` (Safari, Chrome, Firefox), `CHANNEL_EMAIL`, ou `CHANNEL_OTHER` (SMS, mensageiros, Wallet, Windows e outras plataformas).
`channels[].funnel`	array	Estágios do funil para este canal, sempre nesta ordem: `STAGE_AUDIENCE`, `STAGE_SENT`, `STAGE_ERRORS`, `STAGE_DELIVERIES`, `STAGE_OPENED`, e — apenas para transmissões de e-mail, não mensagens transacionais — `STAGE_INTERACTIONS`.
`channels[].funnel[].stage`	string	Nome do estágio do funil.
`channels[].funnel[].count`	string	Contagem total para o estágio.
`channels[].funnel[].pieces`	array	Detalhamento de `count` em categorias. Vazio em `STAGE_ERRORS`, que carrega `errors` em vez disso. Uma categoria com contagem zero é omitida em vez de ser retornada como `0`.
`channels[].funnel[].pieces[].kind`	string	Como a peça se relaciona com o total do estágio: `KIND_PASSED` (passou para o próximo estágio) ou `KIND_REASON` (desistiu por este motivo). Cada peça é uma parcela — as peças de um estágio sempre somam seu `count`.
`channels[].funnel[].pieces[].category`	string	Categoria de detalhamento, por exemplo, `INVALID_TOKEN`, `FREQUENCY_CAPPING`, `ELIGIBLE_AUDIENCE` — veja a tabela de estágios abaixo.
`channels[].funnel[].pieces[].count`	string	Contagem para esta categoria.
`channels[].funnel[].pieces[].platforms`	array	Detalhamento por plataforma desta categoria: `{ "platform": <id>, "count": "<n>" }`. Uma plataforma sem nada a relatar é omitida, não retornada como `0`.
`channels[].funnel[].errors`	array	Apenas `STAGE_ERRORS`, no lugar de `pieces`: uma linha por categoria de desistência (`category`, `count`, `platforms`) — mesma forma de uma peça, menos `kind`.
`channels[].funnel[].platforms`	array	Detalhamento por plataforma do próprio `count` do estágio.
`channels[].deliveries_form`	string	Qual detalhamento `STAGE_DELIVERIES` carrega: `DELIVERIES_FORM_PER_DEVICE` (três linhas, estado de alerta conhecido) ou `DELIVERIES_FORM_BASIC` (duas linhas, estado de alerta desconhecido).
`channels[].basic_form_reason`	string	Definido apenas quando `deliveries_form` é `DELIVERIES_FORM_BASIC`: `BASIC_FORM_REASON_RETENTION` (mensagem mais antiga do que o log de nível de linha retém), `BASIC_FORM_REASON_UNAVAILABLE` (sem dados por dispositivo para esta conta), `BASIC_FORM_REASON_NO_DELIVERIES` (nada aceito ainda), ou `BASIC_FORM_REASON_NOT_APPLICABLE` (este canal não tem estado de alerta — não é uma degradação).
`channels[].confirmed_deliveries`	object	`{ "count": "<n>", "platforms": [...] }` — dispositivos únicos que confirmaram a entrega, independentemente de `deliveries_form`. `confirmed_deliveries` não é limitado a `STAGE_DELIVERIES.count`, então pode variar ligeiramente além desse total; use `confirmed_deliveries` para uma tendência de entrega contínua entre mensagens de diferentes idades.
`window_from`, `window_to`	string (data-hora RFC 3339)	A janela de tempo sobre a qual o funil foi realmente calculado, derivada dos próprios dados da mensagem.
`funnel_state`	string	`FUNNEL_STATE_READY` (`channels` preenchido), `FUNNEL_STATE_NO_EVENTS` (nada aconteceu para esta mensagem ainda — `channels` está vazio), ou `FUNNEL_STATE_EXPIRED` (mensagem com mais de 365 dias, estatísticas não mais armazenadas — `channels` está vazio).

Estágios do funil

Estágio	Aplica-se a	`count` significa	`pieces` / `errors`
`STAGE_AUDIENCE`	todos os canais	Levado em processamento.	`KIND_PASSED` `ELIGIBLE_AUDIENCE`; `KIND_REASON`: `FREQUENCY_CAPPING`, `CONTROL_GROUP` (todos os canais), `UNSUBSCRIBED`, `BOUNCED`, `COMPLAINT`, `FILTERED_BY_CATEGORY` (apenas e-mail)
`STAGE_SENT`	todos os canais	Aceito pelo gateway/provedor (`ACCEPTED_BY_GATEWAY`).	nenhum — o estágio é inteiramente o total aceito; rejeições aparecem em `STAGE_ERRORS`
`STAGE_ERRORS`	todos os canais	Rejeitado antes de chegar ao destinatário.	`errors[]`, não `pieces`: `INTERNAL_ERROR`, `INVALID_TOKEN`, `NO_TOKEN`, `NO_DEVICE`, `PLATFORM_DISABLED`, `QUOTA_EXCEEDED`, `INVALID_CONTENT`, `INVALID_CONFIGURATION`, `PROVIDER_ERROR` (não categorizado)
`STAGE_DELIVERIES`	todos os canais	Envios aceitos para confirmar — quantos foram, não quantos confirmaram.	Formulário por dispositivo: `KIND_PASSED` `DISPLAYABLE_CONFIRMED`; `KIND_REASON`: `DISPLAYABLE_NO_CONFIRMATION`, `ALERTS_DISABLED`. Formulário básico: `KIND_PASSED` `CONFIRMED_BY_DEVICE`; `KIND_REASON` `NO_CONFIRMATION`
`STAGE_OPENED`	todos os canais	Dispositivos/endereços únicos que abriram.	Apenas e-mail, e apenas enquanto a mensagem tiver menos de 60 dias: `KIND_PASSED` `OPENED_BY_RECIPIENT`; `KIND_REASON`: `MACHINE_OPENS_ONLY` (aberturas automatizadas, por exemplo, clientes de pré-visualização de caixa de correio), `OPEN_TYPE_UNKNOWN`. Outros canais, e e-mail com mais de 60 dias: sem `pieces`.
`STAGE_INTERACTIONS`	apenas transmissões de e-mail (não mensagens transacionais)	O que o destinatário fez com o e-mail.	`KIND_PASSED` `CLICKED_ONLY`; `KIND_REASON`: `CLICKED_AND_UNSUBSCRIBED`, `CLICKED_AND_COMPLAINED`, `UNSUBSCRIBED_WITHOUT_CLICK`, `COMPLAINED_WITHOUT_CLICK`

Exemplo de resposta

{
  "channels": [
    {
      "channel": "CHANNEL_EMAIL",
      "funnel": [
        {
          "stage": "STAGE_AUDIENCE",
          "count": "600000",
          "pieces": [
            { "kind": "KIND_PASSED", "category": "ELIGIBLE_AUDIENCE", "count": "580000" },
            { "kind": "KIND_REASON", "category": "UNSUBSCRIBED", "count": "14000" },
            { "kind": "KIND_REASON", "category": "BOUNCED", "count": "6000" }
          ]
        },
        {
          "stage": "STAGE_SENT",
          "count": "560000",
          "pieces": []
        },
        {
          "stage": "STAGE_ERRORS",
          "count": "20000",
          "errors": [
            { "category": "INVALID_TOKEN", "count": "18000" },
            { "category": "PROVIDER_ERROR", "count": "2000" }
          ]
        },
        {
          "stage": "STAGE_DELIVERIES",
          "count": "560000",
          "pieces": [
            { "kind": "KIND_PASSED", "category": "CONFIRMED_BY_DEVICE", "count": "540000" },
            { "kind": "KIND_REASON", "category": "NO_CONFIRMATION", "count": "20000" }
          ]
        },
        {
          "stage": "STAGE_OPENED",
          "count": "30514",
          "pieces": [
            { "kind": "KIND_PASSED", "category": "OPENED_BY_RECIPIENT", "count": "26102" },
            { "kind": "KIND_REASON", "category": "MACHINE_OPENS_ONLY", "count": "4412" }
          ]
        },
        {
          "stage": "STAGE_INTERACTIONS",
          "count": "1980",
          "pieces": [
            { "kind": "KIND_PASSED", "category": "CLICKED_ONLY", "count": "1820" },
            { "kind": "KIND_REASON", "category": "UNSUBSCRIBED_WITHOUT_CLICK", "count": "140" },
            { "kind": "KIND_REASON", "category": "CLICKED_AND_COMPLAINED", "count": "20" }
          ]
        }
      ],
      "deliveries_form": "DELIVERIES_FORM_BASIC",
      "basic_form_reason": "BASIC_FORM_REASON_NOT_APPLICABLE",
      "confirmed_deliveries": { "count": "540000" }
    },
    {
      "channel": "CHANNEL_MOBILE_PUSH",
      "funnel": [
        {
          "stage": "STAGE_DELIVERIES",
          "count": "168316",
          "pieces": [
            { "kind": "KIND_PASSED", "category": "DISPLAYABLE_CONFIRMED", "count": "89570" },
            { "kind": "KIND_REASON", "category": "DISPLAYABLE_NO_CONFIRMATION", "count": "78746" }
          ]
        },
        { "stage": "STAGE_OPENED", "count": "30514", "pieces": [] }
      ],
      "deliveries_form": "DELIVERIES_FORM_PER_DEVICE",
      "confirmed_deliveries": { "count": "91240" }
    }
  ],
  "window_from": "2026-08-01T00:00:00Z",
  "window_to": "2026-08-04T00:00:00Z",
  "funnel_state": "FUNNEL_STATE_READY"
}

Códigos de resposta e exemplos

{
  "channels": [],
  "funnel_state": "FUNNEL_STATE_NO_EVENTS"
}

{
  "error": "message_code must be set"
}

{
  "error": "account not found"
}

{
  "error": "message not found"
}

getMessageLog

Exibe informações detalhadas sobre as mensagens enviadas.

POST https://api.pushwoosh.com/api/v2/statistics/getMessageLog

Cabeçalhos

Nome	Obrigatório	Descrição
`Authorization`	Obrigatório	Token de acesso à API do Painel de Controle da Pushwoosh.

Parâmetros do corpo da solicitação

Nome	Obrigatório	Tipo	Descrição
`message_id`	Não	Integer	Seleciona eventos de mensagens por ID da Mensagem obtido do histórico de mensagens. Exemplo: `12345678900`.
`message_code`	Não	String	Seleciona eventos de mensagens por Código da Mensagem obtido das respostas da API `/createMessage`. Exemplo: `"A444-AAABBBCC-00112233"`.
`campaign_code`	Não	String	Seleciona eventos de mensagens por Código da Campanha especificado no payload da sua mensagem. Exemplo: `"AAAAA-XXXXX"`.
`hwid`	Não	String ou Array	Seleciona eventos de mensagens por HWID (Hardware ID) ou um array de HWIDs.
`date_from`	Obrigatório se `message_id`, `message_code` ou `campaign_code` não for fornecido	Datetime	Data de início para filtrar mensagens. Formato: `"YYYY-MM-DD HH:MM:SS"`. Exemplo: `"2000-01-25 00:00:00"`.
`date_to`	Obrigatório se `message_id`, `message_code` ou `campaign_code` não for fornecido	Datetime	Data de término para filtrar mensagens. Formato: `"YYYY-MM-DD HH:MM:SS"`. Exemplo: `"2000-01-26 00:00:00"`.
`limit`	Não	Integer	Número máximo de eventos de mensagem retornados em uma única resposta. Valor máximo: `100000`.
`pagination_token`	Não	String	Token de paginação obtido de uma resposta `/getMessageLog` anterior. Use-o para recuperar resultados adicionais.
`user_id`	Não	String	Seleciona eventos de mensagens por um ID de Usuário personalizado. Veja `/registerUser` para mais detalhes.
`application_code`	Sim	String	Seleciona eventos de mensagens por código da aplicação Pushwoosh
`actions`	Não	Array	Filtra resultados por ações de mensagem específicas. Valores possíveis: `"sent"`, `"delivered"`, `"opened"`, `"inbox_delivered"`, `"inbox_read"`, `"inbox_opened"`, `"inbox_deleted"`.
`platforms`	Não	Array	Array de plataformas de destino para filtrar resultados. Valores possíveis: `"ios"`, `"android"`, `"osx"`, `"windows"`, `"amazon"`, `"safari"`, `"chrome"`, `"firefox"`, `"ie"`, `"email"`, `"huawei_android"`.

Exemplo de solicitação

curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/getMessageLog' \
--header 'Authorization: Key API_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "pagination_token": "PAGINATION_TOKEN_FROM_PREVIOUS_RESPONSE",  // opcional, token para paginação
   "limit": 1000,                                  // opcional, o número máximo de entradas para uma única resposta
   "application_code": "XXXXX-XXXXX",              // Código da aplicação Pushwoosh
   "message_code": "A444-AAABBBCC-00112233",       // opcional, código da mensagem obtido da requisição /createMessaage
   "message_id": 1234567890,                       // opcional, ID da mensagem obtido do Painel de Controle da Pushwoosh
   "campaign_code": "AAAAA-XXXXX",                 // opcional, código de uma campanha para obter o log
   "hwid": "aaazzzqqqqxxx",                        // opcional, ID de hardware de um dispositivo específico alvo de uma mensagem
   "user_id": "user_123",                          // opcional, ID de um usuário alvo da mensagem
   "date_from": "2000-01-25 00:00:00",             // opcional, início do período de estatísticas
   "date_to": "2000-02-10 23:59:59",               // opcional, fim do período de estatísticas
   "actions": ["opened", "inbox_opened"],          // opcional, usado para filtragem de resultados. Valores possíveis: "sent", "opened", "delivered", "inbox_delivered", "inbox_read", "inbox_opened", "inbox_deleted". A resposta incluirá todas as mensagens com a(s) ação(ões) especificada(s).
   "platforms": ["ios", "chrome"]                  // opcional, usado para filtragem de resultados. Valores possíveis: "ios", "android", "osx", "windows", "amazon", "safari", "chrome", "firefox", "ie", "email", "huawei android"
}'

Códigos de resposta e exemplos

{
  "pagination_token": "PAGINATION_TOKEN_FOR_NEXT_REQUEST",
  "data": [{
    "timestamp": "2000-01-25T11:18:47Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "sent",
    "status": "success",
    "push_alerts_enabled": "true"
  }, {
    "timestamp": "2000-01-25T11:18:49Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "delivered",
    "push_alerts_enabled": "true"
  }, {
    "timestamp": "2000-01-25T11:19:23Z",
    "application_code": "XXXXX-XXXXX",
    "message_id": 12345678900,
    "message_code": "A444-AAABBBCC-00112233",
    "campaign_code": "AAAAA-XXXXX",
    "hwid": "aaazzzqqqqxxx",
    "user_id": "user_123",
    "platform": "android",
    "action": "opened",
    "push_alerts_enabled": "true"
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

Estatísticas de e-mail

linksInteractions

Exibe estatísticas sobre cliques em links em e-mails

POST https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions

Cabeçalhos

Nome	Obrigatório	Descrição
`Authorization`	Sim	Token de acesso à API do Painel de Controle da Pushwoosh.

Parâmetros do corpo da solicitação

Nome	Obrigatório	Tipo	Descrição
`date_range`	Não	Object	Define o período do relatório. Contém `date_from` e `date_to`.
`filters`	Sim	Object	Filtros de e-mail.
`application`	Sim	String	Código da aplicação Pushwoosh (alternativamente, especifique `campaign`, `messages_ids` ou `message_codes`).
`messages_codes`	Sim	Array	Códigos de mensagem (alternativamente, especifique `application`, `campaign` ou `messages_ids`).
`campaign`	Sim	String	Código da campanha (alternativamente, especifique `application`, `messages_ids` ou `message_codes`).
`messages_ids`	Sim	Array	IDs de mensagem (alternativamente, especifique `application`, `campaign` ou `message_codes`).
`link_template`	Obrigatório se `application` ou `campaign` for especificado.	String	Filtra interações de links de e-mail por palavra-chave. Apenas links que incluem o texto especificado em sua URL serão retornados na resposta da API. Por exemplo, se seu e-mail contém links como `https://example.com/news` e `https://example.com/shop`, definir “link_template”: “shop” retornará interações apenas para `https://example.com/shop`.
`email_content_code`	Não	String	Identificador único para o conteúdo do e-mail.
`params`	Não	Object	Define opções de resposta adicionais. Inclui `with_full_links`, que adiciona uma lista de links completos com estatísticas.

Exemplo de solicitação

curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractions' \
--header 'Authorization: Api API_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "filters": {
      "date_range": {
         "date_from": "string",           // Formato obrigatório: 2000-01-01
         "date_to": "string"              // Formato obrigatório: 2000-01-01
      },
      "campaign": "string",               // Código da campanha (você pode especificar application, messages_ids ou message_codes em vez disso)
      "application": "string",            // Código da aplicação (você pode especificar campaign, messages_ids ou message_codes em vez disso)
      "messages_ids": [],                 // IDs de mensagem (você pode especificar application, campaign ou message_codes em vez disso)
      "messages_codes": [],               // Códigos de mensagem (você pode especificar application, campaign ou message_ids em vez disso)
      "link_template": "string",          // Modelo de link (obrigatório se application ou campaign for especificado)
      "email_content_code": "string"      // Identificador único para o conteúdo do e-mail.
   },
   "params": {
      "with_full_links": true             // Especifique se deseja mostrar estatísticas detalhadas. Uma lista de links completos com estatísticas será passada no array full_links.
   }
}'

Códigos de resposta e exemplos

{
  "items": [{
    "template": "string",
    "link": "string",
    "title": "string",
    "clicks": 0,
    "full_links": [{
      "full_link": "string",
      "clicks": 0
    }]
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

linksInteractionsDevices

Mostra os usuários que clicaram em links em e-mails

POST https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices

Cabeçalhos

Nome	Obrigatório	Descrição
`Authorization`	Sim	Token de acesso à API do Painel de Controle da Pushwoosh.

Parâmetros do corpo da solicitação

Nome	Obrigatório	Tipo	Descrição
`date_range`	Não	Object	Define o período do relatório. Contém `date_from` e `date_to`.
`filters`	Sim	Object	Filtros de e-mail.
`application`	Sim	String	Código da aplicação Pushwoosh (alternativamente, especifique `campaign`, `messages_ids` ou `message_codes`).
`messages_codes`	Sim	Array	Códigos de mensagem (alternativamente, especifique `application`, `campaign` ou `messages_ids`).
`campaign`	Sim	String	Código da campanha (alternativamente, especifique `application`, `messages_ids` ou `message_codes`).
`messages_ids`	Sim	Array	IDs de mensagem (alternativamente, especifique `application`, `campaign` ou `message_codes`).
`link_template`	Obrigatório se `application` ou `campaign` for especificado.	String	Filtra interações de links de e-mail por palavra-chave. Apenas links que incluem o texto especificado em sua URL serão retornados na resposta da API. Por exemplo, se seu e-mail contém links como `https://example.com/news` e `https://example.com/shop`, definir “link_template”: “shop” retornará interações apenas para `https://example.com/shop`.
`email_content_code`	Não	String	Identificador único para o conteúdo do e-mail.
`page`	Não	Integer	Número da página para paginação.
`per_page`	Não	Integer	Número de resultados por página (≤ 1000).

Exemplo de solicitação

curl --location --request POST 'https://api.pushwoosh.com/api/v2/statistics/emails/linksInteractionsDevices' \
--header 'Authorization: Api API_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
   "filters": {
      "date_range": {
         "date_from": "string",         // Formato obrigatório: 2000-01-01
         "date_to": "string"            // Formato obrigatório: 2000-01-01
      },
      "campaign": "string",             // Código da campanha (você pode especificar application, messages_ids ou message_codes em vez disso)
      "application": "string",          // Código da aplicação (você pode especificar campaign, messages_ids ou message_codes em vez disso)
      "messages_ids": [],               // IDs de mensagem (você pode especificar application, campaign ou message_codes em vez disso)
      "messages_codes": [],             // Códigos de mensagem (você pode especificar application, campaign ou message_ids em vez disso)
      "link_template": "string",        // Modelo de link (obrigatório se application ou campaign for especificado)
      "email_content_code": "string"    // Identificador único para o conteúdo do e-mail.
   },
   "per_page": 100,
   "page": 0
}'

Códigos de resposta e exemplos

{
  "total": 0,
  "items": [{
    "timestamp": "string",
    "link": "string",
    "hwid": "string"
  }]
}

{
  "error": "exceeded the maximum date interval. Max interval: 30 days"
}

{
  "error": "account not found"
}

bouncedEmails

POST https://api.pushwoosh.com/api/v2/statistics/emails/bouncedEmails

Fornece dados sobre reclamações de e-mail, soft bounces e hard bounces, incluindo a data, o endereço de e-mail e o motivo de cada devolução.

Autorização

A autorização é tratada através do Token de Acesso à API no cabeçalho da solicitação.

Parâmetros do corpo da solicitação

Nome do Parâmetro	Tipo	Descrição	Obrigatório
`application`	string	Código da aplicação Pushwoosh	Sim
`message_code`	string	Código da mensagem.	Obrigatório se `date range` ou `campaign` não for fornecido
`campaign`	string	Código da campanha.	Obrigatório se `message_code` ou `date range` não for fornecido
`date_from`	string	A data de início para os dados no formato `YYYY-MM-DDTHH:MM:SS.000Z` (padrão ISO 8601).	Obrigatório se `message_code` ou `campaign` não for fornecido
`date_to`	string	A data de término para os dados no formato `YYYY-MM-DDTHH:MM:SS.000Z` (padrão ISO 8601).	Obrigatório se `message_code` ou `campaign` não for fornecido
`per_page`	int	O número de linhas por página, máximo 5000.	Sim
`page`	int	O número da página, começando do zero.	Sim
`type`	string	O tipo de devolução: Complaint, Softbounce, Hardbounce.	Não

Exemplo de solicitação

{
  "application": "XXXXX-XXXXX",               // obrigatório. Código da aplicação Pushwoosh
  "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // obrigatório se campaign ou date range não for fornecido.
                                              //          Identificador único da mensagem
  "campaign": "XXXXX-XXXXX",                  // obrigatório se message_code ou date range não for fornecido.
                                              //          Código da campanha
  "date_from": "2024-07-20T00:00:00.000Z",    // obrigatório se message_code ou campaign não for fornecido.
                                              //          Data de início no formato ISO 8601 "YYYY-MM-DDTHH:MM:SS.SSSZ"
  "date_to": "2024-07-20T00:00:00.000Z",      // obrigatório se message_code ou campaign não for fornecido.
                                              //          Data de término no formato ISO 8601 "YYYY-MM-DDTHH:MM:SS.SSSZ"
  "per_page": 1000,                           // obrigatório. Número de resultados por página, máximo 5000
  "page": 5,                                  // opcional. Número da página, começando do zero
  "type": "Softbounce"                        // opcional. O tipo de devolução: Complaint, Softbounce, Hardbounce
}

Campos da resposta

Nome do Campo	Tipo	Descrição
`total`	int	A contagem total de linhas.
`bounced_emails`	array	Um array de detalhes de e-mails devolvidos.
├── `email`	string	O endereço de e-mail que foi devolvido.
├── `date`	string	A data da devolução (formato: `YYYY-MM-DDTHH:MM:SS.000Z`).
├── `reason`	string	O motivo da devolução.
└── `type`	string	O tipo de devolução: Complaint, Softbounce, Hardbounce.

Exemplo de resposta

{
  "total": 25,                             // Contagem total de linhas.
  "bounced_emails": [{
    "email": "example@example.com",        // Endereço de e-mail que foi devolvido
    "date": "2024-07-20T00:00:00.000Z",    // Data da devolução no formato ISO 8601
    "reason": "Invalid recipient address", // Motivo da devolução
    "type": "Hardbounce"                   // Tipo de devolução: Complaint, Softbounce, Hardbounce
  }]
}