Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  • Send notifications to a user or a group e.g. the ToDo app sends a notification whenever a ToDo is added, updated or deleted in the group.
  • Send attachments on behalf of a user like the Code Snippets or the Notes app
  • Converse with your users using your app's bot. For eg the Reminder app bot sends a message to a user based on the user's configuration


  1. Inline within a one-on-one or group chat tab. You may wish to do this for messages that are meant to be seen by the entire group or both parties in a one-on-one conversation. For eg the Todo app sends a notification to the entire group when a Task created within that group was completed.
  2. Directly to a user from your app's BotBots. This message will appear in your Bot's chat tab for that user. You may wish to do this for messages that are meant only for a given user e.g. the Reminder app bot sends a notification directly to a user


  1. Go through Creating an App to set up your app via the developer dashboard.
  2. Install the app into your own Flock account. Make sure that you save the user the authentication token received in the app.install event. You will need it for the method calls that follow.
  3. To be able to send a message to a contact or a group, you will need to know their identifier first. The methods roster.listContacts and groups.list can help you do this. Typically, your configuration URL will use these methods to set up an interface wherein a user can select which contact or group he wants to send messages from your app to.

  4. Send this message using the chat.sendMessage method. You can use either HTTP GET:

    Code Block
    titlechat.sendMessage using a GET request

    or POST to call the method.

    Code Block
    titlechat.sendMessage using a POST request
    POST /v1/chat.sendMessage HTTP/1.1
    Content-Type: application/x-www-form-urlencoded
    Content-Length: 70
  5. If you want to send attachments, take a look at the Sending Attachments page. Or if you want to create a bot, take a look at BotBots.