Custom Attributes

Custom Attributes

Enrich your customer data with Custom Attributes in Bevatel, enabling tracking of specific details like subscription plans, order history, and more to enhance customer insights.

Custom Attributes

Bevatel supports Custom Attributes other than standard data attributes (a default set of data about your conversations/contacts like Name, Email, Location, etc.). A Custom Attribute tracks facts about your contacts/conversations. The Custom Attribute can be anything, E.g.:

  1. Subscription plan
  2. Subscribed date
  3. Signup date
  4. Most ordered item
  5. Ordered product link
  6. Last transaction date

Notes
The only difference between custom and standard attributes is standard data attributes automatically get updated

Custom data attributes are the information you attached to conversations/customers, like how many times they've ordered a product when they sign up, or what plan they're on. So you can set whatever attributes you want to understand your customer/conversation better, and it will all show in Bevatel.

Add a new Custom Attribute

To add a new Custom Attribute, navigate to the Custom Attributes by clicking on Settings (1) -> Custom Attributes (2)
from the sidebar.


Click on the Add Custom Attributes (3) button available on the top right corner of the page, which will open a modal as shown below.


These are the inputs required to create the Custom Attribute:



Input
Description

Display name

Act as a label while rendering a Custom Attribute

Description

Description about the Custom Attribute

Type

Type of data it will store. Currently supports Text, Number, Link, and Date

Key

Unique identifier attached to the Custom Attribute



Notes
You cannot create a Custom Attribute with the same key twice in the account.


Once you enter the details, click on the Create button. A message "Custom Attribute added successfully" will be displayed if the request is successful.

Conversation Custom Attributes

1. Set attributes via the SDK method

You can set Custom Attributes for each conversation using the SDK  setConversationCustomAttributes method and also delete the attribute using the deleteConversationCustomAttribute method.

2. Set attributes via the contact side panel

After creating a conversation Custom Attribute, you will be able to add these attributes to the conversation via the conversation sidebar.

It will open an attribute dropdown selector, then select the attribute that you want to add




Enter a valid value and click on the Create button. A message "Attribute added successfully" will be displayed if the request is successful.



Also, you could see the actions like edit/delete/copy by hovering on the attribute.





Custom attributes

There are two ways to set Custom Attributes for contacts

1. Set attributes via the SDK method

To set a Custom attributes call setCustomAttributes the method as follows,

  1. window.$bevatel.setCustomAttributes({
      key: value,
      // Key is a unique identifier which is already defined while creating a Custom attribute
      // Value should be based on type (Currently support Number, Date, String and Number)
      // Double-check that your keys always have a JSON-valid value
      // You need to flatten nested JSON structure while using this function
    });
Ex:

  1. window.$bevatel.setCustomAttributes({
      plan: "premium",
      signUpDate: new Date(),
    });
    

You can view these attributes in the contact side panel To delete a Custom Attribute, use deleteCustomAttribute as following
  1. window.$bevatel.deleteCustomAttribute("attribute-key");

Ex:
  1. window.$bevatel.deleteCustomAttribute("signUpDate");
Notes
Prior to version v1.22 , all the attributes rendered as text. Please create new definition to display the value properly

2. Set attributes via the contact side panel

After creating the Custom Attribute, you will be able to add these attributes to the contact via the conversation/contact sidebar.


It will open an attribute dropdown selector, then select the attribute that you want to add





Enter a valid value, and click on the Create button. A message "Attribute added successfully" will be displayed if the request is successful.





Also, you could see the actions like edit/delete/copy by hovering on the attribute.


    • Related Articles

    • Introduction

      Introduction "Connect Bevatel to multiple channels for unified communication. Manage conversations, collaborate on the go with mobile apps, and explore Bevatel's features in this user guide." Integrate your Bevatel account with multiple conversation ...
    • Priority

      "Bevatel's priority feature lets you assign urgency levels (Low, Medium, High, Urgent) to conversations for effective workload management." Assigning a priority Prioritizing conversations is essential for managing your workload effectively, ensuring ...
    • Website Live Chat

      Add and Configure Easily set up and customize your website's live chat channel, including greetings, agent assignments, and business hours, with step-by-step instructions. Add and configure your website channel Step 1. Go to the Inboxes page. Go to ...
    • Pre Chat Form

      The Pre-chat form in the website's live chat allows collection of contact/conversation information, including standard and custom fields, with customizable options for field management and validation. Collect the contact/conversation information ...
    • API Channel

      Create Channel Effortlessly set up an API channel inbox in Bevatel, allowing you to send and receive messages using Bevatel APIs with simple configuration steps. How to create an API channel inbox? Setting up an API channel consists of the following ...