ارسال پیامک با کاوهنگار: از کلید API تا کمپین هدفمند
کاوهنگار پنلی است که با ذهنیت توسعه‌دهنده ساخته شده: یک API رست، کتابخانهٔ رسمی برای چند زبان برنامه‌نویسی و سرویس جداگانه برای کد یک‌بارمصرف. هدهدهاب همان کلید را می‌گیرد و چیزی را اضافه میکند که خود پنل ندارد — گروه هدف، آزمون A/B و شمارش کلیک هر پیام.
قبل از شروع بدان: ارسال با کلید کاوهنگار در پلن‌های پولی باز است و دورهٔ آزمایشی پیامک ندارد. پیامک و اعتبار را هم از ما نمی‌خری؛ هر پیام از حساب کاوهنگار خودت و با تعرفهٔ خودت می‌رود.
- ارسال با کلید API خودت، روی همان تعرفه‌ای که با کاوهنگار بسته‌ای
- شمارهٔ خط اختیاری است؛ اگر ندهی، پیام با خط پیشفرض همان حساب می‌رود
- کمپین با گروه هدف، آزمون A/B و لینک ردیاب روی مخاطب‌های خودت
- تأیید کلید در همان لحظهٔ ثبت، با یک درخواست کوچک به حساب کاوهنگار
چطور راه می‌افتد
- ۱
کلید API را از حساب کاوهنگار بردار
از بخش تنظیمات حساب کاربری کاوهنگار کلید API را کپی میکنی. همین یک رشته برای همهٔ ارسال‌ها کافی است؛ نام کاربری و رمز پنل هیچ‌وقت از تو خواسته نمیشود و جایی ذخیره نمیشود.
- ۲
اگر خط اختصاصی داری، شماره‌اش را هم بنویس
برخلاف سه پنل دیگر، کاوهنگار در این اتصال بدون شمارهٔ فرستنده هم کار میکند: اگر خالی بگذاری پیام با خط پیشفرض حساب خودت می‌رود، و اگر شماره بدهی همان خط ملاک ارسال میشود.
- ۳
کلید را در «اتصالها» ثبت و تأیید کن
به‌محض ثبت، یک درخواست کوچک به سرویس اطلاعات حساب کاوهنگار زده میشود تا معلوم شود کلید واقعاً کار میکند. کلید رمزنگاریشده ذخیره میشود، خام به رابط کاربری برنمیگردد و در هیچ گزارشی نوشته نمیشود.
- ۴
اول یک پیام واقعی، بعد کمپین
پیش از هر ارسال گروهی یک پیام به شمارهٔ خودت بفرست تا ببینی متن با کدام خط و با چه فرستنده‌ای به دست مخاطب می‌رسد؛ همین یک تست کوچک، بیشتر اشتباه‌های روز اول را می‌گیرد.
کجا به کار می‌آید
تیمی که از قبل با API کاوهنگار کار کرده
خیلی از فروشگاه‌ها کاوهنگار را برای کد ورود یا پیامک ثبت سفارش به سایتشان وصل کرده‌اند. همان کلید این‌جا هم کار میکند؛ لازم نیست حساب تازه بسازی، خط جدید بخری یا اعتبار دیگری شارژ کنی.
یادآوری نوبت در کلینیک و آموزشگاه
برای کسب‌وکاری که وقتش را می‌فروشد، غیبتِ بدون اطلاع گران‌ترین اتفاق روز است. فهرست نوبت‌های فردا را با یک برچسب وارد میکنی و عصرِ امروز برای همان گروه یادآوری می‌فرستی؛ پیامک به هر شماره‌ای می‌رسد — حتی مشتری‌ای که هیچ پیام‌رسانی را باز نمی‌کند. یادآوری خودکار بر اساس تاریخ نوبت هر نفر هنوز نداریم.
کمپین روی یک گروه مشخص، نه روی کل فهرست
به‌جای ارسال به تمام دفترچهٔ شماره‌ها، مثلاً فقط شماره‌هایی را که برچسب «مشتری وفادار» دارند یا بعد از یک تاریخ مشخص اضافه شده‌اند جدا میکنی، دو متن را هم‌زمان آزمایش میکنی و می‌بینی کدام نسخه کلیک بیشتری آورده است.
کدام بخش از API کاوهنگار واقعاً استفاده میشود
شفاف بگوییم این اتصال دقیقاً چه میکند. برای ارسال، سرویس ارسال پیامک کاوهنگار با متن آزاد صدا زده میشود؛ برای تأیید کلید، سرویس اطلاعات حساب؛ و همین. مسیر ارسال با الگو (lookup) در کد ما نوشته شده اما فقط برای فرستادن کد ورود خودِ هدهدهاب از خط خودمان به کار می‌رود و روی کمپین‌ها و ربات‌های تو اجرا نمیشود. سرویس‌های دیگر کاوهنگار مثل تماس صوتی و وب‌پوش هم اصلاً بخشی از این اتصال نیستند. ترجیح می‌دهیم فهرست کوتاه و درست باشد تا فهرست بلند و نصفه‌درست.
خط پیشفرض، خط اختصاصی، و فرقشان سر تحویل
سامانه‌های پیامکی دو جنس خط دارند: خدماتی، که برای پیام‌های ضروری مثل کد و وضعیت سفارش است، و تبلیغاتی، که برای کمپین به کار می‌رود و قواعد سخت‌گیرانه‌ترش دست اپراتور است. چیزی که این اتصال را متفاوت میکند این است که اجبارت نمی‌کند از همان اول شمارهٔ خط بدهی؛ می‌توانی با خط پیشفرض حسابت شروع کنی و بعد که مطمئن شدی پیامک برایت کار میکند، سراغ خط اختصاصی بروی. اینکه کدام متن روی کدام خط مجاز است، تصمیم اپراتور و کاوهنگار است، نه ما.
پنل سر جایش می‌ماند؛ چیزی که کم دارد تصمیم است
یک پنل پیامک کارش تحویل پیام است و در همان کار هم خوب است؛ چیزی که ندارد قضاوت است. پنل نمی‌داند این شماره از کجا آمده، چه برچسبی دارد و کدام متن کلیک بیشتری گرفته است. هدهدهاب دقیقاً همین لایه را اضافه میکند و تحویل نهایی را به حساب کاوهنگار خودت می‌سپارد؛ نه پنلت عوض میشود، نه تعرفه‌ات. اگر هنوز پنلی نخریده‌ای، مقایسهٔ چهار سامانهٔ پشتیبانی‌شده را در راهنمای انتخاب پنل پیامک آورده‌ایم.
منابع و شواهد
در یک نگاه
- چه چیزی لازم داری
- کلید API کاوهنگار؛ شمارهٔ خط اختیاری است و در نبودش خط پیشفرض حساب استفاده میشود.
- تأیید اتصال
- یک درخواست به سرویس اطلاعات حساب؛ موجودی و ریز تعرفهٔ پنل را نمایش نمی‌دهیم.
- مسیر ارسال
- ارسال متن آزاد؛ مسیر الگو (lookup) فقط برای کد ورود خودِ هدهدهاب استفاده میشود.
- هزینه
- همان تعرفهٔ حساب خودت به تومان؛ هدهدهاب واسطهٔ فروش پیامک نیست و چیزی روی آن نمی‌کشد.
- سقف ارسال
- هر پلن سقف پیامک جدا در هر ۲۸ روز دارد (شروع ۳۰۰، رشد ۱٬۵۰۰، مقیاس ۶٬۰۰۰)؛ دورهٔ آزمایشی ۷ روزه ارسال پیامک ندارد. جزئیات در صفحهٔ قیمت‌ها.
- انصراف
- لینک «لغو» پای پیام‌های تبلیغاتی و فهرست انصراف مشترک با بقیهٔ کانال‌ها.
بی‌پرده: چه کاری نمی‌کند
این‌ها را همین اول می‌گوییم، نه بعد از خرید.
- ارسال با الگو (پترن) برای کمپین‌ها و ربات‌های تو فعال نیست؛ مسیر lookup کاوهنگار فقط کد ورود خودِ هدهدهاب را می‌فرستد و متن تو آزاد ارسال میشود.
- پیامک خودکار فقط بعد از اولین تماس یا ثبت سرنخ در ربات فرستاده میشود؛ پیامک وضعیت سفارش و یادآوری بر اساس تاریخ هر مشتری نداریم.
- گروه هدف روی فهرست شماره‌ها با برچسب، منبع و تاریخ اضافه‌شدن ساخته میشود؛ شرط «چند روز است خرید نکرده» برای پیامک در دسترس نیست.
- تماس صوتی، وب‌پوش و ارسال بین‌المللی کاوهنگار در این اتصال پشتیبانی نمی‌شوند.
- پیامک نمی‌فروشیم و اعتبار حسابت را شارژ نمی‌کنیم؛ موجودی و تعرفه به تومان دست خودت است.
- بانک شماره ارائه نمی‌دهیم و ارسال به فهرست خریداری‌شده را پشتیبانی نمی‌کنیم.
- تحویل نهایی و محدودیت محتوایی هر خط با اپراتور و کاوهنگار است، نه با ما.
سؤال‌های متداول
اگر خط اختصاصی نداشته باشم چه میشود؟+
چیزی خراب نمیشود؛ شمارهٔ خط را خالی میگذاری و پیام با خط پیشفرض حساب کاوهنگارت ارسال میشود. هر وقت خط اختصاصی گرفتی، فقط شماره را در «اتصالها» اضافه میکنی.
کلید API من کجا نگهداری میشود؟+
رمزنگاریشده در «اتصالها». در API کاوهنگار کلید بخشی از خود آدرس درخواست است، برای همین عمداً هیچجا لاگ نمیشود، خام به رابط کاربری برنمیگردد و هر لحظه قابل حذف است.
ارسال با الگوی کاوهنگار پشتیبانی میشود؟+
برای ارسالهای تو نه. مسیر الگو در کد ما هست ولی فقط برای کد ورود خودِ هدهدهاب استفاده میشود؛ پس اگر جریان کارت به الگوی تأییدشده وابسته است، فعلاً روی این اتصال حساب نکن.
کاوهنگار برای چه کسی مناسبتر است؟+
برای تیمی که خودش هم به API وصل میشود: مستندات و کتابخانهٔ رسمی برای چند زبان دارد و سرویس کد یکبارمصرفش جداست. از نظر کاری که هدهدهاب میکند، چهار پنل تفاوت عملی چندانی ندارند.
در دورهٔ آزمایشی هم می‌توانم پیامک بفرستم؟+
نه. هر پلن سقف پیامک جدا در هر ۲۸ روز دارد (شروع ۳۰۰، رشد ۱٬۵۰۰، مقیاس ۶٬۰۰۰)؛ دورهٔ آزمایشی ۷ روزه ارسال پیامک ندارد. جزئیات در صفحهٔ قیمت‌ها. هزینهٔ هر پیامک هم جداست و از حساب کاوهنگار خودت کم میشود.
از کجا بفهمم پیامکها نتیجه دادهاند؟+
هر لینکی که داخل متن بگذاری ردیاب میشود و ارسال و کلیک شمرده میشود. نسبتدادن خرید به کمپین فقط وقتی ممکن است که فروشگاهت وصل باشد و تکهکد ثبت خرید روی آن نصب شده باشد.
آماده‌ای حرفت رو هدهد کنی؟
بیا شروع کنیم. توی چند دقیقه اولین رباتت رو می‌سازم و قبل از انتشار نشونت می‌دم.