The Berto IFTT driver provides integration to the IFTTT Webhooks Service. To use the driver you need to connect your IFTTT account to the Webhooks service to obtain a key.
In order for your Control4 system to receive messages from the IFTTT service you need to post your webhook request to https://ifttt.berto.io which in turn securely forwards the request to your system using MQTT over SSL. Authentication is provided by your IFTTT key being part of the URL that is setup on the Webhooks service. The URL is in the format used for sending webhook requests from IFTTT to the Berto service is https://ifttt.berto.io/trigger/{event}/{system MAC address}/{key}. Requests not macthing this URL are immediately closed and also any requests with a content length greater that 1024 bytes are shutdown.
Users set up with a Berto Profile driver will be able to receive messages from the IFTTT driver based on the pin number supplied in the event of the message. The IFTTT message event should contain the user porfile name in uppercase followed by a space and the users pin number. This ensures that the driver only processes message received with the correct credentials. The message is then sent to the corresponding user profile driver.
There is a limit of sending or receiving 100 requests per day with the Basic subscription level.
Properties
-
IFTTT Key - The key associated with your IFTTT Webhooks service.
-
Text Variables - A list of text variables separated by commands that will be created to be used under programming.
-
Number Variables - A list of number variables separated by commands that will be created to be used under programming.
-
Boolean Variables - A list of boolean variables separated by commands that will be created to be used under programming.
Programming
When an IFTTT message is received an event is fired and the appropriate variables will be updated, see below. If the message contains a body and is in JSON format then values will be extracted from the JSON to update the variables setup under Properties. eg. '{ "NAME": "Jon Doe", "TEMPERATURE": 23, "STATE": true }'.
The driver also provides the Send Event action to post an event to the Webhooks service. You need to specify the Event to publish and optionally 3 values that can be used by the IFTTT Webhooks service.
Variables
-
RECEIVED - Date and time of the last message received.
-
EVENT - Event received.
-
CONTENT TYPE - The content type of the message.
-
BODY - The body of the message.
Release Notes
v1.00 - 2020-03-15
-
Initial Release.
v1.10 - 2020-03-29
-
Auto Update changed to be managed via the Auto Update Time specified in the Berto Cloud driver.
v1.11 - 2020-04-17
-
Added Console option to Debug Mode property to allow for external logging output.