Configure a post to an external system

Event Types


Using Webhook

The Webhook tool posts events to an external system of your choice.

Available variables:

  • %{author}: Name of the author who triggered the event
  • %{object}: Class name of the related object in the event..
  • %{space}: Space in which the event happened
  • %{action}: The action that triggered the event..
  • %{title}: title of a message, wiki page, or name of uploaded file, ...
  • %{body}: content of a message, wiki page, ...
  • %{link}: link to the event in Assembla

Note on the POST method together with application/x-www-form-urlencoded. You must specify variables (in the content field), like with GET. For example:
space=%{space}&title=%{title}&author=%{author}

Example:

%{author} has %{action} a %{object}: "%{title}" in space %{space}
will generate
Andy has created a message: "we will need to discuss the new design tomorrow" in space Assembla Development
when a message event occurs.

Basic authentication:

You can give webhook the username and password required by the external system through the external url.
http://your_username:your_password@link_to_the_external_system_API
In some pre-configured posts, you just need to replace "username" and "password" in the url by your information.
For example: http://username:password@twitter.com/statuses/update.xml

Authentication with OAuth:

OAuth, an authentication method that lets you use apps without them storing your password.
You can give webhook your app's API key and Secret. Setup the external service OAuth URL's.
They should be provided in external service's API documentation. Authenticate with the service and you are ready to go!