سرویس MCP هُما
🛠️
ابزارها
دستیار چه کارهایی میتواند بکند؟
| # | ابزار |
|---|---|
| 1 |
فعال
·
بررسی اتصال و سطح دسترسی توکن
·
«این توکن به چه چیزهایی دسترسی دارد؟»
·
ID
homa_whoami
|
| 2 |
فعال
·
فهرست ابزارهای در دسترس این توکن
·
«چه ابزارهایی برای من فعال است؟»
·
ID
homa_get_capabilities
|
| 3 |
فعال
·
جستجوی سراسری (مخاطب + تیکت)
·
«رضایی را در پرتال پیدا کن»
·
ID
homa_search
|
| 4 |
فعال
·
آمار کلی پرتال
·
«خلاصهٔ وضعیت پرتال را بگو»
·
ID
homa_stats_overview
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
تاریخ و ساعت آنلاین (میلادی + شمسی)
·
«الان ساعت و تاریخ شمسی چیست؟»
·
ID
utilities_get_datetime
|
| 2 |
فعال
·
تولید QR code از متن یا لینک
·
«از این لینک یک QR بساز»
·
ID
utilities_generate_qrcode
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
جستجوی مخاطب
·
«مخاطبی با موبایل ۰۹۱۲… پیدا کن»
·
ID
crm_search_contacts
|
| 2 |
فعال
·
جزئیات مخاطب
·
«جزئیات کامل علی رضایی را نشان بده»
·
ID
crm_get_contact
|
| 3 |
فعال
·
شمارش مخاطبین
·
«چند مخاطب در گروه مشتریان دارم؟»
·
ID
crm_count_contacts
|
| 4 |
فعال
·
فهرست گروههای مخاطب با تعداد اعضا
·
«گروههای مخاطبین را نشان بده»
·
ID
crm_list_contact_groups
|
| 5 |
فعال
·
ساخت مخاطب جدید ✍️
·
«این شماره را با نام علی ذخیره کن»
·
ID
crm_create_contact
|
| 6 |
فعال
·
ویرایش مخاطب ✍️
·
«ایمیل علی رضایی را عوض کن»
·
ID
crm_update_contact
|
| 7 |
فعال
·
ساخت گروه مخاطبین ✍️
·
«یک گروه مخاطبین به نام باشگاه مشتریان بساز»
·
ID
crm_create_group
|
| 8 |
فعال
·
ویرایش گروه مخاطبین ✍️
·
«نام گروه باشگاه را عوض کن»
·
ID
crm_update_group
|
| 9 |
فعال
·
حذف گروه / انتقال اعضا ✍️
·
«اعضای گروه مشتریان را به باشگاه منتقل کن و گروه را حذف کن»
·
ID
crm_delete_group
|
| 10 |
فعال
·
حذف مخاطب ✍️
·
«این مخاطب را حذف کن»
·
ID
crm_delete_contact
|
| 11 |
فعال
·
فهرست پایپلاینهای فروش
·
«مراحل قیف فروش من چیست؟»
·
ID
crm_list_pipelines
|
| 12 |
فعال
·
فهرست معاملات
·
«معاملههای باز این ماه را نشان بده»
·
ID
crm_list_deals
|
| 13 |
فعال
·
ساخت معاملهٔ جدید ✍️
·
«یک معامله برای قرارداد سالانه بساز»
·
ID
crm_create_deal
|
| 14 |
فعال
·
ویرایش / حذف معامله ✍️
·
«مبلغ معامله ۸ را عوض کن» / «معامله ۸ را حذف کن»
·
ID
crm_update_deal
|
| 15 |
فعال
·
فهرست سرنخها
·
«سرنخهای جدید را نشان بده»
·
ID
crm_list_leads
|
| 16 |
فعال
·
ثبت سرنخ جدید ✍️
·
«این تماس نمایشگاه را بهعنوان سرنخ ثبت کن»
·
ID
crm_create_lead
|
| 17 |
فعال
·
ویرایش / حذف سرنخ ✍️
·
«یادداشت سرنخ ۲۲ را بهروز کن»
·
ID
crm_update_lead
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
لیست تیکتهای پشتیبانی
·
«تیکتهای باز من را نشان بده»
·
ID
support_list_tickets
|
| 2 |
فعال
·
جزئیات یک تیکت
·
«وضعیت تیکت ۹۸۱ چیست؟»
·
ID
support_get_ticket
|
| 3 |
فعال
·
جستجوی متنی تیکتها
·
«تیکتهای مربوط به پیامک را پیدا کن»
·
ID
support_search_tickets
|
| 4 |
فعال
·
ثبت تیکت جدید ✍️
·
«یک تیکت فوری برای مشکل ارسال ثبت کن»
·
ID
support_create_ticket
|
| 5 |
فعال
·
پاسخ به تیکت ✍️
·
«روی تیکت ۹۸۱ بنویس مشکل حل شد»
·
ID
support_reply_ticket
|
| 6 |
فعال
·
درخواست پیگیری ✍️
·
«بگو عجله دارم، تیکتم را پیگیری کنند»
·
ID
support_followup_ticket
|
| 7 |
فعال
·
درخواست تماس تلفنی ✍️
·
«بگو با این شماره تماس بگیرند»
·
ID
support_request_callback
|
| 8 |
فعال
·
بستن تیکت ✍️
·
«تیکت ۹۸۱ حل شد، ببندش»
·
ID
support_close_ticket
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
جستجو در دانشنامهٔ منتشرشده
·
«راهنمای شارژ پیامک را پیدا کن»
·
ID
knowledge_search
|
| 2 |
فعال
·
دریافت یک مقالهٔ دانشنامه با شناسه
·
«متن کامل مقالهٔ ۱۲ را بده»
·
ID
knowledge_get_entry
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
فهرست تسکهای کارتابل
·
«تسکهای امروزم را نشان بده»
·
ID
kartable_list_tasks
|
| 2 |
فعال
·
جزئیات یک تسک
·
«جزئیات تسک ۴۱۲ چیست؟»
·
ID
kartable_get_task
|
| 3 |
فعال
·
ساخت تسک جدید ✍️
·
«یک تسک برای پیگیری قرارداد بساز»
·
ID
kartable_create_task
|
| 4 |
فعال
·
ثبت یادداشت روی تسک ✍️
·
«روی تسک ۴۱۲ بنویس تماس گرفته شد»
·
ID
kartable_comment_task
|
| 5 |
فعال
·
تغییر وضعیت تسک ✍️
·
«تسک ۴۱۲ را انجامشده کن»
·
ID
kartable_update_task_status
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
موجودی اعتبار پیامک
·
«چقدر اعتبار پیامک دارم؟»
·
ID
messaging_get_credit
|
| 2 |
فعال
·
فهرست شمارههای فرستنده
·
«با کدام شمارهها میتوانم پیامک بفرستم؟»
·
ID
messaging_list_numbers
|
| 3 |
فعال
·
گزارش پیامکهای ارسالی
·
«پیامکهای این هفته به کجا رسیدند؟»
·
ID
messaging_outbox_report
|
| 4 |
فعال
·
گزارش پیامکهای دریافتی
·
«پیامکهای دریافتی امروز را نشان بده»
·
ID
messaging_inbox_report
|
| 5 |
فعال
·
فهرست پیشنویسهای پیامک
·
«متنهای آمادهٔ پیامک را نشان بده»
·
ID
messaging_list_drafts
|
| 6 |
فعال
·
جزئیات پیشنویس
·
«متن کامل پیشنویس ۴۱ را بده»
·
ID
messaging_get_draft
|
| 7 |
فعال
·
ساخت پیشنویس ✍️
·
«این متن را بهعنوان پیشنویس ذخیره کن»
·
ID
messaging_create_draft
|
| 8 |
فعال
·
ویرایش پیشنویس ✍️
·
«متن پیشنویس خوشآمد را عوض کن»
·
ID
messaging_update_draft
|
| 9 |
فعال
·
حذف پیشنویس ✍️
·
«پیشنویس ۴۲ را حذف کن»
·
ID
messaging_delete_draft
|
| 10 |
فعال
·
ارسال پیامک ✍️ (با تأیید شما — تست فقط از دستیار) ·
messaging_send_sms
·
«به این شماره بگو فاکتور آماده است»
|
| 11 |
فعال
·
پروفایل WhoIS (هویت فرستنده)
·
«وضعیت پروفایل WhoIS من چیست؟»
·
ID
messaging_get_whois_profile
|
| 12 |
فعال
·
فهرست کارزارهای ارسال گروهی
·
«کارزارهای پیامک گروهی را نشان بده»
·
ID
messaging_list_programs
|
| 13 |
فعال
·
جزئیات یک کارزار گروهی
·
«جزئیات کارزار ۵۱۲۰ را بده»
·
ID
messaging_get_program
|
| 14 |
فعال
·
ارسال گروهی ✍️ (با پیشنمایش هزینه و تأیید)
·
«این کارزار را برای همه اجرا کن»
·
ID
messaging_create_bulk_send
|
| 15 |
فعال
·
فهرست لیست سیاه
·
«چه شمارههایی در لیست سیاهاند؟»
·
ID
messaging_list_blacklist
|
| 16 |
فعال
·
قرارداد Gateway قدیمی (فقط اطلاعاتی)
·
«اطلاعات درگاه پیامک حسابداری را بده»
·
ID
messaging_get_gateway
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
فهرست پرتالهای زیرمجموعه
·
«پرتالهای نمایندگیام را نشان بده»
·
ID
deputy_list_portals
|
| 2 |
فعال
·
جزئیات یک پرتال زیرمجموعه
·
«جزئیات پرتال ۱۰۰۰۴۵۶۷ را بده»
·
ID
deputy_get_portal
|
| 3 |
فعال
·
اعتبار پیامک یک زیرمجموعه
·
«اعتبار پرتال ۱۰۰۰۴۵۶۷ چقدر است؟»
·
ID
deputy_get_portal_credit
|
| 4 |
فعال
·
آمار یک پرتال زیرمجموعه
·
«آمار پیامک پرتال ۱۰۰۰۴۵۶۷ را بده»
·
ID
deputy_get_portal_stats
|
| 5 |
فعال
·
آمار کل شبکهٔ نمایندگی
·
«آمار کلی نمایندگیام را بگو»
·
ID
deputy_stats
|
| 6 |
فعال
·
ساخت پرتال زیرمجموعه ✍️
·
«یک پرتال پیامکی جدید برای این مشتری بساز»
·
ID
deputy_create_portal
|
| 7 |
فعال
·
شارژ اعتبار زیرمجموعه ✍️
·
«۵۰۰ هزار تومان اعتبار به پرتال ۱۰۰۰۴۵۶۷ بده»
·
ID
deputy_charge_credit
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
فهرست کالاها
·
«کالاهای دستهٔ دیجیتال را نشان بده»
·
ID
warehouse_list_products
|
| 2 |
فعال
·
دستهبندیهای کالا
·
«دستهبندیهای انبار من چیست؟»
·
ID
warehouse_list_categories
|
| 3 |
فعال
·
موجودی انبار
·
«از لپتاپ ایسوس چند تا مانده؟»
·
ID
warehouse_get_inventory
|
| 4 |
فعال
·
فهرست انبارگردانیها
·
«انبارگردانیهای ثبتشده را نشان بده»
·
ID
warehouse_list_stocktakings
|
| 5 |
فعال
·
ساخت کالای جدید ✍️
·
«یک کالای جدید به نام لپتاپ ایسوس بساز»
·
ID
warehouse_create_product
|
| 6 |
فعال
·
ویرایش کالا ✍️
·
«قیمت کالای ۵۰۲ را بهروز کن»
·
ID
warehouse_update_product
|
| 7 |
فعال
·
ثبت حرکت انبار (ورود/خروج/انتقال) ✍️
·
«۲ عدد لپتاپ به انبار وارد کن»
·
ID
warehouse_create_stock_movement
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
فهرست فاکتورها
·
«فاکتورهای تسویهنشدهٔ این ماه را نشان بده»
·
ID
finance_list_invoices
|
| 2 |
فعال
·
جزئیات فاکتور
·
«اقلام فاکتور ۱۲۰۱ چه بود؟»
·
ID
finance_get_invoice
|
| 3 |
فعال
·
فهرست پرداختها
·
«پرداختهای هفتهٔ گذشته را فهرست کن»
·
ID
finance_list_payments
|
| 4 |
فعال
·
درخت کدینگ حسابداری
·
«سرفصل حسابهایم را نشان بده»
·
ID
finance_get_accounts_tree
|
| 5 |
فعال
·
فهرست چکهای خزانه
·
«چکهای دریافتی در جریان را نشان بده»
·
ID
finance_list_cheques
|
| 6 |
فعال
·
فهرست صندوقها
·
«صندوقهای نقدی من کداماند؟»
·
ID
finance_list_funds
|
| 7 |
فعال
·
فهرست حسابهای بانکی
·
«حسابهای بانکی پرتال را نشان بده»
·
ID
finance_list_banks
|
| 8 |
فعال
·
صدور فاکتور جدید ✍️
·
«یک فاکتور برای این مشتری صادر کن»
·
ID
finance_create_invoice
|
| 9 |
فعال
·
ثبت پرداخت/دریافت ✍️
·
«یک دریافت ۱٬۲۵۰٬۰۰۰ تومانی ثبت کن»
·
ID
finance_record_payment
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
فهرست سفارشهای تولید
·
«سفارشهای تولید در جریان را نشان بده»
·
ID
production_list_orders
|
| 2 |
فعال
·
جزئیات سفارش تولید
·
«پیشرفت سفارش ۳۱ چقدر است؟»
·
ID
production_get_order
|
| 3 |
فعال
·
فرمولهای تولید (BOM)
·
«فرمول صندلی مدل A چیست؟»
·
ID
production_list_formulas
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
دورههای حقوق
·
«دورههای حقوق امسال را نشان بده»
·
ID
payroll_list_periods
|
| 2 |
فعال
·
اجراهای محاسبهٔ حقوق
·
«محاسبهٔ حقوق تیر انجام شده؟»
·
ID
payroll_list_runs
|
| 3 |
فعال
·
خلاصهٔ اجرای حقوق
·
«جمع پرداختی حقوق تیر چقدر شد؟»
·
ID
payroll_get_run_summary
|
| 4 |
فعال
·
فهرست پرسنل
·
«چند پرسنل فعال در لیست حقوق دارم؟»
·
ID
payroll_list_employees
|
| 5 |
فعال
·
اطلاعات یک پرسنل
·
«شمارهٔ تماس پرسنل ۳۱ چیست؟»
·
ID
payroll_get_employee
|
| 6 |
فعال
·
گزارش حضور و غیاب
·
«حضور و غیاب این ماه را نشان بده»
·
ID
payroll_list_attendance
|
| 7 |
فعال
·
درخواستهای پرسنلی
·
«درخواستهای مرخصی باز را فهرست کن»
·
ID
payroll_list_requests
|
| 8 |
فعال
·
وام و مساعدهها
·
«وامهای پرسنل را نشان بده»
·
ID
payroll_list_loans
|
| 9 |
فعال
·
خلاصهٔ فیش حقوقی
·
«خلاصهٔ فیش حقوقی ۹۰۱ را بده»
·
ID
payroll_get_payslip_summary
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
جلسات — فهرست
·
«جلسههای این هفته را نشان بده»
·
ID
meetings_list
|
| 2 |
فعال
·
جلسات — جزئیات
·
«جزئیات جلسهٔ ۵ را بده»
·
ID
meetings_get
|
| 3 |
فعال
·
باشگاه مشتریان — اعضا
·
«اعضای باشگاه مشتریان را فهرست کن»
·
ID
club_list_members
|
| 4 |
فعال
·
باشگاه مشتریان — یک عضو
·
«امتیاز عضو ۲۰ چقدر است؟»
·
ID
club_get_member
|
| 5 |
فعال
·
کیف پول — موجودی
·
«موجودی کیف پول پرتال چقدر است؟»
·
ID
wallet_get_balance
|
| 6 |
فعال
·
کیف پول — تراکنشها
·
«تراکنشهای کیف پول را نشان بده»
·
ID
wallet_list_transactions
|
| 7 |
فعال
·
گزارش خلاصهٔ فروش
·
«خلاصهٔ فروش خرداد را بده»
·
ID
reports_sales_summary
|
| 8 |
فعال
·
گزارش مصرف پیامک
·
«مصرف پیامک ۳۰ روز اخیر را نشان بده»
·
ID
reports_sms_usage
|
| 9 |
فعال
·
آپلود فایل و پیوست ✍️
·
«این فایل را برای پیوست تیکت آپلود کن»
·
ID
files_upload
|
| 10 |
فعال
·
ارسال اعلان داخلبرنامه ✍️
·
«به کاربر ۱۲ یادآوری جلسه بفرست»
·
ID
notifications_send
|
| # | ابزار |
|---|---|
| 1 |
فعال
·
وضعیت سرویسها
·
«همهٔ سرویسهای هُما سالماند؟»
·
ID
system_get_status
|
| 2 |
فعال
·
فهرست ماژولها/پکیجها
·
«چه ماژولهایی در API فعال است؟»
·
ID
system_list_packages
|
| # | ابزار |
|---|---|
| 1 |
بهزودی
·
تبدیل تاریخ شمسی ↔ میلادی
·
«۱۴۰۵/۰۴/۱۳ چه تاریخ میلادیای است؟»
|
| 2 |
بهزودی
·
اعتبارسنجی کد ملی / موبایل / شبا
·
«این کد ملی معتبر است؟»
|
| 3 |
بهزودی
·
عدد به حروف فارسی
·
«۱٬۲۵۰٬۰۰۰ را به حروف بنویس»
|
| 4 |
بهزودی
·
یافتن مخاطبین تکراری
·
«مخاطبین تکراری را پیدا کن»
|
| 5 |
بهزودی
·
خلاصهٔ روزانهٔ پرتال
·
«امروز در پرتال چه خبر بود؟»
|
ابزارهای نشاندار ✍️ نوشتنی هستند: داده واقعی ثبت میکنند و همیشه confirm: true میخواهند — یعنی دستیار اول از شما تأیید میگیرد، بعد اجرا میکند. بقیه فقطخواندنی و بیخطرند.
ابزارها بر اساس ماژول دستهبندی شدهاند. با homa_get_capabilities میتوانید فهرست دستهها و ابزارهای فعال برای توکن خود را ببینید. سرویس همچنین چند منبع (resource) فقطخواندنی دارد: homa://catalog/tools، homa://catalog/categories و homa://guide/scopes.
نکات
- با دستیار بپرسید توکن به چه چیزهایی دسترسی دارد.
- توکن ثانویه با دسترسی متناسب بسازید — برخی ابزارها (ارسال پیامک، ثبت مخاطب و تیکت) نوشتنی هستند.