مهارتهای بیسقف: هر سرویسی را به رباتت وصل کن
توانایی هُدهُد سقف ندارد: مهارتهای آمادهٔ حسابداری (حسابفا)، CRM (دیدار)، فروشگاه و سایت — و برای بقیه، کافی است مستندات API را بدهی تا خودش مهارت جدید بسازد.
اگر دنبال «اتصال نرم افزارها به ربات» هستید، این صفحه مسیر عملی را روشن میکند: از مسئلهٔ اصلی و مراحل راهاندازی تا محدودیتها، مثالهای واقعی و سوالهایی که قبل از انتخاب باید جوابشان را بدانید.
- مهارتهای آماده: حسابفا، دیدار، ووکامرس، وردپرس، زرینپال
- مهارتسازی از روی مستندات: توضیح فارسی + لینک docs کافی است
- هر مهارت قبل از فعال شدن روی API واقعی تست میشود
- بازار مهارتها: مهارت ساختهشده را منتشر کن یا از بقیه نصب کن
چطور راه میافتد
- 1
بگو چه کاری باید انجام شود
به فارسی توضیح میدهی مهارت چه کاری بکند: «وضعیت مرسوله را از سامانهٔ پستی بگیر» یا «موجودی انبار را از این سرویس بخوان». هدف را میگویی، نه روش را.
- 2
لینک مستندات API سرویس را بده
هُدهُد از روی همان مستندات، مسیرها، پارامترها و شکل پاسخ را درمیآورد و مهارت را میسازد. اگر جایی مبهم بود، همانجا از خودت میپرسد.
- 3
کلید سرویس را در «اتصالها» ثبت کن
کلیدها رمزنگاریشده در گاوصندوق اتصالها مینشینند، خام در رابط کاربری نشان داده نمیشوند و هر مهارت فقط به سرویس خودش دسترسی دارد.
- 4
قبل از فعالشدن، روی API واقعی تست کن
مهارت پیش از اینکه در ربات یا «دستیار» فعال شود، روی سرویس واقعی خودت اجرا میشود تا ببینی جواب درست میدهد، نه فقط بدون خطا اجرا میشود.
کجا به کار میآید
سرویسهای ایرانی که کسی برایشان افزونه نساخته
سامانهٔ ارسال، انبارداری محلی یا نرمافزار داخلی شرکت — همان چیزهایی که هیچ ابزار جهانی پشتیبانیشان نمیکند ولی مستندات API دارند.
پاسخ ربات از سیستم عملیاتی خودت
وقتی مهارت ساخته شد، ربات میتواند از دادهٔ واقعی همان سرویس به مشتری جواب بدهد — نه از توضیحی که یکبار نوشتهای.
کارهای داخلی از راه «دستیار»
همان مهارت در اختیار «دستیار» هم قرار میگیرد تا خودت با یک جملهٔ فارسی از سرویس استعلام بگیری یا کاری را ثبت کنی.
چرا سقف قابلیتها اهمیت دارد
بیشتر ابزارها فهرست ثابتی از اتصالها دارند و اگر سرویس تو در آن فهرست نباشد، جواب «نداریم» است. برای بازار ایران این محدودیت جدی است، چون بخش بزرگی از سرویسهای پرکاربرد اصلاً در فهرست ابزارهای جهانی نیستند. مدل مهارتسازی این معادله را عوض میکند: بهجای انتظار برای اضافهشدن یک اتصال، مستندات API را میدهی و مهارت ساخته میشود. یعنی سقف قابلیت، فهرست ما نیست؛ فهرست سرویسهایی است که API دارند.
تست روی API واقعی، قبل از استفادهٔ واقعی
مهارتی که فقط «بدون خطا اجرا شد» هنوز قابل اعتماد نیست؛ ممکن است فیلد اشتباهی بخواند یا در حالت خاصی جواب بیمعنا بدهد. برای همین هر مهارت پیش از فعالشدن روی حساب و API واقعی خودت اجرا میشود و خروجیاش را میبینی. این مرحله عمداً اجباری است: مهارتها در نهایت به مشتریهای تو جواب میدهند و اشتباهشان مستقیم پای اعتبار تو نوشته میشود.
مرز خواندن و نوشتن در مهارتها
خواندن کمریسک است و نوشتن نه. به همین دلیل مهارتهایی که چیزی را در سرویس بیرونی تغییر میدهند، مثل بقیهٔ کارهای نوشتنی، از مسیر تأیید عبور میکنند مگر خودت برای یک محدودهٔ مشخص اجازهٔ خودکار داده باشی. این تفکیک باعث میشود بشود با خیال راحت مهارتهای خواندنی زیادی فعال کرد، بدون اینکه ریسک عملیاتی بالا برود.
در یک نگاه
- مهارتهای آماده
- حسابفا، دیدار، ووکامرس، وردپرس و زرینپال.
- برای سرویس جدید
- یک توضیح فارسی از هدف، بهعلاوهٔ لینک مستندات API سرویس.
- تست
- اجرای مهارت روی API واقعی خودت، قبل از فعالشدن.
- امنیت کلید
- رمزنگاریشده در «اتصالها»؛ هر مهارت فقط به سرویس خودش دسترسی دارد.
- اشتراکگذاری
- مهارت ساختهشده قابل انتشار در بازار مهارتها یا نصب از دیگران است.
بیپرده: چه کاری نمیکند
ترجیح میدهیم قبل از خرید بدانی، نه بعد از آن.
- سرویسی که API عمومی یا مستندات ندارد، قابل اتصال نیست؛ راههای دورزننده مثل اسکرپینگ پنل خصوصی را محصولی نمیکنیم.
- کیفیت مهارت به کیفیت مستندات سرویس بستگی دارد؛ مستندات ناقص یعنی مهارت ناقص.
- پایداری سرویس بیرونی دست ما نیست؛ اگر آن سرویس قطع شود، مهارت هم کار نمیکند.
- مهارتهای نوشتنی بهصورت پیشفرض تأیید میخواهند و خودکار اجرا نمیشوند.
سوالات متداول
چه سرویسهایی را میشود وصل کرد؟+
هر سرویسی که API داشته باشد — از نرمافزار حسابداری تا سامانهٔ لجستیک. اگر مستندات دارد، هُدهُد میتواند یاد بگیرد.
امنیت کلیدهای API چطور حفظ میشود؟+
کلیدها رمزنگاریشده در گاوصندوق اتصالها نگهداری میشوند و هر مهارت فقط به سرویس خودش دسترسی دارد.
اگر سرویس من API نداشته باشد چه؟+
آن سرویس قابل اتصال نیست. راههای دورزننده مثل اسکرپینگ پنل خصوصی را عمداً پشتیبانی نمیکنیم چون شکنندهاند و میتوانند حساب تو را به خطر بیندازند.
مهارت میتواند در سرویس من چیزی را تغییر بدهد؟+
اگر مهارت نوشتنی باشد بله، ولی بهصورت پیشفرض با تأیید تو؛ اجرای خودکار فقط در محدودهای که خودت اجازه دادهای انجام میشود.
مهارت ساختهشده مال خودم میماند؟+
بله؛ در همان workspace تو میماند. اگر خواستی میتوانی منتشرش کنی تا بقیه هم نصبش کنند، ولی این کار اختیاری است.
آمادهای حرفت رو هُدهُد کنی؟
بیا شروع کنیم. توی چند دقیقه اولین رباتت رو میسازم و قبل از انتشار نشونت میدم.
همین حالا اولین هُدهُدت رو بساز