---
title: "ربط التطبيقات (Google وSlack وHubSpot والمزيد)"
description: "امنح وكلاءك قدرات حقيقية ببضع نقرات ومن دون برمجة — تحقّق من التقاويم، وحدّث نظام CRM لديك، وانشر على Slack — عبر عمليات ربط مُسبقة الإنشاء بالتطبيقات التي تستخدمها."
---

تتيح اتصالات التطبيقات للوكيل الصوتي العمل داخل الأدوات التي يستخدمها فريقك بالفعل أثناء المحادثة: التحقق من التوفر في تقويم، والبحث عن متصل في نظام CRM لديك، وإضافة عميل محتمل إلى جدول بيانات، ونشر ملخص في 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>

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

## التحكم في ما يمكن للوكيل فعله

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

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

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

تتضمن اتصالات Google Calendar أيضًا مفتاح **إرسال دعوات عبر البريد الإلكتروني إلى الضيوف**
المفعّل افتراضيًا. عندما يجمع الوكيل عنوان البريد الإلكتروني للمتصل
ويمرره كضيف في الحدث، يرسل Google إليه الدعوة عبر البريد الإلكتروني،
وكذلك أي تحديث أو إلغاء لاحق يجريه الوكيل. عطّله للإبقاء على الضيوف
في الحدث دون بريد إلكتروني. تتضمن الدعوة وصف الحدث، لذا اجعل الوكيل
يبقي الملاحظات الداخلية خارجها ويعيد قراءة العنوان على المتصل قبل الحجز.

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

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

- **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>