Xenioo Official Docs
  • Welcome!
  • Product Overview
    • Definitions
    • Building & Sending
    • All Integrations
    • Mobile App
    • Artificial Intelligence
    • Reporting Dashboard
    • Professional Service & Support
    • Privacy & Security
    • GDPR
  • Basic Concepts
    • Your Account
      • The Trial plan
      • Upgrading your trial
      • Additional Packages
      • Canceling your current plan
      • Deleting your account
      • Messages Count
      • Data Retention
      • Multi-factor Authentication (MFA)
        • MFA Configuration
        • MFA Login
      • Multiple Owners
    • Designing your Chatbot
      • My Bots
      • Introduction
      • Flow Design
      • Behaviors
      • Interactions
      • Actions and Operations
    • Chatbot Details
      • Chatbot Settings
        • General Settings
        • Localization Settings
        • Conversation Settings
        • Integration Settings
        • Payment Integration Settings
        • Developers Setting
      • Teams
        • Team Permissions
        • Team Message Templates
        • Availability Calendars
        • Takeover Default Message
        • Team Member Access
      • Backup & Restore
      • Master and Child Bot
    • Publishing
      • Live & Draft Chatbots
      • Publish Your Bot
      • Channels
        • Web
          • Web Variables
          • WordPress
          • Widget Customization
            • Initialization
            • Scripting
        • WhatsApp
          • WhatsApp Variables
          • First Message Processing
          • Opt-in QR code generation
        • RCS
          • RCS Variables
          • Configuring Providers
            • LINK Mobility
          • Opt-in QR code generation
        • Google Business Messages (Deprecated)
          • Google Business Messages Variables
        • SMS
          • SMS Variables
          • Configuring Providers
            • LINK Mobility
        • Facebook
          • Facebook Ads Integration
          • Feed Integration
          • Messenger Referral
          • Facebook Variables
          • Moving users from an existing bot to Xenioo
        • Instagram
          • Instagram Variables
        • Telegram
          • Telegram Deep Linking
          • Telegram Variables
        • Slack
          • Configuring Slack
          • Slack Variables
        • Microsoft Teams
          • Microsoft Teams Variables
        • Discord
          • Discord Variables
        • Alexa
          • Troubleshooting
          • Alexa Variables
        • Phone
          • Phone Variables
          • Configuring Providers
            • Voximplant
        • Genesys
          • Genesys Variables
        • Viber
          • Viber Variables
        • Custom
          • REST Reference Guide
          • API Variables
  • Artificial Intelligence
    • NLP
      • Intents
      • Expressions
      • Entities
        • Creating Manually
        • Entity Types
        • Synonims
      • Training & Testing your Model
        • Using the NLP Parse Logs
        • Importing Intents From File
      • NLP Master
    • Large Language Models
      • Settings
      • Guidelines
      • Resources
      • Functions
      • Train & Test
  • Database
    • Xenioo Database
    • Collections
      • Import And Export Collections Data
    • Database API Interface
      • Url Filtering Syntax
      • Read Record
      • Save To Collection
      • Delete From Collection
      • Query Collection
        • Open Query
        • Read Records
      • CSV Direct Data
  • Broadcasts
    • Broadcasts
      • Settings
        • On Demand
          • HubSpot
        • On Date And Time
        • On Time
        • On Trigger
        • On Interval
        • On Conversation State Changed
    • Broadcast Widget Page
    • Campaigns
    • Distribution Lists
    • Audiences
    • Distribution Logs
  • Conversations
    • Conversations
    • My Conversations
    • Contacts
    • Chat Commands
    • Contact Details
  • Analytics
    • Dashboards
    • Goals
    • Audit Logs
    • Widgets
      • List of Widgets
  • Actions And Operations
    • Execution
      • Execution Diagram
    • Actions Availability
    • Variables and Tags
    • Dynamic Parsing And Content
    • Content
      • Text Action
      • Random Text Action
      • Quick Reply Action
      • Database Quick Reply Buttons Action
      • Quick Reply Array Action
      • Chat Delay Action
      • Phone Quick Reply Action
      • Email Quick Reply Action
      • Location Quick Reply Action
      • Display Location
      • Image Action
      • QR Code Action
      • Video Action
      • Audio Action
      • File Action
      • Url Action
      • NLP Topics Summary Action
      • Highly Structured Message
      • Custom Class
      • Comment Action
    • Input
      • Voice Recognition Action
      • Global Detection
        • Text Parse Action
        • NLP Processing Action
        • Dialogflow Detection Action
        • IBM Watson Assistant Intent Detection Action
        • OpenAI Assistant Detection
        • AI Detection
      • Generic Input Action
      • NLP Input Action
      • Number Input Action
      • Email Input Action
      • Phone Number Action
      • Media Attachment Action
      • Voice Input Action
      • Global Detection Action
      • OpenAI
        • OpenAI Assistant Input
        • OpenAI Assistant Detection
      • Dialogflow
        • Dialogflow Input Action
        • Dialogflow Detection Action
      • IBM Watson Assistant
        • IBM Watson Assistant Input Action
        • IBM Watson Assistant Detection Action
      • Large Language Models
        • AI Detection
        • AI Input
    • Flow
      • Agent State Check
      • Calendar Check
      • Channel Check
      • Conversation Bookmark Action
      • Create Conversation URL Action
      • Flow Control Action
      • Go To Action
      • Goal
      • Include Interaction Action
      • Log Message
      • Random Split Action
      • Reset Conversation Action
      • Set Chat Operator State Action
      • Schedule Behaviour Action
      • Tag Switch Action
      • Variable Switch Action
      • Set Context Action
      • Control Conversation Transfer Action
        • Forward Variable Value Action
    • Forms
      • Form Container
      • Fields
        • Text Box
        • Password
        • Text Area
        • Dropdown
        • Checkbox
        • Number
        • Date Picker
        • Time Picker
        • Calendar
        • File Upload
      • Layout
        • Image
        • Literal
        • Divider
        • Html Content
        • Custom CSS
    • Database
      • Load Single Record
      • Delete Records
      • Save Record
      • Save Raw Model
      • Query Collection Data
      • Move To Next Record
      • Set Field Filter Value
      • Order By Field
      • Set Field Value
      • Database Function
    • Cards
      • Carousel Template Action
      • List Card Template Action
      • Buttons Card Template Action
      • Card Container Action
      • Interactive Message Action
      • One-Time Notification Request Action
      • Database Carousel Action
      • Dynamic Carousel Action
      • Card And Menu Buttons
        • Postback Button Action
        • URL Button Action
        • Call Phone Button
        • Share Button Action
        • Nested Button Action
        • Interactive Button
    • Profile
      • Set Variable Action
      • Delete Variable Action
      • Set Tag Action
      • Delete Tag Action
      • Set Campaign Subscription Action
    • Privacy
      • Forget User
      • Privacy Opt-In
      • Privacy Flag Condition
    • IoT
      • Control Device State
      • Device State Switch
    • Integration
      • Call API Service Action
      • Execute Cloud Script Action
        • Base Conversation object methods
        • Firebase Connection methods
        • Xenioo Database Collection Methods
      • Execute Client Script Action
      • Send SMS Message
      • LINK Mobility Payment API Action
      • Marketing Platform Action
      • Dynamic Content Action
      • Post To Facebook Action
      • Firebase Database Action
      • ActiveCampaign Action
      • Zapier Webhook Action
      • Microsoft Teams Webhook Action
      • MailChimp Contact Action
      • Marketing Platform Action
      • Wordpress Search Action
      • RSS & Podcast Feed Action
      • SendGrid Mail Action
      • Send Mail Action
      • Send Custom Mail Action
  • Xenioo API
    • Choosing your API
    • Global Platform API
      • Authorization
      • Platform SSO
      • Bots
        • List
        • Publishing
          • Publish
          • Get Channel Settings
          • Set Channel Settings
        • Variables
        • Cloning and Referencing
          • Clone
          • Reference Clone
          • Attach Child
          • Detach Child
        • Backup And Restore
          • Backup
          • Restore
          • Restore With Overwrite
      • Teams
        • Members
          • List
          • Add Or Update
          • Delete
        • Profiles
          • List
          • Add Or Update
          • Delete
      • Conversations
        • Audiences
        • Audience Contacts
        • Entries
        • Share Url
      • NLP Query
      • Large Language Models
        • Settings
        • Guidelines
        • Add Resource
        • Delete Resource
        • Add Function
        • Delete Function
        • Train
        • Train State Check
        • Test
      • Statistics
        • Account Statistics Data
        • Bot Statistics Data
        • Report Files
        • Download Report File
      • Broadcasts
        • Broadcasts List
        • Broadcast State
  • Changelog
Powered by GitBook
On this page
  • Contacts Menu
  • Data Menu
  • Sort Menu
  • Filter Menu
  • Display Tags Menu
  • Send Message
  • Enable/Disable Chat Notifications
  • Retention

Was this helpful?

  1. Conversations

Contacts

PreviousMy ConversationsNextChat Commands

Last updated 9 months ago

Was this helpful?

The contacts list will contain all of the users that have talked with your chatbot. Users are added in this list in near real-time, as soon as the first interaction is fired.

Each user badge will display a number of information:

  1. Contact Name. This value might vary depending on the channel and on the variables that are available to the conversation. The value or:

    • If the first_name variable is set it is used. If also the last_name variable is set, it is used in junction.

    • If the first name is not available, and the contact channel is either WhatsApp, RCS or SMS, the user_phone_number is displayed

    • If the user_phone_number is not available, the default user_name value is used.

    • If none of these values is available, * Unknown * is displayed.

  2. Online State. A small green dot near the avatar image indicates that the user is currently online. Depending on the channel it may indicate actual current connection or an interaction happened in the last minutes.

  3. Last Seen. This is the amount of time since the last time your chatbot has had any interaction with this user.

  4. Subscribed: This is the amount of time since the very fist time your chatbot had a contact with this user.

  5. Avatar. This image is the user avatar, if available. Some channels will supply this value by default. Xenioo will display here any valid image you set in the profile_pic variable.

  6. Flag. This flag is based on the locale variable. If exposed by your channel, Xenioo will automatically fill it with the correct user related locale.

  7. Channel Icon. This icon let you know what is the user current communication channel.

  8. Operator State. This icon may appear depending on the operator state of the conversation.

Contacts Menu

The contacts menu can be accessed from the bolt-like icon you can see near the contacts search bar. Multiple quick filters and sorting feature are available from the contacts menu.

Data Menu

Export Users

Using this command will schedule an export of all the active conversation users into a comma separated CSV file. The file will contain a line for each user and all of the variables associated as columns. This feature is available only to premium accounts.

Import Users

The Import Users command will import users from a standard CSV file.

Users created with this import will automatically appear on the left side of the conversation section as empty conversations.

Every column of the input file will be automatically transformed into a conversation variable. There are no mandatory columns except channel: without the channel column, that assigns the conversation to a specific channel, the user will not be created.

If you wish to overwrite an existing user conversation data, include an Id column as the very first in your input file. Xenioo will automatically attempt to load the conversation with the specified id. If the conversation is not found, a new conversation will be created. Only user variables will be overwritten in your import. Existing users affected by the import will not see their conversation history deleted or altered.

When importing WhatsApp contacts make sure to have a column named user_phone_number specifying your contact's full phone number.

It's important to have the phone number starting with the country prefix, like +39 for Italy.

If this column is not available broadcasts will not be able to target this user later.

If you need to import Facebook users from another chatbot make sure to disengage to follow this small guide.

This feature is available only to premium accounts.

Sort Menu

From this menu you can change the way contacts are sorted in the contacts list. By default, Xenioo will sort all contacts by the Last Seen field which indicates the last time a user has interacted with the bot in any way. You can also chose to sort for First Seen (the very first time a user interacted with the bot) or Channel.

The last entry in this menu, named "Auto Sort" will change the automatic sort behaviour of the contacts view:

  • If enabled, contacts will automatically sorted on every update if any entry changes. If a user talks with the bot it will be moved automatically to the top

  • If disabled, contacts will not be sorted after initial refresh and will stay in their initial position regardless of updates.

You can chose the automatic sort mode that best suits your customers support/chat needs. The sort flag choice is stored in a cookie persisting trough sessions.

You can also enable or disable automatic sorting altogether. Using the "Auto Sort" menu, you can chose if Xenioo should automatically sort contacts based on updates received or keep the original sorting even if new conversations appear.

Filter Menu

This menu offers multiple quick filters that can be used with a single click and the option to create more complex audience filter.

All the filters, except the custom ones, can be joined together. You can simultaneously select a channel and a control state and a tag.

To clear a set filter just click again on the filter entry o click on the "Filtered View" close icon you see beside the filter label.

Ignore Empty Conversations

Web Chat Contacts behave slightly differently from other types of contacts as they tend to be more volatile: since by default there's no opt-in mechanism, users may come to your website, have a look at the chat area but never really interact with your chatbot.

Xenioo will automatically hide any user who did not have any conversation (that have never interacted) with your chatbot so that your conversations are kept alive only with engaged users. Using this command you can choose to hide or show these conversations while they are active. As the conversation is marked as idle by Xenioo it will be automatically deleted.

Display Tags Menu

This menu let you pick one or more tags that will be displayed directly in the contacts list.

All the tags selected will be displayed with a tick. If a contact has one of the selected tags assigned, it will be displayed directly. This will greatly help agents that will be able to see additional bits of information directly in the contacts list.

You can change the display settings for a specific tag by clicking on the tag in the contacts list. This will open the tag settings popup, where you can modify the text color, background color, icon, and display mode of the tag.

Tags selection and configuration are stored permanently for your specific user. Each agent can have a different configuration and display selection.

Send Message

The send message command will display the broadcasting widget that can is automatically configured for your bot. From there you will be able to select channels and broadcats that have been defined in your bot to send a new message to a contact.

Enable/Disable Chat Notifications

By default Xenioo will generate a desktop notification whenever a user sends a message in a taken over conversation. This is particularly useful when you need to oversee users support but cannot constantly keep the Xenioo conversation section opened. Use this menu to enable or disable these notifications.

Retention

Unless forcefully deleted, your contacts are kept forever.

Conversations instead are driven by your account retention value and are routinely deleted starting from the oldest and moving forward to the newest.

You can create more complex filters by using the Custom menu and creating a custom audience. If you wish to have the custom audience quickly accessible from the contacts filter menu, A maximum of 10 quick filters will be listed in the custom filters menu.

enable the "Add to conversation quick filter" toggle.