Advanced Features

“Action” parameters are used to tell your Gumball what to do when it receives the webhook:

https://app-gumball.com/request?id=gumball_xxxxxxx&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 20)
[sleep_on]→ put Gumball in sleep mode and disable notifications
[sleep_off] → put Gumball in active mode and re-able notifications
[reset_wifi]→ reset saved wifi credentials
[update_firmware] → update to the latest firmware version (coming soon)

track_x

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

https://app-gumball.com/request?id=gumball_xxxxxxx&action=track_12

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

Tips: By default, the command 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 command asks your Gumball to play a random track between track_x and track_xx

https://app-gumball.com/request?id=gumball_xxxxxxx&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 command sets the audio volume to volume_x. The minimum is 0 (silent) and the maximum is 20.

https://app-gumball.com/request?id=gumball_xxxxxxx&action=volume_15

This will set the volume to 15.

sleep_on

This command puts Gumball in sleep mode on, meaning all notifications are disabled.

https://app-gumball.com/request?id=gumball_xxxxxxx&action=sleep_on

This will disable all notifications, so your Gumball won’t turn on and play sounds when it receives notifications.

sleep_off

This command puts Gumball in sleep mode off, meaning all notifications are enabled.

https://app-gumball.com/request?id=gumball_xxxxxxx&action=sleep_off

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

reset_wifi

This command resets the saved wifi credentials (SSID and Password)

https://app-gumball.com/request?id=gumball_xxxxxxx&action=reset_wifi

Wifi credentials will be reset, you’ll need to reconnect your Gumball to the wifi again following the Setting up Gumball instructions.

Update firmware (coming soon)

This command will check for a firmware update and upgrade to the latest version if a new update is available.

https://app-gumball.com/request?id=gumball_xxxxxxx&action=firmware_update

This will perform a firmware update if a new version is available.