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.
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.
- Open the Aelo app card in the Bitrix24 Marketplace. You can also reach it from your portal: Applications → Marketplace, then search for “Aelo”.
- Click Install.
- Review the permissions Aelo requests (see below) and confirm.
- Aelo opens its onboarding inside Bitrix24 — connect your Aelo organization or create a new one.
- 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.
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.
During installation, Bitrix24 asks you to grant Aelo access. Each permission maps to a specific capability:
| Permission | Why Aelo needs it |
|---|---|
| CRM | Read contacts, deals, leads, and companies, and write analysis results back |
| Telephony | Access call records so Aelo can analyze your calls |
| Chat | Access open-channel chat transcripts for analysis |
| Placement | Show the Aelo tab in deal, lead, contact and company cards; open a call from a portal notification at the right moment |
| Tasks | Create follow-up tasks from analysis insights (when you enable automations) |
| Users | Identify which rep handled each conversation |
| Drive | Download call recordings for transcription |
You can revoke this access at any time by uninstalling the app.
Once the organization owner confirms the recording compliance settings in onboarding, Aelo starts listening for new calls and chats:
- A call is completed or a chat is closed in Bitrix24.
- Aelo picks up the recording or transcript.
- 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.
- Results are delivered to the matching CRM card.
In Automatic mode the first results usually appear within a few minutes of a completed conversation.
- 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.
- Open the related contact or deal card in Bitrix24.
- 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.
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.
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.
- 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.
- In Bitrix24, open Applications and find Aelo under installed applications.
- Choose Delete.
Aelo stops listening for new conversations and its access to your portal is revoked.
| Problem | What to check |
|---|---|
| App not in the left menu | Reload Bitrix24; confirm the install finished; confirm your role is allowed to open the app |
| No Aelo comment or note on a card | The 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 analyzed | Confirm 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 app | Usually 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) |
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.