Skip to content

Installing Aelo in Bitrix24

This guide walks you through installing Aelo in your Bitrix24 portal. Installation takes a few minutes and needs no technical setup.

Before you start

Owner Admin

  • A Bitrix24 account with CRM and telephony. For call analysis, call recording must be enabled in your Bitrix24 telephony settings.
  • Administrator rights on the portal — only an account that can install applications can add Aelo.
  • An Aelo account — you can connect an existing one or create it during onboarding.

Install the app

  1. Open the Aelo app card in the Bitrix24 Marketplace. You can also reach it from your portal: Applications → Marketplace, then search for “Aelo”.
  2. Click Install.
  3. Review the permissions Aelo requests (see below) and confirm.
  4. Aelo opens its onboarding inside Bitrix24 — connect your Aelo organization or create a new one.
  5. Finish onboarding. Aelo now appears in your left menu; analysis results will reach your CRM cards in the fields you map (on the card itself or a Smart Process item) and, by default, as a comment in the card’s timeline.

Who becomes the organization owner

Only the person who installed Aelo in the portal, and was a portal administrator when they did, can become the organization’s Owner: they become it when they open Aelo and accept, on the organization’s behalf, the Terms of Service and the DPA. Everyone else who opens Aelo joins the organization as a Rep, even while it has no Owner. While the organization has no Owner yet, Aelo asks the installer whether they represent the company or are setting the app up for a client:

  • I represent this company — you become the Owner.
  • I am setting it up for a client — for partners and integrators. You get the Admin role, and ownership stays open: the company’s own portal administrator becomes the Owner by reinstalling Aelo and then opening it. If they had already opened Aelo and accepted the terms before the reinstall, Aelo shows them the terms and this question once more when they next open it.

If the person who installed Aelo was not a portal administrator, nobody becomes the Owner from the Bitrix24 app until a portal administrator reinstalls it. Once the organization has an Owner, nobody else is asked, and reinstalling the app does not change who the Owner is. An Admin cannot assign the Owner role. Until the recording compliance settings are confirmed, Aelo accepts no calls or chats from the portal. In the Bitrix24 app only the Owner can confirm them; in the Aelo web app an Admin can as well.

Permissions Aelo requests

During installation, Bitrix24 asks you to grant Aelo access. Each permission maps to a specific capability:

PermissionWhy Aelo needs it
CRMRead contacts, deals, leads, and companies, and write analysis results back
TelephonyAccess call records so Aelo can analyze your calls
ChatAccess open-channel chat transcripts for analysis
PlacementShow the Aelo tab in deal, lead, contact and company cards; open a call from a portal notification at the right moment
TasksCreate follow-up tasks from analysis insights (when you enable automations)
UsersIdentify which rep handled each conversation
DriveDownload call recordings for transcription

You can revoke this access at any time by uninstalling the app.

After installation

Once the organization owner confirms the recording compliance settings in onboarding, Aelo starts listening for new calls and chats:

  1. A call is completed or a chat is closed in Bitrix24.
  2. Aelo picks up the recording or transcript.
  3. Aelo analyzes the conversation (a call is transcribed first) — in Automatic mode right away, within the project’s settings. A new organization starts in Manual mode: the conversation waits, spending no minutes, until an owner or admin starts it.
  4. Results are delivered to the matching CRM card.

In Automatic mode the first results usually appear within a few minutes of a completed conversation.

Verify it works

  1. Make a test call with at least 30 seconds of conversation and recording enabled (a shorter one gets no analysis and uses no minutes; the minimum is set per project), or wait for a real one. In Manual mode, an owner or admin starts its analysis once it appears in Aelo.
  2. Open the related contact or deal card in Bitrix24.
  3. Once processing finishes, check where you deliver: the fields you mapped are filled (on the card or its Smart Process item), and an Aelo comment appears in its timeline (on by default; Analysis Setup → CRM Updates → Report as a comment). The full analysis opens in the card’s Aelo tab and in the Aelo app in your left menu.

Configure capture and delivery

To control which conversations are analyzed and where results land, set up distribution rules (Analysis Setup → Distribution) and the fields for results (Analysis Setup → CRM Updates). See the Bitrix24 user guide for step-by-step instructions.

Opening the full web app

Inside Bitrix24, Aelo shows the essentials: the same dashboard as in the web app, and Records. Report links on the dashboard cards open inside Bitrix24 only for Objections and Voice of Customer; the others (the criteria report, script steps, call statistics, missed calls) open the web app in a new window. The prompt builder and billing live in the full web app, which opens with Full portal in the Aelo app.

The first time you open it, Aelo asks you to sign in. That is deliberate: under the permissions the Bitrix24 Marketplace approves, apps do not receive portal users’ e-mail addresses, so Aelo has no address for you until you provide one yourself. Sign in with Google or an e-mail code — Aelo links that account to your Bitrix24 workspace and starts sending your digests and alerts to it.

After that, Full portal takes you straight in, with no sign-in step.

The link is valid for one hour and works once. If it expires, open Aelo in Bitrix24 and press Full portal again — the new link works immediately.

Security and privacy

  • Aelo connects to Bitrix24 over OAuth 2.0 — you grant access explicitly during install, and you stay in control of it.
  • Authorization is stored securely and renewed automatically; you never handle keys or tokens yourself.
  • Uninstalling removes Aelo’s access and stops all processing immediately.
  • All traffic is encrypted over HTTPS. Customer content is stored at rest in the EU (in the database and the audio storage; the search index — numerical vectors, no text — and Cloudflare’s processing state, queues, logs, caches and coordination state, some of which hold transcript and chat text for a few days, are not pinned to the EU); Cloudflare edge processing may occur outside the EU.

See the EULA and Privacy Policy for details.

Uninstalling

  1. In Bitrix24, open Applications and find Aelo under installed applications.
  2. Choose Delete.

Aelo stops listening for new conversations and its access to your portal is revoked.

Troubleshooting

ProblemWhat to check
App not in the left menuReload Bitrix24; confirm the install finished; confirm your role is allowed to open the app
No Aelo comment or note on a cardThe timeline comment is on by default, so check that Report as a comment was not switched off in Analysis Setup → CRM Updates; the note on the call or chat activity (Report as a note) is off by default and appears only once you turn it on. Or there is no analyzed conversation for that entity yet — check delivery in Analysis Setup → CRM Updates
New calls aren’t analyzedConfirm call recording is on in Bitrix24; confirm the source is connected and distribution rules are set up in Aelo; in Manual mode (the default for a new organization) an owner or admin starts the analysis; in Automatic mode, check that the project’s Auto Analysis switch is on; confirm the recording compliance settings: if everyone sees Recordings are not being received, the organization owner named in that banner must confirm them
Delivery errors in the Aelo appUsually expired authorization (re-open the app) or CRM fields that are not chosen in the table of the CRM Updates step or are missing on the card (review the field table)

Pricing

Aelo is billed by analyzed minutes. The Free plan includes 100 analyzed minutes every month, with no credit card. See the pricing page for plans and rates.