Sequences
Configure and execute a serie of actions or sending messages, based on an event that occurred in the conversation.
All the sequences that are needed can be created, in any context of the conversation. But only one will remain active per user at any given time.
Can be very useful when it comes to sending reminder messages in the development of a sales funnels for instance.
To start a sequence, the following method is used, which can be called within an action block or in a callback in the Conversation class:
start_sequence "sign_up_sequence"
start_sequence "profile/sign_up_sequence"
Sequences are defined within the
sequences()
method of a Context
class by calling the following method:In turn, this will receive as parameters the name of the sequence and a block with one or several calls to the
past()
method, one for each action of the sequence.This last method will execute the code in the
block
argument, when the time defined in the time_elapsed
argument has elapsed since the start of the sequence.def sequences
sequence :sign_up_sequence do
past 20.minutes do
logger.debug "This will executed 20 minutes after secuence_start(:sign_up_sequence) was called"
end
past 3.hours do
logger.debug "This will executed 3 hours after secuence_start(:sign_up_sequence) was called"
end
past 2.days do
logger.debug "You've already got the idea ;)"
end
end
end
It will stop automatically after the execution of the last block in the sequence, but if it's necessary to stop it prematurely, the following method can be called:
The example below will attempt to get the user to complete the registration process by sending two reminders: one at
20 minutes
and one at 3 hours
.In case the user does the registration process, we will stop the sequence prematurely.
class MainContext < Conversation
def blocks
intent :greeting do
@reply.text "Hello!"
@rsp.quick_reply(
"To start, please create an account",
[
{
title: "Continue",
payload: "sign_up"
}
]
)
start_sequence :sign_up_sequence
end
postback :sign_up do
@reply.text "To create a new account please click in the button bellow."
@reply.url(
{
title: "Create a new User",
url: "https://kogno.io/sign_up"
}
)
stop_sequence :sign_up_sequence
end
end
def sequences
sequence :sign_up_sequence do
past 20.minutes do
@rsp.quick_reply(
"Don't forget to create your account.",
[
{
title: "Create an Account",
payload: "sign_up"
}
]
)
end
past 3.hours do
@rsp.text "Did you know that by creatig an account with us you'll receive a gift?"
@rsp.quick_reply(
"Don't miss this oportunity",
[
{
title: "Sign Up",
payload: "sign_up"
}
]
)
end
end
end
end
This functionality has a independent process that must be running by calling the following commands in terminal:
kogno sequences fg
kogno sequences start
It can also be started with the other Kongo daemons like
http
and schedule_messages
by running:kogno start
See the logs in
logs/sequences.log
.It could be the case when after the activation of a sequence, a user continues the conversation with the app and in between, receives a programmed message from an active sequence.
To avoid this problem, define the minimum time elapsed since the last message from the user, that the sequence must wait in order to execute the next block, by modifying the configuration file
config/application.rb
.config.sequences.time_elapsed_after_last_usage = 900 # 15 minutes
Last modified 10mo ago