Custom Webhooks

Your status feed can receive incoming webhook messages from other apps.

You will need to configure both status.net app and a third-party app so that the both apps would "talk" to each other. You can connect more than one web app to post updates to your status feed.

New updates will be automatically posted by connected web apps to your status feed. 

Step 1: Configure your status feed

  1. Login to your status.net account. Go to Manage Feeds screen and choose your status feed.
  2. Click "Edit feed", then choose the "Connections" tab. Click "+" to create a new trigger, and scroll down to choose Webhook.
  3. Make sure the notification is turned On and click "Edit".
  4. Edit notification Name - this name will be visible everywhere next to the updates.
  5. Copy the webhook code.

Step 2: Configure the app that will post updates to your status feed

1. Login to the web application you're connecting (app that will send updates to your Status feed)

2. Open webhook settings in that app and paste the Status webhook code into the url/endpoint input field.

3. If this app provides several events to send notifications about - select one event per connection. This will allow you to customize the update message to be unique and provide much more useful data for each event.

4. Different apps will provide different types of events. Check the app's documentation to find out more about events for that specific web app.

Step 3: Configure the update message template

Option 1 - generic updates:

Generic updates are the easiest to configure. Every time an event happens, the connected app posts a pre-defined message that will always be the same.

1. Enter any text message you'd like to be posted to your feed when a new notification is received from the connected app. 

For example, if new connection is listening to the newly submitted orders, you can enter

"We've got a new order. Yay!".

This message will be posted automatically whenever a new notification is received from the connected app.

2. You can style automatic messages the same way you usually do this when posting updates from users: you can use rich font formatting and include emojis.

Option 2 - enriched updates:

3. Optionally, you can enrich automatic updates by adding unique details about each notification. This is done by adding properties to the message template.

For example, you could enrich your static message to become:

"We've got a new order #{{ order_id }} from {{ customer_location }} for {{ ordered_item }}. Yay!" 

This template will be translated into unique message every time and will include unique properties of each orders. 

"We've got a new order #128 from Annecy, France for Special T-Shirt. Yay!"

"We've got a new order #129 from New York, USA for Cool Sticker. Yay!"

This way you and your team get all the needed details right into the Status feed and can discuss them in comments.

Please note: These properties are unique values that are being passes together with each notification. Their names differ from app to app and you should check connected app documentation to see which properties each event type passes along.

TIP: If you use connected web apps for internal status updates, you can enrich your update message template with user @mentions to trigger specific team members for specific events.

Still need help? Contact Us Contact Us