Versions Compared

Key

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

...

You can append query options to the URI in the following format, ?options=value&option2=value&...

URI Options

Name

Default Value

Context

RequiredProducer/Consumer

Description

authToken

null

Shared

YesBothAuthorization token(personal access token) obtained from Hipchat

 

protocol

http

Shared

NoBoth

Default protocol to connect to the Hipchat server

consumeUsers

null

Shared

NoConsumer

Comma separated list of user @Mentions or emails whose messages to the owner of authToken must be consumed

hostapi.hipchat.comSharedNoBothThe API host of the Hipchat to connect to
port80SharedNoBothThe port to connect to on the Hipchat host
delay5000SharedNoConsumerThe poll interval in millisec for consuming messages from consumeUsers provided. Please read about rate limits before increasing this.

...

Div
classconfluenceTableSmall

Header

Constant

Type

Description

HipchatFromUserHipchatConstants.FROM_USERStringThe body has the message that was sent from this user to the owner of authToken
HipchatMessageDateHipchatConstants.MESSAGE_DATEStringThe date message was sent. The format is ISO-8601 as present in the Hipchat response.
HipchatFromUserResponseStatusHipchatConstants.FROM_USER_RESPONSE_STATUS StatusLineThe status of the API response received.

...

Div
classconfluenceTableSmall

Header

Constant

Type

Description

HipchatToUserHipchatConstants.TO_USERStringThe Hipchat user to which the message needs to be sent.
HipchatToRoomHipchatConstants.TO_ROOMStringThe Hipchat room to which the message needs to be sent.
HipchatMessageFormatHipchatConstants.MESSAGE_FORMATStringValid formats are 'text' or 'html'. Default: 'text'
HipchatMessageBackgroundColorHipchatConstants.MESSAGE_BACKGROUND_COLORStringValid color values are 'yellow', 'green', 'red', 'purple', 'gray', 'random'. Default: 'yellow' (Room Only) 
HipchatTriggerNotificationHipchatConstants.TRIGGER_NOTIFYStringValid values are 'true' or 'false'. Whether this message should trigger a user notification (change the tab color, play a sound, notify mobile phones, etc). Default: 'false' (Room Only)

...

Div
classconfluenceTableSmall

Header

Constant

Type

Description

HipchatToUserResponseStatusHipchatConstants.TO_USER_RESPONSE_STATUSStatusLineThe status of the API response received when message sent to the user.
HipchatFromUserResponseStatusHipchatConstants.TO_ROOM_RESPONSE_STATUSStatusLineThe status of the API response received when message sent to the room.

...