Documentation

Nimbuzz Terms of Use

Nimbuzz Chat buddy - Buddy Push

This page explains the feature of your buddy sending a message to a user on it's own. User will not be required to send a message to receive a message from your buddy!

Please note that this feature is not provided to any buddy by default. If you feel you really need this feature , please get in touch with us at developers@nimbuzz.com.

To send a message to a user you would need to perform the a POST call in the following way.

Buddy -> API

POST http://bot.nimbuzz.com/ws/iceman HTTP/1.1
Content-Type: application/xml

<?xml version="1.0"?>
<message to='varun'>
<body>Hey varun, see i am now able to contact you on your own!</body>
</message>

Replace 'iceman' with the JID of your buddy and 'varun' with the Nimbuzz username of the user you want to send a message to. This user should be signed into Nimbuzz.

In case the message is not sent to the user for any reason the API will respond with a proper HTTP status code. Refer Appendix A.

If everything goes well, the user should receive a message from the buddy like this


Appendix A: HTTP Response Codes

The following Response Codes are defined for the Buddy API.

HTTP Response Code Description
200 The operation was completed successfully
400 Either mime-type is NOT application/xml, or the body is invalid (i.e. malformed XML, unknown tag)
403

Invoked from unauthorized IP address
500 Internal server error - any other error triggered by the Nimbuzz server