Portfolio
The Portfolio page is where you manage all your accounts and contacts. You can import accounts in bulk, filter them by status, and drill down into individual cases.
Uploading Accounts
- Click the Upload Portfolio button at the top of the page.
- Drag and drop a CSV or Excel file, or click to browse.
- Fynex will detect the columns in your file and show a preview.
- Map each column to the corresponding field (contact name, email, phone, amount, due date, reference, etc.).
- Click Import to load the accounts.
TIP
Supported formats: CSV, XLSX, XLS. There is no hard limit on the number of rows — Fynex processes thousands of accounts in seconds.
Required and Optional Fields
| Field | Required | Description |
|---|---|---|
| Contact name | Yes | Full name of the debtor |
| Total amount | Yes | Total debt amount |
| No | Used for email channel | |
| Phone | No | Used for SMS, voice, and WhatsApp |
| No | Specific WhatsApp number if different from phone | |
| Pending balance | No | Remaining balance (defaults to total amount) |
| Due date | No | Original due date of the debt |
| Reference | No | Your internal reference number |
| Document / ID | No | National ID or document number |
| Currency | No | Defaults to organization currency |
| Language | No | Preferred language for this contact (es, en, pt, or a full locale like es-MX). Overrides the organization default for that contact. |
| Notes | No | Free-text notes for the account |
Importing via API
For programmatic imports, use the REST API instead of file upload. The API supports JSON payloads with upsert by external_id for idempotent syncing with your source system.
See Import & Export via API for endpoints, field mapping, and examples.
Filtering and Searching
- Status filter — Filter accounts by status: new, pending contact, auto management, active conversation, promise active, promise overdue, paid, escalated, in review, closed, or paused.
- Search — Search by reference number using the search bar.
Account Detail
Click any row to open the account detail drawer, which contains:
- Contact information — Name, email, phone, WhatsApp.
- Interaction timeline — Chronological list of all contacts made with this debtor, including channel, result, and summary. Voice interactions also display inline sentiment (color-coded dot) and willingness to pay (W:n/5) indicators for at-a-glance assessment of the debtor's trajectory.
- Promises — Any payment promises registered for this account, with status and amount.
- Debt items — Line-by-line breakdown of what is owed (capital, interest, fees, payments applied). Use Add item to open a side panel for new entries, or Edit on a row to change amounts, dates, and status in the same panel (no inline table editing).
- Quick actions — Send a message, make a call, or escalate directly from the detail view. Starting an AI voice call opens a confirmation dialog (destination number, account context, and optional opening mode: use defaults, callee speaks first, or agent speaks first for that call only).
- Priority score — A 0–100 score (higher = higher collection priority) with a factor breakdown. Use Recalculate to refresh; the card shows when the score was last computed. Errors are shown in your language with actionable context (e.g. account not in your organization vs. calculation failure).
- Disposition history — A dedicated card lists voice outcomes over time (contact result, disposition, sentiment, cooperation, and related metadata) so you can audit what the AI concluded on each call without opening every timeline row.
Disposition Data
Voice and agent-tool outcomes are summarized in three places:
- Interaction timeline — Timeline entries can show disposition badges (contact result and call disposition) next to the channel and summary, so you see at a glance whether the call was right-party, a promise, a dispute, hardship, and so on.
- Disposition history — On account detail, the disposition history card groups the same fields chronologically for compliance review and handoff to a human collector.
- Portfolio table — The worklist includes a willingness column derived from recent structured assessments (when available), helping you prioritize accounts where the debtor signaled higher or lower intent to pay.
Together, these surfaces connect what happened on the call to strategy execution, scoring, and your next manual action.
Account Statuses
| Status | Meaning |
|---|---|
| New | Just imported, not yet contacted |
| Pending Contact | Scheduled for first contact |
| Auto Management | Being managed by AI agents |
| Active Conversation | Agent is actively engaging with the debtor |
| Promise Active | Debtor made a payment promise |
| Promise Overdue | Promise due date has passed |
| Paid | Debt fully resolved |
| Escalated | Requires human intervention |
| In Review | Under manual review |
| Closed | Closed without recovery |
| Paused | Temporarily paused from automated contacts |