OPPO 推送补新消息分类(channel_id/category/notify_level)

2024-11-20 后创建的 OPPO 应用发送通知必须携带 category(新规),
配置项 OPPO_PUSH_CHANNEL_ID / OPPO_PUSH_CATEGORY / OPPO_PUSH_NOTIFY_LEVEL(0=不传),
均留空时 payload 与原先完全一致。凭据已到位:荣耀/小米(含 channel 154219)/OPPO/vivo
四家配齐(.env,不入库),仅剩华为待补。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

app/core/config.py

@@ -111,6 +111,12 @@ class Settings(BaseSettings):
     OPPO_PUSH_SEND_ENDPOINT: str = (
         "https://api.push.oppomobile.com/server/v1/message/notification/unicast"
     )
+    # OPPO 新消息分类(2024-11-20 后创建的应用必须携带,否则可能被拒/限):
+    # channel_id=通知栏通道(OPPO 后台「通道ID」),category=消息分类 code(如 MARKETING 内容营销)。
+    # notify_level=提醒方式(0=不传走 OPPO 默认;内容营销类仅支持 1 通知栏/2 通知栏+锁屏)。
+    OPPO_PUSH_CHANNEL_ID: str = ""
+    OPPO_PUSH_CATEGORY: str = ""
+    OPPO_PUSH_NOTIFY_LEVEL: int = 0
 
     # 无障碍保护存活监控后台任务(推送 + pull 后置兜底)
     HEARTBEAT_MONITOR_ENABLED: bool = True       # 总开关

app/integrations/vendor_push.py

@@ -484,18 +484,26 @@ def _oppo_auth_token() -> str:
 def _send_oppo(token: str, title: str, body: str, extras: dict[str, str]) -> dict[str, Any]:
     auth_token = _oppo_auth_token()
     ttl_hours = max(1, min(72, settings.PUSH_TIME_TO_LIVE_SEC // 3600))
+    notification: dict[str, Any] = {
+        "app_message_id": f"{extras.get('type', 'notify')}_{uuid.uuid4().hex}",
+        "title": title,
+        "content": body,
+        "click_action_type": 0,
+        "off_line": True,
+        "off_line_ttl": ttl_hours,
+        "action_parameters": json.dumps(extras, ensure_ascii=False),
+    }
+    # 新消息分类(2024-11-20 后创建的 OPPO 应用必须带 category,否则可能被拒收/降级)
+    if settings.OPPO_PUSH_CHANNEL_ID.strip():
+        notification["channel_id"] = settings.OPPO_PUSH_CHANNEL_ID.strip()
+    if settings.OPPO_PUSH_CATEGORY.strip():
+        notification["category"] = settings.OPPO_PUSH_CATEGORY.strip()
+    if settings.OPPO_PUSH_NOTIFY_LEVEL:
+        notification["notify_level"] = settings.OPPO_PUSH_NOTIFY_LEVEL
     message = {
         "target_type": 2,
         "target_value": token,
-        "notification": {
-            "app_message_id": f"{extras.get('type', 'notify')}_{uuid.uuid4().hex}",
-            "title": title,
-            "content": body,
-            "click_action_type": 0,
-            "off_line": True,
-            "off_line_ttl": ttl_hours,
-            "action_parameters": json.dumps(extras, ensure_ascii=False),
-        },
+        "notification": notification,
     }
     data = _request_form(
         "POST",