Variables

If you're looking for help in using your Textline Variables, then look no further, you're in the right place!

Variables are a feature of Textline that allows you to set up Messages to send to Contacts that are generic but then pulls more specific information.  This information could be about the Contact or the Agent currently handling the Conversation.

Variables are currently available in Shortcuts and Announcements.  Below is a list of the Variables currently available in Textline.  There are some that are only applicable to certain sections of Textline and will be labeled as such.

In case your desired variable lacks information, we have also designed a system to have your variable fall back onto other information.  More on Fallbacks below.

Variables - Everywhere

Current Agent

This pulls information from the agent that is currently logged into Textline and performing the action of using a shortcut or sending an Announcement.  These are coming from the agent's profile page in settings.

Name: {{current_agent.name}}
Role: {{current_agent.role}}

Assigned Agent

This pulls information from the agent that is assigned to the conversation. These are coming from the agent's profile page in settings.

Name: {{assigned_agent.name}}
Role: {{assigned_agent.role}}

Department

This pulls information from the department that the conversation is currently taking place in or where the announcement is being sent from.

Name: {{department.name}}
Phone number: {{department.phone_number}}

Contact

This variable pulls information regarding the contact that you are sending the message to.  This set is unique in that we will not be able to document every variable possible, simply because we allow you to create custom fields in your Address Book.  If you are using a custom field that has a space in the title, replace the space with an underscore _ .  Note: The fields Notes, Tags, and custom fields using the checkbox type are not supported variables.

Name: {{contact.name}}
Phone Number: {{contact.phone_number}}
Custom fields in the Address Book: {{contact.custom_field}}

Date & Time

If you would like to have a variable put in the time or date in your messages, use the following variables.  These use the time and date from when the message is actually sent, so if you are sending an announcement to lots of contacts that takes time to send, it will be the time or date from when the message is actually sent, not when you created the announcement.

Time - 24hr: {{system.24hr}}
Time - AM/PM: {{system.ampm}}
Date - Day Mon Year: {{system.ddmmyyyy}}
Date - Mon Day, Year: {{system.mmddyyyy}}

Variables - Announcements

The below are Variables that are only usable in the Announcement feature.

Upload

This variable pulls information regarding the contact that you are sending the message to.  This variable set comes from the column headers in the CSV that you upload as the contact list for your Announcement.  This set is special in that we will not be able to document every variable possible because we cannot predict what you have added to your uploaded CSV (not yet at least).  If you are using a column header that has a space in the title, replace the space with an underscore _ .

Name: {{upload.name}}
Phone number: {{upload.phone_number}}
Custom Column: {{upload.custom_column}}

Fallback

As mentioned above, we have designed a Variable system that will allow you to choose the information that gets sent in case the Variable used lacks information.  This means that if you use a Variable in a Shortcut or Announcement, but the Variable returns an empty value for the Contact, then you can choose to look elsewhere for text.  This is done by placing a pipe | after your variable and then continuing on.  You can even use another variable as your fallback.  If you want to use text as a Fallback, make sure to encapsulate the text in quotation marks "like this".  Here are a few samples of fallbacks:

  • We want to use the name assigned agent on the conversation, but if there is none, then we use the current agent:

{{assigned_agent.name|current_agent.name}}

  • We want to use the name of the contact, but if there is none, just use the text Chewie

{{contact.name|"Chewie"}}

  • We want to use a custom Address Book field 1, but if there is no data, then use custom field 2, and finally if there is none there either, use the text Fastest Pilot in the Galaxy

{{contact.custom_field1|contact.custom_field2|"Fastest Pilot in the Galaxy"}}