Links

IFTTT

IFTTT is short for "If This Then That" and allows you to link up to 700 different apps and services, including Twitter, DropBox, Twitch, and Google Sheets. IFTTT works by creating applets with triggers, queries, and actions.
The IFTTT x BotGhost link allows you to trigger IFTTT applets through custom commands and events, as well as triggering BotGhost custom events when other services trigger fires.

Linking IFTTT to BotGhost

To get started with IFTTT you must first link your IFTTT account to your BotGhost account. To do so head over to the BotGhost IFTTT page and click Connect to begin this process.
This will prompt you to log in and redirect you to the BotGhost dashboard where you must give permission to link your BotGhost account to IFTTT. Click Authorize to confirm the BotGhost x IFTTT link.
Once complete your accounts are now linked. You can now begin creating Applets using BotGhost triggers, queries, and actions on IFTTT.

Applets

Applets are the backbone of IFTTT. Applets use a customizable script to link two or more apps that normally remain separate. Within BotGhost, we use IFTTT Applets to either trigger custom events or trigger other services actions on IFTTT.
To create an Applet, once again head over to the BotGhost IFTTT service page and click Create.
You will then be prompted to Add at least one trigger and action. Triggers are what causes an applet to run, whilst actions are the end result of an action. Within BotGhost, the IFTTT trigger is executed through an Action block in custom commands or events.
In your applet, click Add in the If This section and select the Action Block triggered IFTTT trigger.

Action Block Triggered (IFTTT Triggers)

The Action Block Triggered IFTTT Trigger executes an Applet when an Execute an IFTTT Trigger action block in a custom command or event is run.
On IFTTT the Action Block Triggered Trigger has three options.
First, select your linked BotGhost account in the BotGhost account dropdown.

Action ID

The action ID field is what links your action in BotGhost to your trigger on IFTTT. This field must match the Action ID field in an Execute an IFTTT Trigger action in a BotGhost custom command or event. You can name this action ID anything you wish.

Bot

Select the bot you wish to trigger the action from.

Execute an IFTTT Trigger Action

Once you have set up your trigger on IFTTT, you can execute it through an Execute an IFTTT trigger action block in a custom command or event on BotGhost. To do so, first, create a custom command or event and drag in the action.
In the action, set the Action ID to the same Action ID you specified in your trigger on IFTTT.

Variables

You can pass information from your command or event to the action triggered in your Applet through IFTTT ingredients. The Action Block Triggered IFTTT Trigger has 10 variable slots you can use to pass through as ingredients. All BotGhost variables can be used in these slots including custom variables.
These variables will come through as ingredients named Variable1, Variable2, Variable3... in any connected IFTTT action in your applets.

Trigger a Custom Event (IFTTT Actions)

In IFTTT actions are the end result of an Applet. They are what are run when triggered by an IFTTT trigger. In BotGhost, the IFTTT Action is the execution of a custom event.
Once again create an applet and set a trigger of your choosing. Click the Add Section in Then That and choose BotGhost. Click on Trigger a Custom Event to add the BotGhost IFTTT Action to your Applet.
You will then be shown the options for the Action. Once again select your BotGhost account and input the Bot ID of the bot you wish to trigger the custom event of.

Event ID

Similarly to the IFTTT Trigger, we must provide an ID that is the same in BotGhost and IFTTT. If you have not done so already, head over to your BotGhost and create a Custom Event with the type When an IFTTT Action is executed.
You will need to input an IFTTT Event ID and then select that Event in your IFTTT Action.
Enter an event ID and then select that same event in your IFTTT Action.
Then make sure to enter your server ID in the Discord Server ID field in your event. You can then continue to build out your custom event like normal.

IFTTT Event Variables

You can pass variables through to your BotGhost custom event using the 10 IFTTT Variable slots. You can input your text or use ingredients from the execution action.
Each variable has its corresponding variable in the event builder. For example, any text or ingredients you put into the Variable 1 slot, can be used in your custom event as {ifttt_variable1}.