The internet is a busy place. As a developer you need to check a lot of services to know what’s going on with your teams. Has anyone pushed new changes to my repositories? Did my boss enter any new tasks for me? Have my latest changes broken the build? Keeping up to date is time consuming. Wouldn’t it be great to see all your updates on a single feed? We thought so.
Yesterday we released teowaki’s webhooks. You can listen to events happening elsewhere in the internet and show them in your team stream. Click on an event to see the details or navigate directly to the page where the event happened. You can even use teowaki’s to search through your received webhooks.
You don’t need to do anything special to start receiving webhooks. All you need is your team’s secret URL. Go to the list of teams and click on the team settings icon of any team you admin. You will notice a new section called Webhooks. In that section you will find a secret URL for your project, such as
At the moment we have integrated GitHub, Pivotal Tracker and Bitbucket. Here is what you need to configure on those tools to send webhooks into teowaki:
Go to your project settings and navigate to the Settings menu. Select the Webhooks & Services option and simply paste your teowaki’s secret URL into the Payload URL input box*.
Click on the Settings icon of your project and then select the Hooks option. From the dropdown list of integrations choose POST and simply paste your teowaki’s secret URL into the URL input box.
Select Configure integrations from the Project menu. Scroll down to the Activity Web Hook section and simply paste your teowaki’s secret URL into the input box.
Getting Hooks from any other service
If you want to send webhooks into your project from any other service, all you need to do is POST a XML, JSON or x-www-form-urlencoded request to your secret endpoint. The POST should include at least a field called name and a field called description. You can also send a field called url and a field called origin_name. As long as your POST contains those field, teowaki will display the information into your team stream.
The use cases for custom webhooks are endless. As an idea, you can send webhooks from scripts running in your servers every time a new version is deployed or a service is restarted. Everybody in your team will receive the notification on teowaki.
We are already working on integrations for Jira and Trello. We will keep adding new services we think are interesting for developers. If you are using teowaki and you are missing any integrations, please let us know.
For any suggestions or any questions you might have, we are always available at firstname.lastname@example.org
* at the moment we only recognise GitHub push events. We will be adding more GitHub events in the following weeks