API de Email

createEmailMessage

Crea un mensaje de correo electrónico.

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

Parámetros del cuerpo de la solicitud

Nombre	Tipo	Requerido	Descripción
auth	string	Sí	Token de acceso a la API desde el Panel de Control de Pushwoosh.
application	string	Sí	Código de aplicación de Pushwoosh
notifications	array	Sí	Array JSON que contiene los detalles del mensaje de correo electrónico. Consulte la tabla de Parámetros de Notificaciones a continuación.

Parámetros de las notificaciones

Nombre	Tipo	Requerido	Descripción
send_date	string	Sí	Define cuándo enviar el correo electrónico. Formato: AAAA-MM-DD HH:mm o "now".
preset	string	Sí	Código de preajuste de correo electrónico. Cópielo de la barra de URL del Editor de Contenido de Correo Electrónico en el Panel de Control de Pushwoosh.
subject	string o object	No	Línea de asunto del correo electrónico. El correo electrónico siempre estará en el idioma del contenido. Si subject no contiene un idioma que coincida con content, el asunto estará vacío.
content	string o object	No	El contenido del cuerpo del correo electrónico. Puede ser una cadena para contenido HTML simple o un objeto para versiones localizadas.
attachments	array	No	Los archivos adjuntos del correo electrónico. Solo se permiten dos archivos adjuntos. Cada archivo adjunto no debe exceder 1MB (codificado en base64).
list_unsubscribe	string	No	Permite establecer una URL personalizada para el encabezado “Link-Unsubscribe”.
campaign	string	No	Código de campaña para asociar el correo electrónico con una campaña específica.
ignore_user_timezone	boolean	No	Si es true, envía el correo electrónico inmediatamente, ignorando las zonas horarias del usuario.
timezone	string	No	Envía el correo electrónico según la zona horaria del usuario. Ejemplo: "America/New_York".
filter	string	No	Envía el correo electrónico a los usuarios que coinciden con una condición de filtro específica.
devices	array	No	Lista de direcciones de correo electrónico (máximo 1000) para enviar correos electrónicos dirigidos. Si se utiliza, el mensaje se envía solo a estas direcciones. Se ignora si se utiliza el Grupo de Aplicaciones.
use_auto_registration	boolean	No	Si es true, registra automáticamente los correos electrónicos del parámetro devices.
users	array	No	Si se establece, el mensaje de correo electrónico solo se entregará a los ID de Usuario especificados (registrados a través de la llamada /registerEmail). No más de 1000 ID de usuario en un array. Si se especifica el parámetro “devices”, el parámetro “users” será ignorado.
dynamic_content_placeholders	object	No	Marcadores de posición para contenido dinámico en lugar de los valores de las etiquetas del dispositivo.
conditions	array	No	Condiciones de segmentación usando etiquetas. Ejemplo: [["Country", "EQ", "BR"]].
from	object	No	Especifique un nombre y correo electrónico de remitente personalizados, anulando el predeterminado en las propiedades de la aplicación.
reply-to	object	No	Especifique un correo electrónico de respuesta personalizado, anulando el predeterminado en las propiedades de la aplicación.
bcc	array	No	CCO (Copia de Carbón Oculta): array de direcciones de correo electrónico que reciben una copia del correo electrónico sin que otros destinatarios las vean.
email_type	string	No	Especifique el tipo de correo electrónico: "marketing" o "transactional".
email_category	string	Requerido cuando email_type es "marketing".	Especifique uno de los nombres de categoría configurados en el centro de preferencias de suscripción (por ejemplo, Newsletter, Promocional, Actualizaciones de Producto).
transactionId	string	No	Identificador de mensaje único para evitar el reenvío en caso de problemas de red. Se almacena en el lado de Pushwoosh durante 5 minutos.
capping_days	integer	No	El número de días (máximo 30) para aplicar el frequency capping por dispositivo. Nota: Asegúrese de que el frequency capping global esté configurado en el Panel de Control.
capping_count	integer	No	El número máximo de correos electrónicos que se pueden enviar desde una aplicación específica a un dispositivo en particular dentro de un período de capping_days. En caso de que el mensaje creado exceda el límite de capping_count para un dispositivo, no se enviará a ese dispositivo.
capping_exclude	boolean	No	Si se establece en true, este correo electrónico no se contará para el capping de futuros correos electrónicos.
capping_avoid	boolean	No	Si se establece en true, el capping no se aplicará a este correo electrónico específico.
send_rate	integer	No	Limita cuántos mensajes se pueden enviar por segundo a todos los usuarios. Ayuda a prevenir la sobrecarga del backend durante envíos de gran volumen.
send_rate_avoid	boolean	No	Si se establece en true, el límite de throttling no se aplicará a este correo electrónico específico.

Ejemplo de solicitud

{
  "request": {
    "auth": "API_ACCESS_TOKEN",         // requerido. Token de acceso a la API desde el Panel de Control de Pushwoosh
    "application": "APPLICATION_CODE",  // requerido. Código de aplicación de Pushwoosh.
    "notifications": [{
      "send_date": "now",               // requerido. AAAA-MM-DD HH:mm  O 'now'
      "preset": "ERXXX-32XXX",          // requerido. Copie el código de preajuste de correo electrónico de la barra de URL de
                                        //           la página del editor de Contenido de Correo Electrónico en el Panel de Control de Pushwoosh.
      "subject": {                      // opcional. Línea de asunto del mensaje de correo electrónico.
        "de": "subject de",
        "en": "subject en"
      },
      "content": {                      // opcional. Contenido del cuerpo del correo electrónico.
        "de": "<html><body>de Hello, moto</body></html>",
        "default": "<html><body>default Hello, moto</body></html>"
      },
      "attachments": [{                 // opcional. Archivos adjuntos del correo electrónico
        "name": "image.png",            //           "name" - nombre del archivo
        "content": "iVBANA...AFTkuQmwC" //           "content" - contenido del archivo codificado en base64
      }, {
        "name": "file.pdf",
        "content": "JVBERi...AFTarEGC"
      }],
      "list_unsubscribe": "URL",        // opcional. Permite establecer una URL personalizada para el encabezado "Link-Unsubscribe"
      "campaign": "CAMPAIGN_CODE",      // opcional. Para asignar este mensaje de correo electrónico a una campaña en particular,
                                        //           agregue un código de campaña aquí.
      "ignore_user_timezone": true,     // opcional.
      "timezone": "America/New_York",   // opcional. Especifique para enviar el mensaje de acuerdo con
                                        //           la zona horaria establecida en el dispositivo del usuario.
      "filter": "FILTER_NAME",          // opcional. Envíe el mensaje a usuarios específicos que cumplan con las condiciones del filtro.
      "devices": [                      // opcional. Especifique las direcciones de correo electrónico para enviar mensajes de correo electrónico dirigidos.
        "email_address1",               //           No más de 1000 direcciones en un array.
        "email_address2"                //           Si se establece, el mensaje solo se enviará a las direcciones de
      ],                                //           la lista. Se ignora si se utiliza el Grupo de Aplicaciones.
      "use_auto_registration": true,    // opcional. Registra automáticamente los correos electrónicos especificados en el parámetro "devices"
      "users": [                        // opcional. Si se establece, el mensaje de correo electrónico solo se entregará a los
        "userId1",                      //           ID de usuario especificados (registrados a través de la llamada /registerEmail).
        "userId2"                       //           No más de 1000 ID de usuario en un array.
      ],                                //           Si se especifica el parámetro "devices",
                                        //           el parámetro "users" será ignorado.
      "dynamic_content_placeholders": { // opcional. Marcadores de posición para contenido dinámico en lugar de los valores de las etiquetas del dispositivo.
        "firstname": "John",
        "firstname_en": "John"
      },
      "conditions": [                   // opcional. Condiciones de segmentación, vea la nota a continuación.
        ["Country", "EQ", "BR"],
        ["Language", "EQ", "pt"]
      ],
      "from": {                         // opcional. Especifique un nombre de remitente y una dirección de correo electrónico de remitente
        "name": "alias from",           //           para reemplazar el "Nombre del remitente" y el "Correo electrónico del remitente" predeterminados
        "email": "from-email@email.com" //           configurados en las propiedades de la aplicación.
      },
      "reply-to": {                     // opcional. Especifique una dirección de correo electrónico para reemplazar la
        "name": "alias reply to ",      //           "Dirección de respuesta" predeterminada configurada en las propiedades de la aplicación.
        "email": "reply-to@email.com"
      },
      "bcc": [                          // opcional. CCO: array de direcciones de correo electrónico que reciben una copia sin que otros destinatarios las vean.
        "bcc1@example.com",
        "bcc2@example.com"
      ],
      "email_type": "marketing",        // opcional. "marketing" o "transactional".
      "email_category": "category name",// requerido cuando email_type es "marketing". Nombre de la categoría.
      "transactionId": "unique UUID",   // opcional. Identificador de mensaje único para evitar el reenvío
                                        //           en caso de problemas de red. Almacenado en el lado
                                        //           de Pushwoosh durante 5 minutos.
      // Parámetros de Frequency capping. Asegúrese de que el Frequency capping Global esté configurado en el Panel de Control.
      "capping_days": 30,               // opcional. Cantidad de días para el frequency capping (máximo 30 días)
      "capping_count": 10,              // opcional. El número máximo de correos electrónicos que se pueden enviar desde una
                                        //           aplicación específica a un dispositivo en particular dentro de un período de 'capping_days'.
                                        //           En caso de que el mensaje creado exceda el
                                        //           límite de 'capping_count' para un dispositivo, no
                                        //           se enviará a ese dispositivo.
      "capping_exclude": true,          // opcional. Si se establece en true, este correo electrónico no
                                        //           se contará para el capping de futuros correos electrónicos.
      "capping_avoid": true,            // opcional. Si se establece en true, el capping no se aplicará a
                                        //           este correo electrónico específico.
      "send_rate": 100,                 // opcional. Límite de throttling.
                                        //           Limita cuántos mensajes se pueden enviar por segundo a todos los usuarios.
                                        //           Ayuda a prevenir la sobrecarga del backend durante envíos de gran volumen.
      "send_rate_avoid": true,          // opcional. Si se establece en true, el límite de throttling no se aplicará a
                                        //           este correo electrónico específico.
    }]
  }
}

Ejemplos de respuesta

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

403

{
  "status_code": 403,
  "status_message": "Token restrictions forbid this operation",
  "response": null
}

Condiciones de las etiquetas (Tags)

Cada condición de etiqueta es un array como [tagName, operator, operand] donde

• tagName: nombre de una etiqueta
• operator: “EQ” | “IN” | “NOTEQ” | “NOTIN” | “LTE” | “GTE” | “BETWEEN”
• operand: string | integer | array | date

Descripción del operando

• EQ: el valor de la etiqueta es igual al operando;
• IN: el valor de la etiqueta se cruza con el operando (el operando siempre debe ser un array);
• NOTEQ: el valor de la etiqueta no es igual a un operando;
• NOTIN: el valor de la etiqueta no se cruza con el operando (el operando siempre debe ser un array);
• GTE: el valor de la etiqueta es mayor o igual que el operando;
• LTE: el valor de la etiqueta es menor o igual que el operando;
• BETWEEN: el valor de la etiqueta es mayor o igual que el valor mínimo del operando pero menor o igual que el valor máximo del operando (el operando siempre debe ser un array).

Etiquetas de cadena (String)

Operadores válidos: EQ, IN, NOTEQ, NOTIN
Operandos válidos:

• EQ, NOTEQ: el operando debe ser una cadena;
• IN, NOTIN: el operando debe ser un array de cadenas como ["valor 1", "valor 2", "valor N"];

Etiquetas de entero (Integer)

Operadores válidos: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE
Operandos válidos:

• EQ, NOTEQ, GTE, LTE: el operando debe ser un entero;
• IN, NOTIN: el operando debe ser un array de enteros como [valor 1, valor 2, valor N];
• BETWEEN: el operando debe ser un array de enteros como [valor_min, valor_max].

Etiquetas de fecha (Date)

Operadores válidos: EQ, IN, NOTEQ, NOTIN, BETWEEN, GTE, LTE
Operandos válidos:

• "AAAA-MM-DD 00:00" (cadena)
• marca de tiempo unix 1234567890 (entero)
• "hace N días" (cadena) para los operadores EQ, BETWEEN, GTE, LTE

Etiquetas booleanas (Boolean)

Operadores válidos: EQ
Operandos válidos: 0, 1, true, false

Etiquetas de lista (List)

Operadores válidos: IN
Operandos válidos: el operando debe ser un array de cadenas como ["valor 1", "valor 2", "valor N"].

Peligro

Recuerde que los parámetros “filter” y “conditions” no deben usarse juntos.
Además, ambos serán ignorados si el parámetro “devices” se utiliza en la misma solicitud.

Nota

Etiquetas de País e Idioma

El valor de la etiqueta de idioma es un código de dos letras en minúsculas según ISO-639-1
El valor de la etiqueta de país es un código de dos letras en MAYÚSCULAS según ISO_3166-2
Por ejemplo, para enviar una notificación push a suscriptores de habla portuguesa en Brasil, deberá especificar la siguiente condición: "conditions": [["Country", "EQ", "BR"],["Language", "EQ", "pt"]]

registerEmail

Registra una dirección de correo electrónico para la aplicación.

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

Encabezados de la solicitud

Nombre	Requerido	Valor	Descripción
Authorization	Sí	Token XXXX	Token de Dispositivo de la API para acceder a la API de Dispositivos. Reemplace XXXX con su token real de la API de Dispositivos.

Cuerpo de la solicitud

Nombre	Tipo	Descripción
application*	string	Código de aplicación de Pushwoosh
email*	string	Dirección de correo electrónico.
language	string	Configuración regional de idioma del dispositivo. Debe ser un código de dos letras en minúsculas según el estándar ISO-639-1.
userId	string	ID de Usuario para asociar con la dirección de correo electrónico.
tz_offset	integer	Desplazamiento de la zona horaria en segundos.
tags	object	Valores de etiquetas para asignar al dispositivo registrado.

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

Ejemplo

{
  "request": {
    "application": "APPLICATION_CODE",   // requerido. Código de aplicación de Pushwoosh.
    "email":"email@domain.com",          // requerido. Dirección de correo electrónico a registrar.
    "language": "en",                    // opcional. Configuración regional de idioma.
    "userId": "userId",                  // opcional. ID de Usuario para asociar con la dirección de correo electrónico.
    "tz_offset": 3600,                   // opcional. Desplazamiento de la zona horaria en segundos.
    "tags": {                            // opcional. Valores de etiquetas para establecer en el dispositivo registrado.
       "StringTag": "string value",
       "IntegerTag": 42,
       "ListTag": ["string1","string2"], // establece la lista de valores para Etiquetas de tipo Lista
       "DateTag": "2024-10-02 22:11",    // tenga en cuenta que la hora debe estar en UTC
       "BooleanTag": true                // los valores válidos son: true, false
    }
  }
}

deleteEmail

Elimina una dirección de correo electrónico de su base de usuarios.

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

Encabezados de la solicitud

Nombre	Requerido	Valor	Descripción
Authorization	Sí	Token XXXX	Token de Dispositivo de la API para acceder a la API de Dispositivos. Reemplace XXXX con su token real de la API de Dispositivos.

Cuerpo de la solicitud

Nombre	Tipo	Descripción
application	string	Código de aplicación de Pushwoosh
email	string	Dirección de correo electrónico utilizada en la solicitud /registerEmail.

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

Ejemplo

{
  "request": {
    "application": "APPLICATION_CODE",  // requerido. Código de aplicación de Pushwoosh
    "email": "email@domain.com"         // requerido. Correo electrónico a eliminar de los suscriptores de la aplicación.
  }
}

setEmailTags

Establece los valores de las etiquetas para la dirección de correo electrónico.

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

Encabezados de la solicitud

Nombre	Requerido	Valor	Descripción
Authorization	Sí	Token XXXX	Token de Dispositivo de la API para acceder a la API de Dispositivos. Reemplace XXXX con su token real de la API de Dispositivos.

Cuerpo de la solicitud

Nombre	Tipo	Descripción
application	string	Código de aplicación de Pushwoosh
email	string	Dirección de correo electrónico.
tags	object	Objeto JSON de etiquetas para establecer, envíe ‘null’ para eliminar el valor.
userId	string	ID de Usuario asociado con la dirección de correo electrónico.

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "skipped": []
  }
}

Ejemplo

{
  "request": {
    "email": "email@domain.com",                  // requerido. Dirección de correo electrónico para la que se establecerán las etiquetas.
    "application": "APPLICATION_CODE",            // requerido. Código de aplicación de Pushwoosh.
    "tags": {
      "StringTag": "string value",
      "IntegerTag": 42,
      "ListTag": ["string1", "string2"],
      "DateTag": "2024-10-02 22:11",              // hora en UTC
      "BooleanTag": true                          // los valores válidos son: true, false
    },
    "userId": "userId"                            // opcional. ID de Usuario asociado con la dirección de correo electrónico.
  }
}

Nota

Para otros tipos de dispositivos se devolverá 200 OK, aunque las etiquetas no se guardarán.

Precaución

Por favor, evite establecer más de 50 valores de etiquetas en una sola solicitud /setEmailTags.

registerEmailUser

Asocia un ID de Usuario externo con una dirección de correo electrónico especificada.

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

Nota

Tenga en cuenta que este método no registra una dirección de correo electrónico en su base de usuarios; debe usarse solo para asignar ID de usuario a direcciones de correo electrónico que ya han sido registradas mediante la solicitud /registerEmail.

Se puede usar en la llamada a la API /createEmailMessage (el parámetro ‘users’).

Encabezados de la solicitud

Nombre	Requerido	Valor	Descripción
Authorization	Sí	Token XXXX	Token de Dispositivo de la API para acceder a la API de Dispositivos. Reemplace XXXX con su token real de la API de Dispositivos.

Cuerpo de la solicitud

Nombre	Tipo	Descripción
application*	string	Código de aplicación de Pushwoosh
email*	string	Dirección de correo electrónico.
userId*	string	ID de Usuario para asociar con la dirección de correo electrónico.
tz_offset	integer	Desplazamiento de la zona horaria en segundos.

200

{
  "status_code": 200,
  "status_message": "OK",
  "response": null
}

400

{
  "status_code": 400,
  "status_message": "Request format is not valid."
}

403

{
  "status_code": 403,
  "status_message": "Forbidden."
}

Ejemplo

{
  "request": {
    "application": "APPLICATION_CODE", // requerido. Código de aplicación de Pushwoosh.
    "email": "email@domain.com",       // requerido. Dirección de correo electrónico del usuario.
    "userId": "userId",                // requerido. ID de Usuario para asociar con la dirección de correo electrónico.
    "tz_offset": 3600                  // opcional. Desplazamiento de la zona horaria en segundos.
  }
}

Nota

Para recuperar datos sobre rebotes blandos, rebotes duros y quejas de correo electrónico, incluyendo la fecha, la dirección de correo electrónico y el motivo de cada rebote, utilice el método BouncedEmails.