crmاکسیرتجارت این امکان را دارد که سرنخها (Leads) را مستقیماً از محبوبترین فرم تماس وردپرس، یعنی Contact Form 7، و همچنین هر فرم سفارشی دیگر، همراه با قابلیت یکپارچهسازی ایمیل که داخل سیستم موجود است، وارد کند و ثبت نماید.
این فرآیند بسیار ساده است: پس از تنظیم فرم تماس بهگونهای که با یکپارچهسازی ایمیل سازگار باشد، اطلاعات سرنخها بهسرعت وارد سیستم میشوند و فیلدهای فرم بهصورت خودکار به رکورد سرنخ اضافه میگردند.
پیشنهاد میکنیم ابتدا این مقاله راهنما را بهطور کامل مطالعه کنید تا با نحوه همخوانی فیلدهای فرم تماس و فیلدهای سرنخ در crmاکسیرتجارت آشنا شوید. این کار به شما کمک میکند مراحل لازم برای پیکربندی صحیح را بهدرستی انجام دهید.
پیشنیاز: قبل از شروع، یکپارچهسازی ایمیل سرنخها در crmاکسیرتجارت باید بهصورت صحیح و فعال تنظیم شده باشد. برای اطلاعات بیشتر درباره نحوه پیکربندی آن، میتوانید به لینک راهنمای مربوطه مراجعه کنید.
برای سادهتر کردن مثال و آموزش، در اینجا از یک فرم نمونه با سه فیلد نام، ایمیل و پیام استفاده شده است (در ادامه میتوان نمونههای پیچیدهتر را هم اضافه کرد)
نصب Contact Form 7
اگر از قبل Contact Form 7 را نصب کردهاید و با عملکرد آن آشنا هستید، میتوانید این مرحله را رد کنید.
اگر هنوز این افزونه را نصب نکردهاید، باید آن را از داشبورد وردپرس خود نصب کنید:
- از منوی سمت چپ وردپرس به افزونهها → افزودن بروید.
- در قسمت جستجو، Contact Form 7 را تایپ کنید.
- پس از پیدا کردن افزونه، روی نصب کلیک کنید و پس از اتمام نصب، روی فعالسازی کلیک کنید.
ما فرض میکنیم که شما با نحوه کار Contact Form 7 و چگونگی جاسازی فرم در صفحات سفارشی (مثل صفحه تماس با ما) آشنا هستید. اگر نیاز به آموزش بیشتر دارید، میتوانید با کلیک روی لینک راهنمای مربوطه اطلاعات بیشتری کسب کنید.
پیکربندی Contact Form 7
در این مثال، از تنظیمات پایه فرم Contact Form 7 که پس از نصب ارائه میشود استفاده میکنیم.
- پس از نصب و فعالسازی افزونه، از منوی وردپرس به مسیر Contact → Contact Forms بروید.
- فرم مورد نظر خود را برای پیکربندی انتخاب کرده و روی نام آن کلیک کنید.
📌 در فرم باز شده، به تب Mail بروید تا ایمیل فرم تماس را طوری تنظیم کنید که با crmاکسیرتجارت سازگار باشد.
💡 نکته مهم:
همیشه توصیه میشود که فیلد ایمیل را در بخش پیام و همچنین در هدر Reply-To در بخش Additional Headers وارد کنید و از فیلد ترکیبی [your-email] استفاده کنید تا پاسخها به ایمیل کاربر ارسال شود.
سربرگهای اضافی (Additional Headers)
- ایمیل یکپارچهسازی سرنخها (ایمیلی که در CRM برای دریافت سرنخها تنظیم کردهاید) را در این قسمت وارد کنید.
مثال: اگر ایمیل یکپارچهسازی شما yourleadsintegrationemail@example.com است، در یک خط جدید این مقدار را با پیشوند Bcc اضافه کنید:
Bcc: yourleadsintegrationemail@example.com
- دقت کنید هدر Reply-To بهدرستی تنظیم شده باشد (معمولاً با فیلد ایمیل فرم، مثل [your-email]) تا پاسخها به ایمیل ارسالکننده هدایت شود.
چرا این مهم است؟
وقتی کاربر فرم را پر میکند، افزونه Contact Form 7 با دستور Bcc ایمیل را به آدرس یکپارچهسازی سرنخها میفرستد. سپس کار زمانبندیشده (Cron Job) در crmاکسیرتجارت این ایمیلها را بررسی کرده و سرنخها را بهصورت خودکار وارد (import) میکند. پس Bcc و Reply-To دقیق تنظیم شود تا اطلاعات درست به CRM برسد.
محتوای پیام (Message Body)
برای اینکه مقادیر فیلدهای فرم بهصورت دقیق وارد رکورد سرنخ در CRM شوند، باید مقادیر فرم را داخل بدنهٔ ایمیل (Message Body) با قالب HTMLمشخص قرار دهید.
فرمت پیشنهادی برای هر فیلد:
<div id=”field_LEAD_FIELD”>[your-CONTACT-FORM-FIELD]</div>
- بعد از ارسال ایمیل، این تگ با مقدار واقعی جایگزین میشود؛ مثلاً:
<div id=”field_LEAD_FIELD”>John Doe</div>
نکته مهم:
- بهجای LEAD_FIELD باید نام فیلدی که در CRM برای سرنخ استفاده میشود را قرار دهید (مثلاً name یا email یا هر کلید دیگری که CRM میفهمد).
- بهجای [your-CONTACT-FORM-FIELD] باید شورتکد مربوط به فیلد فرم Contact Form 7 را قرار دهید (مثلاً [your-name] یا [your-email]).
- بنابراین برای فیلد نام کاربر یک مثال واقعی میتواند اینگونه باشد:
<div id=”field_name”>[your-name]</div>
که بعد از ارسال ایمیل تبدیل میشود به:
<div id=”field_name”>علی رضایی</div>
نکات عملی برای همخوانی فیلدها
- قبل از گذاشتن تگها در بدنهٔ ایمیل، مطمئن شوید همان فیلدها را در فرم Contact Form 7 ساختهاید (یعنی فیلد your-name، your-email و غیره وجود داشته باشد).
- نام LEAD_FIELD باید دقیقاً مطابق کلید فیلدهای مورد انتظار در crmاکسیرتجارت باشد؛ اگر مطمئن نیستید چه اسمی استفاده کنید، در CRM بررسی کنید یا از تیم فنی سوال کنید.
استفاده از محتوای HTML (Use HTML Content Type)
در تب Mail فرم Contact Form 7، گزینه Use HTML content type را فعال (تیک) کنید تا ایمیل با فرمت HTML ارسال شود.
این لازم است چون ما از تگهای HTML (مثل <div>) برای انتقال مقادیر استفاده میکنیم.
جمعبندی گامبهگام (خلاصه)
- در بخش Additional Headers خط Bcc: yourleadsintegrationemail@example.com را اضافه کنید.
- هدر Reply-To را با شورتکد ایمیل فرم (مثلاً [your-email]) تنظیم کنید.
- در Message Body برای هر فیلد از قالب <div id=”field_LEAD_FIELD”>[your-field]</div> استفاده کنید و LEAD_FIELD را با کلید مناسب CRM جایگزین کنید.
- تیک Use HTML content type را فعال کنید.
- از طریق CRON و تنظیمات ایمیل یکپارچهسازی، crmاکسیرتجارت ایمیلها را خوانده و سرنخها را وارد میکند.
فیلدهای قابل پذیرش برای سرنخ (Available lead fields)
در crmاکسیرتجارت میتوانید از فیلدهای زیر در بدنهٔ ایمیل برای ایجاد/پر کردن رکورد سرنخ استفاده کنید:
- field_name — نام
- field_title — عنوان (مثلاً آقای/خانم یا سمت)
- field_email — ایمیل
- field_website — وبسایت
- field_phonenumber — تلفن
- field_company — شرکت
- field_description — توضیحات / پیام
- field_address — آدرس
- field_city — شهر
- field_state — استان
- field_country — کشور
- field_zip — کد پستی
- field_lead_value — ارزش سرنخ (اضافهشده در نسخه v2.5.0)
⚠️ دربارهٔ فیلد کشور (field_country)
اگر فیلد کشور را ارسال میکنید، دقت کن:
- مقدار یا باید عدد شناسه (ID) کشور در جدول کشورها (tblcountries) در دیتابیس crmاکسیرتجارت باشد،
- یا باید نام کشور بهطور دقیق (مثلاً United States) ارسال شود — بدون اشتباه تایپی.
سیستم تلاش میکند نام فرستادهشده را با جدول کشورها مطابقت دهد و شناسهٔ مناسب را پیدا کند.
اگر نام کشور اشتباه نوشته شود (مثلاً Untited States) یا در جدول کشورها وجود نداشته باشد، سیستم نمیتواند کشور را شناسایی کند.
اگر ممکن است نام کشور را به فارسی میفرستید، بهتر است از شناسهٔ عددی کشور استفاده کنید یا از مدیر سیستم بخواهید نام دقیق انگلیسی کشورها را بررسی کند.
🔧 فیلدهای سفارشی (Custom Fields)
اگر میخواهید فیلد سفارشی برای سرنخ پر کنید:
- از قالب custom_field_ID استفاده کن (مثلاً custom_field_12) — بهجای IDشناسهٔ واقعی فیلد سفارشی را قرار بده.
- شناسهٔ فیلد سفارشی را در مسیر تنظیمات → فیلدهای سفارشی (Setup → Custom Fields) میتوانی ببینی.
نمونه در بدنهٔ ایمیل:
<div id=”custom_field_12″>[your-custom-field]</div>
در این مثال 12 شناسهٔ فیلد در CRM و [your-custom-field] شورتکد فرمِ شماست.
✅ نکات مهم دربارهٔ انواع فیلدها
- اگر فیلد سفارشی از نوع Checkbox یا Select است:
گزینههایی که ارسال میکنی باید دقیقاً همان عباراتی باشند که در تنظیمات فیلد سفارشی در crmاکسیرتجارت تعریف شدهاند (بدون تغییر یا اشتباه تایپی).
- برای فیلدهای تاریخ: مقدار باید در فرمت Y-m-d باشد (مثلاً 2024-12-31).
- همیشه قبل از ارسال ایمیل، مطمئن شو شورتکدهای فرم (مثل [your-name]، [your-email] و …) در فرم ساخته شدهاند.
🔁 مثال عملی (نمونهٔ بدنهٔ ایمیل)
فرض کن فرم Contact Form 7 شامل این شورتکدهاست: [your-name], [your-email], [your-message] و یک فیلد سفارشی با شناسهٔ 12 که شورتکدش [your-type] است. بدنهٔ ایمیل میتواند بهصورت زیر باشد:
<div id=”field_name”>[your-name]</div>
<div id=”field_email”>[your-email]</div>
<div id=”field_description”>[your-message]</div>
<div id=”custom_field_12″>[your-type]</div>
بعد از ارسال، این تگها به مقادیر واقعی جایگزین میشوند و crmاکسیرتجارت آنها را بهعنوان فیلدهای سرنخ ثبت میکند.
✔️ جمعبندی کوتاه و کاربردی
- از کلیدهای استاندارد (field_name, field_email, …) استفاده کن تا CRM بهطور خودکار فیلدها را شناسایی کند.
- برای کشور یا شناسه کشور دقت کن (ID یا نام دقیق).
- فیلدهای سفارشی را با custom_field_ID بفرست.
- گزینههای Select/Checkbox و فرمت تاریخ دقیق باشند.
📎 پیوستها (Attachments)
در تب Mail فرم Contact Form 7، کافیست تگ مربوط به فایل را در بخش File Attachments اضافه کنید.
توجه داشته باشید که فقط فایلهایی با پسوندهای مجاز که در مسیر تنظیمات → تنظیمات عمومی → پیوستها (Setup->Settings->General) در crmاکسیرتجارت تعریف شدهاند، هنگام وارد کردن سرنخ اضافه خواهند شد.
📝 مثال کامل با فیلدهای بیشتر
فرض کنیم فرم Contact Form 7 ما شامل فیلدهای زیر است:
- موضوع (Subject)
- نام (Name)
- ایمیل (Email)
- وبسایت (Website)
- شماره تلفن (Phone number)
- شرکت (Company)
- پیام (Message)
تنظیم فیلدهای فرم Contact Form 7
فرم شما میتواند به شکل زیر باشد (میتوانید استایل آن را مطابق سلیقه خود تغییر دهید):
<label> Subject
[text* your-subject] </label>
<label> Your Name (required)
[text* your-name] </label>
<label> Your Email (required)
[email* your-email] </label>
<label> Website
[text your-website] </label>
<label> Phone Number
[text your-phonenumber] </label>
<label> Company
[text your-company] </label>
<label> Your Message
[textarea your-message] </label>
[submit “Send”]
📧 تنظیم بدنهٔ ایمیل (Mail Tab Config)
برای تنظیم ایمیل، روی تب Mail کلیک کنید و محتوای بدنهٔ ایمیل را مطابق فرم زیر وارد کنید.
میتوانید از شورتکدهای فرم استفاده کنید که در بالای تب Mail Tab نمایش داده میشوند (“In the following fields, you can use these mail-tags”).
نمونه بدنهٔ ایمیل:
From: [your-name] <[your-email]>
Subject: [your-subject]
Name:
<div id=”field_name”>[your-name]</div>
Email:
<div id=”field_email”>[your-email]</div>
Website:
<div id=”field_website”>[your-website]</div>
Phone Number:
<div id=”field_phonenumber”>[your-phonenumber]</div>
Company:
<div id=”field_company”>[your-company]</div>
Message Body:
<div id=”field_description”>[your-message]</div>
—
This e-mail was sent from a contact form on crmاکسیرتجارت
✅ توضیح:
- تمام مقادیر فرم داخل <div> با id مشخص (field_LEAD_FIELD) قرار میگیرند.
- LEAD_FIELD همان فیلدهای قابل پذیرش سرنخ هستند (field_name, field_email, field_description و غیره).
- پیام کاربر در فرم، در فیلد توضیحات سرنخ ذخیره میشود.
- موضوع ایمیل (Subject) به فیلدهای سرنخ اضافه نمیشود، اما میتوانید برای آن فیلد سفارشی بسازید یا از طریق تب Email Activityدر رکورد سرنخ مشاهده کنید.
🔄 فرآیند خودکار وارد کردن سرنخها
وقتی کاربر فرم Contact Form 7 را پر میکند:
- پلاگین Contact Form 7 ایمیل مربوطه را به همراه BCC ایمیل یکپارچهسازی سرنخها ارسال میکند.
- وظیفه زمانبندی (Cron Job) crmاکسیرتجارت این ایمیل را خوانده و تمام فیلدهای داخل ایمیل را شناسایی میکند.
- سرنخها بهصورت خودکار در بخش سرنخها (Leads) در crmاکسیرتجارت ثبت میشوند.
💡 نکته حرفهای
این روش را میتوان برای هر پلاگین فرم تماس وردپرس یا حتی یک فرم ایمیل ساده PHP استفاده کرد، کافیست:
- BCC ایمیل یکپارچهسازی سرنخها را اضافه کنید،
- بدنهٔ ایمیل را همانطور که توضیح داده شد فرمتبندی کنید.
به این ترتیب، تمام فرمها بدون نیاز به تغییرات پیچیده، میتوانند سرنخها را مستقیم به crmاکسیرتجارت ارسال کنند.