Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

The package in which you create a business process must depend on the Beesender BeesenderBotMaster package

Table of Contents

What elements make up a chatbot?

...

(blue star) Start event – use this element as the beginning of your process

(blue star) Beesender: Text message – use this element to send messages without buttons (for example, greeting, parting, some information, when you don’t expect a response to this message)

(blue star) Beesender: Button messageAsk question – use this element to send messages with buttons OR when you want to receive an answer to your question

(blue star) Beesender: Send image – use this element to send an image

(blue star) Beesender: Send file – use this element to send a file

(blue star) Beesender: Send location – use this element to send the location

(blue star) Exclusive gateway (OR) – Exclusive gateway (OR)

(blue star) Subprocess – build process using subprocess to increase the speed of the chatbot, and to call ready-made Beesender subprocesses

(blue star) End event – use this element as the ending of your process

Create a chatbot process

...

  1. Go to the section Process library Library and click New Process

  2. Fill in a name of your process and a code

  3. Go to the Parameters tab and create 3 required parameters:

Title

Code

Data type

ChatId

ChatId

Unique identifier

ClientId

ClientId

Unique identifier

OperatorId

OperatorId

Unique identifier

Let’s try to create the first chatbot message!

...

  1. Select the element

...

  1. Select Beesender: Text message from the

...

  1. User action panel

...

  1. Fill in the fields:

Filed

Value

ChatId

Set parameter ChatId

ClientId

Set parameter ClientId

OperatorId

Set parameter OperatorId

Text

Set your message, for example Hello

...

Now go back to your Creatio system and set your process to your chatbot. Don’t forget to add the channel on the Channels detail.

...

As you already know, the Beesender: Text message has the following mandatory parameters:

Filed

Value

ChatId

[#ChatId#]

ClientId

[#ClientId#]

OperatorId

[#OperatorId#]

Text

The message you want to send

In the Text field, you can not only write text but also enter the parameters read from the object. It can be like the name of the contact, today's date, and so on.

...

Follow the link to learn more about working with the [Formula] process element

Beesender:

...

Ask question

Info

Use Beesender: Button messageAsk question element to send messages with buttons OR when you want to receive an answer to your question.

The Beesender: Text messageAsk question has the following mandatory parameters:

Filed

Value

ChatId

[#ChatId#]

ClientId

[#ClientId#]

OperatorId

[#OperatorId#]

Message

The message you want to send

Button 1 - Button 9

The text displayed on the button for selecting the client's response to the chatbot. During the dialogue with the chatbot, only those buttons that are filled in are displayed

Answer

Leave this field blank

For example, let’s try to create the next case:

  1. Chatbot sends contact information (we will use the already configured logic)

  2. Chatbot asked: “Please confirm that the information provided is correct” and show 2 buttons:

    • Confirm

    • Decline

  3. If the client clicked Confirm, the bot writes: “Thank you, the information is confirmed

  4. If the client clicked decline, the bot writes: “Please enter a valid full name” and replaces the full name in the contact card with the information that the client enters

The scheme of this case:

...

Follow the next steps to build this case:

  1. Select the element User task

  2. Select Beesender: Ask question from the list

  3. Fill in the fields:

    • ChatId, ClientId, OperatorId

    • Message: Please confirm that the information provided is correct

    • Button 1: Confirm

    • Button 2: Decline

  4. Add element OR

  5. Click on a flow and set the condition:

    • parameter Answer from Beesender: Ask question element == parameter Button 1 from Beesender: Ask question element

      Image Added
  6. Add another flow from element OR and set the condition:

    • parameter Answer from Beesender: Ask question == parameter Button 2 from Beesender: Ask question element

      Image Added
  7. Add the last flow from element OR to Beesender: Ask question element and select flow type = Default type – this is necessary so that if the client doesn't select the buttons, but writes something, the process doesn't break, and repeats the previous question

    Image Added
  8. Add Beesender: Text message element on Confirm flow and field in fields:

    • ChatId, ClientId, OperatorId

    • Text: Thank you, the information is confirmed

  9. Add Beesender: Ask question element on Decline flow and field in fields:

    • ChatId, ClientId, OperatorId

    • Message: Please enter a valid full name

    • Leave all other fields blank

  10. Add Modify data element, select Contact object, where Id = Id from Read Contact data element

  11. Select column Full name and set to this field the parameter Answer from previous Beesender: Ask question element

  12. Image Added

    Save your process

    Image Added
  13. Go back to your channel and write a new message to trigger a chatbot

  14. Select buttons to see the result

...

Beesender subprocesses

The Beesender package includes several processes, that can be useful in your chatbot business process.

...