背景 #

我正在Python中构建定时自动化程序，从Google Sheets读取行数据，根据分支名列将格式化消息发送到特定Viber社群，脚本在本地Windows机器上7*24运行。

目标 #

• 使用gspread读取Google Sheets行数据
• 对每条“到期”（距上次发送已3天）的行构建格式化消息
• 根据分支名与社群ID的映射，将消息发送到对应Viber社群
• 若存在链接，同时发送文件附件（PDF或图片）

已尝试方案 #

根据Viber REST API文档，使用/pa/post端点实现主动外发消息，代码如下：

import requests  

def send_text(community_id: str, text: str, token: str, bot_name: str) -> bool:  
    payload = {  
        "auth_token": token,  
        "to":         community_id,  
        "type":       "text",  
        "text":       text,  
        "sender":     {"name": bot_name}  
    }  
    r = requests.post(  
        "https://chatapi.viber.com/pa/post",  
        json=payload,  
        headers={"Content-Type": "application/json"},  
        timeout=10  
    )  
    result = r.json()  
    return result.get("status") == 0  

疑问 #

1. /pa/post是否是向Viber社群主动发送消息（无需用户先给机器人发消息）的正确端点？
2. 机器人需要设置为社群管理员，还是普通成员即可？
3. 发送PDF文件附件时，如下payload结构是否正确？

file_payload = {  
    "auth_token": token,  
    "to":         community_id,  
    "type":       "file",  
    "media":      "https://drive.google.com/file/...",  
    "file_name":  "document.pdf",  
    "size":       0,  
    "sender":     {"name": bot_name}  
}  

4. Viber Bot API在菲律宾是否存在已知的区域限制？

环境信息 #

• Python 3.11
• requests 2.31
• Windows 11
• Viber Bot创建于partners.viber.com

解答 #

1. 关于/pa/post端点 #

是的，/pa/post是Viber Bot API中用于发送主动外发消息的正确端点，适用于向已添加机器人的社群或用户发送消息，无需用户先发起对话。前提是机器人已被添加到目标社群中。

2. 机器人的社群权限要求 #

机器人必须是社群的管理员才能主动发送消息。如果只是普通成员，机器人无法主动向社群推送消息，仅能回复用户@它的消息。

3. PDF文件payload结构的问题 #

你的payload结构框架正确，但有两处需要修正：

• size字段不能设为0，必须填写文件的实际字节大小。Viber API会校验该值，不匹配会导致发送失败。
• media链接必须是直接可下载的公开链接，普通Google Drive分享链接无法被Viber解析，需要转换为直接下载格式（例如将/file/d/xxx/view改为/uc?export=download&id=xxx）。

修正后的示例payload：

file_payload = {  
    "auth_token": token,  
    "to":         community_id,  
    "type":       "file",  
    "media":      "https://drive.google.com/uc?export=download&id=xxx",  
    "file_name":  "document.pdf",  
    "size":       123456,  # 替换为实际文件字节数  
    "sender":     {"name": bot_name}  
}  

4. 菲律宾区域限制 #

目前Viber Bot API在菲律宾没有公开的官方区域限制，但需注意两点：

• 确保机器人后台（partners.viber.com）的地区设置未做限制。
• 部分本地网络环境可能存在API访问延迟，建议给请求添加重试机制，处理超时或发送失败的情况。

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