Descripción general de la API de mensajería v2

La API de mensajería v2 es un único punto de conexión REST/JSON para crear mensajes salientes a través de todos los canales que Pushwoosh admite:

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 carga útil (payload para push / SMS / mensajeros, 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 Gerente de Éxito del Cliente 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 un 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"
    }
  }'

Próximos pasos

Notificar

Referencia de carga útil

Referencia de carga útil de correo electrónico

Migración desde v1