{"id":1795,"date":"2025-11-28T21:33:41","date_gmt":"2025-11-28T21:33:41","guid":{"rendered":"https:\/\/devad.io\/guides\/?p=1795"},"modified":"2026-01-28T18:21:52","modified_gmt":"2026-01-28T18:21:52","slug":"user-management","status":"publish","type":"post","link":"https:\/\/devad.io\/guides\/chat-devad-io-docs\/user-management\/","title":{"rendered":"User Management"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" id=\"manage-users-overview\">Comprehensive User Management<\/h2>\n\n\n\n<p>Efficiently administering your user base is crucial for support operations. You can fully manage users directly from the <strong>Users area<\/strong> located in the left-hand menu of your admin dashboard.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"importing-and-searching\">Importing and Searching Users<\/h3>\n\n\n\n<p>To bulk onboard users, navigate to <strong>Settings &gt; Users &gt; Import users<\/strong>. The system currently supports <strong>CSV files<\/strong> exclusively. A template CSV file is available for download within that section to guide your formatting. In this template, the first row serves as the header. If you wish to import specific data points like &#8220;Height&#8221; or &#8220;Hair color,&#8221; you must first add them as <strong>Custom User Fields<\/strong> via <em>Settings &gt; Users &gt; Custom fields<\/em>.<\/p>\n\n\n\n<p>Locating specific individuals is streamlined through the search function. You can query the database using the user&#8217;s name, surname, email address, or any defined custom fields.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"deleting-users\">Deleting Users<\/h3>\n\n\n\n<p>To remove a single user, open their User Edit box and click the <strong>Delete user<\/strong> button. For bulk actions, navigate to the Users table, select multiple users via the checkboxes, and click the <strong>Delete icon<\/strong> in the top right corner.<\/p>\n\n\n\n<p><strong>Permanent Deletion<\/strong>! When a user is deleted, all their conversations, messages, and attachments (including those on AWS S3) are permanently removed. <strong>Visitors<\/strong> are automatically deleted every 24 hours.<\/p>\n\n\n\n<p>If a previously deleted user returns to your website, a completely new user profile is automatically created for them.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"merging-and-customizing\">Merging Users &amp; Custom Columns<\/h3>\n\n\n\n<p><strong>Merging Profiles:<\/strong> You can consolidate two user profiles directly from the user table. Simply select two users and click the <strong>Merge Users<\/strong> button at the top. All conversations will be combined under the new user account, and the system will intelligently merge relevant personal details.<\/p>\n\n\n\n<p><strong>Additional Table Columns:<\/strong> To view more data at a glance, go to <em>Settings &gt; Admin &gt; Users table additional columns<\/em>. Add columns using the <strong>slug<\/strong> of the user detail. The slug must be lowercase with spaces replaced by hyphens (e.g., &#8220;Date of birth&#8221; becomes <code>date-of-birth<\/code>).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"user-types-and-roles\">User Types &amp; Roles<\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>Type<\/th><th>Description<\/th><\/tr><tr><td><strong>User<\/strong><\/td><td>A standard &#8220;user&#8221; is any registered individual associated with a valid email address.<\/td><\/tr><tr><td><strong>Lead<\/strong><\/td><td>A &#8220;lead&#8221; is a user without specific details (like a name) who is automatically registered after initiating at least one conversation.<\/td><\/tr><tr><td><strong>Visitor<\/strong><\/td><td>A &#8220;visitor&#8221; is a user currently browsing who has not yet started a conversation. Note that visitors are automatically purged from the system every 24 hours.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"manage-agents-and-admins\">Manage Agents and Admins<\/h2>\n\n\n\n<p>You can create, manage, and delete agents and administrators directly from the Users area. To create a new team member, click the <strong>Add user<\/strong> button in the top right corner.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Privileges:<\/strong> Configure permissions via <em>Settings > Admin > Agent privileges<\/em>.<\/li>\n\n\n\n<li><strong>Supervisors:<\/strong> Create special agents with extended privileges at <em>Settings > Admin > Supervisor<\/em>. You can add multiple supervisors by entering comma-separated Admin IDs.<\/li>\n\n\n\n<li><strong>WordPress Integration:<\/strong> Upon activating the plugin, an admin account is automatically created matching your current WordPress credentials.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"collecting-user-details-registration\">Collecting User Details &amp; Registration<\/h2>\n\n\n\n<p>Gathering user data such as names and emails is essential for follow-up. This can be achieved via <strong>Chatbot Flows<\/strong>, <strong>Follow-up messages<\/strong>, or the <strong>Registration Form<\/strong>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"registration-settings\">Registration &amp; Login Forms<\/h3>\n\n\n\n<p>The registration form acts as a pre-chat gate, requiring users to enter specific details before engaging. You can configure this in <em>Settings &gt; Users<\/em>.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Pre-Chat Form:<\/strong> You can limit the form to specific fields (e.g., just the email or name) by selecting &#8220;Registration form&#8221; under the <em>Require registration<\/em> option and enabling specific fields in the <em>Registration fields<\/em> list.<\/li>\n\n\n\n<li><strong>Login Logic:<\/strong> The login form appears only if the email field is enabled. If the user system is set to &#8220;WordPress,&#8221; the password field is mandatory.<\/li>\n\n\n\n<li><strong>Duplicate Emails:<\/strong> If a user attempts to register with an existing email, an <strong>OTP (One-Time Password)<\/strong> is sent to facilitate login. This prevents duplicate registrations, which are rare in real-world scenarios as users typically stay logged in.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"otp-verification\">OTP Verification<\/h3>\n\n\n\n<p>The OTP feature validates emails by sending a one-time code that the user must enter. Enable this via <em>Settings &gt; Users &gt; Email verification<\/em>. Even if disabled, the OTP system triggers automatically if a user tries to register an already existing email.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"advanced-authentication\">Advanced Authentication<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"login-verification-url\">Login Verification URL<\/h3>\n\n\n\n<p>This feature allows authentication via an external source. The system sends a request to your specified URL (<em>Settings &gt; Users &gt; Login verification URL<\/em>), appending the `email` and `password` as parameters.<br>Example: <code>https:\/\/example.com\/login.php?email=user@mail.com&amp;password=123<\/code>.<\/p>\n\n\n\n<p>The external URL must respond with a JSON object formatted as follows:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n\"first_name\": \"John\",\n\"last_name\": \"Doe\",\n\"email\": \"john@example.com\",\n\"profile_image\": \"https:\/\/chat.devad.io\/user.svg\",\n\"department\": null,\n\"password\": \"\",\n\"details\": {\n\"location\": &#91; \"Location\", \"New York, United States\" ],\n\"country_code\": &#91; \"Country code\", \"America\/New_York\" ]\n}\n}<\/code><\/pre>\n\n\n\n<p><em>Note: The value <code>first_name<\/code> is required.<\/em><\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"magic-link-login\">Login Link &amp; Forgot Password<\/h3>\n\n\n\n<p>If enabled (under &#8220;Require registration&#8221;), users can click &#8220;Forgot password&#8221; to receive a <strong>Magic Login Link<\/strong> via email. Clicking this link logs them in automatically. You can customize the email template at <em>Settings &gt; Users &gt; Login link email<\/em>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"real-time-monitoring\">Real-Time Monitoring &amp; Notifications<\/h2>\n\n\n\n<p><strong>Online Notifications!<br><\/strong>To receive notifications for online users (Visitors and Leads included), enable <strong>Pusher<\/strong> in settings. Note: Notifications are sent once per user every 24 hours.<\/p>\n\n\n\n<p>New users populate the user table in real time. To view all active visitors, enable <em>Settings &gt; Users &gt; Register all visitors<\/em>.<\/p>\n\n\n\n<p><strong>Away Mode:<\/strong> If an agent or admin is inactive for 10 minutes (no clicks, movements, or key presses), their status is automatically set to &#8220;Offline&#8221;. This requires <strong>Pusher<\/strong> to be enabled and does not function on mobile devices.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Comprehensive User Management Efficiently administering your user base is crucial for support operations. You can fully manage users directly from the Users area located in&#8230;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"_gspb_post_css":"","pgc_sgb_lightbox_settings":"","footnotes":"","_siteseo_titles_title":"","_siteseo_titles_desc":"","_siteseo_analysis_target_kw":"","_siteseo_robots_canonical":"","_siteseo_robots_index":"","_siteseo_robots_follow":"","_siteseo_robots_primary_cat":"","_siteseo_social_fb_title":"","_siteseo_social_fb_desc":"","_siteseo_social_fb_img":"","_siteseo_social_twitter_title":"","_siteseo_social_twitter_desc":"","_siteseo_social_twitter_img":""},"categories":[2],"tags":[],"class_list":["post-1795","post","type-post","status-publish","format-standard","hentry","category-chat-devad-io-docs"],"acf":[],"menu_order":0,"_links":{"self":[{"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/posts\/1795","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/comments?post=1795"}],"version-history":[{"count":1,"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/posts\/1795\/revisions"}],"predecessor-version":[{"id":1796,"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/posts\/1795\/revisions\/1796"}],"wp:attachment":[{"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/media?parent=1795"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/categories?post=1795"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devad.io\/guides\/wp-json\/wp\/v2\/tags?post=1795"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}