API Methods

3jam.conversations.sendMessage (currently for commercial users only)

Send a message to an existing conversation

Authentication

Authentication with a 3jam user's mobile phone number and password is required

Arguments

api_key (required)
api_version (required)
mobile (required)
Mobile number or virtual number of the sender
password (required)
md5 the concatenation of the mobile number and 3jam password for this user. e.g. in PHP: md5($mobile . $password)
message (required)
Message to send. Messages must be less than 100 characters.
conversation_id (required)
ID of the conversation to send message to

Response

Either success or failure with an error code.

Error Codes

98: Login failed
The login details or auth token passed were invalid.
100: Invalid API Key
The API key passed was not valid or has expired.
105: Service currently unavailable
The requested service is temporarily unavailable.
111: Format 'xxx' not found
The requested response format was not found.
112: Method 'xxx' not found
The requested method was not found.
120: Message is a required argument
No message was specified in the request.
121: Message must be less than 100 characters
The message sent was longer than 100 characters.
145: Insufficent credits
The sender of the message has insufficent credits. Please ask user to top up at http://www.3jam.com.
146: Invalid conversation ID
The sender is not in this conversation.