4. How to Edit a Client

Once a client exists in Wifox, you can fine-tune their profile, track interactions, upload documents, and manage accounts—all from the Edit window. Follow these numbered steps to ensure nothing is overlooked.

After creating a client, the Edit window will open automatically.

In the Edit window, you can:

Edit the client’s information entered during the creation stage (except Type and Project). This also includes reassigning clients to another desk or status.
Add or edit Actions: comments, notes, and other relevant information within the CRM.
Add or edit Requests: for instance, support tickets, call requests, etc.
Upload Documents: passport or ID, and bank card (front and back).
Check the client’s Transactions.
Add or edit the client’s Accounts and linked Assets (including currency and balance).

Note: Information about the client’s Requests, Transactions, and Accounts is pulled automatically from the relevant modules.

1. Open the Client’s Record

In the Clients list, locate the row for the client you want to edit.

Locate your client:
Use the Search… box at the top of the Clients list to type any part of their Email, Full name, or ID. (Instant filtering, partial matches allowed.)
Or click Filter ► Desk, Project, or Created date to narrow by scope.

Pro Tip: Bookmark heavy-use filters (e.g. “All Personal clients in Acme Project”) via the URL link icon next to the page title.

Enter Edit mode:
Click the pencil icon in the Actions column for that row.
The right-hand drawer slides out, pre‐loaded on the General tab.

Quick Create Action from Clients List
You can create an action directly from the Clients table without opening the client record.

In the Clients list:

Locate the client row.
In the Actions column, click the Create Action icon.
The Action creation drawer opens.
The selected client is automatically prefilled.
Complete the required fields and click Save or Save and create new.

This shortcut allows agents to log calls, notes, or comments without navigating into the client profile first.

Permission note:
The Create action option is visible only to roles with access to Clients → Actions.
Users without this permission will not see the option.

Note: If you click the client’s Email link instead, you’ll land on the same drawer but can immediately jump to any other tab.

2. Navigate the Tabs

At the top of the client’s detail view you’ll see these tabs:

General: Core profile fields you can edit
Actions: Log calls, notes & follow-ups
Documents: KYC uploads (IDs, bank cards, proof of funds)
Requests: Client-generated tickets and ad hoc data requests
Transactions: All ledger entries for this client (read-only)
Accounts: Create/manage asset or bank accounts linked to this client
Agreements: View signed contracts, NDAs, service agreements
Logs: Complete audit trail of every field change with user/timestamp details

Pro Tip: Press Ctrl + F inside the drawer to quickly find any field or label.

General Tab

1. Balance (Read-Only Financial Summary)

If Core Banking is enabled in your environment, the client’s total balance is displayed at the top of the client card.

Location:
Visible in the Client View drawer
Displayed in the header section of the Client View and Client Edit screens
Field label: Balance
Type: Numeric (float)
Editable: No (read-only)

The Balance represents the client’s total aggregated amount across all linked assets.

Important:

The value is automatically retrieved from the Core Banking microservice.
The CRM does not calculate this amount locally within the client module.
If Core Banking is unavailable, the Balance field will not be displayed at all.
This field is informational only and cannot be modified manually.

Use case: Agents can instantly see the client’s financial standing without switching to the Accounts or Assets tabs.

2. Personal

Type:
Personal clients have first/last names, DOB, risk fields.
Business clients use the 3-step wizard (company profile + UBO + members).

Status: Default or any custom statuses you’ve configured (e.g. “VIP”, “High-Risk”).

When creating a new Client status in Settings → Configurations → Statuses, make sure to define the Order field.
The Order value determines how statuses are displayed in dropdowns and lists. Statuses are sorted in ascending order based on this value.

If the Order field is not set, the status may appear in an unexpected position in the interface.

Name & Contact:
First name, Last name: Displayed on statements, emails, and internal lists.
Phone number (required) & Additional phone number (optional): Used for SMS alerts or 2FA.

Date of Birth:
Opens a date picker; used for age verification.
Example: You might block accounts under age 18.

External ID: Your own CRM or partner reference number (e.g. “Zendesk User #1234”).

Passport: Enter passport number if you collect it for KYC.

Nationality: Impacts tax or compliance rules.

Risk level: Your internal scale (e.g. Low, Medium, High)—drives transaction limits.

AML Screening: Free-form field to paste screening summary or pass/fail status.

Warning: Changing Type from Business→Personal is not allowed after initial creation.

3. Billing:
Country: Dropdown list of ISO country codes.
Region: State/province field (free text).
City, Address, Postcode: Standard postal fields.

Use case: Some payment rails require exact match between billing address and card on file.

4. Affiliation
Controls where the client “lives” in your operational hierarchy:

Project: Required for scoping data and routing workflows.
Desk: Optional sub-group within a Project (e.g. “LOAN desk” vs “ONBOARDING desk”).
Manager: The internal employee accountable for this client.
Company fee group: Assigns tiered pricing or service-level agreements.
AffiliateID: Partner or campaign code for revenue sharing.
Sub ID: Optional secondary tracking or sub‑campaign identifier.
Verification level: KYC method requested (Email, Video, In-person).
Verification status: Init, Pending, Approved, Rejected.

Example: Jane Doe is in Project = “Acme USA,” Desk = “Sales,” Manager = “Bob.”

5. Credentials
Email: Login ID (read-only here).
Password: Must meet complexity: ≥8 chars, uppercase, lowercase, digit, special char.
✨ Sparkle auto-generates a random secure password.
👁️ Eye toggles show/hide.

Tip: Rotate client passwords quarterly by clicking ✨ and emailing the new credentials.

6. Additional
A JSON-style tree picker for arbitrarily structured metadata:
Click the + to append a new key/value.
Rearrange, filter, or delete entries.

Multi-Select Display Behavior
For multi-select custom fields:

Selected values are displayed as individual chips inside the field.
If the number of selected values exceeds the available field width, the interface collapses the overflow into a “+N more” indicator.
Clicking the field expands the dropdown, where all selected values are visible and can be removed.

This keeps the interface compact while preserving full visibility when editing.

Use cases:

Store third-party IDs (e.g. “StripeCustomerID”:“cus_ABC123”).

Attach ad-hoc flags (e.g. “VIP: true”).

7. Two-Factor Authentication (2FA)
Displays any methods already set up (Email, SMS, TOTP).
Hover on a non-default method to reveal Make default or Delete.

Note: You cannot add 2FA methods here—clients configure those on first login.

8. Description: Supports long-form text (up to 2000 characters). Good for case notes or behavioral observations.

9. State & Create asset & Save
State dropdown (top-right) toggles among Active, Deactivated, Suspended.
Deactivated preserves the record but blocks login/assignment.
Suspended can be used for temporary holds pending review.

Create asset
Located in the top‐right header of the General tab, immediately to the right of the State dropdown. When checked, this option auto-provisions a new asset ledger entry for the client as soon as you hit Save.

If changes are not saved, check field validation limits (e.g. text length) and required fields.

Actions Tab

Log every meaningful interaction:

Click + Add (upper right in the Actions block header).

Fast “Create Action” from Client Card

Managers can quickly create an Action directly from the client card without leaving their workflow.

Location
Inside the Client card:
/clients/view/{clientId}/client

In the Actions block header (above the table), a + Add button is available.

Permissions
The + Add button is visible only to roles that have permission to create Actions.
If the role does not have create permission, the button is not displayed.

Behavior
Clicking + Add:
Opens the Action creation UI (drawer or modal)
The current client is automatically prefilled
The client field is locked and cannot be changed

On Save
The action is created
The modal/drawer closes
The Actions table refreshes automatically
The new record appears without a full page reload

This allows managers to log calls, notes, or reminders instantly while reviewing the client profile.

Type:

Note: Internal memos (“Called compliance – waiting docs.”)
Call: Schedule a follow-up call—requires an Action date.
Comment: Public-facing remarks (e.g. “Client agreed to terms”).
Manager dropdown: Who’s responsible for follow-up.
Text box: Detail your note/call/comment.
Save or Save and create new.

Save and create new

In addition to the standard Save button, the Action drawer includes a Save and create new option.
Button behavior:

Save:
Saves the action
Closes the drawer (default behavior)

Save and create new:
Saves the action
Keeps the drawer open
Resets the form for creating a new action
Preserves the selected Client and Manager
Clears Type, Subtype (if applicable), and Text fields
Resets validation state

This feature allows agents to quickly create multiple consecutive actions without reopening the drawer.

Example use case: An agent logs several follow-up calls or notes in sequence for the same client.

Editing Action Type and Subtype

Users with Edit Action permissions (or the action creator) can modify the action’s Type and Subtype if needed.
This is useful in cases where an incorrect subtype was initially selected (for example, choosing the wrong call category).

To change it:

Open the action from the Actions tab.
Click Edit.
Select a different Type or Subtype from the dropdown.
Click Save.

All changes are recorded in the Logs tab for audit purposes.

Documents Tab

Upload or replace verification documents by dragging or browsing to add images for:

Bank card (front) (Step #1) & (back) (Step #2): Required for payments.
Passport or ID (Step #3): Government-issued photo ID.
Source of funds (Step #4): e.g. Pay slip PDF, bank statement.
Drag-and-drop or click to browse; valid formats .jpg, .jpeg, .png.

Auto-save on upload; look for the thumbnail preview to confirm success.

Requests Tab

1. Click +Add in the top-right.

2. Fill in:
Name: Short title (“Upload proof of address”).
Time range: When you need it completed.
Type: e.g. Document Request, Support Ticket.
Description: Full instructions or context.
Additional information: Use the JSON tree for structured data.
Attach files: PDFs, screenshots.
Save .

Note: New requests will appear in this list with status and creation date.

Transactions Tab

Read-only ledger of every monetary event for this client: Deposits, withdrawals, fees, adjustments.

Columns include Date, Type, Amount, Currency, Balance.

Pro Tip: Filter by date or type to investigate anomalies.

Accounts Tab

1. Click + Add in the top-right.

Provision new asset wallets or bank links:
Type: e.g. fiat, crypto, e-wallet.
External ID: Bank account number or integration reference.
Platform: Which service (e.g. Stripe, Utip, Binance).
Save.

Each account row shows Status (Active/Inactive), UID, Owner, Created.

Assets Tab

The Assets tab displays all asset entries (wallets, balances, or positions) associated with a specific client.
This tab is available to users whose role has the Assets → View permission enabled in the Roles module.

Use this tab to review, track, or verify every asset currently held by the client.
Each entry includes key information such as:

Asset type (e.g. fiat, crypto, tokenized balance)
Currency and amount
Linked account ID
Status (Active / Inactive)
Date created and last update

To enable the tab for a user role:

Go to Roles → Edit Role.
Expand the Clients section.
Check the box Assets → View (and Edit if required).
Save changes.
Once enabled, the Assets tab becomes visible in the client’s Edit view.

At the top-right of the General tab, next to the State dropdown, you’ll see a checkbox Create asset.
When checked, this option automatically creates a default asset record for the client upon saving, if none exists yet.
This ensures every new client has at least one corresponding asset entry linked to their profile.

Authorized users can:

View detailed balances and currency allocations
Adjust statuses or link assets to new accounts (if “Edit” permission is enabled)
Export asset data for reconciliation or reporting

Agreements Tab

Lists PDF or link to signed service agreements, NDAs, or other legal documents.

Read-only; to upload or modify agreements, use the Agreements module in the sidebar.

Logs Tab

The ultimate audit resource:
Every field change is logged with User, Timestamp, Old value, New value.
Search within logs by keyword or date.

Use case: Prove who deactivated a client or changed their fee group for compliance audits.

Final Save & Exit

Wherever you make edits, look for a Save button and confirm it turns green.
Closing the drawer (× in top-left) will prompt you if you have unsaved changes.
After a major batch update, run a filter to verify that all expected changes appear in the list view.

By following this comprehensive guide, you’ll ensure every client record is complete, traceable, and compliant with your organization’s policies—and you’ll maximize the power of Wifox’s modular CRM to keep your data accurate and your teams aligned.