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

# مقدمة

> أرسل واقرأ الرسائل عبر واتساب وانستجرام وماسنجر وتيليجرام من أنظمتك الخاصة.

يتيح Linkiasoft API لأنظمتك التعامل مع محادثات العملاء ومع نظام إدارة العملاء خلفها — إشعار عميل
عند إغلاق تذكرته، أو سحب محادثة إلى نظام الدعم لديك، أو نقل عميل محتمل عبر مسارك، أو تسجيل متابعة
من سير عمل تشغّله بالفعل.

وحركة البيانات في الاتجاهين. استدعِنا بمفتاح API، أو سجّل [webhook](/ar/webhooks) فنرسل إليك طلب
POST فور وصول الرسائل وتحرك العملاء المحتملين.

**مضيفان ومفتاح واحد.** المراسلة ونظام إدارة العملاء خدمتان منفصلتان، وكل صفحة نقطة نهاية توضح
أيهما تستخدم. ومفتاح API نفسه يصادق على الاثنين.

|                                                                   | الرابط الأساسي                      |
| ----------------------------------------------------------------- | ----------------------------------- |
| المراسلة — المحادثات والقوالب والقنوات                            | `https://social.linkiasoft.com/api` |
| إدارة العملاء — العملاء المحتملون والمراحل وجهات الاتصال والأنشطة | `https://api.linkiasoft.com/api`    |

## ما يمكنك فعله

<CardGroup cols={2}>
  <Card title="إرسال رسالة" icon="paper-plane" href="/api-reference/conversations/send-a-message">
    قوالب أو وسائط أو نص عادي — نقطة نهاية واحدة للثلاثة.
  </Card>

  <Card title="قراءة المحادثات" icon="comments" href="/api-reference/conversations/list-conversations">
    عرض المحادثات وتصفح سجل رسائلها.
  </Card>

  <Card title="عرض القوالب" icon="table-list" href="/api-reference/templates/list-approved-templates-for-a-channel">
    معرفة قوالب واتساب المعتمدة التي يمكن للقناة إرسالها.
  </Card>

  <Card title="العثور على قنواتك" icon="plug" href="/api-reference/channels/list-your-connected-channels">
    كل نقطة نهاية أخرى تحتاج `channelId` — ومن هنا تحصل عليه.
  </Card>

  <Card title="نقل عميل محتمل" icon="chart-line" href="/ar/leads">
    قراءة مراحل مسارك، وتغيير مرحلة عميل محتمل، وإعادة إسناده.
  </Card>

  <Card title="تسجيل متابعة" icon="phone" href="/ar/leads#mark-a-follow-up">
    تسجيل مكالمة أو بريد أو اجتماع على عميل محتمل.
  </Card>

  <Card title="جهات الاتصال في شركة" icon="address-book" href="/api-reference/contacts/list-contacts-for-a-company">
    الأشخاص المرتبطون بسجل عميل.
  </Card>

  <Card title="استقبال الأحداث" icon="bolt" href="/ar/webhooks">
    نرسل POST إلى نقطة نهايتك عند وصول رسالة أو تحرك عميل محتمل. بلا استطلاع دوري.
  </Card>

  <Card title="نسخ العملاء المحتملين إلى أودو" icon="arrows-rotate" href="/ar/guides/odoo-leads">
    كل عميل محتمل يُلتقط هنا يظهر في أودو لديك ويبقى متوافقًا.
  </Card>
</CardGroup>

## قبل أول استدعاء

<Steps>
  <Step title="أنشئ مفتاح API">
    في لينكياسوفت، اذهب إلى **الإعدادات ← مفاتيح API**. ويُعرض المفتاح مرة واحدة عند الإنشاء —
    انسخه حينها. وامنحه النطاقات التي يحتاجها التكامل فقط؛ راجع [المصادقة](/ar/authentication).
  </Step>

  <Step title="اعثر على قناتك">
    استدعِ [`GET /v1/connect/channels`](/api-reference/channels/list-your-connected-channels).
    فـ`id` القناة التي تريد الإرسال منها هو `channelId` الذي تطلبه كل نقطة نهاية أخرى.
  </Step>

  <Step title="أرسل شيئًا">
    اتبع [البداية السريعة](/ar/quickstart) لإرسال أول قالب لك.
  </Step>
</Steps>

<h2 id="the-one-whatsapp-rule-that-catches-everyone">
  قاعدة واتساب التي تُوقع الجميع
</h2>

لا يسمح لك واتساب بإرسال نص حر إلا خلال **24 ساعة من آخر رسالة للعميل**. وخارج تلك النافذة — وهو
الحال دائمًا تقريبًا مع أي إشعار يبدأه نظامك — يجب إرسال **قالب معتمد**.

<Warning>
  إرسال نص عادي إلى عميل لم يراسلك مؤخرًا سيرفضه واتساب، لا نحن. فإذا كان تكاملك يرسل إشعارات،
  فينبغي أن يرسل قوالب.
</Warning>

ولانستجرام وماسنجر وتيليجرام قواعدها الخاصة؛ والمبدأ نفسه ينطبق.

## الاصطلاحات

* كل أجسام الطلبات والاستجابات بصيغة JSON.
* الطوابع الزمنية بصيغة ISO 8601 بتوقيت UTC.
* المعرّفات من نوع UUID ما لم يُذكر خلاف ذلك.
* أرقام الهواتف بصيغة **E.164 بدون `+`** — `201001234567`، لا `01001234567` أبدًا.
* عمليات الإرسال تعيد `202 Accepted`: أي أن الرسالة في الطابور ولم تُسلَّم بعد. تابع النتيجة عبر
  حقل `status` في الرسالة.