Skip to content

Webhooks

Grouptalk

This manual explains how to configure a webhook for GroupTalk and connect it to a panic button device. Once configured, pressing the panic button will send an alarm notification to the configured GroupTalk recipient.

1. Create a New Webhook

  1. Navigate to:

Webhooks → New Webhook

  1. Fill in the webhook configuration fields:
Field Value
Name Enter a descriptive name for the webhook
URL Enter your GroupTalk endpoint URL
IsActive Set to Yes
DataFormat Select GroupTalk
Secret Enter your GroupTalk REST API Bearer token

  1. Configure the webhook event:

  2. Select Button Pressed as the event.

  3. This event is used to review and trigger an alarm when the panic button is pressed.

  4. Save the webhook configuration.

2. Configure the Panic Button Device

After creating the webhook, configure the device that will trigger the alarm.

  1. Open your ioThings device (panic button).

  2. Select:

Manage

  1. Locate the Metadata field.

  2. Add the following JSON configuration:

{
  "webhook_message": "Test message",
  "webhook_priority": "ALARM",
  "webhook_recipient": "ERT_ALARM"
}
  1. Save the device configuration.

3. Metadata Field Explanation

The metadata values determine the content and routing of the alarm sent to GroupTalk.

Field Description
webhook_message The alarm message that will be displayed in GroupTalk. Replace "Test message" with your desired alarm text.
webhook_priority The priority level of the alarm. Supported values: NORMAL, URGENT, or ALARM.
webhook_recipient The GroupTalk recipient that receives the alarm. This must be configured in GroupTalk and can be a USER and/or GROUP.

Example:

{
  "webhook_message": "Emergency assistance required at loading dock",
  "webhook_priority": "URGENT",
  "webhook_recipient": "SECURITY_TEAM"
}

4. Testing the Configuration

To verify the setup:

  1. Ensure the webhook is active.
  2. Confirm the panic button device contains the correct metadata configuration.
  3. Press the panic button.
  4. Verify that the alarm is received by the configured GroupTalk user or group.

Troubleshooting

Alarm is not received

Check the following:

  • The webhook is set to Active.
  • The GroupTalk REST API Bearer token in the Secret field is valid.
  • The endpoint URL is correct.
  • The webhook_recipient exists in GroupTalk.
  • The recipient is configured as a valid GroupTalk USER and/or GROUP.
  • The webhook_priority value is one of:
  • NORMAL
  • URGENT
  • ALARM

Invalid metadata

Ensure the Metadata field contains valid JSON format and that all required fields are present:

{
  "webhook_message": "Your alarm message",
  "webhook_priority": "NORMAL",
  "webhook_recipient": "YOUR_GROUP_OR_USER"
}

Your GroupTalk webhook integration is now configured and ready for use.