Resumen de la API de mensajería v2

La API de mensajería v2 es un único endpoint REST/JSON para crear mensajes salientes a través de todos los canales que Pushwoosh soporta:

Push: iOS, Android, Huawei, Baidu, macOS, Amazon, Windows, Safari, Chrome, Firefox, IE
Correo electrónico
SMS
Telegram, Kakao, LINE, WhatsApp

El canal se selecciona por el tipo de payload (payload para push / SMS / mensajería, email_payload para correo electrónico).

La segmentación se selecciona por el tipo de solicitud (segment para segmentos de audiencia, transactional para listas explícitas de dispositivos o usuarios).

URL base

https://api.pushwoosh.com

Si utiliza una región dedicada o una implementación privada, confirme la URL base exacta con su Customer Success Manager de Pushwoosh.

Autenticación

Cada solicitud debe incluir un encabezado Authorization con un token de acceso a la API de Pushwoosh del lado del servidor:

Authorization: Token YOUR_API_TOKEN

Utilice el mismo token que ya emite para las llamadas a la API de servidor a servidor. No exponga este token en las aplicaciones cliente.

Métodos

Notify: POST /messaging/v2/notify. Crear y enviar un único mensaje (de segmento o transaccional).

Formato de solicitud y respuesta

Tipo de contenido: application/json.
Los nombres de los campos utilizan snake_case. Los grupos oneof aparecen como objetos anidados con exactamente una clave establecida.
Los valores de enumeración se serializan como sus nombres de cadena (por ejemplo, "IOS", "MESSAGE_TYPE_MARKETING").
Las respuestas exitosas devuelven HTTP 200 con un cuerpo JSON; los errores utilizan el sobre de error estándar de gRPC-Gateway — { "code": ..., "message": ..., "details": [...] }.

Inicio rápido

curl -X POST https://api.pushwoosh.com/messaging/v2/notify \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "segment": {
      "application": "XXXXX-XXXXX",
      "platforms": ["IOS", "ANDROID"],
      "code": "active_users",
      "payload": {
        "content": {
          "localized_content": {
            "en": {
              "ios":     { "body": "Hello from v2!" },
              "android": { "body": "Hello from v2!" }
            }
          }
        }
      },
      "schedule": { "at": "2026-05-01T12:00:00Z" },
      "message_type": "MESSAGE_TYPE_MARKETING"
    }
  }'

Envío de correo electrónico a través de SMTP

Si un servicio ya habla SMTP, puede enviar correos electrónicos transaccionales a través de la puerta de enlace SMTP en lugar de llamar a Notify directamente. La puerta de enlace reenvía cada mensaje a esta API como un Notify transaccional, por lo que se aplican las mismas reglas de autenticación y de payload de correo electrónico.

Próximos pasos

Notify

Referencia de payload

Referencia de payload de correo electrónico

Puerta de enlace SMTP

Migración desde v1