Skip to main content

Property Builder

Property Builder Module: Friendly Configuration Guide

Hello! Welcome to the PropBuilder Module configuration. This module is like a helper that organizes and saves important information for your bot, such as names, customer data, or anything you need to use later. Think of it as a magic notebook where you write something down and then paste it in the right place. You configure everything in a simple window, without any programming needed!

What does the PropBuilder Module do?​

The PropBuilder Module tells your bot:

  • What information to take (for example, the name someone gave you in a chat).
  • Where to save it (such as in a customer field or in the chat history).

You'll do this in a popup window that appears on your screen, with two easy-to-fill boxes.

Step-by-Step Configuration in the Popup Window​

When you open this tool, you'll see a window titled "PropBuilder Configuration". Here's how to configure it:

1. Define Where the Information Comes From (Source)​

  • Where: The "Source" text box.
  • What it does: Here you tell the bot what information to take, like something someone wrote in the chat or data you already have saved.
  • How to set it up: Write the "origin" of the information. For example, if you want to use the name someone gave, you might write something like "communication.message" (this depends on how your system is configured, but someone on the team can give you the exact names). This field is mandatory!

Example: Write "communication.name" if you want to take the name someone sent in the chat.

2. Decide Where to Save the Information (Target)​

  • Where: The "Target" text box.
  • What it does: Here you tell the bot where to put that information, such as in a customer profile or in a special place in the chat.
  • How to set it up: Write the "destination" using a special format with "@" to indicate where it goes. For example, "@client.name@" saves the data in the customer's name. Your team can give you a list of options like "@communication.note@" or "@client.phone@". This field is also mandatory!

Example: Write "@client.name@" to save the name in the customer profile.

3. Save Your Configuration​

  • Where: The "Save" button at the end of the window.
  • What it does: Saves the instructions so the bot knows what to do with the information.
  • How to set it up: Click "Save" when you've filled in both fields. If everything is correct, the window will close and a message will appear saying it was saved successfully. If you forgot something, it will ask you to complete it.

Tip: Make sure both fields are filled in before saving.

What Happens When It Runs?​

  1. The bot looks for the information you told it in "Source" (for example, a name like "Anna" that someone wrote).
  2. It saves it in the place you indicated in "Target" (like the customer's "name" field).
  3. Then, it continues with the next step you have configured for your bot.

Practical Example​

Imagine your bot is chatting with someone in an online store:

  1. You open the "PropBuilder Configuration" popup window.
  2. In "Source", you write "communication.message" (assuming that's where the name the person gave is, like "My name is John").
  3. In "Target", you write "@client.name@" to save "John" in the customer profile.
  4. You click "Save".

Result: If someone says "My name is John", the bot saves "John" as the customer name and can use it later, like in a message that says "Hello John, what do you need?".

Simplified Special Tricks​

Saving in Different Places​

  • What it does: You can save things in the customer profile (like "@client.name@") or in the chat (like "@communication.note@").
  • How to set it up: Use the format with "@" that your team gives you. For example, "@client.phone@" for a phone number.

Example: If someone gives their phone, you put "communication.phone" in "Source" and "@client.phone@" in "Target".

Using Information from Previous Steps​

  • What it does: If someone already gave some data before (like their email), you can take it and save it wherever you want.
  • How to set it up: Just write the correct "Source" (like "communication.email") and the bot will find it automatically.

Example: "Source: communication.email" and "Target: @client.email@" saves the email from the chat to the profile.

Troubleshooting Tips​

  • Can't save? Check that you've filled in "Source" and "Target". They're mandatory.
  • Data not saving where you expected? Confirm with your team that the "Target" is correctly written (like "@client.name@" instead of "@customer.name@").
  • Can't find the information? Make sure the "Source" is correct and that information is available in the chat.

That's it! With this, your bot can take information and organize it however you want. Fill in the two fields, save them, and watch how the bot starts saving data usefully. If something doesn't work, check the names you used or ask for help from whoever manages the system. Let's get configuring!