Hướng dẫn sử dụng FIBO SMS API - Fibo | Simple - Effective

**FiboSMS** · 08-10-2009, 10:36 AM

1. Giới thiệu
Hệ thống nhắn tin SMS chuyên biệt được cung cấp bởi các công ty phần mềm kết hợp với ISP Internet và ISP Viễn thông, cho phép doanh nghiệp có thể tiếp cận với khách hàng bằng SMS - thí dụ: Mua bán, tra cứu giá cả, tìm đường...v.v... Khi doanh nghiệp có ý định cải tiến phương thức tiếp cận người dùng thì tin nhắn là một trong các giải pháp cần được nghĩ đến đầu tiên. Thí dụ, doanh nghiệp muốn người dùng của mình có thể đấu giá sản phẩm trên website nhiều hơn,hay thông báo ăn trưa ở bất kỳ đâu...

Hệ thống SMS của Fibo có nhiều ưu điểm vượt trội hơn so với các hệ thống hiện tại, với một lớp ảo ( virtual ) kết nối, các lời gọi hàm SMS sẽ dễ dàng thực thi và có cấu trúc đơn giản khi sử dụng.

Sự khác biệt của Fibo với các hệ thống SMS khác :

Độ tương tác với người dùng cao
Giao diện thân thiện, dễ sử dụng
Tính năng đơn giản, hiệu quả
Tính độc lập : Fibo kết hợp được với nhiều đầu số khác nhau và hệ thống SMS Gateway được xây dựng trên nền tảng “Ảo hóa kết nối”.

SMS Gatewaylà cổng kết nối tới các nhà khai thác mạng di động, cho phép các đối tác tổ chức những chương trình sử dụng tin nhắn SMS, làm phương tiện tương tác với khách hàng của mình.
Phổ biến là triển khai các dịch vụ như :

Nhắc nhở, duy trì mối quan hệ khách hàng
Thông tin cập nhật đến khách hàng
Khuyến mãi,chào hàng
Thi/nhắn tin để thắng
Tổ chức cuộc thi, trò chơi trên SMS
Tổ chức, quản lý các sự kiện
Bình chọn qua SMS
Thông tin liên lạc nội bộ qua SMS
Tương tác với màn hình lớn
Đặt mua hàng đặc biệt, số lượng hạn chế
Thông tin báo cáo

SMS Hosting ( thông qua SMS API ) là cơ chế nền SMS, cho phép các nhà phát triển dịch vụ toàn quyền tích hợp hệ thống SMS vào bất kỳ ứng dụng nào. Fibo SMS Hosting chính là cơ hội cho các lập trình viên, những nhà phát triển ứng dụng, có thể nhanh chóng đưa SMS vào cuộc sống.

SMS API là giao thức kết nối để sử dụng các dịch vụ SMS thông qua API ( Application Programming Interface : giao diện lập trình ứng dụng ), nằm trên nền Fibo SMS Hosting, các kết nối từ SMS API sẽ giao tiếp với nền tảng SMS Hosting để triển khai các ứng dụng SMS. Lập trình viên có thể tích hợp SMS vào bất kỳ chương trình nào để gởi/nhận SMS

Lập trình viên có thể kết nối bằng tất cả các ngôn ngữ lập trình thông dụng: ASP, PHP, dotNet, thậm chí có thể kết nối thông qua HTML

Cơ chế hoạt động hoạt động :

Chạy đa nền : Unix, Windows, Mac
Kết nối thông qua Web Services : POST/GET, SOAP
Hỗ trợ gởi tin nhắn SMS thông qua giao thức SMTP, SMPP ( tích hợp vào các ứng dụng chuẩn theo giao thức này )

2. Các hàm API

2.1 About
2.2 CheckClient
2.3 GetClientBalance
2.4 GetClientCommingSMSNotDividePage
2.5 GetClientSMSListOfPage
2.6 SendBulkSMS
2.7 SendSMS
2.8 SendSMSToListMobilePhone
2.9 SendSMSEMail
2.10 SendMaskedSMS
2.11 GetSMSSentList
2.12 GetTotalPageOfClientSMS
2.13 GetCommingSMSList
2.14 GetSMSStatus
2.15 GetClientSenderNameList
2.16 GetListSMSHostingWithBalance

**FiboSMS** · 08-10-2009, 10:41 AM

2.1. About
Trả về chuỗi www.fibovietnam.com, khách hàng có thể dung hàm này để kiểm tra xem có kết nối được với Webservice không
Gọi hàm:
http://center.fibosms.com/Service.asmx/About
Kết quả trả về :

Code:

<string>www.Fibovietnam.com</string>

2.2. CheckClient
Kiểm tra account của khách hàng.
Gọi hàm:
http://center.fibosms.com/Service.asmx/CheckClient?clientNo=string&clientPass=string
Tham số:

clientNo
clientPass

Kết quả trả về :
Username/pass đúng, trả về tên của client:

Code:

<string>
<SMS>
<Code>0</Code>
<Message>Nguyen Van A</Message><
Time></Time>
</SMS>
</string>

Username/pass không đúng:

Code:

<string>
<SMS>
<Code>100</Code>
<Message>Please check your account!</Message>    
<Time></Time>
</SMS>
</string>

2.3. GetClientBalance
Trả về số lượng SMS được gởi trong tài khoản khách hàng.
Gọi hàm:
http://center.fibosms.com/Service.asmx/GetClientBalance?clientNo=string&clientPass=string &serviceType=string
Tham số:

clientNo
clientPass
serviceType

Kết quả trả về:

Code:

<string>529</string>

Số >0 số lượng sms được gởi
Số =0 không thể gởi sms
Số <0 serviceType sai

Username/pass không đúng:

Code:

<string>
<SMS>    
<Code>100</Code>   
<Message>Please check your account!</Message>   
<Time></Time>
</SMS>
</string>

**FiboSMS** · 08-10-2009, 10:46 AM

2.4. GetClientCommingSMSNotDividePage

Hàm cho phép lấy danh sách SMS về.
Gọi hàm:
http://center.fibosms.com/Service.asmx/GetClientCommingSMSNotDividePage?clientNo=string&c lientPass=string&fromDate=string&toDate=string&sms Status=string&serviceTypeID=string&key=string
Tham số:

clientNo
clientPass
fromDate
toDate
smsStatus
serviceTypeID
key

Trong đó:

fromDate(MM-DD-YYYY) : những tin nhắn từ ngày này trở đi sẽ được gửi trả về
toDate(MM-DD-YYYY): những tin nhắn từ ngày này trở lại sẽ được gửi trả về
smsStatus : trạng thái của những tin nhắn mà bạn muốn nhận về
serviceTypeID : Mã dịch vụ
key: những tin nhắn có nội dung trùng với tham số key sẽ được trả về, có thể là số điện thoại hoặc nội dung tin nhắn. Nếu không có thì để trống

Chú ý:
SMSStatus có ý nghĩa sau:

Pending = 0,
Sending = 1,
SentSuccess = 2,
SentFailed = 3,
Deleted = 4,
ToNumberNotCorrect = 5,
CanNotSend = 6,
OutOfDate = 7,
SendMTFailed = 8,
Other = 9,
SpamSMS = 10,
RestoreToAccountClient = 11

Kết quả trả về:

Có danh sách SMS:

Code:

<string>
<DocumentElement>
  <SMSLIST>
    <ClientCommingSMSID>263011</ClientCommingSMSID>
    <PhoneNumber>84913122005</PhoneNumber>
    <message>FIBO DEMODGN 50</message>
    <SentDate>22/04/2009(16:37:00)</SentDate>
  <createddate>2009-04-22T16:37:00+07:00</createddate>
    <ServiceTypeID>229</ServiceTypeID>
    <serviceTypename>8022(FIBO)</serviceTypename>
  </SMSLIST>
</DocumentElement>
</string>

Không có SMS nào thỏa điều kiện:

Code:

<string>
<SMS>    
<Code>301</Code> 
<Message>No SMS!</Message>    
<Time></Time>
</SMS>
</string>

Username/pass không đúng:

Code:

<string>
<SMS>    
<Code>100</Code>   
<Message>Please check your account!</Message>   
<Time></Time>
</SMS>
</string>

**FiboSMS** · 08-10-2009, 10:48 AM

2.5. GetClientSMSListOfPage

Hàm này trả về danh sách sms của một trang.
Gọi hàm:
http://center.fibosms.com/Service.asmx/GetClientSMSListOfPage?clientNo=string&clientPass= string&pageNO=string&fromDate=string&toDate=string &smsStatus=string&serviceTypeID=string&key=stri ng

Tham số:

clientNo
clientPass
pageNO
key

Trong đó:

Key : là điều kiện lọc, dùng điều kiện lọc này để lấy ra danh sách SMS theo một tiêu trí nào đó. Ví dụ lấy SMS gởi tới số SPhone thì key=”0905”. Nếu muốn lấy toàn bộ danh sách thì key=””
PageNO: số trang muốn lấy.

Kết quả trả về:
Chú ý:

SMSStatus có ý nghĩa sau:
Pending = 0,
Sending = 1,
SentSuccess = 2,
SentFailed = 3,
Deleted = 4,
ToNumberNotCorrect = 5,
CanNotSend = 6,
OutOfDate = 7,
SendMTFailed = 8,
Other = 9,
SpamSMS = 10,
RestoreToAccountClient = 11

Kết quả:

Code:

<string>
<DocumentElement>
  <SMSLIST>
<SMSID>492</SMSID>
<SMSGUID />
<PhoneNumber>0909626922</PhoneNumber>
<Message>Message 42</Message>
<CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate>
<SentDate>2008-05-16T09:32:00+07:00</SentDate>
<SMSStatus>2</SMSStatus>
  </SMSLIST>
  <SMSLIST>
<SMSID>493</SMSID>
<SMSGUID />
<PhoneNumber>0909128628</PhoneNumber>
<Message>Message 43</Message>
<CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate>
<SentDate>2008-05-16T09:32:00+07:00</SentDate>
<SMSStatus>2</SMSStatus>
  </SMSLIST>
…
…

</DocumentElement>
</string>

**FiboSMS** · 08-10-2009, 10:54 AM

2.6. SendBulkSMS

Hàm cho phép gởi n tin SMS. Số n này tùy thuộc vào số lượng SMS còn lại trong tài khoản khách hàng.
Gọi hàm:
http://center.fibosms.com/Service.asmx/SendBulkSMS?clientNo=string&clientPass=string&smsL ist=string&serviceType=string

Tham số:

clientNo
clientPass
smsList
serviceType

Trong đó:

smsList có cấu trúc như sau:

Code:

<DocumentElement>
<SMSLIST> 
<PhoneNumber>0937100759</PhoneNumber>
<Message>Message 1</Message>
               </SMSLIST>
<SMSLIST>
<PhoneNumber>0937100759</PhoneNumber> 
<Message>Message 2</Message>
               </SMSLIST>
</DocumentElement>

Kết quả trả về:
Thành công :

Code:

<string>
<SMS>    
<Code>200</Code>   
 <Message>Sending...</Message>   
 <Time></Time>
</SMS>
</string>

Sai username/password:

Code:

<string>
<SMS> 
<Code>100</Code>
<Message>Please check your account!</Message>   
<Time></Time>
</SMS>
</string>

Tài khoản đã hết hạn:

Code:

<string>
<SMS>   
<Code>102</Code>    
<Message>Your balance is zero!</Message>
<Time></Time>
</SMS>
</string>

Số tin nhắn nhiều hơn số lượng cho phép của tài khoản:

Code:

<string>
<SMS>   
<Code>104</Code>    
<Message> The number of SMS is greater than SMS balance! </Message>
<Time></Time>
</SMS>
</string>

Sai ServiceID:

Code:

<string>
<SMS>   
 <Code>103</Code>   
 <Message> Service type is wrong! </Message>
<Time></Time>
</SMS>
</string>

Ví dụ :
http://center.fibosms.com/Service.asmx/SendBulkSMS?clientNo=CL1218&clientPass=123456&serviceType=1&smslist=<DocumentElement><SMSLIST><PhoneNumber>0909128628</PhoneNumber><Message>Message1</Message></SMSLIST><SMSLIST><PhoneNumber>0909128628</PhoneNumber><Message>Message 2</Message></SMSLIST></DocumentElement>

**FiboSMS** · 08-10-2009, 10:58 AM

2.7. SendSMS

Hàm gởi một tin nhắn tới một số điện thoại.
Gọi hàm:
http://center.fibosms.com/Service.asmx/SendSMS?clientNo=string&clientPass=string&phoneNum ber=string&smsMessage=string&smsGUID=string&servic eType=string
Tham số:

clientNo
clientPass
phoneNumber
smsMessage
smsGUID : ID của tin nhắn
serviceType

Kết quả trả về:
Thành công :

Code:

<string>
<SMS>    
<Code>200</Code>   
 <Message>Sending...</Message>   
 <Time></Time>
</SMS>
</string>

Sai username/password:

Code:

<string>
<SMS> 
<Code>100</Code>
<Message>Please check your account!</Message>    
<Time></Time>
</SMS>
</string>

Tài khoản đã hết hạn:

Code:

<string>
<SMS>   
<Code>102</Code>    
<Message>Your balance is zero!</Message>
<Time></Time>
</SMS>
</string>

Sai số điện thoại:

Code:

<string>
<SMS>   
<Code>101</Code>    
<Message>Please check your Phone number!</Message>    
<Time></Time>
</SMS>
</string>

Sai ServiceID:

Code:

<string>
<SMS>   
               <Code>103</Code>   
               <Message> Service type is wrong! </Message>
<Time></Time>
</SMS>
</string>

**FiboSMS** · 08-10-2009, 11:00 AM

2.8. SendSMSToListMobilePhone

Hàm này dùng để gửi một nội dung tin nhắn tới n số điện thoại.

Gọi Hàm:
http://center.fibosms.com/Service.asmx/SendSMSToListMobilePhone?clientNo=string&clientPas s=string&senderName=string&smsContent=string&listP honeNumber=string&serviceType=string
Tham số:

clientNo
clientPass
senderName: nếu có đăng ký dịch vụ sendername của Fibo thì truyền vào đây, không thì truyền vào là n/a
smsContent: nội dung của tin nhắn
listPhoneNumber: danh sách số điện thoại
serviceType

Cấu trúc của một listPhoneNumber:

Code:

<Document>
<ListMobilePhone>
<PhoneNumber>0903636635</PhoneNumber>
<SMSGUID>acce8d19-2106-46f9-a2d1-8b7991f30232</SMSGUID>
</ListMobilePhone>
<ListMobilePhone>
<PhoneNumber>8122</PhoneNumber>
<SMSGUID>62c55648-29fb-4765-9ec4-a591f0a2b29f</SMSGUID>
</ListMobilePhone>
</Document>

Trong đó

PhoneNumber:Số điện thoại
SMSGUID: ID của tin nhắn

Kết quả trả về:
Thành công :

Code:

<string>
<SMS>    
<Code>200</Code>   
<Message>Sending...</Message>   
<Time></Time>
</SMS>
</string>

Nếu có tin nhắn không đưa được vào hệ thống của Fibo:

Code:

<ListWrongPhoneNumber>
<SMSGUID>62c55648-29fb-4765-9ec4-a591f0a2b29f</SMSGUID>
<SMSGUID>62c55648-29fb-4765-9ec4-a591f0a2b29f</SMSGUID>
…
</ListWrongPhoneNumber>

Sai username/password:

Code:

<string>
<SMS> 
<Code>100</Code>
<Message>Please check your account!</Message>    
<Time></Time>
</SMS>
</string>

Tài khoản đã hết hạn:

Code:

<string>
<SMS>
<Code>102</Code>    
<Message>Your balance is zero!</Message>
<Time></Time>
</SMS>
</string>

Nếu có tin nhắn không được đưa vào trong hệ thống:

Code:

<string>
<ListWrongPhoneNumber>
<SMSGUID>SMS ID</SMSGUID>
<SMSGUID> SMS ID</SMSGUID>
<ListWrongPhoneNumber>
</string>

Sai ServiceID:

Code:

<string>
<SMS>   
<Code>103</Code>   
<Message> Service type is wrong! </Message>
<Time></Time>
</SMS>
</string>

Số lượng tin nhắn cần gửi nhiều hơn số lượng tin nhắn còn lại trong tài khoản:

Code:

<string>
<SMS>   
<Code>104</Code>   
<Message> The number of SMS is greater than SMS balance!</Message>
<Time></Time>
</SMS>
</string>

**FiboSMS** · 08-10-2009, 11:02 AM

2.9. SendSMSEMail

Dùng để test trong lúc lập trình, khách hàng có thể dùng hàm này để kiểm tra quá trinh họat động của hệ thống khi tích hợp dịch vụ SMS. Hàm này chỉ nhận nội dung SMS và lưu vào trong hệ thống, nó giúp tiết kiệm chi phí trong lúc test chương trình. Để sử dụng chức năng này, yêu cầu người dùng đăng ký trước với Fibo. Các kết quả trả về tương tự như hàm SendSMS
Gọi hàm:
http://center.fibosms.com/Service.asmx/SendSMS?clientNo=string&clientPass=string&phoneNum ber=string&smsMessage=string&smsGUID=string&servic eType=3

Tham số:

clientNo
clientPass
smsList
serviceType=3.

2.10. SendMaskedSMS
Hàm gởi một tin nhắn tới một số điện thoại, dùng cho dịch vụ sender name và dịch vụ gửi tin nhắn thường
Gọi hàm:
http://center.fibosms.com/service.asmx/SendMaskedSMS?clientNo=string&clientPass=string&se nderName=&phoneNumber=string&smsMessage=string&sms GUID=string&serviceType=string

Tham số:

clientNo
clientPass
senderName
phoneNumber
smsMessage
smsGUID
serviceType

Trong đó:

senderName: nếu có đăng ký dịch vụ sendername của Fibo thì truyền vào đây, không thì để trống
phoneNumber: có cấu trúc như số điện thoại hay dùng
smsMessage: nội dung của tin nhắn
smsGUID: ID của tin nhắn, ID này là từ hệ thống của khách hàng cung cấp, để sau này lấy trạng thái của tin nhắn thông qua ID này.

Kết quả trả về:
Thành công :

Code:

<string>
<SMS>    
<Code>200</Code>   
 <Message>Sending...</Message>   
 <Time></Time>
</SMS>
</string>

Sai username/password:

Code:

<string>
<SMS> 
<Code>100</Code>
<Message>Please check your account!</Message>    
<Time></Time>
</SMS>
</string>

Tài khoản đã hết hạn:

Code:

<string>
<SMS>   
<Code>102</Code>    
<Message>Your balance is zero!</Message>
<Time></Time>
</SMS>
</string>

Sai số điện thoại:

Code:

<string>
<SMS>   
<Code>101</Code>    
<Message>Please check your Phone number!</Message>    
<Time></Time>
</SMS>
</string>

Sai ServiceID:

Code:

<string>
<SMS>   
<Code>103</Code>   
<Message> Service type is wrong! </Message>
<Time></Time>
</SMS>
</string>

**FiboSMS** · 08-10-2009, 11:05 AM

2.11. GetSMSSentList

Hàm lấy danh sách các tin nhắn đã gởi trong quá khứ. Tham số là số gs phút. Số gs được đặt tùy vào gói dịch vụ, tức là tối đa ứng dụng của khách hàng có thể xem được danh sach các tin sms đã gởi trong quá khứ cách thời điểm hiện tại gs phút. Nếu khách hàng muốn xem lại các tin nhắn đã gởi trong quá khứ trước gs phút, khách hàng phải đăng nhập hệ thống SMS Hosting để xem danh sách SMS đã gởi, trong danh sách này khách hàng có thể in báo cáo , export dữ liệu ra dạng XML hay SQL.
Gọi hàm:
http://center.fibosms.com/Service.asmx/GetSMSSentList?clientNo=string&clientPass=string&m inutes=string

Tham số:

clientNo
clientPass
minutes (gs)

Kết quả trả về:
Chú ý:

SMSStatus có ý nghĩa sau:
Pending = 0,
Sending = 1,
SentSuccess = 2,
SentFailed = 3,
Deleted = 4,
ToNumberNotCorrect = 5,
CanNotSend = 6,
OutOfDate = 7,
SendMTFailed = 8,
Other = 9,
SpamSMS = 10,
RestoreToAccountClient = 11

Kết quả có SMS:

Code:

<string>
<DocumentElement>
  <SMSLIST>
    <SMSID>492</SMSID>
    <SMSGUID />
    <PhoneNumber>0909626922</PhoneNumber>
    <Message>Message 42</Message>
    <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate>
    <SentDate>2008-05-16T09:32:00+07:00</SentDate>
    <SMSStatus>2</SMSStatus>
  </SMSLIST>
  <SMSLIST>
    <SMSID>493</SMSID>
    <SMSGUID />
    <PhoneNumber>0909128628</PhoneNumber>
    <Message>Message 43</Message>
    <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate>
    <SentDate>2008-05-16T09:32:00+07:00</SentDate>
    <SMSStatus>2</SMSStatus>
  </SMSLIST>
…
…

</DocumentElement>
</string>

Không có SMS:

Code:

<string><DocumentElement /></string>

**FiboSMS** · 08-10-2009, 11:09 AM

2.11. GetSMSSentList

Hàm lấy danh sách các tin nhắn đã gởi trong quá khứ. Tham số là số gs phút. Số gs được đặt tùy vào gói dịch vụ, tức là tối đa ứng dụng của khách hàng có thể xem được danh sach các tin sms đã gởi trong quá khứ cách thời điểm hiện tại gs phút. Nếu khách hàng muốn xem lại các tin nhắn đã gởi trong quá khứ trước gs phút, khách hàng phải đăng nhập hệ thống SMS Hosting để xem danh sách SMS đã gởi, trong danh sách này khách hàng có thể in báo cáo , export dữ liệu ra dạng XML hay SQL.
Gọi hàm:
http://center.fibosms.com/Service.asmx/GetSMSSentList?clientNo=string&clientPass=string&m inutes=string

Tham số:

clientNo
clientPass
minutes (gs)

Kết quả trả về:
Chú ý:

SMSStatus có ý nghĩa sau:
Pending = 0,
Sending = 1,
SentSuccess = 2,
SentFailed = 3,
Deleted = 4,
ToNumberNotCorrect = 5,
CanNotSend = 6,
OutOfDate = 7,
SendMTFailed = 8,
Other = 9,
SpamSMS = 10,
RestoreToAccountClient = 11

Kết quả có SMS:

Code:

<string>
<DocumentElement>
  <SMSLIST>
    <SMSID>492</SMSID>
    <SMSGUID />
    <PhoneNumber>0909626922</PhoneNumber>
    <Message>Message 42</Message>
    <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate>
    <SentDate>2008-05-16T09:32:00+07:00</SentDate>
    <SMSStatus>2</SMSStatus>
  </SMSLIST>
  <SMSLIST>
    <SMSID>493</SMSID>
    <SMSGUID />
    <PhoneNumber>0909128628</PhoneNumber>
    <Message>Message 43</Message>
    <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate>
    <SentDate>2008-05-16T09:32:00+07:00</SentDate>
    <SMSStatus>2</SMSStatus>
  </SMSLIST>
…
…

</DocumentElement>
</string>

Không có SMS:

Code:

<string><DocumentElement /></string>

08-10-2009, 10:36 AM	#1
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	Hướng dẫn sử dụng FIBO SMS API 1. Giới thiệu Hệ thống nhắn tin SMS chuyên biệt được cung cấp bởi các công ty phần mềm kết hợp với ISP Internet và ISP Viễn thông, cho phép doanh nghiệp có thể tiếp cận với khách hàng bằng SMS - thí dụ: Mua bán, tra cứu giá cả, tìm đường...v.v... Khi doanh nghiệp có ý định cải tiến phương thức tiếp cận người dùng thì tin nhắn là một trong các giải pháp cần được nghĩ đến đầu tiên. Thí dụ, doanh nghiệp muốn người dùng của mình có thể đấu giá sản phẩm trên website nhiều hơn,hay thông báo ăn trưa ở bất kỳ đâu... Hệ thống SMS của Fibo có nhiều ưu điểm vượt trội hơn so với các hệ thống hiện tại, với một lớp ảo ( virtual ) kết nối, các lời gọi hàm SMS sẽ dễ dàng thực thi và có cấu trúc đơn giản khi sử dụng. Sự khác biệt của Fibo với các hệ thống SMS khác : Độ tương tác với người dùng cao Giao diện thân thiện, dễ sử dụng Tính năng đơn giản, hiệu quả Tính độc lập : Fibo kết hợp được với nhiều đầu số khác nhau và hệ thống SMS Gateway được xây dựng trên nền tảng “Ảo hóa kết nối”. SMS Gatewaylà cổng kết nối tới các nhà khai thác mạng di động, cho phép các đối tác tổ chức những chương trình sử dụng tin nhắn SMS, làm phương tiện tương tác với khách hàng của mình. Phổ biến là triển khai các dịch vụ như : Nhắc nhở, duy trì mối quan hệ khách hàng Thông tin cập nhật đến khách hàng Khuyến mãi,chào hàng Thi/nhắn tin để thắng Tổ chức cuộc thi, trò chơi trên SMS Tổ chức, quản lý các sự kiện Bình chọn qua SMS Thông tin liên lạc nội bộ qua SMS Tương tác với màn hình lớn Đặt mua hàng đặc biệt, số lượng hạn chế Thông tin báo cáo SMS Hosting ( thông qua SMS API ) là cơ chế nền SMS, cho phép các nhà phát triển dịch vụ toàn quyền tích hợp hệ thống SMS vào bất kỳ ứng dụng nào. Fibo SMS Hosting chính là cơ hội cho các lập trình viên, những nhà phát triển ứng dụng, có thể nhanh chóng đưa SMS vào cuộc sống. SMS API là giao thức kết nối để sử dụng các dịch vụ SMS thông qua API ( Application Programming Interface : giao diện lập trình ứng dụng ), nằm trên nền Fibo SMS Hosting, các kết nối từ SMS API sẽ giao tiếp với nền tảng SMS Hosting để triển khai các ứng dụng SMS. Lập trình viên có thể tích hợp SMS vào bất kỳ chương trình nào để gởi/nhận SMS Lập trình viên có thể kết nối bằng tất cả các ngôn ngữ lập trình thông dụng: ASP, PHP, dotNet, thậm chí có thể kết nối thông qua HTML Cơ chế hoạt động hoạt động : Chạy đa nền : Unix, Windows, Mac Kết nối thông qua Web Services : POST/GET, SOAP Hỗ trợ gởi tin nhắn SMS thông qua giao thức SMTP, SMPP ( tích hợp vào các ứng dụng chuẩn theo giao thức này ) 2. Các hàm API 2.1 About 2.2 CheckClient 2.3 GetClientBalance 2.4 GetClientCommingSMSNotDividePage 2.5 GetClientSMSListOfPage 2.6 SendBulkSMS 2.7 SendSMS 2.8 SendSMSToListMobilePhone 2.9 SendSMSEMail 2.10 SendMaskedSMS 2.11 GetSMSSentList 2.12 GetTotalPageOfClientSMS 2.13 GetCommingSMSList 2.14 GetSMSStatus 2.15 GetClientSenderNameList 2.16 GetListSMSHostingWithBalance __________________ FiboSMS Team Simple - Effective

08-10-2009, 10:41 AM	#2
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	2.1. About Trả về chuỗi www.fibovietnam.com, khách hàng có thể dung hàm này để kiểm tra xem có kết nối được với Webservice không Gọi hàm: http://center.fibosms.com/Service.asmx/About Kết quả trả về : Code: <string>www.Fibovietnam.com</string> 2.2. CheckClient Kiểm tra account của khách hàng. Gọi hàm: http://center.fibosms.com/Service.asmx/CheckClient?clientNo=string&clientPass=string Tham số: clientNo clientPass Kết quả trả về : Username/pass đúng, trả về tên của client: Code: <string> <SMS> <Code>0</Code> <Message>Nguyen Van A</Message>< Time></Time> </SMS> </string> Username/pass không đúng: Code: <string> <SMS> <Code>100</Code> <Message>Please check your account!</Message> <Time></Time> </SMS> </string> 2.3. GetClientBalance Trả về số lượng SMS được gởi trong tài khoản khách hàng. Gọi hàm: http://center.fibosms.com/Service.asmx/GetClientBalance?clientNo=string&clientPass=string &serviceType=string Tham số: clientNo clientPass serviceType Kết quả trả về: Code: <string>529</string> Số >0 số lượng sms được gởi Số =0 không thể gởi sms Số <0 serviceType sai Username/pass không đúng: Code: <string> <SMS> <Code>100</Code> <Message>Please check your account!</Message> <Time></Time> </SMS> </string> __________________ FiboSMS Team Simple - Effective

08-10-2009, 10:46 AM	#3
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	2.4. GetClientCommingSMSNotDividePage Hàm cho phép lấy danh sách SMS về. Gọi hàm: http://center.fibosms.com/Service.asmx/GetClientCommingSMSNotDividePage?clientNo=string&c lientPass=string&fromDate=string&toDate=string&sms Status=string&serviceTypeID=string&key=string Tham số: clientNo clientPass fromDate toDate smsStatus serviceTypeID key Trong đó: fromDate(MM-DD-YYYY) : những tin nhắn từ ngày này trở đi sẽ được gửi trả về toDate(MM-DD-YYYY): những tin nhắn từ ngày này trở lại sẽ được gửi trả về smsStatus : trạng thái của những tin nhắn mà bạn muốn nhận về serviceTypeID : Mã dịch vụ key: những tin nhắn có nội dung trùng với tham số key sẽ được trả về, có thể là số điện thoại hoặc nội dung tin nhắn. Nếu không có thì để trống Chú ý: SMSStatus có ý nghĩa sau: Pending = 0, Sending = 1, SentSuccess = 2, SentFailed = 3, Deleted = 4, ToNumberNotCorrect = 5, CanNotSend = 6, OutOfDate = 7, SendMTFailed = 8, Other = 9, SpamSMS = 10, RestoreToAccountClient = 11 Kết quả trả về: Có danh sách SMS: Code: <string> <DocumentElement> <SMSLIST> <ClientCommingSMSID>263011</ClientCommingSMSID> <PhoneNumber>84913122005</PhoneNumber> <message>FIBO DEMODGN 50</message> <SentDate>22/04/2009(16:37:00)</SentDate> <createddate>2009-04-22T16:37:00+07:00</createddate> <ServiceTypeID>229</ServiceTypeID> <serviceTypename>8022(FIBO)</serviceTypename> </SMSLIST> </DocumentElement> </string> Không có SMS nào thỏa điều kiện: Code: <string> <SMS> <Code>301</Code> <Message>No SMS!</Message> <Time></Time> </SMS> </string> Username/pass không đúng: Code: <string> <SMS> <Code>100</Code> <Message>Please check your account!</Message> <Time></Time> </SMS> </string> __________________ FiboSMS Team Simple - Effective

08-10-2009, 10:48 AM	#4
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	2.5. GetClientSMSListOfPage Hàm này trả về danh sách sms của một trang. Gọi hàm: http://center.fibosms.com/Service.asmx/GetClientSMSListOfPage?clientNo=string&clientPass= string&pageNO=string&fromDate=string&toDate=string &smsStatus=string&serviceTypeID=string&key=stri ng Tham số: clientNo clientPass pageNO key Trong đó: Key : là điều kiện lọc, dùng điều kiện lọc này để lấy ra danh sách SMS theo một tiêu trí nào đó. Ví dụ lấy SMS gởi tới số SPhone thì key=”0905”. Nếu muốn lấy toàn bộ danh sách thì key=”” PageNO: số trang muốn lấy. Kết quả trả về: Chú ý: SMSStatus có ý nghĩa sau: Pending = 0, Sending = 1, SentSuccess = 2, SentFailed = 3, Deleted = 4, ToNumberNotCorrect = 5, CanNotSend = 6, OutOfDate = 7, SendMTFailed = 8, Other = 9, SpamSMS = 10, RestoreToAccountClient = 11 Kết quả: Code: <string> <DocumentElement> <SMSLIST> <SMSID>492</SMSID> <SMSGUID /> <PhoneNumber>0909626922</PhoneNumber> <Message>Message 42</Message> <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate> <SentDate>2008-05-16T09:32:00+07:00</SentDate> <SMSStatus>2</SMSStatus> </SMSLIST> <SMSLIST> <SMSID>493</SMSID> <SMSGUID /> <PhoneNumber>0909128628</PhoneNumber> <Message>Message 43</Message> <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate> <SentDate>2008-05-16T09:32:00+07:00</SentDate> <SMSStatus>2</SMSStatus> </SMSLIST> … … </DocumentElement> </string> __________________ FiboSMS Team Simple - Effective

08-10-2009, 10:54 AM	#5
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	2.6. SendBulkSMS Hàm cho phép gởi n tin SMS. Số n này tùy thuộc vào số lượng SMS còn lại trong tài khoản khách hàng. Gọi hàm: http://center.fibosms.com/Service.asmx/SendBulkSMS?clientNo=string&clientPass=string&smsL ist=string&serviceType=string Tham số: clientNo clientPass smsList serviceType Trong đó: smsList có cấu trúc như sau: Code: <DocumentElement> <SMSLIST> <PhoneNumber>0937100759</PhoneNumber> <Message>Message 1</Message> </SMSLIST> <SMSLIST> <PhoneNumber>0937100759</PhoneNumber> <Message>Message 2</Message> </SMSLIST> </DocumentElement> Kết quả trả về: Thành công : Code: <string> <SMS> <Code>200</Code> <Message>Sending...</Message> <Time></Time> </SMS> </string> Sai username/password: Code: <string> <SMS> <Code>100</Code> <Message>Please check your account!</Message> <Time></Time> </SMS> </string> Tài khoản đã hết hạn: Code: <string> <SMS> <Code>102</Code> <Message>Your balance is zero!</Message> <Time></Time> </SMS> </string> Số tin nhắn nhiều hơn số lượng cho phép của tài khoản: Code: <string> <SMS> <Code>104</Code> <Message> The number of SMS is greater than SMS balance! </Message> <Time></Time> </SMS> </string> Sai ServiceID: Code: <string> <SMS> <Code>103</Code> <Message> Service type is wrong! </Message> <Time></Time> </SMS> </string> Ví dụ : http://center.fibosms.com/Service.asmx/SendBulkSMS?clientNo=CL1218&clientPass=123456&serviceType=1&smslist=<DocumentElement><SMSLIST><PhoneNumber>0909128628</PhoneNumber><Message>Message1</Message></SMSLIST><SMSLIST><PhoneNumber>0909128628</PhoneNumber><Message>Message 2</Message></SMSLIST></DocumentElement> __________________ FiboSMS Team Simple - Effective

08-10-2009, 10:58 AM	#6
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	2.7. SendSMS Hàm gởi một tin nhắn tới một số điện thoại. Gọi hàm: http://center.fibosms.com/Service.asmx/SendSMS?clientNo=string&clientPass=string&phoneNum ber=string&smsMessage=string&smsGUID=string&servic eType=string Tham số: clientNo clientPass phoneNumber smsMessage smsGUID : ID của tin nhắn serviceType Kết quả trả về: Thành công : Code: <string> <SMS> <Code>200</Code> <Message>Sending...</Message> <Time></Time> </SMS> </string> Sai username/password: Code: <string> <SMS> <Code>100</Code> <Message>Please check your account!</Message> <Time></Time> </SMS> </string> Tài khoản đã hết hạn: Code: <string> <SMS> <Code>102</Code> <Message>Your balance is zero!</Message> <Time></Time> </SMS> </string> Sai số điện thoại: Code: <string> <SMS> <Code>101</Code> <Message>Please check your Phone number!</Message> <Time></Time> </SMS> </string> Sai ServiceID: Code: <string> <SMS> <Code>103</Code> <Message> Service type is wrong! </Message> <Time></Time> </SMS> </string> __________________ FiboSMS Team Simple - Effective thay đổi nội dung bởi: tct, 16-03-2010 lúc 06:54 PM

08-10-2009, 11:00 AM	#7
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	2.8. SendSMSToListMobilePhone Hàm này dùng để gửi một nội dung tin nhắn tới n số điện thoại. Gọi Hàm: http://center.fibosms.com/Service.asmx/SendSMSToListMobilePhone?clientNo=string&clientPas s=string&senderName=string&smsContent=string&listP honeNumber=string&serviceType=string Tham số: clientNo clientPass senderName: nếu có đăng ký dịch vụ sendername của Fibo thì truyền vào đây, không thì truyền vào là n/a smsContent: nội dung của tin nhắn listPhoneNumber: danh sách số điện thoại serviceType Cấu trúc của một listPhoneNumber: Code: <Document> <ListMobilePhone> <PhoneNumber>0903636635</PhoneNumber> <SMSGUID>acce8d19-2106-46f9-a2d1-8b7991f30232</SMSGUID> </ListMobilePhone> <ListMobilePhone> <PhoneNumber>8122</PhoneNumber> <SMSGUID>62c55648-29fb-4765-9ec4-a591f0a2b29f</SMSGUID> </ListMobilePhone> </Document> Trong đó PhoneNumber:Số điện thoại SMSGUID: ID của tin nhắn Kết quả trả về: Thành công : Code: <string> <SMS> <Code>200</Code> <Message>Sending...</Message> <Time></Time> </SMS> </string> Nếu có tin nhắn không đưa được vào hệ thống của Fibo: Code: <ListWrongPhoneNumber> <SMSGUID>62c55648-29fb-4765-9ec4-a591f0a2b29f</SMSGUID> <SMSGUID>62c55648-29fb-4765-9ec4-a591f0a2b29f</SMSGUID> … </ListWrongPhoneNumber> Sai username/password: Code: <string> <SMS> <Code>100</Code> <Message>Please check your account!</Message> <Time></Time> </SMS> </string> Tài khoản đã hết hạn: Code: <string> <SMS> <Code>102</Code> <Message>Your balance is zero!</Message> <Time></Time> </SMS> </string> Nếu có tin nhắn không được đưa vào trong hệ thống: Code: <string> <ListWrongPhoneNumber> <SMSGUID>SMS ID</SMSGUID> <SMSGUID> SMS ID</SMSGUID> <ListWrongPhoneNumber> </string> Sai ServiceID: Code: <string> <SMS> <Code>103</Code> <Message> Service type is wrong! </Message> <Time></Time> </SMS> </string> Số lượng tin nhắn cần gửi nhiều hơn số lượng tin nhắn còn lại trong tài khoản: Code: <string> <SMS> <Code>104</Code> <Message> The number of SMS is greater than SMS balance!</Message> <Time></Time> </SMS> </string> __________________ FiboSMS Team Simple - Effective

08-10-2009, 11:02 AM	#8
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	2.9. SendSMSEMail Dùng để test trong lúc lập trình, khách hàng có thể dùng hàm này để kiểm tra quá trinh họat động của hệ thống khi tích hợp dịch vụ SMS. Hàm này chỉ nhận nội dung SMS và lưu vào trong hệ thống, nó giúp tiết kiệm chi phí trong lúc test chương trình. Để sử dụng chức năng này, yêu cầu người dùng đăng ký trước với Fibo. Các kết quả trả về tương tự như hàm SendSMS Gọi hàm: http://center.fibosms.com/Service.asmx/SendSMS?clientNo=string&clientPass=string&phoneNum ber=string&smsMessage=string&smsGUID=string&servic eType=3 Tham số: clientNo clientPass smsList serviceType=3. 2.10. SendMaskedSMS Hàm gởi một tin nhắn tới một số điện thoại, dùng cho dịch vụ sender name và dịch vụ gửi tin nhắn thường Gọi hàm: http://center.fibosms.com/service.asmx/SendMaskedSMS?clientNo=string&clientPass=string&se nderName=&phoneNumber=string&smsMessage=string&sms GUID=string&serviceType=string Tham số: clientNo clientPass senderName phoneNumber smsMessage smsGUID serviceType Trong đó: senderName: nếu có đăng ký dịch vụ sendername của Fibo thì truyền vào đây, không thì để trống phoneNumber: có cấu trúc như số điện thoại hay dùng smsMessage: nội dung của tin nhắn smsGUID: ID của tin nhắn, ID này là từ hệ thống của khách hàng cung cấp, để sau này lấy trạng thái của tin nhắn thông qua ID này. Kết quả trả về: Thành công : Code: <string> <SMS> <Code>200</Code> <Message>Sending...</Message> <Time></Time> </SMS> </string> Sai username/password: Code: <string> <SMS> <Code>100</Code> <Message>Please check your account!</Message> <Time></Time> </SMS> </string> Tài khoản đã hết hạn: Code: <string> <SMS> <Code>102</Code> <Message>Your balance is zero!</Message> <Time></Time> </SMS> </string> Sai số điện thoại: Code: <string> <SMS> <Code>101</Code> <Message>Please check your Phone number!</Message> <Time></Time> </SMS> </string> Sai ServiceID: Code: <string> <SMS> <Code>103</Code> <Message> Service type is wrong! </Message> <Time></Time> </SMS> </string> __________________ FiboSMS Team Simple - Effective

08-10-2009, 11:05 AM	#9
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	2.11. GetSMSSentList Hàm lấy danh sách các tin nhắn đã gởi trong quá khứ. Tham số là số gs phút. Số gs được đặt tùy vào gói dịch vụ, tức là tối đa ứng dụng của khách hàng có thể xem được danh sach các tin sms đã gởi trong quá khứ cách thời điểm hiện tại gs phút. Nếu khách hàng muốn xem lại các tin nhắn đã gởi trong quá khứ trước gs phút, khách hàng phải đăng nhập hệ thống SMS Hosting để xem danh sách SMS đã gởi, trong danh sách này khách hàng có thể in báo cáo , export dữ liệu ra dạng XML hay SQL. Gọi hàm: http://center.fibosms.com/Service.asmx/GetSMSSentList?clientNo=string&clientPass=string&m inutes=string Tham số: clientNo clientPass minutes (gs) Kết quả trả về: Chú ý: SMSStatus có ý nghĩa sau: Pending = 0, Sending = 1, SentSuccess = 2, SentFailed = 3, Deleted = 4, ToNumberNotCorrect = 5, CanNotSend = 6, OutOfDate = 7, SendMTFailed = 8, Other = 9, SpamSMS = 10, RestoreToAccountClient = 11 Kết quả có SMS: Code: <string> <DocumentElement> <SMSLIST> <SMSID>492</SMSID> <SMSGUID /> <PhoneNumber>0909626922</PhoneNumber> <Message>Message 42</Message> <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate> <SentDate>2008-05-16T09:32:00+07:00</SentDate> <SMSStatus>2</SMSStatus> </SMSLIST> <SMSLIST> <SMSID>493</SMSID> <SMSGUID /> <PhoneNumber>0909128628</PhoneNumber> <Message>Message 43</Message> <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate> <SentDate>2008-05-16T09:32:00+07:00</SentDate> <SMSStatus>2</SMSStatus> </SMSLIST> … … </DocumentElement> </string> Không có SMS: Code: <string><DocumentElement /></string> __________________ FiboSMS Team Simple - Effective

08-10-2009, 11:09 AM	#10
FiboSMS Status: Fibosms.com Tham gia ngày: Jun 2008 Bài gởi: 839	2.11. GetSMSSentList Hàm lấy danh sách các tin nhắn đã gởi trong quá khứ. Tham số là số gs phút. Số gs được đặt tùy vào gói dịch vụ, tức là tối đa ứng dụng của khách hàng có thể xem được danh sach các tin sms đã gởi trong quá khứ cách thời điểm hiện tại gs phút. Nếu khách hàng muốn xem lại các tin nhắn đã gởi trong quá khứ trước gs phút, khách hàng phải đăng nhập hệ thống SMS Hosting để xem danh sách SMS đã gởi, trong danh sách này khách hàng có thể in báo cáo , export dữ liệu ra dạng XML hay SQL. Gọi hàm: http://center.fibosms.com/Service.asmx/GetSMSSentList?clientNo=string&clientPass=string&m inutes=string Tham số: clientNo clientPass minutes (gs) Kết quả trả về: Chú ý: SMSStatus có ý nghĩa sau: Pending = 0, Sending = 1, SentSuccess = 2, SentFailed = 3, Deleted = 4, ToNumberNotCorrect = 5, CanNotSend = 6, OutOfDate = 7, SendMTFailed = 8, Other = 9, SpamSMS = 10, RestoreToAccountClient = 11 Kết quả có SMS: Code: <string> <DocumentElement> <SMSLIST> <SMSID>492</SMSID> <SMSGUID /> <PhoneNumber>0909626922</PhoneNumber> <Message>Message 42</Message> <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate> <SentDate>2008-05-16T09:32:00+07:00</SentDate> <SMSStatus>2</SMSStatus> </SMSLIST> <SMSLIST> <SMSID>493</SMSID> <SMSGUID /> <PhoneNumber>0909128628</PhoneNumber> <Message>Message 43</Message> <CreatedDate>2008-05-16T09:23:00+07:00</CreatedDate> <SentDate>2008-05-16T09:32:00+07:00</SentDate> <SMSStatus>2</SMSStatus> </SMSLIST> … … </DocumentElement> </string> Không có SMS: Code: <string><DocumentElement /></string> __________________ FiboSMS Team Simple - Effective

Ðiều Chỉnh
Tạo trang in Email trang này
Xếp Bài
Chế độ bình thường Chuyển sang chế độ Pha trộn Chuyển sang chế độ dạng cây