Advanced Features

“Actions” tell your Gumball what to do when one of its webhooks is called. You choose the action when you create a webhook in your Gumball account. You can also change it for a single call, by adding it to the webhook address:

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=track_1

Here are the possible actions:

[track_x] → play audio track x
[track_random_x-xx] → play random track from x to xx
[volume_x] → set volume to x (from 0 to 21)
[sleep_on] → put Gumball in sleep mode and disable notifications
[sleep_off] → put Gumball in active mode and re-enable notifications

track_x

This action asks your Gumball to play a specific audio track_x when the notification is received.

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=track_12

This will play 12.mp3 from Gumball’s microSD card.

Tips: By default, the action track_0 is a silent track (0.mp3 on the microSD card). This is handy if you want to have your Gumball turn on with the rotating light only, no sound.

track_random_x-xx

This action asks your Gumball to play a random track between track_x and track_xx

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=track_random_7-10

This will pick a random audio track to play out of the following: 7.mp3, 8.mp3, 9.mp3, 10.mp3

volume_x

This action sets the audio volume to volume_x. The minimum is 0 (silent) and the maximum is 21. The default is 15. You can also set it from your Gumball’s page in your account.

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=volume_15

This will set the volume to 15.

sleep_on

This action puts Gumball in sleep mode on, meaning all notifications are disabled. It is the “Sound off” button of your account.

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=sleep_on

This will disable all notifications, so your Gumball won’t turn on and play sounds when it receives notifications. It stays asleep until you wake it, even after being unplugged.

sleep_off

This action puts Gumball in sleep mode off, meaning all notifications are enabled. It is the “Sound on” button of your account.

https://app.getgumball.com/hook/xxxxxxxxxxxxxxxx?action=sleep_off

This will re-activate all notifications, so your Gumball will turn on and play sounds when it receives notifications.

Changing WiFi

For safety, a webhook can no longer reset the WiFi (the old reset_wifi action). To move your Gumball to another network, see Changing WiFi later in the setup guide.

Firmware updates

Your Gumball now updates over WiFi: no cable, and nothing to do on your side. If a new version cannot get back online, your Gumball returns to the previous one by itself. Just avoid unplugging it in the few minutes after an update.

Good to know

• Several Gumballs: add another one to the same account with the code from its box, under “Add a Gumball”. Give each one a name to tell them apart.
• Activity: your Gumball’s page lists every notification it received and every time it connected.
• One at a time: a notification that arrives while a sound is playing is skipped. The light turns for as long as the sound plays, 30 seconds at most.
• Offline: notifications sent while your Gumball is unplugged or offline are not played later.
• Limits: each webhook takes up to 30 calls a minute.
• Address leaked? Delete the webhook in your account and create a new one. The old address stops working straight away.