> ## Documentation Index
> Fetch the complete documentation index at: https://developers.huechat.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# مرجع أدوات MCP

> مرجع مأخوذ من الشيفرة لأدوات هيوشات ونطاقات التفويض وتصنيفات الإجراءات.

تتضمن هذه اللقطة **97 تعريف أداة أصلية: 47 للقراءة و50 للتعديل**، من الشيفرة
`a9c5ee5f196a02b36a6a6764d5999de0668b0c9a` بتاريخ 19 أكتوبر 2026.
وهي مرجع لإمكانات الشيفرة، وليست تفويضًا فعليًا أو ادعاءً بتفعيل كل أداة أو
تنفيذها في كل مساحة عمل.

ابدأ من [دليل الربط والصلاحيات](https://developers.huechat.ai/ar/mcp-server.md). يختار مالك مساحة Enterprise
المؤهلة أو مديرها صلاحيات الاتصال ذاتيًا. وتُرشّح قائمة الأدوات الفعلية حسب
العضوية الحالية وسياسة المساحة وميزات الخطة والوحدات الأصلية والاعتمادات
ومفاتيح تفعيل المراسلة. لا يؤدي تثبيت الإضافة أو تحديثها إلى توسيع التفويض الحالي.

## قراءة الجدول

* تُطلب النطاقات الواردة في الصف معًا، إلا إذا ذكر الصف **أي واحد من**.
* تقبل `get_price_list` أي نطاق من `products:read` أو `appointments:read` أو
  البديل القديم `deals:read`. يتيح كل نطاق القسم الموافق له فقط، وتظل
  اعتمادات القسم وميزات الخطة مطبقة.
* يعرض عمود الخطة ميزة النطاق المُدارة. وقد تُطبق شروط أخرى للوحدات والتشغيل
  حتى عندما يكون العمود فارغًا.
* يشير `destructiveHint` إلى الاستبدال أو الإزالة أو الإلغاء أو الآثار الإتلافية
  الأخرى، ويشير `openWorldHint` إلى التفاعل خارج السجلات المخزنة في المساحة.
  هذه بيانات وصفية لضوابط العميل؛ ولا تمنح صلاحيات أو تستبدل فحوص الخادم
  والموافقة البشرية.
* يتطلب الإرسال نطاق إرسال مطابقًا وضوابط إرسال مفعلة بصورة مستقلة. يعيد وضع
  التأكيد معاينة، وينتظر وضع مراجعة الفريق موافقته. وتتطلب جدولة البث دائمًا
  تأكيدًا أو مراجعة.

## قائمة الأدوات

تتطلب `create_template` قيمة `inbox_id` لصندوق وارد موجود في مساحة العمل
المختارة. وهي تحفظ `DRAFT` فقط؛ أما تقديم القالب إلى Meta أو إرساله إلى عميل
فعمليتان مستقلتان لهما متطلبات إضافية.

مرّر عناصر `components` ككائنات JSON، مثل
`[{"type":"BODY","text":"طلبك جاهز"}]`.
عند تعديل مسودة، احذف `components` من الطلب للاحتفاظ بمحتواها الحالي.

| الأداة | الوصول وتصنيفات الإجراء | نطاقات التفويض | ميزة الخطة |
| - | - | - | - |
| `add_filtered_contacts_to_list` | تعديل | `lists:write` | |
| `add_private_note` | تعديل | `conversations:write` | |
| `add_tags_to_contact` | تعديل | `labels:write` | |
| `analytics.summary` | قراءة | `reports:read` | |
| `assign_conversation` | تعديل, `destructiveHint` | `conversations:write`, `agents:read` | |
| `assign_ticket` | تعديل, `destructiveHint` | `tickets:write` | |
| `block_contact` | تعديل, `destructiveHint` | `contacts:write` | |
| `book_appointment` | تعديل | `appointments:write`, `contacts:read`, `contacts:write` | `appointments` |
| `cancel_action` | تعديل, `destructiveHint` | `mcp:use` | |
| `cancel_appointment` | تعديل, `destructiveHint` | `appointments:write` | `appointments` |
| `check_appointment_availability` | قراءة | `appointments:read` | `appointments` |
| `clear_list` | تعديل, `destructiveHint` | `lists:write` | |
| `close_appointment_availability` | تعديل | `appointments:write` | `appointments` |
| `close_ticket` | تعديل, `destructiveHint` | `tickets:write` | |
| `confirm_action` | تعديل, `destructiveHint`, `openWorldHint` | `mcp:use` | |
| `create_broadcast_draft` | تعديل | `broadcasts:write` | `broadcasts` |
| `create_custom_field` | تعديل | `custom_fields:write` | |
| `create_deal` | تعديل | `deals:write` | `deals` |
| `create_list` | تعديل | `lists:write` | |
| `create_list_from_filters` | تعديل | `lists:write`, `contacts:read` | |
| `create_tag` | تعديل | `labels:write` | |
| `create_template` | تعديل | `templates:write` | `templates` |
| `create_ticket` | تعديل | `tickets:write` | |
| `delete_custom_field` | تعديل, `destructiveHint` | `custom_fields:write` | |
| `delete_deal` | تعديل, `destructiveHint` | `deals:write` | `deals` |
| `delete_list` | تعديل, `destructiveHint` | `lists:write` | |
| `delete_tag` | تعديل, `destructiveHint` | `labels:write` | |
| `delete_template` | تعديل, `destructiveHint` | `templates:write` | `templates` |
| `get_account_summary` | قراءة | `reports:read` | |
| `get_ad_performance` | قراءة | `reports:read` | |
| `get_agent_performance` | قراءة | `reports:read`, `agents:read` | |
| `get_ai_actions_summary` | قراءة | `reports:read` | |
| `get_appointment_catalog` | قراءة | `appointments:read` | `appointments` |
| `get_appointment_changes` | قراءة | `appointments:read` | `appointments` |
| `get_appointments` | قراءة | `appointments:read` | `appointments` |
| `get_automation_summary` | قراءة | `reports:read` | |
| `get_campaign` | قراءة | `broadcasts:read` | |
| `get_campaign_performance` | قراءة | `broadcasts:read` | |
| `get_campaign_summary` | قراءة | `reports:read` | |
| `get_campaigns` | قراءة | `broadcasts:read` | |
| `get_contact` | قراءة | `contacts:read` | |
| `get_contact_analytics` | قراءة | `reports:read` | |
| `get_contact_stats` | قراءة | `reports:read` | |
| `get_contact_tags` | قراءة | `contacts:read` | |
| `get_contacts` | قراءة | `contacts:read` | |
| `get_conversation` | قراءة | `conversations:read` | |
| `get_conversations` | قراءة | `conversations:read` | |
| `get_custom_field` | قراءة | `custom_fields:read` | |
| `get_custom_field_usage` | قراءة | `custom_fields:read` | |
| `get_custom_fields` | قراءة | `custom_fields:read` | |
| `get_deal` | قراءة | `deals:read` | `deals` |
| `get_deal_pipelines` | قراءة | `deals:read` | `deals` |
| `get_deals` | قراءة | `deals:read` | `deals` |
| `get_list` | قراءة | `lists:read` | |
| `get_lists` | قراءة | `lists:read` | |
| `get_message_analytics` | قراءة | `reports:read` | |
| `get_operators` | قراءة | `account:read` | |
| `get_or_create_contact` | تعديل | `contacts:write`, `contacts:read` | |
| `get_price_list` | قراءة | أي واحد من: `products:read` OR `appointments:read` OR `deals:read` | |
| `get_resolution_trends` | قراءة | `reports:read` | |
| `get_tags` | قراءة | `labels:read` | |
| `get_template` | قراءة | `templates:read` | `templates` |
| `get_templates` | قراءة | `templates:read` | `templates` |
| `get_ticket` | قراءة | `tickets:read` | |
| `get_ticket_categories` | قراءة | `tickets:read` | |
| `get_tickets` | قراءة | `tickets:read` | |
| `get_upcoming_events` | قراءة | `broadcasts:read` | |
| `get_whatsapp_quality` | قراءة | `reports:read` | |
| `list_conversations` | قراءة | `conversations:read` | |
| `list_inboxes` | قراءة | `inboxes:read` | |
| `list_pending_actions` | قراءة | `mcp:use` | |
| `mark_read` | تعديل | `conversations:write` | |
| `merge_tags` | تعديل, `destructiveHint` | `labels:write` | |
| `move_deal` | تعديل, `destructiveHint` | `deals:write` | `deals` |
| `open_appointment_availability` | تعديل | `appointments:write` | `appointments` |
| `remove_contacts_from_list` | تعديل, `destructiveHint` | `lists:write` | |
| `remove_filtered_contacts_from_list` | تعديل, `destructiveHint` | `lists:write` | |
| `remove_tags_from_contact` | تعديل, `destructiveHint` | `labels:write` | |
| `reschedule_appointment` | تعديل, `destructiveHint` | `appointments:write` | `appointments` |
| `schedule_campaign` | تعديل, `destructiveHint`, `openWorldHint` | `broadcasts:write`, `broadcasts:send` | `broadcasts` |
| `search_contacts_advanced` | قراءة | `contacts:read` | |
| `search_workspace` | قراءة | `account:read`, `contacts:read`, `labels:read`, `lists:read`, `templates:read`, `broadcasts:read`, `tickets:read`, `deals:read`, `ai_agents:read` | |
| `send_message` | تعديل, `destructiveHint`, `openWorldHint` | `messages:send`, `conversations:read` | |
| `send_template` | تعديل, `destructiveHint`, `openWorldHint` | `templates:send`, `templates:read` | `templates` |
| `set_appointment_recurring_availability` | تعديل, `destructiveHint` | `appointments:write` | `appointments` |
| `set_contact_field_value` | تعديل, `destructiveHint` | `contacts:write` | |
| `status` | قراءة | `mcp:use` | |
| `submit_template` | تعديل, `destructiveHint`, `openWorldHint` | `templates:write` | `templates` |
| `sync_contacts_to_list` | تعديل | `lists:write` | |
| `update_contact` | تعديل, `destructiveHint` | `contacts:write` | |
| `update_conversation_status` | تعديل, `destructiveHint` | `conversations:write` | |
| `update_custom_field` | تعديل, `destructiveHint` | `custom_fields:write` | |
| `update_deal` | تعديل, `destructiveHint` | `deals:write` | `deals` |
| `update_list` | تعديل, `destructiveHint` | `lists:write` | |
| `update_tag` | تعديل, `destructiveHint` | `labels:write` | |
| `update_template` | تعديل, `destructiveHint` | `templates:write` | `templates` |
| `update_ticket` | تعديل, `destructiveHint` | `tickets:write` | |

## نطاقات إضافية للمخرجات أو لحالات محددة

| الأداة | النطاق الإضافي وأثره |
| - | - |
| `get_conversation` | يسمح `messages:read` بسجل الرسائل، ويسمح `contacts:read` ببيانات جهات الاتصال. |
| `list_conversations` | يسمح `contacts:read` بحقلي الهاتف والبريد لجهة الاتصال. |
| `send_template` | يتطلب إنشاء جهة اتصال جديدة من الوجهة المحددة نطاق `contacts:write`. |
| `get_price_list` | تتيح النطاقات البديلة أقسامها فقط؛ ولا يفوّض نطاق أحد الأقسام قراءة جميع الأقسام. |

لا يربط الخادم الخارجي أدوات توليد الوسائط بالذكاء الاصطناعي أو أدوات نشر
الإعلانات الخاصة بالمساعد الداخلي للمالك. ولا يدّعي هذا المرجع دعم نماذج
MCP elicitation الأصلية. يشرح [الدليل الرئيسي](https://developers.huechat.ai/ar/mcp-server.md) أسئلة المحادثة
العادية وتأكيد الإجراءات المعلّقة وإلغاءها.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.