ثبت خودکار سرنخ‌های فروش از فرم سایت با اتصال API به نرم افزار CRM آریا

در بیشتر شرکت‌های ایرانی، فرم تماس با ما یا درخواست مشاوره روی سایت، سرنوشت مشخصی دارد: بازدیدکننده فرم را پر می‌کند، دکمه ارسال را می‌زند و اطلاعاتش به یک ایمیل می‌رود. آن ایمیل معمولاً به اینباکس یک نفر — مسئول سایت، مدیر بازاریابی یا حتی مدیرعامل — می‌رسد. اگر آن فرد در دسترس نباشد، مرخصی باشد یا صرفاً بین صدها ایمیل دیگر آن را نبیند، سرنخ فروش بدون آنکه کسی متوجه شود، از بین می‌رود. هیچ سابقه‌ای در قیف فروش ثبت نمی‌شود، هیچ کارشناسی مسئول پیگیری آن نمی‌شود و تیم فروش اصلاً نمی‌داند چنین درخواستی وجود داشته است.

این اتفاق در عمل بیشتر از آنچه تصور می‌شود رخ می‌دهد. کافی است مسئول سایت برای چند روز مرخصی برود، ایمیل شرکت دچار مشکل فنی موقت شود یا صرفاً پیام در میان انبوه ایمیل‌های تبلیغاتی و اسپم گم شود؛ در همه این حالت‌ها، مشتری بالقوه‌ای که با نیت خرید یا همکاری فرم را پر کرده، بدون هیچ پاسخی می‌ماند و معمولاً به سراغ رقیب می‌رود. این نوع هدررفت، برخلاف خرابی سرور یا خطای فنی، هیچ هشداری تولید نمی‌کند؛ هیچ‌کس متوجه نمی‌شود که یک فرصت فروش از دست رفته، چون اصلاً چیزی برای بررسی وجود ندارد.

این مشکل وقتی جدی‌تر می‌شود که حجم درخواست‌ها بالا برود. یک فرم درخواست دمو، یک فرم دانلود کاتالوگ محصول یا حتی فرم استخدام روی سایت شرکت، هرکدام می‌توانند روزانه ده‌ها ورودی داشته باشند. وقتی این ورودی‌ها فقط در ایمیل پراکنده می‌شوند، عملاً هیچ مدیریتی روی آن‌ها وجود ندارد؛ نه می‌شود دید کدام سرنخ پیگیری شده، نه مشخص است چه کسی مسئول تماس با آن است و نه گزارشی از نرخ تبدیل این کانال در دست است.

راه‌حل درست، حذف واسطه ایمیل و اتصال مستقیم فرم سایت به یک سامانه مدیریت ارتباط با مشتری است. نرم افزار CRM آریا برای دقیقاً همین سناریو یک رابط برنامه‌نویسی (API) رسمی و مستندشده در اختیار توسعه‌دهندگان قرار می‌دهد که با نام «API ارسال فرم» شناخته می‌شود. در این مقاله با جزئیات فنی واقعی این API، نحوه پیاده‌سازی آن روی هر فرم HTML دلخواه، و مسیر سرنخ از لحظه ثبت تا رسیدن به دست تیم فروش آشنا می‌شوید.

فرم‌ساز آریا و مفهوم اتصال از طریق API

پیش از پرداختن به جزئیات فنی، لازم است مفهوم «فرم‌ساز» در نرم افزار CRM آریا روشن شود. فرم‌ساز آریا ابزاری کاملاً گرافیکی است که با آن می‌توان بدون نیاز به دانش برنامه‌نویسی، فرم‌های سفارشی با ترکیب دلخواهی از فیلدها ساخت — از نام و شماره تماس گرفته تا فیلدهای تخصصی‌تر مثل عنوان شغلی، بودجه پروژه یا توضیحات آزاد. هر فرمی که در فرم‌ساز ساخته می‌شود، دقیقاً مانند ماژول‌های پیش‌فرض سامانه، قابلیت ارجاع‌دهی و پیگیری دارد؛ یعنی هر ورودی که وارد این فرم شود، یک رکورد قابل مدیریت در سامانه ایجاد می‌کند، نه صرفاً یک پیام متنی.

سوال این است: چطور اطلاعاتی که کاربر در فرم سایت شما وارد می‌کند، به این فرم‌ساز برسد؟ دو مسیر وجود دارد. مسیر اول، دستی است: کسی باید ایمیل را باز کند و اطلاعات را یکی‌یکی در سامانه وارد کند. این روش هم کند است و هم مستعد خطای انسانی و فراموشی. مسیر دوم، اتصال مستقیم از طریق API است: به‌محض اینکه کاربر روی سایت شما دکمه ارسال فرم را می‌زند، همان لحظه یک درخواست از سرور سایت شما به سرور آریا CRM ارسال می‌شود و اطلاعات مستقیماً در فرم مقصد ثبت می‌شود، بدون هیچ واسطه انسانی.

مزیت این روش فقط سرعت نیست. وقتی سرنخ بلافاصله و بدون تأخیر وارد سامانه می‌شود، می‌توان از همان ابتدا برایش مسئول پیگیری و زمان اقدام بعدی تعیین کرد؛ یعنی درست همان کاری که یک سازمان فروش حرفه‌ای باید انجام دهد. علاوه بر فرم تماس یا درخواست دمو روی سایت اصلی، همین API برای سناریوهای دیگری هم قابل استفاده است: فرم استخدام سایت، اتصال یک اپلیکیشن موبایل سفارشی به سامانه، ارسال پیام از تلگرام به CRM، یا حتی طراحی یک پرتال مستقل برای مشتریان که پشت صحنه با آریا CRM در ارتباط است. در همه این موارد، منطق یکسان است: هر سیستمی که بتواند یک درخواست HTTP از نوع POST ارسال کند، می‌تواند به آریا CRM متصل شود.

نحوه کار API ارسال فرم: پارامترها و ساختار درخواست

API ارسال فرم آریا CRM از نظر فنی ساده و مستقیم طراحی شده است. هر درخواست باید از نوع POST باشد و به آدرس زیر ارسال شود:

https://your-domain.com/api.php

در این آدرس، به‌جای «your-domain.com» باید دامنه اختصاصی سامانه آریا CRM سازمان شما قرار بگیرد. این API سه پارامتر اجباری دارد که بدون هرکدام از آن‌ها، درخواست معتبر شناخته نمی‌شود:

• key: کلید امنیتی اختصاصی API که از تنظیمات سامانه دریافت می‌شود و هویت درخواست‌دهنده را تأیید می‌کند.
• userid: شناسه کاربری در آریا CRM که سرنخ‌های ثبت‌شده به او اختصاص داده می‌شوند یا در سامانه به نام او ثبت می‌شوند.
• formid: شناسه فرم مقصد در فرم‌ساز که اطلاعات باید در آن ذخیره شود.

علاوه بر این سه پارامتر اجباری، باید نامک (slug) فیلدهای همان فرم را هم به‌عنوان پارامترهای اختیاری همراه درخواست ارسال کنید — یعنی همان فیلدهایی که هنگام ساخت فرم در فرم‌ساز تعریف کرده‌اید، مثل name، mobile، email یا tell. نامک دقیق هر فیلد را می‌توانید از تنظیمات همان فیلد در فرم‌ساز مشاهده و کپی کنید. نکته مهم این است که نام این پارامترها باید دقیقاً با نامک فیلدهای فرم مقصد یکی باشد، وگرنه مقدار ارسالی در فیلد درست نمی‌نشیند.

فرض کنید یک فرم HTML ساده برای «درخواست مشاوره» روی سایت شرکت دارید که سه فیلد نام، شماره موبایل و ایمیل را دریافت می‌کند. یک نمونه پیاده‌سازی سمت سرور (با PHP، صرفاً برای نمایش منطق درخواست) به این شکل خواهد بود:

<?php
$data = array(
    'key'    => 'YOUR_API_KEY',
    'userid' => '12',
    'formid' => '45',
    'name'   => $_POST['name'],
    'mobile' => $_POST['mobile'],
    'email'  => $_POST['email'],
);

$ch = curl_init('https://your-domain.com/api.php');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

// در صورت موفقیت، $response برابر رشته "ok" خواهد بود
?>

در این نمونه، فرم HTML سایت شما داده‌های کاربر را به یک اسکریپت PHP روی همان سرور سایت ارسال می‌کند و آن اسکریپت است که درخواست POST را به سمت آریا CRM می‌فرستد. اگر درخواست معتبر باشد، پاسخ API دقیقاً رشته «ok» خواهد بود — نه یک ساختار JSON پیچیده، نه کد وضعیت خاص، فقط یک رشته ساده که موفقیت عملیات را تأیید می‌کند. اگر کلید امنیتی نامعتبر باشد یا مشکلی در احراز هویت درخواست وجود داشته باشد، به‌جای «ok» پیام خطای مربوطه بازگردانده می‌شود که می‌توانید از آن برای عیب‌یابی استفاده کنید.

همین ساختار ساده باعث می‌شود این API را بتوان از هر زبان برنامه‌نویسی یا هر پلتفرمی فراخوانی کرد — چه سایت شما با PHP ساده نوشته شده باشد، چه با Node.js، چه با هر فریم‌ورک دیگری. تنها چیزی که لازم است، توانایی ارسال یک درخواست POST با پارامترهای بالا است.

نکات امنیتی و عملی که در پیاده‌سازی نباید نادیده گرفت

یک نکته امنیتی رسمی و بسیار مهم درباره این API وجود دارد که باید حتماً رعایت شود: کلید امنیتی (key) هرگز نباید در کدی قرار بگیرد که برای کاربران قابل مشاهده است. به بیان دقیق‌تر، اگر این کلید را مستقیماً داخل کد جاوااسکریپت سمت مرورگر (client-side) قرار دهید، هر بازدیدکننده‌ای با باز کردن ابزار توسعه‌دهنده مرورگر می‌تواند آن را ببیند و از آن سوءاستفاده کند — مثلاً برای ارسال حجم انبوهی از داده‌های جعلی به سامانه شما. به همین دلیل، درخواست به API ارسال فرم باید همیشه از سمت سرور (بک‌اند) سایت انجام شود، نه مستقیماً از جاوااسکریپت سمت کاربر. الگوی درست همان چیزی است که در نمونه کد بالا نشان داده شد: فرم HTML داده را به یک اسکریپت روی سرور خودتان می‌فرستد، و آن اسکریپت — که کلید امنیتی در آن پنهان است و کاربر هرگز آن را نمی‌بیند — درخواست را به آریا CRM ارسال می‌کند.

نکته عملی دوم، تطابق دقیق نامک فیلدها با فرم مقصد است. اگر فرمی در فرم‌ساز طراحی کرده‌اید که فیلد شماره تماس آن نامک «mobile» دارد، اما در کد اتصال به اشتباه پارامتر «phone» ارسال کنید، آن مقدار در هیچ فیلدی ثبت نخواهد شد یا در بهترین حالت نادیده گرفته می‌شود. پیش از پیاده‌سازی نهایی، حتماً وارد تنظیمات فرم موردنظر در فرم‌ساز آریا CRM شوید و نامک دقیق هر فیلد را یادداشت کنید. همچنین توصیه می‌شود پیش از اتصال به فرم واقعی سایت، یک بار درخواست تستی با داده نمونه ارسال کنید و مطمئن شوید پاسخ «ok» دریافت می‌شود و رکورد در سامانه به‌درستی ایجاد شده است.

در پیاده‌سازی واقعی، توصیه می‌شود پاسخ دریافتی از API را نادیده نگیرید. از آنجا که در صورت موفقیت مقدار بازگشتی دقیقاً رشته «ok» است و در غیر این صورت پیام خطا برگردانده می‌شود، منطق ساده‌ای در همان اسکریپت سمت سرور اضافه کنید که این پاسخ را بررسی کند: اگر پاسخ برابر «ok» نبود، خطا را در یک فایل لاگ ثبت کنید یا حتی یک ایمیل کوتاه هشدار برای مسئول فنی سایت ارسال کنید. این کار باعث می‌شود اگر روزی کلید امنیتی منقضی شد یا شناسه فرم به اشتباه تغییر کرد، مشکل همان روز کشف شود، نه هفته‌ها بعد که متوجه شوید مدتی است هیچ سرنخی از سایت وارد سامانه نشده است. همچنین بهتر است تجربه کاربری فرم سایت را مستقل از موفقیت یا شکست این درخواست پس‌زمینه‌ای طراحی کنید؛ یعنی حتی اگر ارتباط با API به هر دلیل موقتاً قطع شد، کاربر همچنان پیام «درخواست شما ثبت شد» را ببیند و اطلاعات او به‌صورت جایگزین (مثلاً در یک جدول پایگاه داده محلی سایت) هم ذخیره شود تا در صورت بروز مشکل، قابل بازیابی و ثبت دستی باشد.

باید صادقانه گفت که این یک راهکار کدنویسی است، نه یک افزونه یا پلاگین آماده که با یک کلیک نصب شود. اتصال هر فرم سایت به این API نیازمند نوشتن چند خط کد سمت سرور است — چه با PHP، چه با هر زبان دیگری که سایت شما با آن ساخته شده. برای سایت‌های شرکتی معمولی که با HTML و PHP ساده یا یک سیستم مدیریت محتوای عمومی ساخته شده‌اند، این کار معمولاً کار پیچیده یا زمان‌بری نیست و یک توسعه‌دهنده وب می‌تواند آن را در کوتاه‌ترین زمان پیاده‌سازی کند. لازم به ذکر است برای فروشگاه‌های اینترنتی مبتنی بر ووکامرس، مسیر اختصاصی دیگری هم برای اتصال به آریا CRM وجود دارد که می‌توانید در اتصال WooCommerce به نرم افزار CRM درباره آن بیشتر بخوانید؛ اما موضوع این مقاله همین سناریوی عمومی‌تر است: هر فرم HTML، در هر سایتی، از فرم تماس گرفته تا فرم استخدام یا فرم دانلود کاتالوگ.

بعد از ثبت خودکار سرنخ، چه اتفاقی در نرم افزار CRM می‌افتد

نقطه قوت اصلی این اتصال، جایی است که خیلی از پیاده‌سازی‌های ساده به آن توجه نمی‌کنند: سرنوشت سرنخ بعد از ثبت. وقتی یک درخواست از طریق API ارسال فرم با موفقیت پردازش می‌شود، اطلاعات کاربر صرفاً «ذخیره» نمی‌شود؛ بلکه دقیقاً مانند هر سرنخ یا فرصت فروش دیگری وارد قیف فروش سامانه می‌شود. این یعنی همان تیمی که سرنخ‌های حاصل از تماس تلفنی، نمایشگاه یا معرفی مشتریان قبلی را مدیریت می‌کند، سرنخ فرم سایت را هم دقیقاً در همان محیط و با همان فرآیند می‌بیند — بدون نیاز به هماهنگی جداگانه یا ابزار اضافی.

از آنجا که پارامتر userid در همان درخواست API مشخص می‌کند سرنخ به نام کدام کاربر ثبت شود، می‌توان از همان لحظه ورود، مسئول پیگیری اولیه را تعیین کرد. پس از آن، مثل هر رکورد دیگر در بخش سرنخ‌ها و فرصت‌های فروش، می‌توان برای آن تاریخ اقدام بعدی تعریف کرد، وضعیتش را در مراحل قیف فروش (از سرنخ اولیه تا مذاکره و نهایی‌شدن) جابه‌جا کرد و یادداشت‌های پیگیری ثبت کرد. این یعنی مدیر فروش در هر لحظه می‌تواند ببیند چند سرنخ از کانال سایت وارد شده، کدام‌ها پیگیری شده‌اند و کدام‌ها بدون پاسخ مانده‌اند — چیزی که در حالت پراکنده‌بودن سرنخ‌ها در ایمیل، اصلاً قابل اندازه‌گیری نیست.

این مسئله به‌ویژه برای سایت‌هایی که چند نوع فرم دارند اهمیت پیدا می‌کند. با تعریف formid متفاوت برای هر فرم — یکی برای فرم تماس با ما، یکی برای فرم درخواست دمو، یکی برای فرم دانلود کاتالوگ — می‌توان همه این ورودی‌ها را در فرم‌های جداگانه اما همگی درون یک سامانه واحد نگه داشت و بعداً بر اساس منبع ورود، گزارش گرفت. برای آشنایی با سایر امکانات مربوط به مدیریت این نوع سرنخ‌ها، صفحه سرنخ‌ها و فرصت‌های فروش و همچنین فهرست کامل امکانات نرم افزار CRM آریا را ببینید.

سوالات متداول

آیا برای اتصال فرم سایت به CRM حتماً به برنامه‌نویس نیاز دارم؟

بله. باید صادقانه گفت که API ارسال فرم یک رابط برنامه‌نویسی فنی است، نه یک افزونه آماده با نصب یک‌کلیکی. برای اتصال آن به فرم سایت خودتان، حداقل به یک توسعه‌دهنده وب نیاز دارید که بتواند یک درخواست POST سمت سرور بنویسد — چه با PHP، چه با هر زبان دیگری که سایت شما با آن ساخته شده است. برای اکثر سایت‌های شرکتی این کار پیچیدگی خاصی ندارد و در عرض چند ساعت قابل انجام است.

اگر چند فرم مختلف روی سایت داشته باشم، باید چه کار کنم؟

برای هر فرم، یک فرم مستقل در فرم‌ساز آریا CRM طراحی کنید و formid اختصاصی همان فرم را در کد اتصال به‌کار ببرید. به این ترتیب می‌توانید فرم تماس، فرم درخواست دمو و فرم استخدام را کاملاً جدا از هم مدیریت کنید، در حالی که همه در یک سامانه واحد و برای تیم فروش و منابع انسانی قابل دسترسی هستند.

آیا این روش برای فروشگاه‌های اینترنتی هم مناسب است؟

این API برای اتصال فرم‌های عمومی — مثل فرم تماس، درخواست مشاوره یا استخدام — طراحی شده و برای این سناریوها بهترین گزینه است. برای فروشگاه‌های مبتنی بر ووکامرس که هدف اتصال سفارش‌های خرید است، مسیر اختصاصی دیگری وجود دارد که جزئیات آن را می‌توانید در اتصال WooCommerce به نرم افزار CRM مطالعه کنید.

اتصال مستقیم فرم‌های سایت به نرم افزار CRM آریا از طریق API ارسال فرم، یکی از ساده‌ترین اما پراثرترین اقداماتی است که یک کسب‌وکار می‌تواند برای جلوگیری از هدررفت سرنخ‌های فروش انجام دهد. با چند خط کد سمت سرور، می‌توانید مطمئن شوید هیچ درخواست تماس یا مشاوره‌ای دیگر در ایمیل شخصی گم نمی‌شود و هر سرنخ، از همان لحظه ورود، وارد قیف فروش و در دست مسئول مشخصی برای پیگیری قرار می‌گیرد. برای مشاهده مستندات کامل و به‌روز این API، به صفحه آموزش API ارسال فرم مراجعه کنید و اگر هنوز نرم افزار CRM آریا را در سازمان خود پیاده‌سازی نکرده‌اید، از طریق درخواست دموی رایگان با امکانات آن از نزدیک آشنا شوید.