Standard objects

Fair leads

Potential customers collected at a trade fair booth — quick capture, owner, next action, and conversion to a company.

A fair lead (lead in the API) is the first record of a company you met at a trade fair. A lead isn't a company yet: at entry it can be linked to a company already in the CRM; when it is converted to the CRM, a company (registered or a new prospect), its people and, if needed, an opportunity are created, and the lead moves to Converted (Aktarıldı). Fairs (fair) group leads; each fair has a name, city, venue, and dates.

Status

status Meaning
Yeni New — captured at the booth.
İletişime geçildi Contacted — first contact made after the fair.
Teklif verildi Quote sent.
Aktarıldı Converted to a company (customer_id and opp_id are filled in).
Vazgeçildi Dropped — won't be followed up.

status_eff returns the displayed status: Kazanıldı (won) if the linked project was won, Kaybedildi (lost) if it was lost or canceled, and the stored status otherwise.

Fields

Field Type Description
id, rid integer, string ID and permanent record ID (00Q…).
fair_id, fair integer, string Fair.
company, contact_name, title, phone, email string Company and contact details.
city, sector, website string Company details.
visitor_type string Potansiyel müşteri (potential customer), Mevcut müşteri (existing customer), Tedarikçi (supplier), Rakip (competitor), Diğer (other).
interest string Interest: Sıcak (hot), Ilık (warm), Soğuk (cold).
products, products_text string IDs of the products of interest (comma-separated) and free text.
potential_kg, unit number, string Monthly potential and unit.
timing string Hemen (immediately), 3 ay içinde (within 3 months), 6 ay içinde (within 6 months), 1 yıl+ (1 year+), Belirsiz (unknown).
next_action, next_date string, date Next action and its date — creates a task for the owner.
owner user The sales rep who will follow up on the lead.
customer_id, opp_id, task_id integer Company and opportunity, if converted; follow-up task.
link_customer_id, link_customer integer, string The registered company chosen at entry (v53) — the lead is linked to it on conversion.
link_contact_id integer The CRM contact for the primary person (a contact of the registered company).
people array Other people met at the booth [{name, title, phone, email, cid}] — cid is a CRM contact.
contact_label string Primary person + number of extra people (Ali Veli · Purchasing +2).

Lead entry

In the New lead form, companies already in the CRM are suggested as you type the name (case and Turkish letters are ignored; exact name, then prefix, then word start). Pick one to see its card: status, owner, open opportunities, its leads at this fair and at earlier fairs. If the company isn't listed, keep typing — the lead isn't linked, and converting it creates a new prospect. Remove the link with ×.

If a lead with the same company name, phone or e-mail already exists at the same fair, a Similar record at this fair banner appears; click it to open the existing lead.

People

When a registered company is chosen its contacts appear as chips: tap one to make it the primary person (fields fill in, linked to the CRM contact); if the primary person is already filled, it is added as an extra person. Up to 6 people met at the booth (Add person). If a phone or e-mail you enter belongs to a CRM contact, a Registered in the CRM: Name · Company line with Link appears — linking the company and the contact. The lead list's person column shows the primary person plus the number of extra people.

Convert to the CRM

The Convert to CRM card on the lead page (the row's Convert button in the list opens the same card on the right):

  1. Company: the registered company chosen at entry, or one whose name matches, is suggested; choose New prospect or Change to search for another registered company.
  2. People: a suggestion for each person — if the e-mail or name matches one of the company's contacts, link to that contact (its blank fields are filled), otherwise new contact; leave someone out with Don't convert. A person with a different name never matches by phone alone.
  3. Opportunity: Open a new opportunity (first stage, with the lead's project type and potential), Link to an open opportunity (from the company's open ones) or No opportunity.
  4. Fair visit: an optional face-to-face visit — with the primary person, attendees in the note; shown on the timeline.

After converting, the lead becomes Converted and its follow-up task moves to the company; once the linked opportunity is won, the displayed status becomes Won.

Bulk actions

Select rows in the lead list (long-press on phones): use Convert to CRM in the bottom bar — leads linked to a registered company or whose name matches exactly go to that company, the rest become new prospects; optional opportunity and visit — or Owner to change the owner of the selected leads. Already converted leads are skipped.

Owner and follow-up task

The person who captures a lead and the person who follows it up can be different (owner_id). When a next action and date are entered, a task is created for the owner; when the lead is updated, the task is updated too. By default, sales reps see only their own leads (owner=me).

Fair dashboard

Click a fair's name to open its fair dashboard: the lead → sales funnel (Lead → Potential → Moved to CRM → Project opened → Won), interest and follow-up status, product / sector / city charts, reps, fair cost and return; every number opens its leads. The top of the Fair leads page has a dashboard of all fairs. Admins enter the fair's cost (cost, base currency). Fair dashboard