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.