LoomaBlog
Integrations

KeyCRM integration: website leads land in your pipeline by themselves

A step-by-step guide: a five-minute setup — leads from the AI chat and search become cards in your pipeline, with the contact, the comment, the products and the UTM tags of the visit.

Looma Team 7 min read
KeyCRM integration: website leads land in your pipeline by themselves

KeyCRM is a Ukrainian CRM that thousands of sales teams work in every day: pipelines, cards, tasks and analytics. But something has to fill it with leads, and most of the time that something is a person — a manager reads the website chat, retypes the phone number into the CRM, adds a comment, and repeats.

Looma closes exactly that gap. Connect KeyCRM and every lead your widgets collect becomes a card in your pipeline: with the contact, the comment from the conversation, the products the visitor looked at and the UTM tags of the visit. No exports, no files, no copying. Setup takes about five minutes.

The KeyCRM card in the Integrations section of the Looma dashboard
KeyCRM lives in the Integrations section, next to the shop connectors
What the integration gives you

Leads land in the pipeline by themselves

The connection is one-way: Looma writes into your CRM and takes nothing back — no orders, no catalogue. We add the data your CRM would not otherwise have.

Every lead becomes a card

Requests from the AI chat, from search and from the widget forms arrive in the pipeline you choose: the contact, what the visitor wrote, the products they looked at and the UTM tags of the visit. Looma finds the buyer in your CRM by phone number — or by email when there is no phone — and creates one when neither turns anything up.

Contacts without an order

People who left a phone number or an email in the widget but never ordered and never became a lead. Your shop has no record of them by definition — and they are often the warmest list nobody ever got round to. The switch is off by default: you decide whether they belong in the pipeline.

No duplicates

Every lead is sent once. Testing the connection or changing settings will not create a second card, and if a lead gains details after it was sent — a phone number that arrived later in the chat, a changed status — Looma updates the same card and the same buyer.

The How it works panel on the KeyCRM connection screen
What goes to the CRM, from which point, and what happens on failure — all of it is written right on the connection screen
Before you start

What you will need

A KeyCRM account with the Pipelines section enabled and at least one pipeline in it. This matters: Looma cannot create a pipeline for you — the KeyCRM API does not allow it, so that part is a job for the CRM interface.

The Owner or Administrator role in Looma — the Integrations section is limited to those two.

Extra fields for leads in KeyCRM — if you want the visit details in the card: visitor ID, landing page, referrer. Optional, but Looma can only fill fields that already exist.

Step 1

Get the API key in KeyCRM

In KeyCRM open Settings → Public API → Create key and copy it.

KeyCRM issues one key per account. If you already use it somewhere else, copy the existing one instead of creating a new key — generating a new one revokes the old key, and everything that relied on it stops working.
Step 2

Connect the site

In Looma open Integrations → KeyCRM. You will see the list of your sites — each one connects separately. Find the one you need, press Connect, paste the key and save.

The API key field for a site on the KeyCRM connection screen
The whole connection form is a single field, with the path to the key in KeyCRM spelled out right above it

Then press Test connection. Looma reads your pipelines, sources and extra fields and stores a snapshot of them — every list in the setup wizard is built from that snapshot. When the check succeeds, the badge next to the site name turns into "Connected" and a green "Connection works" appears below.

A site showing the Connected badge and the Connection works label
The Connected badge and the green label mean the key was accepted and the CRM directories were read
Step 3

Say where leads should go

The setup wizard appears only after a successful check — otherwise it would show empty lists with no explanation of why.

The setup wizard: pipeline, source, field map, country code and the What to send switches
The whole wizard on one screen: where leads should go, which visit details to pass along and what exactly to send

Pipeline and source

Two required fields. The pipeline is where the cards land; the source is the KeyCRM label you will later filter website leads by.

Visit details → extra fields

Here you map Looma values — visitor ID, session ID, landing page, referrer, site name and lead status — onto your own extra lead fields in KeyCRM. Leave any row you do not need on "Do not send".

The list shows lead-model fields only. A field created for orders cannot be filled from a pipeline card — so if the list is empty, create the fields for leads and test the connection again to refresh the snapshot.

Country code

The dialling code without the "+". It is what lets a number written in national format arrive in the CRM in international format.

Step 4

Choose what to send

Leads from chat and search

The main pipeline, on by default. Everything the AI assistant, the search widget and the forms collect.

Also send the leads collected earlier

Off by default, and deliberately so. Without this box only the leads created after you save reach the CRM: the older ones may already be there by another route, and duplicating them helps nobody. If you do want the whole collected base, tick it and it goes over in a steady stream of about ten leads a minute. How many you have right now is printed under the switch.

Contacts without an order

The same visitors who left a contact and disappeared. Off by default.

Press Save settings — delivery starts within a minute.

The result

What the manager sees in the CRM

The card arrives already filled in:

Contact and comment

The buyer's phone and email, plus what the visitor wrote in the chat — the manager does not have to open Looma to understand the context.

Products and UTM tags

The items the visitor looked at, plus utm_source, utm_medium and utm_campaign of the visit — you can see which campaign the lead actually came from.

One thing worth knowing in advance: Looma never sets the pipeline status. The card is created in whatever status the pipeline uses by default, and from there your managers run it — we do not interfere with someone else's process. The Looma-side status is not lost, though: it travels as a plain value through the "Lead status in Looma" row of the field map.

Products have their own quirk: they are sent once, when the card is created. KeyCRM always appends items rather than replacing them, so sending them again would simply double the list.

If something goes wrong

Nothing is lost

The badge next to the site name always tells you where you stand: "Connected", "The CRM rejected the key", "Pipelines are turned off in the CRM", "The CRM is not responding". Each one names the thing to fix.

If the CRM refuses ten times in a row — an API key revoked during a rotation, for instance — Looma stops sending and emails the account owner. Nothing is lost in the process: fix the cause, press Test connection, then Retry failed, and the whole waiting queue goes over. The counter measures failures in a row, so any successful send resets it to zero.

FAQ

Do I need a developer?

No. The whole integration is copying a key in KeyCRM and pasting it into Looma. After that it is two dropdowns and three switches.

How long does a lead take to reach the CRM?

About a minute. The backlog transfers more slowly — roughly ten leads a minute, so it does not run into your KeyCRM account's request limit.

What if I have several sites in Looma?

Each connects separately, and each can have its own pipeline and source. Keep in mind that KeyCRM issues one key per account, so sites sharing it share the transfer speed too. Looma warns you about that right on the screen.

What happens if I switch the key to a different CRM account?

Looma warns you and then freezes the history: everything already sent stays in the previous account and stops being updated there, and only new leads go to the new one. The pipeline and source selection is cleared as well — pipeline IDs are small numbers that exist in both accounts, so silently keeping the old choice would file your leads into a stranger's pipeline.

Can I disconnect the integration?

Yes, with the Disconnect button — the stored key is deleted. Just remember that the delivery history goes with it: connect the same CRM again and everything is sent a second time, as new cards.

Connect KeyCRM to your site

Signing up is free and setup takes about five minutes. Leads from chat and search will start arriving in your pipeline on their own.

Try Looma

Want the same for your store?

Looma installs in minutes and starts selling for you 24/7.

Try it free →

Turn visitors into buyers

Looma installs in minutes and sells for you 24/7.

Try it free →