Sending vCard messages using HTTP
Sending a vCard
Single-recipient end points:
Broadcast end points: (HTTP POST only)
Example single-recipient request:http://sms.openmarket.com/sms/v1/send?user=MyBulkAccount
This send a vCard for John Smith to the number 447700900750. Each line in the vCard must have a carriage return and line feed character (different mobile phones require either one of these characters). The URL encoding for these is %0D%0A.
The example vCard, before being URL encoded, has the following format and content:
BEGIN:VCARD VERSION:2.1 FN:John Smith TEL;WORK;VOICE:442071231234 TEL;MOBILE;VOICE:447700900999 TEL;HOME;FAX:442071231235 END:VCARD
|user||The SMS Gateway account you are sending the message through.|
|pass||The password for the SMS Gateway account.|
|smsto||The MSISDN of the message recipient in international format (e.g. 447700900750). No leading "+" is required.
If you are sending a broadcast SMS request, separate each MSISDN with a line break (e.g. smsto=447700900750%0A447700900765%0A447700900999).
|smsfrom||Either a phone number (up to 16 digits) or an alphanumeric string encoded in the
Modified Latin-9 character set (up to 11 characters). This parameter is
mandatory for bulk services in all regions accept the US.|
Regulatory requirements means that you cannot change the originator for Premium Rate SMS messages in any region. In these instances, the originator is always your service's Short Code. If you do set the originator, the SMS Gateway will ignore the value.
|vcard_data||The vCard you are sending.|
Optional parameters specific to this request type:
There are no optional parameters specific to sending a vCard message request.
Optional parameters you can use for any request type:
- submitid: used to send broadcast SMS messages
- report: sets the delivery reports you want for the message
- response: (for single-recipient requests only) changes the format of the HTTP response from the SMS Gateway
- note, subaccount: optional reporting notes that you can add to the request
- vp, billingsingleshot: alters the validity period and billing for the SMS message