ईमेल QR कोड API गाइड

एक ईमेल QR कोड एक mailto: URI एनकोड करता है। इसे स्कैन करने पर फोन का डिफॉल्ट मेल ऐप प्राप्तकर्ता का पता — और वैकल्पिक रूप से विषय पंक्ति और मैसेज का मतन — पहले से भरे हुए खुलता है। यूज़र देखकर भेज देता है।

SMS कोड की तरह, इस प्रवाह में कोई वेब सेवा नहीं है, तो एक email qr code api खोज असल में दो में से एक सवाल पूछ रही है: मैं कौन सा पेलोड फॉर्मेट एनकोड करूं, या इमेज बनाने के लिए कौन सी लाइब्रेरी बुलाऊं? दोनों के जवाब नीचे हैं, साथ में साफ बयान कि SMLLR का अपना REST API क्या करता है और क्या नहीं, क्योंकि यही फर्क वह जगह है जहां इस विषय पर ज़्यादातर सामग्री चुपचाप गुमराह करती है।

आधुनिक, लगभग सार्वभौमिक रूप से समर्थित फॉर्मेट mailto: URI है, जिसे RFC 6068 परिभाषित करता है:

mailto:sales@example.in?subject=Bulk%20order%20enquiry&body=Hi%2C%20I%20saw%20your%20QR%20code

व्यवहार में जो नियम मायने रखते हैं:

• पता mailto: के तुरंत बाद आता है, कोई स्लैश नहीं।
• पहला पैरामीटर ? से शुरू होता है, हर अगला & से।
• subject और body को percent-encode करना ही है। स्पेस %20 बनते हैं, कॉमा %2C, न्यूलाइन %0A। बिना एनकोड किया एक स्पेस या ऐम्परसैंड कटी हुई विषय पंक्ति की सबसे आम वजह है।
• cc और bcc भी समर्थित हैं: ?cc=support@example.in&subject=...।

जब आप एक Email QR कोड बनाते हैं तो SMLLR ठीक यही बनावट बनाता है — पता URI-एनकोड होता है, और subject और body हर एक पैरामीटर के रूप में जोड़ने से पहले percent-encode होते हैं।

पुराना MATMSG: फॉर्मेट (MATMSG:TO:a@b.in;SUB:Subject;BODY:Message;;) एक लीगेसी Denso Wave परंपरा है। कुछ समर्पित स्कैनर ऐप अब भी इसे पढ़ते हैं, लेकिन नेटिव फोन कैमरे — जहां भारतीय स्कैन का अधिकांश हिस्सा होता है — mailto: को कहीं ज़्यादा भरोसे से संभालते हैं। mailto: इस्तेमाल करें।

ईमेल पेलोड खास, बार-बार दोहराए जाने वाले तरीकों से फेल होते हैं। जिनसे बचना ज़रूरी है:

• बिना एनकोड किए विशेष अक्षर। आपके मतन के अंदर एक & पैरामीटर विभाजक के रूप में पढ़ा जाएगा और उसके बाद का सब कुछ चुपचाप काट देगा। हमेशा पूरा subject और body एनकोड करें, सिर्फ स्पेस नहीं।
• लाइन ब्रेक। न्यूलाइन के लिए %0A इस्तेमाल करें। एक QR पेलोड में कच्ची न्यूलाइन असंगत तरीके से संभाली जाती हैं और URI पूरी तरह तोड़ सकती हैं।
• गैर-लैटिन लिपियां। विषय पंक्ति में हिंदी, तमिल या बांग्ला मतन को UTF-8 percent-encode करना पड़ता है, जो उसे काफी फैला देता है — एक छोटा देवनागरी विषय पेलोड में हैरान करने वाली संख्या में अक्षर जोड़ सकता है और कोड को ऊंचे, सघन QR वर्ज़न पर धकेल सकता है।
• लंबे मतन सघन कोड बनाते हैं। दो या तीन वाक्यों का पहले से भरा मतन आसानी से पेलोड को 250 अक्षरों से आगे धकेल सकता है। हमारी डेटा कैपेसिटी गाइड बताती है कि इससे स्कैन भरोसेमंदी पर क्या असर पड़ता है; छोटा जवाब यह है कि लंबा मतन सिर्फ सौंदर्य की नहीं, स्कैनिंग की समस्या है।
• डेस्कटॉप बनाम मोबाइल। कॉन्फ़िगर किए मेल ऐप वाले फोन पर mailto: साफ काम करता है। बिना डिफॉल्ट मेल क्लाइंट वाले डेस्कटॉप पर यह कुछ भी नहीं कर सकता — याद रखने लायक अगर कोड ऐसी किसी चीज़ पर है जिसका स्क्रीनशॉट लेकर बाद में खोला जाता है।

बल्क जेनरेशन के लिए — हर शाखा, हर सेल्सपर्सन, हर प्रोडक्ट लाइन के लिए एक कोड — पेलोड बनाएं और उसे अपने बैकएंड में एनकोड करें।

Python:

import qrcode
from urllib.parse import quote

def email_qr(to: str, subject: str, body: str, out_path: str):
    payload = f"mailto:{to}?subject={quote(subject)}&body={quote(body)}"
    qrcode.make(payload).save(out_path)

email_qr("sales@example.in", "Bulk order enquiry", "Hi, I saw your QR code", "branch_delhi.png")

Node.js:

const QRCode = require('qrcode');

const subject = encodeURIComponent('Bulk order enquiry');
const body = encodeURIComponent('Hi, I saw your QR code');
const payload = `mailto:sales@example.in?subject=${subject}&body=${body}`;
await QRCode.toFile('branch_delhi.png', payload, { errorCorrectionLevel: 'Q' });

ध्यान दें कि quote और encodeURIComponent subject और body पर लगे हैं, पूरे URI पर नहीं — पूरी स्ट्रिंग एनकोड करना उन ? और & को भी बदल देगा जो पैरामीटर को काम करने लायक बनाते हैं। हमारी Python QR कोड API गाइड लाइब्रेरी के चुनाव और आउटपुट फॉर्मेट में और आगे जाती है।

एक कच्चा mailto: QR कोड उसी वजह से एनालिटिक्स के लिए अदृश्य है जिस वजह से एक SMS कोड है: स्कैन किसी सर्वर से संपर्क किए बिना एक स्थानीय ऐप खोलता है। कोई स्कैन गिनती नहीं, कोई टाइमस्टैम्प नहीं, कोई डिवाइस विभाजन नहीं, कोई प्रति-प्लेसमेंट एट्रिब्यूशन नहीं।

खासकर एक ईमेल कोड के लिए यह दिखने से ज़्यादा चुभता है, क्योंकि ईमेल पूछताछ आमतौर पर एक क्लिक से ऊंचे मूल्य की क्रिया होती है — एक थोक ऑर्डर की पूछताछ, एक डिस्ट्रीब्यूटर आवेदन, एक B2B लीड। यह न जानना कि कौन से ट्रेड-शो बैनर, कौन से कैटलॉग पन्ने या कौन से डीलर काउंटर ने वे दिए, चैनल को सुधारना नामुमकिन बना देता है।

दूसरी समस्या स्थायित्व है। प्राप्त करने वाला पता बदलिए — एक सेल्सपर्सन चला जाता है, एक विभाग का ढांचा बदलता है, sales@ orders@ बन जाता है — और हर प्रिंटेड कोड मेल को एक मरे हुए मेलबॉक्स पर भेजता है। दोबारा प्रिंट किए बिना कोई इलाज नहीं।

सटीक रूप से:

डैशबोर्ड में, Email एक QR टाइप है जो Starter प्लान (₹499/माह) से उपलब्ध है। पता, विषय और मतन डालें; SMLLR mailto: पेलोड बनाकर एनकोड करता है।

SMLLR REST API सिर्फ पढ़ने वाला रिपोर्टिंग API है। सात GET एंडपॉइंट — सारांश, QR सूची, QR विवरण, कैंपेन सूची, कैंपेन विवरण, क्लाइंट सूची, क्लाइंट विवरण — Premium प्लान (₹14,999/माह) पर, प्रति key प्रति मिनट 60 रिक्वेस्ट तक सीमित। QR कोड बनाने, संपादित करने या मिटाने का कोई एंडपॉइंट नहीं है, और न ही कोई एंडपॉइंट जो ईमेल भेजता हो।

दो चीज़ें जो एक जैसी सुनाई देती हैं, उन्हें अलग करना ज़रूरी है। SMLLR का Email Marketing फीचर — आपकी कैप्चर की गई लीड को कैंपेन भेजना, एक सत्यापित सेंडिंग डोमेन के साथ — एक असली, शिप हो चुका प्रोडक्ट सतह है जो Pro प्लान (₹4,999/माह) और ऊपर उपलब्ध है, और डैशबोर्ड से चलाया जाता है। यह सार्वजनिक API से उजागर नहीं है, और यह एक ईमेल QR कोड से बिल्कुल अलग चीज़ है, जो बस स्कैन करने वाले का अपना मेल ऐप खोलता है। हमारी ईमेल मार्केटिंग सेटअप गाइड उस फीचर को बताती है; यह पोस्ट QR पेलोड के बारे में है।

सार्वजनिक API डिज़ाइन से ही Lead Hub का संपर्क डेटा कभी नहीं लौटाता — कोई नाम, ईमेल, फोन नंबर या सहमति रिकॉर्ड नहीं।

अगर मकसद है "हमें ईमेल करना आसान बनाओ और मुझे इसे मापने दो," तो बेहतर रचना है एक डायनामिक QR कोड जो ऐसे संपर्क पेज पर इंगित करे जिस पर mailto: लिंक एक बटन के रूप में हो, या एक ठीक-ठाक लीड कैप्चर फॉर्म।

आगे रीडायरेक्ट होने से आपको स्कैन गिनती, टाइमस्टैम्प, डिवाइस और शहर का विभाजन, और प्रति-कोड एट्रिब्यूशन मिलता है — तो आप आखिरकार बता सकते हैं कि कैटलॉग इंसर्ट ने या ट्रेड-शो बैनर ने डिस्ट्रीब्यूटर पूछताछ दी। और क्योंकि डेस्टिनेशन संपादन योग्य है, प्राप्त करने वाला पता बदलना दोबारा प्रिंट नहीं, डैशबोर्ड का एक संपादन है।

अगर आप एक कदम और आगे जाकर एक लीड कैप्चर गेट (Lead Hub, Pro प्लान, ₹4,999/माह) इस्तेमाल करते हैं, तो पूछताछ एक साझा इनबॉक्स में ऐसे बिना-ढांचे वाले ईमेल के रूप में आने के बजाय, जिस पर कोई रिपोर्ट न दे सके, स्रोत एट्रिब्यूशन और दर्ज सहमति के साथ एक व्यवस्थित डैशबोर्ड में आती है।

SMLLR पर अपना QR कोड बनाएं — सीधे कोड के लिए Email टाइप, या जब पूछताछ मापने लायक हो तब एक डायनामिक URL कोड।