如何快速集成彩信群发API？看这篇就够了

2024-11-08 12:11

对于企业来说，使用彩信群发，除了通过彩信群发平台在线发送外，有时候也需要对接彩信群发API，通过接口发送，以完成自动化彩信群发营销。对接彩信群发API，需要一定的开发能力，由于彩信群发接口对接有一定难度，对于初次调用彩信接口的企业不够友好，今天小编准备了详细的彩信群发API对接指南，看完你就能快速集成彩信群发API了。

首先，就是选择一个合适的彩信群发平台，这里以中昱维信彩信群发平台为例，注册好账号后，就能获取到app_id和app_key了。初次注册，会赠送10条彩信群发余额，足够开发调试。app_id和app_key是调用彩信接口的重要屏障，需要妥善保管，不要泄露给任何人。

其次，就是确定开发语言，本文以java为例，其他语言也可以。彩信群发API,是标准https协议，支持任何语言。

接下来，就是正式对接了，以下是详细彩信群发API对接指南：

1.对接彩信模版创建接口

import java.io.IOException;
import org.apache.commons.httpclient.HttpClient;
import org.apache.commons.httpclient.HttpException;
import org.apache.commons.httpclient.NameValuePair;
import org.apache.commons.httpclient.methods.PostMethod;
import com.alibaba.fastjson.JSONObject;
import com.veesing.utils.Config;

public class SmsGroupTest {
	public static void main(String[] args) {
		// 获取连接
		HttpClient client = new HttpClient();
		// 短信群发API接口地址
		PostMethod method = new PostMethod("https://vip.veesing.com/smsApi/group");
		// 设置编码
		client.getParams().setContentCharset("UTF-8");
		method.setRequestHeader("ContentType", "application/x-www-form-urlencoded;charset=utf-8");
		// 将要群发的手机号码，手机号码之间请用英文逗号隔开
		String phone = "15080929435,17608432793";
		// 发送内容
		String content = "【云通信】您的短信群发功能已开通，请在3个工作日之内至平台进行企业认证！";
		// 拼接参数
		NameValuePair[] data = {
				new NameValuePair("appId", "2RYN7CQHL1M*****"),
				new NameValuePair("appKey", "WVNA4A0*****"),
				new NameValuePair("phone", phone),
				// 发送时间，时间请务必大于实际提交时间的30分钟， 立即发送则不填，
				// new NameValuePair("sendTime", "2018-08-21 14:00:00") ,
				new NameValuePair("content", content)};
		method.setRequestBody(data);
		try {
			client.executeMethod(method);
			String result = method.getResponseBodyAsString();
			// 返回结果
			System.out.println(result);
			JSONObject jsonObject = JSONObject.parseObject(result);
			// 返回1则发送成功(逻辑操作请根据接口文档返回参数自行判断)
			if (jsonObject.get("returnStatus").equals("1")) {
				System.out.println("成功！");
			} else {
				System.out.println("失败！");
			}
			// 释放连接
			method.setRequestHeader("Connection", "close");
			method.releaseConnection();
		} catch (HttpException e) {
			e.printStackTrace();
		} catch (IOException e) {
			e.printStackTrace();
		}
	}
}

2.对接彩信发送接口

OkHttpClient client = new OkHttpClient().newBuilder()
  .followRedirects(false)
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://vip.veesing.com/smsApi/group/getBalance?appId=2RYN7CQHL1M*****&appKey=WVNA4A0*****")
  .method("POST", body)
  .build();
Response response = client.newCall(request).execute();

3.对接彩信回执推送接口

4.测试发送

如果一切顺利，恭喜你，可以部署到线上，开启彩信群发之旅了。

彩信群发API集成中的常见问题与解决方案

发送失败

原因很多，除了接口问题外，还和用户的号码状态，彩信内容性质，彩信通道质量相关，具体可联系彩信平台客服或技术支持

回执延迟

彩信回执在72小时内陆续返回，并非即时推送

如有疑问，可参考详细彩信群发接口文档