Integration

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.

Screenshot: IFTTT webhook 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.

Triggers

The IFTTT integration is designed for outbound automation - sending events from FaustBot to IFTTT to trigger actions in other services.

No Incoming Triggers

IFTTT Webhooks are one-way: FaustBot sends events to IFTTT, but IFTTT cannot send events back to FaustBot through this integration. To have external services trigger FaustBot actions, consider using the HTTP Server integration or WebSocket API.

Event Response

While there are no traditional triggers, you can check the response from IFTTT after triggering an event:

Variable	Type	Description
`success`	bool	Whether the webhook request succeeded
`statusCode`	int	HTTP status code from IFTTT (200 = success)
`body`	string	Response body from IFTTT

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 True

Common 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.