Webhook

Prefer to be notified on platforms other than email such as Telegram or Slack?

You can obtain the “Webhook url” from Plumber, another product by Open Government Products.

Refer to the following guides for Plumber:

• Webhooks - https://guide.plumber.gov.sg/user-guides/triggers/webhooks

• Telegram - https://guide.plumber.gov.sg/user-guides/actions/telegram

• Slack - https://guide.plumber.gov.sg/user-guides/actions/slack

• Email by Postman - https://guide.plumber.gov.sg/user-guides/actions/email-by-postman

Note: When using this feature, you will be notified of incomplete submissions 2hrs before its due time.

Armoury → Telegram: Checklist-Due Notifications (via Plumber)

Overview

This step-by-step guide shows how to send Telegram notifications when an Armoury team has checklists due, using Plumber as the integration layer.

Prerequisites

• A Telegram bot and its target chat (bot added to the group/channel).

• Access to both Armoury as a Team Admin/Agency Admin and Plumber.

• Must access the Armoury Admin Portal on a laptop/desktop

Steps

1. In Armoury: Open the team you want to notify and click Add Notification.

1. Select the button "Add Notification" to create your notification

1. You will see this page:

1. In Plumber: go to https://plumber.gov.sg and sign in.

2. Create a new Pipe named “<TeamName> — Armoury Reminder”

   • Example: “Marina Bay — Armoury Reminder”

3. Choose Webhook as the trigger.

1. Copy the Webhook URL from Plumber and paste it into the Armoury notification’s webhook field.

   

   
2. Back in Armoury, click Send Data to push a live sample payload to Plumber (so Plumber can infer the data structure).

1. In Plumber, on the webhook step, click Check Step to retrieve and view the sample data from Armoury.

1. Click Add Step (left panel) and select Telegram.

   
2. When asked for a connection, link your Telegram bot to Plumber.

If you haven’t created a bot yet, see: https://guide.plumber.gov.sg/user-guides/actions/telegram

1. After connecting, click Add Step to insert the Telegram action.

1. Enter your Telegram Chat ID (include the leading “-” for group chats).

You are able to copy this Message Text as a Template for your Plumber Integration: Reminder for <TeamName Option> for checklist due at <CheckDueTime Option>

Checklist that are In Progress: <In Progress Option>

Checklist that are Not Started: <Not Started Option> *Replace the <TeamName Option> with the dropdown option in Plumber

1. Click Check Step on the Telegram step to send a live test message to your Telegram chat.

   1. This will trigger a live message to the telegram group that you've assigned the bot to.

Example:

Do not be worried if you see "No list found" that is because no checklist is due at 11.21am

1. Once you received the telegram message, you must make sure to:

   1. In Plumber, click Publish to publish your Plumber pipe.

   2. Back in Armoury: update the team so it uses this new notification.

Important: If you skip Step 15, the integration between Armoury and Plumber will not go live.