Banno Admin API预催收告警Deep Link使用问题（Python 3.12）

一、让Deep Link渲染为按钮/链接的正确配置 #

你当前的请求已包含deepLink字段，但要让它显示为可点击的按钮/链接，需调整data结构，新增actionLabel字段指定按钮显示文本。修正后的Python代码如下：

BASE_URL = "https://banno.com"
user_id = "[Banno Customer UUID]"
account_id = "[Banno Customer Account UUID]"
dm.access_token = "[access token obtained from client credentials flow]"

response = requests.request(
    "POST",
    f"{BASE_URL}/a/mobile/api/v0/institutions/{INSTITUTION_UUID}/users/{user_id}/alert/send/generic",
    headers = {"Accept": "application/json", "Authorization": f"Bearer {dm.access_token}"},
    json = {
        "title": "账户逾期提醒",
        "message": "您的账户已出现透支/逾期情况，请及时处理。",
        "data": {
            "deepLink": f"/users/{user_id}/accounts/{account_id}",
            "actionLabel": "查看我的账户"  # 定义按钮显示文本
        }
    }
)

当请求同时包含actionLabel和deepLink时，Banno客户端会自动将其渲染为可点击按钮，点击后跳转至指定账户页面。

二、机构专属Deep Link的使用问题 #

对于Banno为机构创建的专属Deep Link（如跳转至外部应用），可以在Send Alerts端点中使用，但需满足两个前提：

• 该专属Deep Link已在Banno后台完成配置并生效，确保Banno客户端能识别并处理该链接；
• 按照Banno提供的专属Deep Link格式填写到deepLink字段中，同时配合actionLabel指定按钮文本即可。

若专属Deep Link涉及外部应用跳转，需确保用户设备已安装目标应用，否则可能触发 fallback 行为（如跳转至网页版或提示下载应用）。

内容的提问来源于stack exchange，提问作者NMad