Estadísticas de mensajes

messages:list

Muestra la lista de mensajes enviados.

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

Cabeceras

Nombre	Requerido	Descripción
`Authorization`	Sí	Token de la API del servidor. Debe proporcionarse en el siguiente formato: `Authorization: Api <Server Key>`.

Parámetros del cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
`platforms`	No	Array	Plataformas de mensajes. Valores posibles: `"IOS"`, `"ANDROID"`, `"OSX"`, `"WINDOWS"`, `"AMAZON"`, `"SAFARI"`, `"CHROME"`, `"FIREFOX"`, `"IE"`, `"EMAIL"`, `"HUAWEI_ANDROID"`, `"SMS"`.
`date_range`	No	Object	Período de informe, filtrado por fecha de creación del mensaje. `date_from` y `date_to` deben seguir el formato `YYYY-MM-DD` (p. ej., `"2000-01-01"`); ambos días se incluyen en su totalidad, por lo que `date_from` y `date_to` establecidos en la misma fecha devuelven ese día completo. Las fechas se interpretan en UTC, no en la zona horaria de su cuenta.
`campaign`	No	String	Código de campaña
`filters`	Sí	Object	Filtros de mensajes.
`source`	No	String	Fuente del mensaje. Por ejemplo: `AB_TEST`, `API`, `AUTO_PUSH`, `CP`, `CSV`, `CUSTOMER_JOURNEY`, `EMAIL_API`, `EMAIL_CP`, `GEO_ZONE`, `PUSH_ON_EVENT`, `RSS`.
`messages_codes`	No	Array	Códigos de mensaje obtenidos de las respuestas de la API `/createMessage`.
`messages_ids`	No	Array	IDs de mensaje obtenidos del Historial de Mensajes
`params`	No	Object	Especifica si se deben mostrar los detalles y las métricas del mensaje. Establece `with_details: true` para incluir el objeto `"details"` y `with_metrics: true` para incluir el objeto `"metrics"` en la respuesta.
`application`	Sí	String	Código de aplicación de Pushwoosh.
`per_page`	No	Integer	Número de resultados por página, de `1` a `499`. Omite el parámetro para obtener el tamaño de página predeterminado de 500 resultados; pasar `500` o más explícitamente es rechazado con `400`.
`page`	No	Integer	Número de página basado en cero para la paginación. Consulta el límite de paginación profunda a continuación.

Solicitud de ejemplo

{
    "filters": {
      "platforms": [],                  // IOS, ANDROID, OSX, WINDOWS, AMAZON, SAFARI, CHROME, FIREFOX, IE, EMAIL, HUAWEI_ANDROID, SMS
      "date_range": {
        "date_from": "string",          // Formato requerido: 2000-01-01
        "date_to": "string"             // Formato requerido: 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 de campaña
      "messages_ids": [],               // IDs de mensaje
      "messages_codes": [],             // Códigos de mensaje
      "application": "string"           // Código de aplicación de Pushwoosh
    },
    "params": {
      "with_details": true,             // Añadir detalles del mensaje a la respuesta (objeto "details")
      "with_metrics": true              // Añadir métricas del mensaje a la respuesta (objeto "metrics")
    },
    "per_page": 20,                     // <= 499
    "page": 0
}

Códigos de respuesta y ejemplos

{
  "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": [               // condiciones de etiqueta (ver /developer/api-reference/messages-api/#tag-conditions)
            TAG_CONDITION1,
            TAG_CONDITION2,
            ...,
            TAG_CONDITIONN
          ],
          "conditions_operator": "AND", // operador lógico para los arrays de condiciones; valores posibles: 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": [              // condiciones de etiqueta (ver Messages-api - tag-conditions)
          TAG_CONDITION1,
          TAG_CONDITION2,
          ...,
          TAG_CONDITIONN
        ],
        "conditions_operator": "AND" // operador lógico para los arrays de condiciones; valores posibles: 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 abarca más de 30 días:

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

page × per_page excede el límite de paginación profunda:

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

{
  "error": "account not found"
}

totalsByIntervals

Devuelve métricas y datos de conversión basados en el código del mensaje, agregados por hora.

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

Autorización

La autorización se maneja a través del Token de Acceso a la API en la cabecera de la solicitud.

Parámetros del cuerpo de la solicitud

Nombre del parámetro	Tipo	Descripción	Requerido
`message_code`	string	Código de mensaje obtenido de las respuestas de la API `/createMessage`.	Sí
`platforms`	[int]	Plataformas	No

Solicitud de ejemplo

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

Campos de respuesta

Nombre	Tipo	Descripción
`metrics`	array	Contiene un array de métricas de mensajes
`timestamp`	string	La hora de la métrica.
`platform`	int	El código de la plataforma (p. ej., iOS, Android).
`sends`	string	El número de mensajes enviados.
`opens`	string	El número de mensajes abiertos.
`deliveries`	string	El número de mensajes entregados.
`inbox_opens`	string	El número de aperturas de la bandeja de entrada.
`unshowable_sends`	string	El número de mensajes aceptados para dispositivos con las notificaciones desactivadas en la configuración del sistema operativo. No se muestra ningún banner, pero el mensaje llega a la aplicación y aparece en la Bandeja de entrada de mensajes si el envío tiene activada la opción Guardar mensaje en la bandeja de entrada. Se cuentan como envíos exitosos, no como errores.
`errors`	string	El número de errores.
`conversion`	object	Contiene datos de conversión
`sends`	string	El número total de mensajes enviados.
`opens`	string	El número total de mensajes abiertos.
`events`	array	Un array de eventos con sus estadísticas
`name`	string	El nombre del evento (p. ej., añadir al carrito).
`hits`	string	El número de hits.
`conversion`	float	La tasa de conversión relativa a las aperturas.
`revenue`	float	Los ingresos (solo para eventos con atributos `__amount` y `__currency`).

Respuesta de ejemplo

{
  "metrics": [{
    "timestamp": "2024-08-03 15:00:00",  // Marca de tiempo de las métricas en formato "YYYY-MM-DD HH:MM:SS"
    "platform": 3,                       // Código de plataforma
    "sends": "55902",                    // Número de mensajes enviados
    "opens": "382",                      // Número de mensajes abiertos
    "deliveries": "22931",               // Número de mensajes entregados
    "inbox_opens": "0",                  // Número de mensajes abiertos en la bandeja de entrada
    "unshowable_sends": "2",             // Enviado a dispositivos con notificaciones desactivadas, no se muestra ningún banner
    "errors": "0"                        // Número de errores encontrados
  }],
  "conversion": {
    "sends": "55902",                    // Número total de mensajes enviados
    "opens": "772",                      // Número total de mensajes abiertos
    "events": [{
      "name": "cart_add",                // Nombre del evento
      "hits": "96",                      // Número de hits para el evento
      "conversion": 0.12,                // Tasa de conversión relativa a las aperturas
      "revenue": 0                       // Ingresos generados por el evento (solo para eventos con atributos de cantidad/moneda)
    }]
  }
}

getMessageLog

Muestra información detallada sobre los mensajes enviados.

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

Cabeceras

Nombre	Requerido	Descripción
`Authorization`	Requerido	Token de acceso a la API del Panel de Control de Pushwoosh.

Parámetros del cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
`message_id`	No	Integer	Selecciona eventos de mensajes por ID de mensaje obtenido del historial de mensajes. Ejemplo: `12345678900`.
`message_code`	No	String	Selecciona eventos de mensajes por Código de mensaje obtenido de las respuestas de la API `/createMessage`. Ejemplo: `"A444-AAABBBCC-00112233"`.
`campaign_code`	No	String	Selecciona eventos de mensajes por Código de campaña especificado en la carga útil de tu mensaje. Ejemplo: `"AAAAA-XXXXX"`.
`hwid`	No	String o Array	Selecciona eventos de mensajes por HWID (Hardware ID) o un array de HWIDs.
`date_from`	Requerido si no se proporciona `message_id`, `message_code` o `campaign_code`	Datetime	Fecha de inicio para filtrar mensajes. Formato: `"YYYY-MM-DD HH:MM:SS"`. Ejemplo: `"2000-01-25 00:00:00"`.
`date_to`	Requerido si no se proporciona `message_id`, `message_code` o `campaign_code`	Datetime	Fecha de fin para filtrar mensajes. Formato: `"YYYY-MM-DD HH:MM:SS"`. Ejemplo: `"2000-01-26 00:00:00"`.
`limit`	No	Integer	Número máximo de eventos de mensaje devueltos en una sola respuesta. Valor máximo: `100000`.
`pagination_token`	No	String	Token de paginación obtenido de una respuesta `/getMessageLog` anterior. Úsalo para recuperar resultados adicionales.
`user_id`	No	String	Selecciona eventos de mensajes por un ID de usuario personalizado. Consulta `/registerUser` para más detalles.
`application_code`	Sí	String	Selecciona eventos de mensajes por código de aplicación de Pushwoosh
`actions`	No	Array	Filtra los resultados por acciones de mensaje específicas. Valores posibles: `"sent"`, `"delivered"`, `"opened"`, `"reject"`, `"create"`, `"inbox_delivered"`, `"inbox_read"`, `"inbox_opened"`, `"inbox_deleted"`. Los eventos `"create"` se excluyen de la respuesta por defecto. Incluye `"create"` en este array para verlos. Los eventos `"delivered"` requieren adicionalmente que las estadísticas de entrega estén habilitadas en la cuenta.
`platforms`	No	Array	Array de plataformas de destino para filtrar los resultados. Valores posibles: `"unknown"`, `"ios"`, `"blackberry"`, `"android"`, `"windows phone"`, `"osx"`, `"windows"`, `"amazon"`, `"safari"`, `"chrome"`, `"firefox"`, `"ie"`, `"email"`, `"fb messenger"`, `"baidu android"`, `"huawei android"`, `"sms"`, `"xiaomi"`, `"web"`, `"whatsapp"`, `"line"`, `"kakao"`, `"telegram"`, `"apple wallet"`, `"google wallet"`, `"viber"`.
`message_type`	No	String	Filtra los resultados por flujo de mensajes. `"all"` (predeterminado si se omite) devuelve todo, `"broadcast"` devuelve solo mensajes masivos (`message_id != 0`), `"transactional"` devuelve solo mensajes con `message_id = 0`, incluidos los enviados desde Customer Journey.

Solicitud de ejemplo

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 paginación
   "limit": 1000,                                  // opcional, el número máximo de entradas para una sola respuesta
   "application_code": "XXXXX-XXXXX",              // Código de aplicación de Pushwoosh
   "message_code": "A444-AAABBBCC-00112233",       // opcional, código de mensaje obtenido de la solicitud /createMessaage
   "message_id": 1234567890,                       // opcional, ID de mensaje obtenido del Panel de Control de Pushwoosh
   "campaign_code": "AAAAA-XXXXX",                 // opcional, código de una campaña para obtener el registro
   "hwid": "aaazzzqqqqxxx",                        // opcional, ID de hardware de un dispositivo específico al que se dirige un mensaje
   "user_id": "user_123",                          // opcional, ID de un usuario al que se dirige el mensaje
   "date_from": "2000-01-25 00:00:00",             // opcional, inicio del período de estadísticas
   "date_to": "2000-02-10 23:59:59",               // opcional, fin del período de estadísticas
   "actions": ["opened", "inbox_opened"],          // opcional, utilizado para la filtración de resultados. Valores posibles: "sent", "delivered", "opened", "reject", "create", "inbox_delivered", "inbox_read", "inbox_opened", "inbox_deleted". La respuesta incluirá todos los mensajes con la(s) acción(es) especificada(s).
   "platforms": ["ios", "chrome"],                 // opcional, utilizado para la filtración de resultados, solo en minúsculas. Valores posibles: "unknown", "ios", "blackberry", "android", "windows phone", "osx", "windows", "amazon", "safari", "chrome", "firefox", "ie", "email", "fb messenger", "baidu android", "huawei android", "sms", "xiaomi", "web", "whatsapp", "line", "kakao", "telegram", "apple wallet", "google wallet", "viber"
   "message_type": "broadcast"                     // opcional, "all" (predeterminado), "broadcast" (message_id != 0), o "transactional" (message_id = 0, incluye envíos de Customer Journey)
}'

Códigos de respuesta y ejemplos

{
  "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"
  }, {
    "timestamp": "2000-01-25T11:19:30Z",
    "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": "reject",
    "status": "failed",
    "error_reason": "invalid device token",
    "payload": "SOME_PAYLOAD_STRING"
  }]
}

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

{
  "error": "account not found"
}

Cada entrada en data también lleva error_reason (string, poblado con la razón del fallo cuando status es "failed") y un payload opcional (string).

Una página de respuesta puede ser más corta que el limit solicitado. Eso por sí solo no significa que la exportación haya terminado.

Estadísticas de correo electrónico

linksInteractions

Muestra estadísticas sobre los clics en enlaces en los correos electrónicos

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

Cabeceras

Nombre	Requerido	Descripción
`Authorization`	Sí	Token de acceso a la API del Panel de Control de Pushwoosh.

Parámetros del cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
`date_range`	No	Object	Define el período de informe. Contiene `date_from` y `date_to`.
`filters`	Sí	Object	Filtros de correo electrónico.
`application`	Sí	String	Código de aplicación de Pushwoosh (alternativamente, especifica `campaign`, `messages_ids` o `message_codes`).
`messages_codes`	Sí	Array	Códigos de mensaje (alternativamente, especifica `application`, `campaign` o `messages_ids`).
`campaign`	Sí	String	Código de campaña (alternativamente, especifica `application`, `messages_ids` o `message_codes`).
`messages_ids`	Sí	Array	IDs de mensaje (alternativamente, especifica `application`, `campaign` o `message_codes`).
`link_template`	Requerido si se especifica `application` o `campaign`.	String	Filtra las interacciones de enlaces de correo electrónico por palabra clave. Solo los enlaces que incluyan el texto especificado en su URL se devolverán en la respuesta de la API. Por ejemplo, si tu correo electrónico contiene enlaces como `https://example.com/news` y `https://example.com/shop`, establecer “link_template”: “shop” devolverá interacciones solo para `https://example.com/shop`.
`email_content_code`	No	String	Identificador único para el contenido del correo electrónico.
`params`	No	Object	Define opciones de respuesta adicionales. Incluye `with_full_links`, que añade una lista de enlaces completos con estadísticas.

Solicitud de ejemplo

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 requerido: 2000-01-01
         "date_to": "string"              // Formato requerido: 2000-01-01
      },
      "campaign": "string",               // Código de campaña (puedes especificar application, messages_ids o message_codes en su lugar)
      "application": "string",            // Código de aplicación (puedes especificar campaign, messages_ids o message_codes en su lugar)
      "messages_ids": [],                 // IDs de mensaje (puedes especificar application, campaign o message_codes en su lugar)
      "messages_codes": [],               // Códigos de mensaje (puedes especificar application, campaign o message_ids en su lugar)
      "link_template": "string",          // Plantilla de enlace (requerida si se especifica application o campaign)
      "email_content_code": "string"      // Identificador único para el contenido del correo electrónico.
   },
   "params": {
      "with_full_links": true             // Especifica si se deben mostrar estadísticas detalladas. Se pasará una lista de enlaces completos con estadísticas en el array full_links.
   }
}'

Códigos de respuesta y ejemplos

{
  "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

Muestra los usuarios que hicieron clic en los enlaces de los correos electrónicos

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

Cabeceras

Nombre	Requerido	Descripción
`Authorization`	Sí	Token de acceso a la API del Panel de Control de Pushwoosh.

Parámetros del cuerpo de la solicitud

Nombre	Requerido	Tipo	Descripción
`date_range`	No	Object	Define el período de informe. Contiene `date_from` y `date_to`.
`filters`	Sí	Object	Filtros de correo electrónico.
`application`	Sí	String	Código de aplicación de Pushwoosh (alternativamente, especifica `campaign`, `messages_ids` o `message_codes`).
`messages_codes`	Sí	Array	Códigos de mensaje (alternativamente, especifica `application`, `campaign` o `messages_ids`).
`campaign`	Sí	String	Código de campaña (alternativamente, especifica `application`, `messages_ids` o `message_codes`).
`messages_ids`	Sí	Array	IDs de mensaje (alternativamente, especifica `application`, `campaign` o `message_codes`).
`link_template`	Requerido si se especifica `application` o `campaign`.	String	Filtra las interacciones de enlaces de correo electrónico por palabra clave. Solo los enlaces que incluyan el texto especificado en su URL se devolverán en la respuesta de la API. Por ejemplo, si tu correo electrónico contiene enlaces como `https://example.com/news` y `https://example.com/shop`, establecer “link_template”: “shop” devolverá interacciones solo para `https://example.com/shop`.
`email_content_code`	No	String	Identificador único para el contenido del correo electrónico.
`page`	No	Integer	Número de página para la paginación.
`per_page`	No	Integer	Número de resultados por página (≤ 1000).

Solicitud de ejemplo

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 requerido: 2000-01-01
         "date_to": "string"            // Formato requerido: 2000-01-01
      },
      "campaign": "string",             // Código de campaña (puedes especificar application, messages_ids o message_codes en su lugar)
      "application": "string",          // Código de aplicación (puedes especificar campaign, messages_ids o message_codes en su lugar)
      "messages_ids": [],               // IDs de mensaje (puedes especificar application, campaign o message_codes en su lugar)
      "messages_codes": [],             // Códigos de mensaje (puedes especificar application, campaign o message_ids en su lugar)
      "link_template": "string",        // Plantilla de enlace (requerida si se especifica application o campaign)
      "email_content_code": "string"    // Identificador único para el contenido del correo electrónico.
   },
   "per_page": 100,
   "page": 0
}'

Códigos de respuesta y ejemplos

{
  "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

Proporciona datos sobre quejas de correo electrónico, rebotes suaves y rebotes duros, incluyendo la fecha, la dirección de correo electrónico y la razón de cada rebote.

Autorización

La autorización se maneja a través del Token de Acceso a la API en la cabecera de la solicitud.

Parámetros del cuerpo de la solicitud

Nombre del parámetro	Tipo	Descripción	Requerido
`application`	string	Código de aplicación de Pushwoosh	Sí
`message_code`	string	Código de mensaje.	Requerido si no se proporciona `date range` o `campaign`
`campaign`	string	Código de campaña.	Requerido si no se proporciona `message_code` o `date range`
`date_from`	string	La fecha de inicio para los datos en el formato `YYYY-MM-DDTHH:MM:SS.000Z` (estándar ISO 8601).	Requerido si no se proporciona `message_code` o `campaign`
`date_to`	string	La fecha de fin para los datos en el formato `YYYY-MM-DDTHH:MM:SS.000Z` (estándar ISO 8601).	Requerido si no se proporciona `message_code` o `campaign`
`per_page`	int	El número de filas por página, máximo 5000.	Sí
`page`	int	El número de página, comenzando desde cero.	Sí
`type`	string	El tipo de rebote: Complaint, Softbounce, Hardbounce.	No

Solicitud de ejemplo

{
  "application": "XXXXX-XXXXX",               // requerido. Código de aplicación de Pushwoosh
  "message_code": "XXXXX-XXXXXXXXX-XXXXXXXX", // requerido si no se proporciona campaign o date range.
                                              //          Identificador único del mensaje
  "campaign": "XXXXX-XXXXX",                  // requerido si no se proporciona message_code o date range.
                                              //          Código de campaña
  "date_from": "2024-07-20T00:00:00.000Z",    // requerido si no se proporciona message_code o campaign.
                                              //          Fecha de inicio en formato ISO 8601 "YYYY-MM-DDTHH:MM:SS.SSSZ"
  "date_to": "2024-07-20T00:00:00.000Z",      // requerido si no se proporciona message_code o campaign.
                                              //          Fecha de fin en formato ISO 8601 "YYYY-MM-DDTHH:MM:SS.SSSZ"
  "per_page": 1000,                           // requerido. Número de resultados por página, máximo 5000
  "page": 5,                                  // opcional. Número de página, comenzando desde cero
  "type": "Softbounce"                        // opcional. El tipo de rebote: Complaint, Softbounce, Hardbounce
}

Campos de respuesta

Nombre del campo	Tipo	Descripción
`total`	int	El recuento total de filas.
`bounced_emails`	array	Un array de detalles de correos electrónicos rebotados.
├── `email`	string	La dirección de correo electrónico que rebotó.
├── `date`	string	La fecha del rebote (formato: `YYYY-MM-DDTHH:MM:SS.000Z`).
├── `reason`	string	La razón del rebote.
└── `type`	string	El tipo de rebote: Complaint, Softbounce, Hardbounce.

Respuesta de ejemplo

{
  "total": 25,                             // Recuento total de filas.
  "bounced_emails": [{
    "email": "example@example.com",        // Dirección de correo electrónico que rebotó
    "date": "2024-07-20T00:00:00.000Z",    // Fecha del rebote en formato ISO 8601
    "reason": "Invalid recipient address", // Razón del rebote
    "type": "Hardbounce"                   // Tipo de rebote: Complaint, Softbounce, Hardbounce
  }]
}