Quick Start

Step 01

가입 인증 완료와 동시에 ToBeText API를 사용하실수 있도록 CID 및 TOKEN을 발급 됩니다.

CID 및 TOKEN

은 ToBeText API를 이용하기 위한 필수 인증 열쇠와 같습니다.
CID 와 Token 을 가지고 있으면  SMS를 전송하거나 Voice SMS 와 같은 ToBeText에서 제공하는 모든 기능을 이용 하실수 있습니다.

해당 CID 및 TOKEN은 어딘가에 드러나거나 유출되지 않도록 주의 해야 합니다.

Step 02

ToBeText API를 이용하여 SMS를 요청 합니다.

‘홍길동’ 씨는 당신의 사이트에 가입하기 위해 본인 인증 SMS 받기를 요청합니다.

POST

http://api-dev.tbnws.com/sms/

‘홍길동’ 씨는 아래와 같이 요청을 합니다.

java
import java.io.BufferedReader;
import java.io.DataOutputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import javax.net.ssl.HttpsURLConnection;

public class sendSMS {

	public static void main(String[] args) throws Exception {
		sendSMS SMS = new sendSMS();
		SMS.sendExample();
	}

	private void sendExample() throws Exception {
		String USER_AGENT = "Mozilla/5.0";
		String url = "http://api-dev.tbnws.com/sms/";
		URL obj = new URL(url);
		HttpURLConnection httpcon = (HttpURLConnection) obj.openConnection();
		// HttpsURLConnection httpcon = (HttpsURLConnection) obj.openConnection(); // SSL connection
		httpcon.setRequestMethod("POST");
		httpcon.setRequestProperty("User-Agent", USER_AGENT);
		httpcon.setRequestProperty("Accept-Language", "en-US,en;q=0.5");
		StringBuffer urlParameters = new StringBuffer();

		urlParameters.append("Ckey= 메시지 ID");
		urlParameters.append("&RecvNum= 수신전화번호 입력");
		urlParameters.append("&SendNum= 발신전화번호 입력");
		urlParameters.append("&Body= 메시지 본문 입력");
		urlParameters.append("&Cid= ToBeText 에서 발급받은 고객님의 CID 입력");
		urlParameters.append("&token= ToBeText 에서 발급받은 고객님의 token 입력");
		urlParameters.append("&callback= 상태 값 Callback URL");

		System.out.println("\n\nrequest to URL : " + url);
		System.out.println("\n\nparameters : " + urlParameters);

		// Send post request
		httpcon.setDoOutput(true);
		DataOutputStream ostream = new DataOutputStream(httpcon.getOutputStream());
		ostream.writeBytes(urlParameters.toString());
		ostream.flush();
		ostream.close();

		int responseCode = httpcon.getResponseCode();

		System.out.println("\n\nResponse Code : " + responseCode);

		BufferedReader in = new BufferedReader(new InputStreamReader(httpcon.getInputStream()));
		String inputLine;
		StringBuffer response = new StringBuffer();

		while ((inputLine = in.readLine()) != null) {
			response.append(inputLine);
		}
		in.close();

		System.out.println(response.toString());
	}
}
cURL
curl -X POST http://api-dev.tbnws.com/sms
-d 'Ckey = 메시지 ID'
-d 'RecvNum = 수신전화번호 입력'
-d 'SendNum = 발신전화번호 입력'
-d 'Body = 메시지 본문 입력'
-d 'Cid = TOBE TEXT에서 발급받은 고객님의 CID 입력'
-d 'token = TOBE TEXT에서 발급받은 고객님의 token 입력'
-d 'Appid = Appid'
-d 'ACode = ACode'
-d 'callback = 상태 값 Callback URL'
php
<?php
	$url = 'http://api-dev.tbnws.com/sms'; 

	$post_data["Ckey"] = "메시지 ID";
	$post_data["RecvNum"] = "수신 전화번호";
	$post_data["SendNum"] = "발신 전화번호";
	$post_data["Body"] = "메시지내용";
	$post_data["Cid"] = "고객님의 CID 입력 ";
	$post_data["token"] = "고객님의 TOKEN 입력";
	$post_data["Appid"] = "Appid";
	$post_data["callback"] = "상태 값 Callback URL";

	$curlsession = curl_init ();
	curl_setopt ($curlsession, CURLOPT_URL, $url);
	curl_setopt ($curlsession, CURLOPT_POST, 1);
	curl_setopt ($curlsession, CURLOPT_POSTFIELDS, $post_data);
	curl_setopt ($curlsession, CURLOPT_RETURNTRANSFER, 1);
	$res = curl_exec ($curlsession);

	var_dump($res); //결과값 출력
	curl_close($curlsession);
?>

위 예제에서 알 수 있듯이 ‘Outbound SMS’ 발송을 위해서는 6가지의 필수값과 1가지의 Callback URL을 담아 ToBeText 에 요청을 하여야 합니다.

1. Ckey (고객의 메시지 ID) : 추후 결과 값 전송시 해당 메시지의 식별 값을 전달 위해 필요. (필수)
2. RecvNum (수신전화번호) : SMS 를 받을 고객의 전화번호. (필수)
3. SendNum (발신전화번호) : SMS 를 발신 번호 / 해외의 경우 지정된 번호로 자동 변경 됨. (필수)
4. Body (메시지 내용) : 메시지 내용. 160byte 이내 (영문 160자, 다국어 포함시 80자). (필수)
5. Cid (고객사 고유 번호) : ToBeText 가입 시 제공하는 CID 값. (필수)
6. token (고객사 인증 토큰) : ToBeText 가입 시 제공하는 TOKEN 값. (필수)
7. callback (전송결과 Call Back URL) : SMS 발송 전송결과을 받을 URL. (선택)

앞서 말씀 드렸듯 CID 및 TOKEN 은 절대 유출되어선 안됩니다. 발송요청 내용이 웹페이지에 그대로 드러나지 않게 다시 한번 주의 해주세요!

요청하신 발송코드 생성이 무사히 완료되면, ToBeText 는 아래와 같이 응답합니다.

<ToBeTextResult>
<Status>SUCCESS</Status>
<MsgId>41aa33709703dea382c10a057823ffdc</MsgId>
<SendNum>821012341234</SendNum>
<RecvNum>821012341234</RecvNum>
<ErrorCode>200</ErrorCode>
<ErrorMsg>Msg sent successfully</ErrorMsg>
</ToBeTextResult>

ErrorCode ‘200’은 ‘성공’을 나타냅니다.
MsgId 는 발송한 문자 메시지의 고유 값 입니다.

위와 같이 ToBeText API 를 이용 시 쉽고 간편하게 문자메시지를 전송이 가능합니다.

Contact Us

We're not around right now. But you can send us an email and we'll get back to you, asap.