A simple but powerful change to our messaging API

| July 10, 2012

Two of the most beloved HipChat features have always been @mentions and our inline previews for images and links from services like Twitter, YouTube, and GitHub. Unfortunately it wasn’t possible to take advantage of this awesome functionality when using our rooms/message API, but that changes today! You can now choose to have your API messages treated just like your own messages by setting the message_format=text argument. The default value is html which lets you do your own lightweight HTML formatting instead.

This is a powerful change because you now have a way for your automated tools to notify people (even if they’re offline);

as well as send in helpful links like Tweets so your team is aware of the latest happenings;

Oh, and as you may have noticed, we’ve added gray as a background color option since it looks a lot nicer for this type of data.

Check the API documentation for full details. Enjoy!

  • ZSJ

    message_format=text is really great, because emoticons can be used to improve the granularity of status messages from robots

  • http://www.androidpolice.com/ Artem Russakovskii


  • http://twitter.com/Tawheed TK

    Nice! It’d be awesome to be able to have custom sound effects for specific messages. e.g. Cash Register for every time a user enters CC information.

  • James Chiang

    The new deployment cannot be installed successfully. It has stuck for 3 times with the idle dialog “Please wait while the application is being updated…”. Now that I cannot use it any more.

    • http://powdahound.com Garret Heaton

      Please drop us an email at support@hipchat.com and we can help you out. Blog comments aren’t the easiest place for this.

  • http://www.facebook.com/profile.php?id=100001882855067 Jungly Mano

    Type your comment here.(15) Jungly Mano it my facebook link ad me hah 

  • http://www.queryfoundry.com/ concerto49

    Great changes. Going to check out the API now.

  • porges

    Is the Twitter example accomplishable using the HTML message type? The exact HTML allowed doesn’t seem to be documented anywhere.

    • Allen Jensen

      Have been trying to guess how to set font for a via html message type – nothing seems to work – a little documentation would help please.

      • http://powdahound.com/ Garret Heaton

        The supported tags are listed in the docs. We don’t allow stye font tag or style attribute, so there’s currently no way to tweak the font.

  • Ray

    I tried using the API to send “lightweight” formatted HTML, but it doesn’t seem to work. The documentation mentions the use of ” a, b, i, strong, em, br, img, pre, code, lists, tables” But it just displays the raw HTML. at least on the Mac client.

    • http://powdahound.com/ Garret Heaton

      Make sure you’re using message_format=html.