IFTTT
Connect FaustBot to IFTTT (If This Then That) to trigger webhooks and automate hundreds of services including smart home devices, notifications, spreadsheets, and more.
Overview
IFTTT webhooks allow FaustBot to trigger actions in any of IFTTT's 700+ supported services:
Webhook Triggers
Send events to IFTTT from any FaustBot action.
Custom Values
Pass up to 3 custom values with each event.
Smart Home
Control lights, plugs, thermostats, and more.
Notifications
Send push notifications, emails, or SMS.
Social Media
Post to Twitter, Facebook, Discord, etc.
Spreadsheets
Log data to Google Sheets automatically.
How It Works
FaustBot sends HTTP requests to IFTTT's Webhooks service. You create "applets" in IFTTT that listen for specific event names and trigger actions in other services.
Setup
Get Your Webhook Key
Enable Webhooks in IFTTT
Go to ifttt.com/maker_webhooks and click Connect to enable the Webhooks service.
Get Your Key
Click Documentation in the top-right corner. Your unique webhook key will be displayed at the top of the page. Copy this key.
Configure FaustBot
In FaustBot, go to Integrations → IFTTT. Paste your webhook key and click Save.
Create an Applet
In IFTTT, create a new applet. Choose Webhooks as the trigger
("If This") and select "Receive a web request". Enter an event name like stream_started. Then choose your action service ("Then That").
Testing Your Setup
Use the IFTTT Documentation page to test your webhook. Enter your event name and optional values, then click "Test It" to verify it works before using it in FaustBot.
Effects
Webhook Actions
Trigger Event
Send a webhook event to IFTTT.
Trigger with Values
Send event with up to 3 custom values.
Value Placeholders
When creating IFTTT applets, you can use these ingredients in your actions:
| Ingredient | Description |
|---|---|
Value1 | First custom value passed from FaustBot |
Value2 | Second custom value passed from FaustBot |
Value3 | Third custom value passed from FaustBot |
EventName | The name of the triggered event |
OccurredAt | Timestamp when the event was received |
Scripting API
Trigger IFTTT webhooks from your scripts:
Triggering Webhooks
# Trigger a simple webhook event
CPH.IftttTriggerEvent("stream_started")
# Trigger with values (up to 3 values supported)
CPH.IftttTriggerEventWithValues(
"new_follower",
args["userName"], # value1
args["userType"], # value2
str(args["isSubscribed"]) # value3
)Connection Status
# Check if IFTTT is connected
if CPH.IftttIsConnected():
CPH.LogInfo("IFTTT webhook is configured")
# Get connection info
info = CPH.IftttGetConnectionInfo()
CPH.LogInfo(f"Webhook key configured: {info['hasKey']}")Practical Examples
# Stream went live - notify via IFTTT
def Execute():
game = CPH.GetArg("game")
title = CPH.GetArg("title")
CPH.IftttTriggerEventWithValues(
"stream_live",
game,
title,
"https://twitch.tv/yourchannel"
)
return True
# Milestone reached - trigger smart home
def Execute():
followers = CPH.GetFollowerCount()
if followers % 100 == 0:
CPH.IftttTriggerEventWithValues(
"milestone",
"followers",
str(followers),
"Congratulations!"
)
return TrueCommon Use Cases
Smart Lighting
Change Philips Hue or LIFX colors when you get a new subscriber.
Mobile Notifications
Get push notifications for raids, hosts, or large donations.
Stream Logging
Log followers, subs, and donations to Google Sheets.
Social Posting
Auto-tweet when you go live with game and title info.
See the full API reference for all available IFTTT methods.