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

# ربط التطبيقات (Google وSlack وHubSpot والمزيد)

> امنح وكلاءك قدرات حقيقية — تحقّق من التقويمات، وحدّث نظام إدارة علاقات العملاء لديك، وانشر في Slack — ببضع نقرات، من دون كتابة تعليمات برمجية.

تتيح اتصالات التطبيقات لوكيل صوتي تنفيذ إجراءات داخل الأدوات التي يستخدمها فريقك بالفعل أثناء المحادثة: التحقق من التوفر في تقويم، والبحث عن متصل في نظام إدارة علاقات العملاء لديك، وإضافة عميل محتمل إلى جدول بيانات، ونشر ملخص في Slack. يمكنك ربط حساب مرة واحدة ضمن **الاتصالات → التطبيقات**
(`/dashboard/app-connections`)، واختيار ما يُسمح للوكيل بتنفيذه، وإرفاق الاتصال بأي وكيل في أداة إنشائه.

تتوفر ستة تطبيقات حاليًا:

| التطبيق             | ما يمكن لوكيلك فعله به                                           |
| ------------------- | ---------------------------------------------------------------- |
| **Google Calendar** | عرض التوفر وإدارة أحداث التقويم.                                 |
| **Google Sheets**   | إضافة تفاصيل العملاء المحتملين ونتائج المكالمات إلى جدول بيانات. |
| **Slack**           | العثور على القنوات، والبحث في الرسائل، والنشر بإذن.              |
| **HubSpot**         | العثور على جهات الاتصال، وتحديث السجلات، وإضافة الملاحظات.       |
| **Salesforce**      | البحث في السجلات، وتحديث العملاء المحتملين، وتسجيل النشاط.       |
| **Cal.com**         | التحقق من التوفر وإدارة الحجوزات.                                |

بالنسبة إلى أي شيء غير موجود في هذه القائمة، أنشئ
[اتصال API مخصصًا](/ar/guides/api-connections) أو أضف
[خادم MCP](/ar/guides/mcp-servers).

## ربط حساب

<Steps>
  <Step title="افتح الاتصالات → التطبيقات وانقر على إضافة تطبيق">
    تعرض أداة الاختيار التطبيقات الستة. يمكنك ربط عدة حسابات للتطبيق نفسه — ويعرض كل منها عدد «متصل» بمجرد ربط حساب واحد.
  </Step>

  <Step title="منح الحساب الإذن">
    تستخدم معظم التطبيقات OAuth: تفتح نافذة منبثقة، وتسجل الدخول إلى المزوّد وتوافق على الوصول، ثم يظهر الاتصال على الصفحة. **Cal.com هو الاستثناء** — إذ يتصل باستخدام مفتاح API بدلًا من ذلك. الصق المفتاح وانقر على **التحقق والاتصال**؛ يُتحقق من المفتاح مع Cal.com قبل تشفيره وحفظه.
  </Step>

  <Step title="Google Sheets فقط: اختر جدول البيانات">
    يحتاج اتصال Sheets إلى معرفة جدول البيانات وعلامة التبويب المطلوب الكتابة فيهما. مباشرة بعد الاتصال، تفتح لوحة إعدادات — الصق عنوان URL لجدول البيانات (أو معرّفه)، وانقر على **فحص جدول البيانات**، ثم اختر علامة التبويب. تؤكد اللوحة الأعمدة التي عثرت عليها. إلى أن يتم ذلك، تعرض لوحة الاتصال **يتطلب إعدادًا**.
  </Step>
</Steps>

<Note>
  لا تزال عملية التحقق من Google OAuth الخاصة بـ ThunderPhone قيد المراجعة، لذلك تعرض Google تحذير «تطبيق غير متحقق منه» أثناء منح الموافقة لتطبيقي Google Calendar وGoogle Sheets. يرشدك مربع الحوار **إضافة تطبيق** خلال النقرات المطلوبة للمتابعة (**متقدم → الانتقال إلى ThunderPhone**).
</Note>

يتطلب ربط اتصالات التطبيقات وإدارتها دور **مسؤول** أو **مالك** في المؤسسة.

## التحكم في ما يُسمح للوكيل بفعله

يحتوي كل اتصال على مفاتيح أذونات لكل عملية — افتح لوحة اتصال لإدارتها. تبدأ العمليات من نوع القراءة مفعلة؛ أما العمليات التي تكتب في بياناتك أو تغيرها فتبدأ **معطلة** إلى أن تفعلها:

| التطبيق         | مفعّل افتراضيًا                                          | معطّل افتراضيًا                                |
| --------------- | -------------------------------------------------------- | ---------------------------------------------- |
| Google Calendar | عرض الأحداث والتوفر، إنشاء الأحداث                       | تحديث الأحداث، إلغاء الأحداث                   |
| Google Sheets   | إضافة الصفوف                                             | —                                              |
| Slack           | عرض القنوات والرسائل الأخيرة، البحث في الرسائل           | نشر الرسائل                                    |
| HubSpot         | البحث عن جهات الاتصال والشركات وقراءتها                  | إنشاء جهات الاتصال أو تحديثها وإضافة الملاحظات |
| Salesforce      | البحث عن العملاء المحتملين وجهات الاتصال والفرص وقراءتها | إنشاء السجلات أو تحديثها وتسجيل النشاط         |
| Cal.com         | سرد أنواع الأحداث والتحقق من التوفر، إنشاء الحجوزات      | إعادة جدولة الحجوزات أو إلغاؤها                |

أي عملية تعطلها لن تكون متاحة للوكيل ببساطة — لن تُعرض عليه الأدوات المقابلة مطلقًا أثناء المكالمات.

## الأدوات التي يحصل عليها وكيلك

بمجرد ربط اتصال بوكيل، تظهر العمليات المفعّلة
كأدوات قابلة للاستدعاء أثناء المحادثات:

* **Google Calendar** — `calendar_list_events`, `calendar_check_availability`,
  `calendar_create_event`, `calendar_update_event`, `calendar_cancel_event`
* **Google Sheets** — `sheets_append_row` (يكتب في جدول البيانات وعلامة التبويب
  اللذين أعددتهما)
* **Slack** — `slack_list_channels`, `slack_search_messages`,
  `slack_post_message`
* **HubSpot** — `hubspot_search_contacts`, `hubspot_get_contact`,
  `hubspot_upsert_contact`, `hubspot_add_note`
* **Salesforce** — `salesforce_search_records`, `salesforce_get_record`,
  `salesforce_upsert_lead`, `salesforce_log_activity`
* **Cal.com** — `calcom_list_event_types`, `calcom_check_availability`,
  `calcom_create_booking`, `calcom_cancel_booking`

لا تكتب مخططات لأيٍّ من هذه الأدوات — يعرّف ThunderPhone الأدوات
ويوجّه الاستدعاءات عبر الحساب المتصل.

## اربط الاتصال بوكيل

لا تؤدي الاتصالات أي وظيفة حتى يستخدمها وكيل. افتح الوكيل في
أداة الإنشاء ([إنشاء وكيل](/ar/guides/build-an-agent)) وأضف الاتصال
في قسم **التطبيقات المتصلة**. تعرض بطاقة الاتصال في صفحة التطبيقات
عدد العمليات المفعّلة وعدد الوكلاء الذين يستخدمونه.

## قطع الاتصال

افتح بطاقة اتصال واقطع الاتصال من هناك. يفقد الوكلاء الذين كانوا
يستخدمونه تلك الأدوات في مكالمتهم التالية.

## الخطوات التالية

<CardGroup cols={2}>
  <Card title="حوّل أي واجهة API إلى إجراء للوكيل" icon="plug" href="/ar/guides/api-connections">
    معالج لصق cURL للخدمات التي لا تتوفر لها وصلة أصلية.
  </Card>

  <Card title="أضف خادم MCP" icon="server" href="/ar/guides/mcp-servers">
    استخدم خادم الأدوات الخاص بك عبر Streamable HTTP.
  </Card>
</CardGroup>