Channel web hooks allows the post any content to a channel or create cases in channel. Channel web hooks are created in channel properties.
Creating a New Web Hook
To create a new web hook please follow these steps;
- Open channel that you want to create a web hook
- Select "Edit" from channel menu
- Switch to "Web Hooks" tabs and click to "Add New" button
- Web hook Url is automatically generated, enter the purpose of channel
- Click "Copy" button on next to Url field to copy Url to clipboard.
- Click Ok to save changes.
Posting Channel Activity
After web hook is created you can post JSON data to create a new activity on channel. Web hook URL contains required all required information does not need any authentication.
Posting Basic Message
POST /hooks/channels/f923d83a-3350-42d0-b9cb-620032730294/8459b574-62ea-4ea7-bbae-a132fbfee5df Host: my.emakin.com Content-Type: application/json { "text" : "my message" }
Posting Message with Attachments
As another example you can post following JSON to send a message with attachments.
POST /hooks/channels/f923d83a-3350-42d0-b9cb-620032730294/8459b574-62ea-4ea7-bbae-a132fbfee5df Host: my.emakin.com Content-Type: application/json { "text" : "my message", "attachment" : [ { "@type": "file", "displayName": "my file", "ext": "txt", "url": "http://myserver/myfile" }, { "@type": "link", "url": "http://www.google.com", "displayName": "http://www.google.com" }] }