Skip to content

FAQ & Troubleshooting

General Questions

What file formats can I upload?

Aelo supports the following audio formats: MP3, WAV, M4A, OGG, WEBM, FLAC. For chat conversations, use the CRM integration or upload structured text data.

How long does it take to process a recording?

Processing time depends on the recording duration and current system load. Typical processing:

  • Transcription: 30 seconds to 2 minutes
  • Analysis: 1 to 3 minutes
  • Total: Most recordings complete within 5 minutes

What languages are supported?

Aelo supports conversation analysis in English, Russian, Ukrainian, Spanish, and Portuguese (Brazilian). The ASR providers support additional languages for transcription; contact your administrator for specifics.

Can I change my role?

Roles are assigned by the organization’s Owner. Contact your organization administrator to request a role change.

How is the quality score calculated?

The quality score (0–100) is the average of the individual sub-metric scores that apply to the conversation; sub-metrics that don’t apply are skipped rather than scored as zero. By default every sub-metric counts equally. A project can set its own weight for each of the six quality criteria in project settings → Analysis & Quality; past calls are then rescored wherever the score is read, while what was already sent or triggered (the CRM score field, alerts, digests) keeps the score it was made with. See Quality Score. Which sub-metrics are scored depends on the evaluation profile applied to the record and on the conversation itself (its category and channel). See Evaluation Profiles for how the profile is chosen.

Can I use Aelo without Bitrix24?

Yes. Bitrix24 integration is optional. You can use Aelo as a standalone platform by uploading recordings manually or integrating via webhooks.

What browsers are supported?

Aelo works in all modern browsers: Chrome, Firefox, Safari, Edge. We recommend the latest version of Chrome for the best experience.

Is there a mobile app?

Aelo is a responsive web application. The interface adapts to mobile screens, and the sidebar becomes a slide-out drawer on smaller devices. There is no native mobile app at this time.

Account & Access

I didn’t receive my invitation email

  • Check your spam/junk folder.
  • Verify the email address with your administrator.
  • Ask the administrator to resend the invitation from the Team page.
  • Invitation links expire after 7 days — request a new one if expired.

I can’t access certain features

Your access depends on your assigned role. See the Permission Matrix for a full breakdown of what each role can do. Contact your organization’s Owner to request a role change.

I belong to multiple organizations — how do I switch?

Use the organization selector in the sidebar header. Click the current organization name and select the one you want to switch to.

Uploading & Processing

My upload failed

Common causes:

  • Unsupported format — ensure the file is MP3, WAV, M4A, OGG, WEBM, or FLAC.
  • File too large — check your organization’s file size limit with your administrator.
  • No project selected — every upload must be assigned to a project.
  • No balance — billing is prepaid: once the included minutes and the wallet balance are spent, the organization switches to manual mode and stops processing automatically. Topping up clears the block, but you still need to turn automatic mode back on or start the backlog yourself.

Why is a call billed for less than the recording lasts?

Aelo charges for the conversation, not for the length of the audio file. The billed duration runs from the first recognised word to the last, so ringing, an automated greeting, hold music, and silence after goodbye are not charged. A chat works the same way, drawing half a minute from that grant: if the grant only partly covers it, only the uncovered share is charged, at the flat per-chat rate.

The record detail view shows both figures whenever they differ noticeably, for example 1:20 · 0:09 of it conversation.

A recording that contains too little conversation is not analysed at all and uses no minutes. This is the same threshold used for short calls (30 seconds by default, configurable per project), measured against the conversation rather than the recording — so an outbound call picked up by an answering machine is no longer scored as though someone had answered.

Chats have their own version of this threshold: a chat with no reply from a rep, or with fewer real messages than the project’s Min Chat Messages setting (4 by default; system/service messages don’t count), is not analysed either. The transcript is still kept — only the score is skipped.

A chat with more than 100 KB of text is not analysed either, and nothing is charged for it. It is stored and its transcript stays available; the record shows the reason “The chat is too long to analyze”.

A conversation that was still waiting for its recording, or for its chat to close, when its project was paused or archived is not transcribed or analysed, and no minutes are charged for it. The record shows the reason “The project was paused or archived”; resuming the project does not process it. A call from Bitrix24, telephony or Uspacy that is not yet transcribed when call processing is turned off in its project or organization is closed the same way, and so is a call whose intake broke off before processing began: the record shows the reason “Call processing was turned off”, and turning calls back on does not process it. A call whose intake broke off before its record was created is not processed either: it gets no record, and the reason is shown on the Log tab (Analysis Setup → Distribution → Log). A call whose intake broke off is also closed if, while it waits, compliance is not confirmed in the organization (the reason “Compliance was not confirmed”) or processing of its source is paused or withdrawn, its app is removed, or the current processing instruction is not yet accepted (the reason “Processing of this source was stopped”); confirming compliance or resuming processing does not process it.

A record is stuck in “Pending” status

If a record stays in “Pending” for more than 10 minutes:

  1. Try the Retry button in the record detail view.
  2. If retry fails, check the billing balance — nothing is processed on an empty prepaid balance.
  3. Contact your administrator if the issue persists.

A record failed — what do I do?

  1. Open the record detail view.
  2. Check the error message displayed.
  3. Click Retry to resubmit for processing.
  4. If the error persists, common causes include:
    • Audio file is corrupted or empty
    • Audio is too short (less than a few seconds)
    • ASR provider is temporarily unavailable

Can I re-analyze a completed record?

Yes. Open the record detail view and click Re-analyze. This is useful after changing evaluation profiles to see updated scores. Only Owner and Admin roles can re-analyze. For a record of a Uspacy installation whose processing is paused or withdrawn, re-analysis is refused: the recording is stored but not analysed until processing of its source is resumed.

Quality & Analysis

Why are scores different for similar conversations?

Scores depend on the evaluation profile applied to the record. It is chosen for each record in a fixed order, described in Evaluation Profiles. Different profiles differ in which modules are turned on (e.g., sales vs. support) and in their base category, which also picks the built-in worked examples the model is calibrated on (chats always use the Sales Chat set) — so two profiles with identical modules but different bases can score the same call differently. Which sub-metrics are scored also depends on the conversation’s channel (chat or call) and category, so compare only records scored by the same profile, in the same channel and category.

The AI analysis seems inaccurate

AI analysis quality depends on several factors:

  • Audio quality — poor recordings lead to transcription errors
  • Recognition language — pin the spoken language in project settings whenever the project’s calls are in one language; Auto is for projects where it varies, and it does mislabel real calls
  • Evaluation profile — the profile may need tuning for your specific use case

Try re-analyzing the record or adjusting the evaluation profile.

What does “Attention Flag” mean?

The attention flag marks conversations that the AI believes need manual human review — typically due to compliance issues, extremely low scores, or unusual patterns.

In the analysis card of a call, the flag shows its reason and, when the analysis has pinned the flag to one thing said in the conversation and found that quote in it, that moment: the time (click it to play that part of the recording), who spoke, a short label and the quote. Flags that rest on the conversation as a whole — a low score, several unanswered objections — show the reason only.

CRM Integration

Bitrix24 connection fails

  • Verify your Bitrix24 domain is correct (e.g., yourcompany.bitrix24.com).
  • Ensure your Bitrix24 account has administrator permissions.
  • Check that the Aelo app is installed and authorized in Bitrix24.
  • If using a custom domain, ensure it’s properly configured.

Analysis results aren’t appearing in CRM

  1. Check the field table in Analysis Setup → CRM Updates — a CRM field is chosen for every result you need (not “Don’t write”).
  2. In the web app, open Records and filter Status → “Delivery Failed” to see calls whose delivery to the CRM failed.
  3. Verify the CRM entity exists and hasn’t been deleted.
  4. Look at the warnings of the field table in Analysis Setup → CRM Updates: “No such field on: …” (that card type has no such field), “Field of the wrong type on: …” and “Fields not loaded for: …” (press Refresh).
  5. Check that the Bitrix24 access token hasn’t expired — re-authorize if needed.

Records aren’t being created automatically from Bitrix24 calls

  1. Confirm the source is connected (Data Sources) — capture starts automatically once it is.
  2. Check distribution rules (Analysis Setup → Distribution) — a Bitrix24 record that matches no rule goes to the default project, and without one it is not accepted; a paused or archived project and a channel that is off accept no records either (see Projects).
  3. Review the Log tab (Analysis Setup → Distribution → Log) to see if events are being received.
  4. Ensure your Bitrix24 telephony integration is properly configured to share recordings.

Alerts & Notifications

I’m not receiving alert notifications

  1. Check that the notification channel is configured in Settings > Notifications.
  2. Verify alert rules are enabled (not disabled).
  3. For email: check spam folder and verify the email address.
  4. For Telegram: make sure the chat is connected through the bot link and the bot is still in the group. A project’s team channel that shows as not connected in Project Settings → Alert delivery is connected again with Connect via Telegram.
  5. For webhooks: verify the endpoint URL is accessible.

Too many alerts — how do I reduce them?

  • Increase the threshold values in your alert rules (e.g., alert only below score 30 instead of 50).
  • Reduce the severity level for less critical rules.
  • Disable rules that are no longer relevant.
  • Use project scope to limit rules to specific projects.

Performance & Display

The dashboard is loading slowly

  • Clear your browser cache and reload.
  • Try a different browser.
  • If using many filters, reduce the date range.
  • Check your internet connection.

Charts or data are not displaying

  • Ensure JavaScript is enabled in your browser.
  • Try disabling browser extensions (ad blockers may interfere).
  • Clear browser cache and reload the page.
  • If the issue persists, try an incognito/private window.

Data seems outdated

Aelo updates dashboards and metrics in near real-time. If data appears stale:

  • Refresh the page.
  • Check the date range selector — it may be set to an old period.
  • Recently uploaded records may still be processing (check record status).

Contact Support

If you can’t resolve your issue using this guide:

  1. Gather details: what you were doing, what happened, any error messages.
  2. Note your browser, operating system, and the URL where the issue occurred.
  3. Contact your organization administrator, who can escalate to Aelo support.