How to use attributes

Image of an author
Luiza Jurczyk
3 min read
updated: Jul 21, 2026

Attributes save information about the ongoing conversation and help to reuse them in the chat.

Default AttributesLink icon

ChatBot.com automatically collects data about your users from integrated apps. Let’s use one of them to create a nice personalized Welcome Interaction. The following example uses the Facebook Messenger integration.

  1. Create a new story and add an interaction.
  2. Go to bot responses, add text and inside your response type double curly brackets to call the attributes {{ ... }}. Keep Default and user attributes selected.

Text response in ChatBot.com with double curly brackets opening the attribute list and Facebook integration

  1. Find Facebook integration and select User name.

Facebook User name default attribute chosen in a ChatBot.com text response

  1. Add some text and save the interaction.

Bot text response that pulls the user name attribute from Messenger in ChatBot.com

  1. The attribute is ready. The bot will pull the information from Messenger and display the user name in the place of the attribute.

Collecting user attributesLink icon

User attributes allow you to store any value you want. To get the data you can use system or user entities. In the following example, we’ll be saving email address using the emai system entity.

  1. Create a new story and add an interaction. Name it Get email.
  2. Add the sys.email entity to the user says section. To do so, type two curly brackets and select .sys.email and name your attribute. FInd out more about this entity here.

User says field with the sys.email entity selected and a named attribute in ChatBot.com

  1. Add a few similar user says together with the entity.

Several similar user says phrases combined with an entity to collect user attributes

  1. Go to the bot responses section and add a new text response. Type again double curly brackets to view available attributes and select the one we’ve just created called user_email.

Text response using the user_email attribute chosen from the available attributes list

  1. Save your work. Your attribute is set and ready.
You can pass the value of your attributes by webhooks. You’ll find it in the JSON assigned to the parameter.
You can pass the value of your attributes by webhooks. You’ll find it in the JSON assigned to the parameter.

Use Ask the Question action to collect attributesLink icon

You can prompt users to fill the attributes using the Ask a Question action. Ask a Question offers a variety of options, that can be used to gain new leads, collect orders and much more.

  1. In the Interaction view, select Bot responses. Here you’ll find the Ask a Question action.

Ask a Question action in the Bot responses of a ChatBot.com interaction

  1. Configure the action. If you need help, please refer to this article.

Configured Ask a Question action that stores the value entered by users as an attribute

  1. Now you can reuse the value entered by users in your story. Type two curly brackets {{ ... }}. The system will automatically show you available attributes.

Bot response reusing a collected attribute with double curly brackets in ChatBot.com

  1. Now save the interaction. When this bot response is triggered, the bot will display the value entered by the user.
You can also pass the attribute values by other bot responses, such as quick replies, cards and buttons and with webhooks.
You can also pass the attribute values by other bot responses, such as quick replies, cards and buttons and with webhooks.

How to fill AttributesLink icon

It’s possible to send any parameters during the ongoing conversation. They can substitute already existing parameters or create a new one that can be used at the specific scenario stage.

Parameters can be sent either in endpoint /query or as an answer for incoming webhook. Attributes are used as metadata in archives.
Parameters can be sent either in endpoint /query or as an answer for incoming webhook. Attributes are used as metadata in archives.

Was this article helpful?

Got it!

Thanks for your feedback.

Thank you!

We’re happy to help.

Ready for more than a chatbot?
Try AI Agent in Text.

AI Agent trains on your data, resolves issues across live chat and help desk, and takes real actions in your business systems.

14-day free trial No credit card required