Cambiar Configuración de Notificaciones

PUT

/v3/notificationPreferences

PUT

/v3/notificationPreferences

curl -X PUT https://api.megaport.com/v3/notificationPreferences \
     -H "Content-Type: application/json" \
     -d '{
  "emails": [
    {
      "subscribed": true,
      "subscriptionKey": "COMPANY_ACTIVATED"
    },
    {
      "subscribed": false,
      "subscriptionKey": "COMPANY_SUPPLY_NEW"
    },
    {
      "subscribed": false,
      "subscriptionKey": "COMPANY_SUPPLY_EMAIL_CHANGED"
    },
    {
      "subscribed": false,
      "subscriptionKey": "COMPANY_SUPPLY_EMAIL_REJECTED"
    },
    {
      "subscribed": false,
      "subscriptionKey": "SERVICE_SPEED"
    },
    {
      "subscribed": false,
      "subscriptionKey": "SERVICE_MAINTENANCE"
    },
    {
      "subscribed": false,
      "subscriptionKey": "SERVICE_OUTAGE"
    },
    {
      "subscribed": false,
      "subscriptionKey": "SERVICE_LIFECYCLE_CONFIGURED"
    },
    {
      "subscribed": false,
      "subscriptionKey": "SERVICE_LIFECYCLE_DECOMMISSIONED"
    },
    {
      "subscribed": true,
      "subscriptionKey": "SERVICE_LIFECYCLE_LIVE_PLUS_7_DAYS"
    }
  ]
}'

{
  "data": {
    "emails": [
      {
        "description": "Cuando el administrador comienza a facturar un servicio",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "BILLING_START_ADMIN"
      },
      {
        "description": "Cuando un servicio se pone en marcha y comenzamos a facturar por él",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "BILLING_START_LIVE"
      },
      {
        "description": "Cuando un usuario modifica exitosamente el término de un servicio",
        "messageGroupName": "Financial",
        "subscribed": false,
        "subscriptionKey": "BILLING_SERVICE_RETERMED"
      },
      {
        "description": "Cuando se usa una tarjeta de crédito para pagar y el pago es exitoso",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "CARD_GOOD_PAYMENT"
      },
      {
        "description": "Cuando una tarjeta de crédito se utiliza para pagar y falla por problemas temporales",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "CARD_TEMP_BAD_PAYMENT"
      },
      {
        "description": "Cuando una tarjeta de crédito se usa para pagar y falla por problemas permanentes",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "CARD_PERM_BAD_PAYMENT"
      },
      {
        "description": "Cuando una tarjeta de crédito ha sido registrada con éxito",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "CARD_REGISTER"
      },
      {
        "description": "Cuando un intento de registro de tarjeta de crédito ha fallado",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "CARD_REGISTER_FAILED"
      },
      {
        "description": "Cuando una empresa se activa",
        "messageGroupName": "Company",
        "subscribed": true,
        "subscriptionKey": "COMPANY_ACTIVATED"
      },
      {
        "description": "Cuando se crea un mercado empresarial",
        "messageGroupName": "Company",
        "subscribed": true,
        "subscriptionKey": "COMPANY_SUPPLY_NEW"
      },
      {
        "description": "Cuando la cuenta de correo electrónico de facturación se edita en un mercado",
        "messageGroupName": "Company",
        "subscribed": true,
        "subscriptionKey": "COMPANY_SUPPLY_EMAIL_CHANGED"
      },
      {
        "description": "Cuando el cliente rechaza la nueva cuenta de correo electrónico como correo electrónico de contacto de facturación",
        "messageGroupName": "Company",
        "subscribed": true,
        "subscriptionKey": "COMPANY_SUPPLY_EMAIL_REJECTED"
      },
      {
        "description": "Cuando se prepara una nueva factura para el mercado/cliente de facturación",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "INVOICE_NOTIFY_CMD"
      },
      {
        "description": "Cuando se procesa un servicio IX contenido en un pedido",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_IX"
      },
      {
        "description": "Cuando un puerto contenido en un pedido es procesado",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_MEGAPORT"
      },
      {
        "description": "Cuando un servicio VXC contenido en un pedido es aprobado",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_VXC_APPROVED"
      },
      {
        "description": "Cuando un pedido de VXC necesita la aprobación de un extremo",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_VXC_PENDING"
      },
      {
        "description": "Cuando un pedido VXC necesita aprobación de un extremo y ha estado esperando más de 1 semana",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_VXC_PENDING_PLUS_7"
      },
      {
        "description": "Cuando un pedido VXC en espera de aprobación es rechazado",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_VXC_REJECTED"
      },
      {
        "description": "Cuando se crea un pedido de primer orden a un proveedor de empresa y mercado",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "COMPANY_SUPPLY_FIRST_ORDER"
      },
      {
        "description": "Recordatorio enviado de facturas pendientes o vencidas",
        "messageGroupName": "Financial",
        "subscribed": true,
        "subscriptionKey": "PAYMENT_REMIND_CMD"
      },
      {
        "description": "Cuando un servicio está configurado",
        "messageGroupName": "Services",
        "subscribed": true,
        "subscriptionKey": "SERVICE_LIFECYCLE_CONFIGURED"
      },
      {
        "description": "Cuando un servicio ha sido dado de baja",
        "messageGroupName": "Services",
        "subscribed": true,
        "subscriptionKey": "SERVICE_LIFECYCLE_DECOMMISSIONED"
      },
      {
        "description": "Correo electrónico de seguimiento de servicio + 1 semana",
        "messageGroupName": "Services",
        "subscribed": true,
        "subscriptionKey": "SERVICE_LIFECYCLE_LIVE_PLUS_7_DAYS"
      },
      {
        "description": "Cuando un servicio se cae (1 correo por hora si el servicio está intermitente)",
        "messageGroupName": "Service Status",
        "subscribed": true,
        "subscriptionKey": "SERVICE_STATUS_DOWN"
      },
      {
        "description": "Cuando un servicio sube (1 correo por hora si el servicio está oscilando)",
        "messageGroupName": "Service Status",
        "subscribed": true,
        "subscriptionKey": "SERVICE_STATUS_UP"
      },
      {
        "description": "Cuando se realiza un cambio de velocidad que requiere aprobación",
        "messageGroupName": "Services",
        "subscribed": true,
        "subscriptionKey": "SERVICE_SPEED"
      },
      {
        "description": "Cuando las obras planificadas están programadas",
        "messageGroupName": "Services",
        "subscribed": true,
        "subscriptionKey": "SERVICE_MAINTENANCE"
      },
      {
        "description": "Notificación de Interrupción de Servicio",
        "messageGroupName": "Services",
        "subscribed": true,
        "subscriptionKey": "SERVICE_OUTAGE"
      },
      {
        "description": "Cuando una solicitud de pedido está pendiente de aprobación",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_REQUEST_PENDING"
      },
      {
        "description": "Cuando se aprueba una solicitud de pedido",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_REQUEST_APPROVED"
      },
      {
        "description": "Cuando se rechaza una solicitud de pedido",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_REQUEST_REJECTED"
      },
      {
        "description": "Cuando una solicitud de pedido no se puede procesar",
        "messageGroupName": "Ordering",
        "subscribed": true,
        "subscriptionKey": "ORDER_REQUEST_FAILED"
      },
      {
        "description": "Cuando una sesión BGP se cae en un servicio (1 correo por hora si el servicio está fluctuando)",
        "messageGroupName": "Service Status",
        "subscribed": true,
        "subscriptionKey": "SERVICE_EVENT_BGP_DOWN"
      },
      {
        "description": "Cuando una sesión BGP se levanta en un servicio (1 correo por hora si el servicio está oscilando)",
        "messageGroupName": "Service Status",
        "subscribed": true,
        "subscriptionKey": "SERVICE_EVENT_BGP_UP"
      }
    ],
    "receivesChildNotifications": false
  },
  "message": "Tu destino de mensajería ha sido guardado",
  "terms": "This data is subject to the Acceptable Use Policy https://www.megaport.com/legal/acceptable-use-policy"
}

Actualiza la configuración de notificaciones por correo electrónico actual para el usuario que ha iniciado sesión.

Los cambios se definen en el cuerpo de la solicitud. El formato de la solicitud es el mismo que el de la respuesta recibida al enumerar las notificaciones mediante el punto de conexión Listar configuración de notificaciones.

Estos parámetros son necesarios para actualizar la configuración de suscripción a notificaciones por correo electrónico:

subscriptionKey - (Cadena) El valor de clave del evento de correo electrónico. Ejecute el punto de conexión Listar configuración de notificaciones para obtener la lista completa disponible para el usuario. Por ejemplo, BILLING_START_ADMIN.
subscribed - (Booleano) Establezca el valor de subscribed en true o false, según si desea suscribirse al grupo de notificaciones por correo electrónico. Este valor predeterminado será false si no se proporciona el valor de suscripción.

Nota: La respuesta 200 OK siempre devuelve todas las notificaciones del usuario, incluso si solo envía una actualización.

Solicitud

This endpoint expects an object.

emailslist of objectsOpcional

Respuesta

Cambiar Configuración de Notificaciones - Suscribirse a Dos Notificaciones / Cambiar Configuración de Notificaciones - Suscribirse a Todas las Notificaciones a todo / Cambiar Configuración de Notificaciones - Suscribirse a Todas las Notificaciones a todo / Cambiar Configuración de Notificaciones - Suscribirse a Dos Notificaciones

dataobjectOpcional

messagestringOpcional

termsstringOpcional

Errores

400

Bad Request Error