批量发送彩信消息

调用SendBatchMMSMessage API以批量发送彩信消息。

每个批量请求最多支持1000个电话号码。

请求参数

参数名称	类型	描述	是否必需
Action	string	值: SendBatchMMSMessage。	是
AccountId	int	项目ID，获取AccountId。	是
TaskContent	[]SendInfo	批量发送内容。详细字段描述请参见SendInfo。	是

SendInfo

参数名称	类型	描述	是否必需
TemplateId	string	彩信模板ID。	是
SenderId	string	发送者ID。	否
Target	[]TargetPhone	要发送的电话号码的信息。详细字段描述请参见TargetPhone。	是

TargetPhone

参数名称	类型	描述	是否必需
Phone	string	电话号码。	是
TemplateParams	[]string	用于发送的实际模板参数（如果使用无参数模板，则不需要）。	否

响应元素

参数名称	类型	描述	是否必需
RetCode	int	当RetCode不为0时，将在Message中显示具体的错误描述。如果RetCode为0，则不返回Message。	是
Action	string	操作名称。	是
Message	string	当RetCode不为0时，将在Message中显示具体的错误描述。	是
SessionNo	string	此会话的提交任务的唯一ID，可用于查询此会话中发送的短信列表。仅当成功提交的数量大于0时返回此字段。	否
SuccessCount	int	成功提交的彩信消息数量。	否
FailContent	[]SendInfoWithFailure	未成功提交的电话号码的详细信息。详细字段描述请参见SendInfoWithFailure。	否

SendInfoWithFailure

参数名称	类型	描述	是否必需
TemplateId	string	彩信模板ID。	是
SenderId	string	发送者ID。	否
Target	[]TargetPhoneWithFailure	未成功提交的电话号码的信息。详细字段描述请参见TargetPhoneWithFailure。	是
FailureDetails	string	提交失败的原因。	否

TargetPhoneWithFailure

参数名称	类型	描述	是否必需
TemplateParams	[]string	模板参数。	否
Phone	string	电话号码。	是
FailureDetails	string	电话号码提交失败的原因。	是

请求示例

curl --request POST 'https://api.uspeedo.com/api' \
--header 'Content-Type: application/json' \
-d '{
    "Action": "SendBatchMMSMessage",
    "AccountId": 1,
    "TaskContent": [
        {
            "Target": [
                {
                    "TemplateParams": [
                        "param1"
                    ],
                    "Phone": "(1)1111111"
                }
            ],
            "SenderId": "sender id",
            "TemplateId": "template id"
        }
    ]
}'

返回示例

{
    "Action": "SendBatchMMSMessageResponse",
    "Message": "",
    "RetCode": 18046,
    "FailContent": [
        {
            "FailureDetails": "failure details",
            "SenderId": "sender id",
            "Target": [
                {
                    "FailureDetails": "phone failure details",
                    "Invalid": true,
                    "Phone": "(1)1111111",
                    "TemplateParams": [
                        "param1"
                    ]
                }
            ],
            "TemplateId": "template id"
        }
    ],

    "SessionNo": "session no",
    "SuccessCount": 1
}