# التكاملات

> اربط قنوات (WhatsApp، Telegram، Instagram، Messenger، البريد) + تكاملات (التقويم، Cal.com، Webhooks، Notion).

Source: https://waslo.io/ar/docs/integrations · Last updated: 2026-10-16

## نوعان من الاتصالات

صفحة التكاملات في Waslo مقسومة لمجموعتين:

**القنوات** — *أين يتواصل العملاء معك*. كل قناة تصير مكاناً يستقبل فيه وكيلك ويرد على الرسائل.

**التكاملات** — *ماذا يستطيع وكيلك أن يفعل بتلك المحادثة*. حجز التقويم، مزامنة CRM، استيراد العملاء، مصادر المعرفة.

افتح **Integrations ← Marketplace** من الشريط الجانبي.

## القنوات

| القناة | المصادقة | تكلفة الربط |
|--------|-----------|-------------|
| WhatsApp (QR) | امسح QR | مجاني (الرقم الأول مشمول) |
| WhatsApp Cloud API | Meta App + token | مجاني |
| Telegram | إنشاء بوت بضغطة، أو ربط حسابك | مجاني |
| Instagram DM | Meta OAuth | مجاني |
| Facebook Messenger | Meta OAuth | مجاني |
| شات الموقع | مقتطف Widget | مجاني |
| البريد — Gmail | Google OAuth | قريباً |
| البريد — Outlook | Microsoft Graph OAuth | مجاني |

**كل القنوات مشمولة في الباقتين** بلا رسوم تفعيل. في الدفع حسب الاستخدام يستهلك كل رد رصيداً، أما ردود Growth فغير محدودة.

**WhatsApp Cloud API أو QR الرسمي.** يُخرج Cloud API الرقم من تطبيق WhatsApp؛ أما **QR الرسمي** فيُبقي تطبيق WhatsApp Business ويربط الرقم نفسه بواجهة Meta الرسمية (وهو مجاني للربط أيضاً). الرقم الواحد يُربط بطريقة واحدة في كل مرة. ابتداءً من 1 أكتوبر 2026 تحتسب Meta رسوماً على كل رد يرسله الوكيل من رقم رسمي — تفوترها Meta على حساب WhatsApp Business الخاص بك ويعرضها Waslo في صفحة الفوترة. رموز الوصول تتجدد تلقائياً. راجع [ربط WhatsApp](/docs/connecting-whatsapp).

الردود التي تكتبها بنفسك، خارج Waslo، قد توقف الوكيل مؤقتاً لذلك العميل. وما يُعدّ ردًّا كتبته بنفسك يختلف من قناة لأخرى — الجدول الكامل في [التحويل البشري](/docs/human-handoff).

### ربط قناة

1. افتح **Integrations ← Marketplace**
2. اضغط على بطاقة القناة
3. شغّل التدفّق الخاص بالقناة (مسح QR / OAuth / لصق bot token / إلخ)
4. القناة تتحوّل خضراء ("Connected") في الـ marketplace + في فلتر القنوات في الـ Inbox

## التكاملات (إنتاجية)

مشمولة في كل باقة، بلا شيء لفتحه:
- **Knowledge Base** — ارفع وثائق يستشهد بها الـ AI
- **Notion** — شارك صفحاتك مع تكامل Waslo
- **CRM Webhooks** — POST كل حدث leads إلى CRM أو Zapier
- **Inbound Lead API** — استقبل عملاء من حملات Facebook، LeadsBridge، إلخ
- **Telegram Notifications** — تنبيهات admin على HOT leads، تحويلات، كلمات مفتاحية مخصصة
- **Google Calendar** — الـ AI يحجز مواعيد مباشرة في تقويمك
- **Cal.com** — جدولة بديلة بمصادقة API-key
- **CSV Lead Import** — استيراد عملاء بالجملة من جدول
- **Store sync** — مزامنة كتالوجك من Shopify أو Salla أو Zid أو ikas
- **CRM sync** — إرسال العملاء إلى HubSpot

إضافة مدفوعة واحدة:
- **Outbound Campaigns** — إرسال جماعي للقوالب لقوائم مجزّأة. 3,000 رصيد لمرة واحدة في الدفع حسب الاستخدام، ومشمولة في Growth.

## ضبط شخصية AI لكل قناة

بعد ربط قناة، اضغط عليها من الشريط الجانبي (مثلاً **Integrations ← Telegram**) لتجد لوحة **AI behaviour** تتيح ضبط تعليمات ورسائل ترحيب خاصة بهذه القناة فقط. مفيد عندما يحتاج Telegram لنبرة مختلفة عن البريد.

ممكن أيضاً ضبط هذا من **AI Agent ← AI Personality ← Context Selector**، اللي يعرض كل قنواتك وأرقام WhatsApp في مكان واحد.

## Telegram Notifications (تنبيهات admin)

مختلف عن "قناة Telegram" — هذا لإرسال تنبيهات admin إلى **هاتفك أنت** عندما يحدث شيء في Waslo.

1. أنشئ bot في [@BotFather](https://t.me/BotFather)
2. احصل على token + chat_id الشخصي (من [@userinfobot](https://t.me/userinfobot))
3. الصقهما في **Integrations ← Telegram Notifications**

ستصلك تنبيهات لـ: HOT leads، طلبات تحويل AI، كلمات مفتاحية مخصصة.

## CRM Webhooks

ادفع أحداث العملاء إلى أي URL (CRM، Zapier، n8n، إلخ). اضبط من **Integrations ← Webhooks**.

الأحداث المُرسلة: `lead.created`, `lead.classified`, `lead.handoff`, `message.received`, `message.sent`. يُطلَق `lead.classified` للمرحلة الأسخن فقط.

كل طلب يتضمن `X-Waslo-Signature: sha256=<hex>` للتحقق من المصدر. السر المشترك يُعرض عند إنشاء الـ webhook.

## Inbound Lead API

استقبل عملاء من مصادر خارجية عبر webhook. احصل على رابطك الفريد من **Integrations ← Webhooks ← Inbound**.

POST بـ JSON بهذا الشكل:
```json
{
  "phone": "+966501234567",
  "name": "سارة أحمد",
  "source": "facebook_ads",
  "customFields": { "budget": "5000" }
}
```

تحقق HMAC اختياري عند ضبط سر التوقيع.

## Google Calendar / Cal.com

اربط أحدهما (أو كلاهما) ليتمكن وكيلك من حجز المواعيد. الأولوية: Google Calendar → Cal.com → لا شيء.

بمجرد الربط، يحصل الـ AI على 4 أدوات: `get_availability`, `book_slot`, `list_upcoming_appointments`, `cancel_appointment`. العملاء يحجزون مباشرة في المحادثة دون مغادرتها.

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

- [ضبط وكيل AI](/docs/ai-agent-configuration)
- [إدارة العملاء](/docs/lead-management)
- [الفوترة والباقات](/docs/billing-and-plans) — تفاصيل تسعير الرصيد