Setting up QR Business Cards for Bitrix24 Employees
Paper business cards get lost, contacts are manually typed from them with errors, and when a job changes or phone number updates, the print run goes to waste. A QR business card solves all three problems: a customer scans the code with a camera, and the employee's contact instantly saves to the phone book—no manual entry, no typos.
How It Works
A QR code contains data in vCard 3.0 (or 4.0) format. When scanned, the smartphone recognizes the structure and offers to save the contact. The vCard includes:
- Full Name — from the employee profile in Bitrix24
- Job title and department
- Work phone, mobile, extension
- Email (work and personal, if provided)
- Photo — encoded in Base64 or via URL
- Website link
- Office address
Data is pulled from the employee card via Bitrix24 REST API—the user.get method. This means when the profile updates, the QR code automatically provides current information if generation happens dynamically.
Two Implementation Options
| Parameter | Static QR | Dynamic QR |
|---|---|---|
| Content | vCard embedded in code | Link to vCard generation script |
| Data updates | Needs code regeneration | Automatic, when scanned |
| Works offline | Yes | No |
| QR code size | Larger (much data) | Smaller (just URL) |
| Employee photo | Bloats code, usually without photo | Loaded from profile |
For most companies, the dynamic variant is optimal: the QR code contains a short link like company.ru/vc/ivan-petrov, a server script requests data from Bitrix24 and returns a vCard file. An employee changed their last name after marriage—nothing to reprint.
Mass Generation
With a staff of 50+, generating QR business cards manually is pointless. We automate via script:
- Request list of active employees via
user.getwith filterACTIVE=true. - For each, form a vCard string.
- Generate QR code (libraries: phpqrcode, BaconQrCode for PHP; qrcode for Node.js).
- Save PNG files with naming pattern:
qr-{user_id}-{last_name}.png. - If needed—assemble PDF layouts for printing with company logo and QR code.
Script runs on schedule (cron / Bitrix agent) or manually from admin section.
Integration with Employee Profile
QR code embeds directly into employee card in Bitrix24 via custom field of "file" type or via marketplace app (embedded frame). Employee opens their profile, sees QR code—can show on phone screen or print.
Alternative—separate page on corporate portal where each employee downloads their own business card in PNG or PDF format.
Where QR Business Cards Are Used
- Conferences and exhibitions — participant scans code on badge
- Email signatures — QR code in letter footer
- Print materials — brochures, catalogs, packaging
- Passes and badges — access + contact in one code
Technical Nuances
- UTF-8 encoding is mandatory—otherwise Cyrillic becomes gibberish on Apple devices.
- QR code error correction level: for printing—level H (30% recovery); for screen—level M is sufficient.
- Code size for printing—at least 2x2 cm, otherwise budget smartphone cameras won't read it.
- Logo in center of QR — allowed with correction level H, but takes up to 15% of code area.
We configure QR business card generation for your company's specific structure: with department grouping, branding matching your style, and automatic updates when staff changes.