Webhook & Stories
Advanced guide
home-icon
Visit support.prota.info
Frequently Asked Questions are helpful if you want to learn more about using Prota.
Table of contents
Webhook & Stories
  • Stories
    • Sensor story (Sensor, Event) / Actor story (Actor, Action)
    • Condition options, Instruction fields
    • Citing
    • Scene, Taken
  • Webhook
    • Incoming webhook
    • Outgoing webhook
  • Examples
    • Post a message to Slack when app upgrades are available
    • Turn off power when I’m not home (Geo fence - IFTTT ➔ ONOFF)
stories-app-icon
Getting started
Stories app

Stories app is an automation engine that connects native Prota apps, smart devices, and external web services.

Create a story by simply writing a sentence in natural language.

“When receives an
email, NFS saves the text to external drive.”
a-story
Getting Started
A story
Sensor Story
  • A sensor story consists of an actual sensor {a physical device or an app} and its event which triggers the actor story.
plus-mark
Actor story
  • An actor story consists of an actor {a physical device or an app} which once triggered by the sensor’s event performs a pre-defined physical or virtual action.
sensor-story-sensor
Sensor story
Sensor
Role
Just like in a traditional story the Sensor Role can be assumed by a leading character which, in this case, is a sensor. Sensors that assume the Sensor Role can register various events that will specific to each of them.
Push
Transmission
Sensor

Plenty of things can become Sensors ranging from web service accounts to numerous smart devices.

Sensors can realize ‘Events’ that you will choose the assist panel.

Any sensor
iMac((BLE))
sensor-story-event
Sensor story
Event
Event

Event holds the information about what kind of data Prota can receive from a particular sensor. Sensor story will be executed whenever Even meets certain Conditions.
receives a message
Light switch socket is turned on
Webcam detect some motion
sensor-story-event-condition
Sensor story
Event-Condition
Conditions

Once you set up the Event Conditions, Prota will know when it needs to execute the remaining Actor story.

Although setting the Event Conditions is not mandatory, it will allow you to execute your story in a specific way if necessary.

actor-story-actor
Actor Story
Actor
Role
Similarly to the Sensor’s Role, the Actor Role can be assumed by a device or an app which can perform a specific action whenever Sensor’s Event meets certain Conditions.
Push
Volumio
Actor

You can choose your story’s Actor from available devices and web services that are capable either to trigger virtual or physical actions.

Actors can realize ‘Actions’ that you will choose in the assist panel.

All actors
Light switch
Transmission BT
actor-story-action
Actor Story
Action
Action

Once you pick your lead Actor you may choose from its all possible actions to complete this story.

play the Volumio
Light switch socket turns off
add a new torrent file
action-instruction
Actor Story
Action - instruction
Instructions
Setting Instructions is also optional, unless your chosen Actor specifically requires some fields to be filled in.
condition-field
Conditions & Instructions
Condition options

Available Conditions will vary with every selected Sensor.

For example, if you choose your email account as a Sensor, you will be able to set a specific email subject or a sender’s address that will subsequently trigger your Action story.

  • If there are any required conditions you must fill them out to proceed to the next step.
instruction-field
Conditions & Instructions
Instruction fields

Instruction fields will also change with every selected Actor.

Instructions help you to execute your Actor story in a specific way. For example, define an email subject or automatically enclose a file.

  • If there are any required instructions, you must fill them out to proceed to the next step.
cite-bar
select-prota
set-sensor-actor
Cite other stories
Citing

You can use Stories created by others right away by simply citing them in your Prota.

Citing a story allows you to avoid writing it from the beginning, Stories app selects Sensor and Actor automatically. But you can always change any factors by using the assist panel.

scene-list-icon
scene-list
scene-taken
Stories History
Scene, Taken

Whenever you want to check whether any Stories have been triggered without your acknowledgment, you can do so from the Scene list.

If your Story has not been triggered, it means the conditions are wrong and the Scene list will display the NG (“No Good”) scene.

webhook-icon
Getting started
Webhook
With Webhook app you can connect 3rd party devices and apps that otherwise would not have a direct connection to Prota and automate the tedious tasks in your workflow.
incoming-hook
upgrade-prota
upgrade-prota-url
Types of hook
Incoming hook
Incoming webhook is a HTTP request sent by an external app or a device and which will be recognized by Prota as a Sensor Event.
outgoing-hook
select-webhook
set-instruction
Types of hook
Outgoing hook
Outgoing webhook is a HTTP request sent by Prota to an external device or an app. Outgoing webhooks are interpreted as actors in the Stories app.
Example 1
“Post a message to Slack when app upgrades are available.”
example1-1
example1-2
example1-3
example1-4
example1-1-5
example1-1-6
Example 2-1
“Turn off power when I’m not home (Geo fence - IFTTT ➔ OnOff)”
header-bar-1
example2-1-1
example2-1-2
header-bar-2
example2-2-1
example2-2-2
header-bar-3
example2-2-3
example2-2-4
Example 2-2
“Turn off power when I’m not home (Geo fence - IFTTT => OnOff)”
example3-1
example3-2
example3-3
example3-4
example3-5
Enjoy Stories & Webhook
Now you can make automation magically!
app-stories-webhook