Instant Command Usage

From Net2MAX

Jump to: navigation, search
More Information

1. Instant Command Features
2. Instant Command Usage
3. Instant Command List
4. Instant Command Charges
5. Instant Command Help
6. Instant Command Enhancements
7. Instant Command Forum

Contents


1 Introduction

Net2MAX Instant Command allow you to control your Net2MAX Platform just by sending it text messages WITHOUT the need of any programming skills.

Instant Commands can be embedded in any text message and can be transported by any mechanism that support text (e.g. email, SMS, web, instant message, WAP etc.), turning normally passive messages into active commands.


1.1 Instant Command Components

An Instant Command can have up to 4 components:

1. Sender Identity - who issued the Instant Command.
2. Start Time - when to run the Instant Command.
3. Command Output - where should the output of the Instant Command go.
4. Command Input - what data should be supplied to the Instant Command.



1.2 Instant Command Examples

(E61290112121) How are you? The above text message sent by anyone to any Instant Command Access Point worldwide via SMS, Skype, Email, MSN or whatever, will result in an Email to contact number 61290112121 with the content of "How are you?". In this example, Sender Identity, Start Time and Command Input are empty. Onlt the Command Output (E61290112121) is specified.

Note 1 The Instant Command ALWAYS starts at the beginning of the message (the first character). It is normally surrounded by parenthesis ( ). For example with one ( ):

(E61290112121) Hello

This will send an email to contact number 61290112121 with the message "Hello" in the email.

Note 2 Since an Instant Command always occupy the beginning of the text message, the used of ( ) in the rest of the text message will NOT create any conflict. For example with two ( ):

(E61290112121) Hello (There)

This will send an email to contact number 61290112121 with the message "Hello (There)" in the email.


1.3 Instant Command Encoding

Although most international character encodings should work, due to automatic character encoding conversion in most systems, only UTF-8 encoding is officially supported for all communications in any language.


2 Sender Identity

Anyone can send Instant Commands through Net2MAX at any time WITHOUT paying nor joining. However, the identity of the sender of the Instant Command is required for sending messages to people outside of our network which are NOT available to the public(people who do not provide an identity).


2.1 Identification Not Supplied

If NO identity value is supplied with the Instant Command, then it is assumed that the sender is a PUBLIC user - an unknown person. A public user (non-member) can only send a restricted set of Instant Commands (e.g. only sending text messages to contact numbers of members).

Fees (if any) incurred by these Instant Command sent by the public (e.g. ringing the mobile phone of a member) is paid for by the member and NOT the public.

Instant Command is a receiver pay system when the identity of the sender is unknown, members can block Instant Commands from the public, to prevent paying for Instant Commands issued by strangers.


2.2 Identification within Message

The Sender Identity have to be declared IN FRONT of the Command Output by using the syntax (Axxxxx yyyyy), where xxxxx is the sender's Contact Number and yyyyy is the sender's Disposable PIN.

For example, the text message

(A61290111010 123456)(E61290112121) Hello There

The sender Contact Number and Disposable PIN are given as 61290111010 and 123456. If authenticated, an email with the email body "Hello There" will be sent to 61290112121 .

2.3 Identification from Device

If a member has previously verified that a certain device belongs to her, then she can use that device to send the Instant Command without needing to use Message Identity above. The device can be a phone or a jabber client.

For example, there is NO need for the Sender Identity component if the member is sending a SMS message from her own mobile phone number which she has already verified with Net2MAX. She just type "(E61290112121) Hello" and an email with the word "Hello" will be send to the Net2MAX Member with a Contact number of 61290112121.


2.4 Identity Registration

For people who are NOT members, they can register to become a member instantly and freely by sending the special identity command "1" to SMS access points on the Instant Command List. Only a single character 1 is required to be entered. More details are on the Phone Number Registration page.

3 Start Time

The Instant Command Sender can OPTIONALLY specify what time and how often the Instant Command should be ran in the future.


3.1 Run Now

If NO time value is supplied then it is assumed to be NOW - that is the Instant Command is executed as soon as possible.


3.2 Run in Future

Specifies at what time the action should be performed. This is OPTIONAL and you will not need to use it unless you want to schedule an action at a specfic time in the future.

Format:

(* [date] T [time] [timezone] * [repeat] * [offset] )

Defaults:

date = if empty then TODAY - otherwise put in date YYMMDD format
time = if empty then CURRENT time - otherwise put time in HHMM format
timezone = if empty then LOCAL time zone - otherwise in ±HHMM format from GMT
repeat = if empty then NO repeat - otherwise in the number of times to repeat
offset = if empty then NO offset - otherwise the number of minutes between repeats

Example:

(E61290112121)
Net2MAX will send a text message to the email address of contact number 61290112121 as soon as possible.
(*20081218T130000E61290112121)
Net2MAX will send a text message to the email address of contact number 61290112121 on the 18-Dec-2008 at 1pm user defined time.
(*20081218T130000+1000*1*30E61290112121)
Net2MAX will send a text message to the email address of contact number 61290112121 on the 18-Dec-2008 at 1pm, time zone is 10 hours faster than GMT and also again at 1:30pm.

4 Command Output

If NO output value is supplied then it is assumed to be EMAIL - the output will be sent an email address.

No Need for TYPE

There is NO need for the TYPE component if the TYPE is to be used is the preferred messaging format selected by the RECEIVER.
She just type
(61290112121) Hello
and an email with the word "Hello" will be send to the Net2MAX Member with an 1CC number of 61290112121.

No Need for TO

If the person is receiving the message is a member using a device that can provide his or her identity then there is NO need for the TO field.

For example,

There is NO need for the TO component when the sender is using something like Jabber where the destination of the message is known.
She just type
(E) Hello
and an email with the word "Hello" will be send to the Net2MAX Member with an 1CC number of 61290112121.


Instant Command can send the output or the result of an action to a number of different devices.

Format:

  1. C = Call
  2. E = Email
  3. F = Fax
  4. J = Instant Message
  5. L = Location
  6. P = Phone
  7. S = SMS
  8. T = Conference
  9. U = URL
  10. V = Verification
  11. X = Web PABX


Example:

If the message body contains:

  1. (P61290112121) Net2MAX will send a text-to-speech message to the phone numebr of 61290112121
  1. (F61290112121) Net2MAX will send a text-to-image message to the fax number of 61290112121
  1. (E61290112121) Net2MAX will send a text message to the email address of 61290112121
  1. (S61290112121) Net2MAX will send a text message to the mobile number of 61290112121


Output Destination

For each device the output target or destination must be specified. This can be a real destination number like a phone number or an OZnumber.

By specifying an OZnumber, the appropriate destination for that OZmember will be used automatically. That is the the phone number, email address, etc. from the OZmember profile (ozmember_slow) will be selected as required, the sender does NOT need to know or remember any phone numbers or email addresses, etc. of the target OZmember.

Format:

1. 1CC Number 2. Real Destination - in between ** 3. Web PABX Step - in between ** 4. File Name (will be supported in the future) 5. OZnumber (will NOT be supported in the future)

TO

Each member can have a number of different lists for each type of message. For example the message:

(E61290112121) Hello

This will send an email with "Hello" to every email address inside the member 61290112121's file with the name E61290112121

If not specified, the default output target is OZnumber of Sender

Email Example:

(E91136)
Net2MAX will send a text message to the email address of 91136
(E*test@oztell.com*)
Net2MAX will send a text message to the email address of test@oztell.com

Phone Example:

(P*61292176000*)
Net2MAX will send a text-to-speech message to the phone number +61292176000
(C*61292176000 85223120180 899060123456*)
Net2MAX will call the phone numbers +61292176000, +85223120180 and +899060123456, then set up a voice conference call between them.

Web PABX Example:

(X*1*) goto:default
Net2MAX will change the webpabx command where Remote Update Number is equal to 1.


Instant Message Example:

(J*john@jabber.org*)
Net2MAX will send a text message to the jabber address of john@jabber.org
(JA*john*)
Net2MAX will send a text message to the AIM address of john
(JC61290112121)
Net2MAX will send a text message to the Online Conference of 61290112121
(JE*john*)
Net2MAX will send a text message to the MySpace address of john
(JF*john*)
Net2MAX will send a text message to the Facebook address of john (alpha testers only)
(JG*john*)
Net2MAX will send a text message to the GoogleTalk address of john
(JI*12345678*)
Net2MAX will send a text message to the ICQ address of 12345678
(JM*bill@hotmail.com*)
Net2MAX will send a text message to the MSN address of bill@hotmail.com
(JP*bill@sip.test.com*)
Net2MAX will send a text message to the SIP address of bill@sip.lcs.test.com (Microsoft Live Communication Server address)
(JQ*12345678*)
Net2MAX will send a text message to the QQ address of 12345678
(JS*john*)
Net2MAX will send a text message to the Skype address of john
(JT*john*)
Net2MAX will send a text message to the Twitter user name of john (alpha testers only)
(JY*john*)
Net2MAX will send a text message to the Yahoo address of john


5 Command Input

Normally, the body of the text message is used as input to the command, but there are also a number of alternative input sources:

  1. B = Balance - input account information
  2. U = URL - input from URL
  3. G = Address Book - input from Contact's Address Book
  4. D = Calendar - input from calendar
  5. E = Email Box - input from mail box

Examples:

  1. (E61290112121B)
    Net2MAX will send a text message to the email address of 61290112121 containing the balance of her account.
  2. (PB)
    Net2MAX will send an voice message to phone number of Sender containing the balance of her account.
  3. (F91136D)
    Net2MAX will send a fax message to the fax number of 91136 containing the calendar events for today
  4. (SE)
    Net2MAX will send an SMS message to mobile number of Sender containing the titles of emails in her Inbox


5.1 Text

Everything inside the () within a text message are treated as an Instant Command and will be processed by Net2MAX as commands from you.

If NO input value is supplied then it is assumed to be the remaining TEXT - the text in REST of the current message.

After processing the Instant Command, it is removed, and the rest of the text message is passed to the output specified in the instant command without change.

For example, if the Instant Command is

(E61290112121)Hello

then an email will be sent to 1CC Number 61290112121 and only the word "Hello" will be in that email, the instant command "(E61290112121)" will be removed.

Each Input listed above (A, U, C, M) needs a source to input perform. If not specified, then the target is the output target. If output target is not specified either, the target becomes the sender of the message.


5.2 Balance Input (B)

Get value from Net2MAX Account Balance.

Formats:

  1. Contact Number - Return the Account Balance of the contact number
  2. Transfer - Transfer from Sender Account to supplied contact number account

Examples:

(A61290112121 123456)(FB)
Net2MAX will send a fax message to the sender containing the balance in her Net2MAX Account.
(A61290112121 123456)(E61290111010B)
Net2MAX will send an email to the email address of contact number 61290111010 containing the balance of the message sender 61290112121
(A61290112121 123456)(PB61290118383)
Net2MAX will send a phone message to phone number of Sender containing the balance in 61290118383
(A61290112121 123456)(P61290111010B61290118383)
Net2MAX will send an phone message to phone number of contact number 61290111010 containing the balance in 61290118383 account
(A61290112121 123456)(FB61290118383*10)
Net2MAX will transfer $10 from Sender's account 61290112121 to 61290118383 account, then sending a confirmation to the Sender Fax number.

All the above Balance related commands also send a copy to all parties.


5.3 Contact Address Book Input (G)

Input Command: G

Formats

( [Output Command] [Output Target] G [Input Target] [Input Parameter] ) [Message Body]

Input Target Formats
  1. Empty - Search [Output Target]'s content.
  2. Name of the Address Book - Search the specified Universal number's content.
Input Parameter

Formats: [Parameter]=[Value]
Parameter:

  1. Empty - No Limitation on Search.
  2. *firstname - Search contacts by the first name.
  3. *lastname - Search contacts by the last name.
  4. *un - Search contacts by the Universal Number.
  5. *mail - Search contacts by the E-mail Address.
Message Body Formats
  1. Empty - Search from the default Address Book.
  2. Name of the Address Book - Search from the specified Address Book.
Examples of Contact Address Book Input (G)
  1. (F61290112121G) 61290112121's Default Address Book will be fax to her mobile.
  2. (S61295545556G61290112121) - The default Address Book of 61290112121 will be sent to 61294434445's mobile via SMS
  3. (E61295545556G61290112121)Syndey - 61290112121's "Syndey" Address Book will be sent to 61295545556's Email.
  4. (J61290112121G61290112121*lastname=Lee)Melboune - Contacts with lastname "Lee" in 61290112121's "Melboune" Address Book will be Jabber to her.


5.4 Contact Address Book Create (GC)

Input Command: GC

Formats

( [Output Command] [Output Target] GC [Input Target] ) [Message Body]

Input Target Formats
  1. Empty - Create the Address Book in [Output Target]'s Contact Manager.
  2. Name of the Address Book - Create the address book in the specified Universal number's Content Manger.
Message Body Formats
  1. Name of the Address Book - specify the name of the Address Book.
Examples of Contact Address Book Input (G)
  1. (S61295545556G61290112121)others - Create the "others" Address Book for 61290112121 and send the result to 61295545556's mobile via SMS.
  2. (F61290112121GC)friends - Create the "friends" Address Book for 61290112121 and fax the result to her.


5.5 Contact Address Book Insert (GI)

Input Command: GI

Formats

( [Output Command] [Output Target] GI [Input Target] [Input Parameter] ) [Message Body]

Input Target Formats
  1. Empty - Insert Contacts into [Output Target]'s Address Book.
  2. Name of the Address Book - Insert Contacts into the specified Universal number's Address Book.
Input Parameter

Formats: [Parameter]=[Value]
Parameter:

  1. *firstname - Set contact's first name.
  2. *lastname - Set contact's last name.
  3. *un - Set contact's Universal Number.
  4. *workphone - Set contact's work phone number.
  5. *homephone - Set contact's home phone number.
  6. *mail - Set contact's E-mail Address.
  7. *fax - Set contact's Fax Number.
  8. *mobile - Set contact's mobile Number.
  9. *command - ??
Message Body Formats
  1. Empty - Insert the contact into the default Address Book.
  2. Name of the Address Book - Insert the contact into the specified Address Book.
Examples of Contact Address Book Insert (GI)
  1. (F61290112121GI) - Insert an empty contact in 61290112121's default Address Book and fax the result to 61290112121.
  2. (S61295545556GI)123 - Insert an empty contact in 61295545556's "123" Address Book and the result will be sent to 61294434445's mobile via SMS
  3. (E61295545556GI61290112121*lastname=Wong*firstname=Peter*mobile=61295545556)friends - Insert a contact with Wong as lastname, Peter as firstname and 61295545556 as the mobile number into 61290112121's "friends" Address Book and Email the result to 61295545556.


5.6 Calendar Input (D)

Input Command: D

Formats

( [Output Command] [Output Target] D [Input Target] [Input Parameter] ) [Message Body]

Input Target Formats
  1. Empty - Return [Output Target]'s current event.
  2. Universal Number - Return the specified Universal number's current event.
Input Parameter

Formats: [Parameter]=[Value]
Parameter:

  1. Empty - No Limitation on Search.
  2. calendar - Search events in the calendar.
  3. starttime - Search events by starttime(in YYYYMMDDTHHMMSS).
  4. endtime - Search events by endtime.
  5. title - Search events by title.
Message Body Formats
  1. Empty - Search from the default calendar.
  2. Name of the Address Book - Search from the specified calendar.
Examples of Calendar Input (D)
  1. (FD) - Today's calendar for the sender will be faxed to her mobile.
  2. (S91138D91136) - Today's calendar for 91136 will be sent to 91138's mobile via SMS
  3. (S91138D91136*starttime=20080808) - 08-Aug-2008's calendar for 91136 will be sent to 91138's mobile via SMS


5.7 Calendar Create (DC)

Input Command: DC

Formats

( [Output Command] [Output Target] DC [Input Target] ) [Message Body]

Input Target Formats
  1. Empty - Create the Calendar in [Output Target]'s Contact Manager.
  2. Name of the Address Book - Create the Calendar in the specified Universal number's Content Manager.
Message Body Formats
  1. Name of the Calendar - specify the name of the Address Book.
Examples of Calendar Create (DC)
  1. (S61295545556DC61290112121)others - Create the "others" Calendar for 61290112121 and send the result to 61295545556's mobile via SMS.
  2. (F61290112121GC)friends - Create the "friends" Calendar for 61290112121 and fax the result to her.


5.8 Calendar Insert (DI)

Input Command: DI

Formats

( [Output Command] [Output Target] DI [Input Target] [Input Parameter] ) [Message Body]

Input Target Formats
  1. Empty - Insert Contacts into [Output Target]'s Address Book.
  2. Name of the Address Book - Insert Contacts into the specified Universal number's Address Book.
Input Parameter

Formats: [Parameter]=[Value]
Parameter:

  1. *title - Set Event's title.
  2. *description - Set Event's description.
  3. *starttime - Set Event's start time.
  4. *endtime - Set Event's end time.
Message Body Formats
  1. Empty - Insert the event into the default calendar.
  2. Name of the Address Book - Insert the event into the specified calendar.
Examples of Calendar Insert (DI)
  1. (F61290112121GI) - Insert the event '(Public event)' into 61290112121's default calendar and fax the result to her.
  2. (S61295545556GI)2008 - Insert the event '(Public event)' into 61295545556's '2008' calendar and the result will be sent to 61294434445's mobile via SMS
  3. (E61295545556GI61290112121*title=lunch*description=lunch*starttime=20080808T130000+1000*endtime=20080808T140000+1000)2008 - Insert an event with title as lunch, description as lunch, start time as 13:00 August 8 2008, end time as 14:00 August 8 2008 into 61290112121's '2008' calendar and Email the result to 61295545556.


5.9 Email Input (E)

Subject lines of mails in the Group Email can be retrieved.

Formats of Mailbox input (M):

  1. Input is not specific
    Return subject lines of unread mails in the Sender's Group Email

  2. Input is 1
    Return subject lines of read mails in the Sender's Group Email


Examples of Mailbox input (M):

  1. (SM)
    Send an SMS of the subject lines of unread mails.


5.10 URL Input (U)

URL content can be retrieved.


Formats for URL input (U):

  1. Input is 1CC Number
    Return result of accessing the defined URL of 1CC Number.

  2. Input is *URL*
    Return result of accessing a URL defined between **.

  3. If Input not specified
    Return result of accessing the defined URL of the Sender.


Examples for URL input (U):

  1. (E91136U91138)
    Net2MAX will get the results from the URL defined by 91138 and send to 91136's email address

  2. (E91136U*https://www.oztell.com/value.php?number=123*)
    Net2MAX will get the results from www.oztell.com and send to 91136's email address
Retrieved from "http://en.net2max.com/Instant_Command_Usage"
Personal tools