> ## 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.

# البداية السريعة

> اعرض محادثاتك، أرسل رسالة، أنشئ جهة اتصال.

<Steps>
  <Step title="احصل على رمز">
    سجّل الدخول إلى [app.huechat.ai](https://app.huechat.ai/app/login)، افتح
    **الإعدادات ← الملف الشخصي** وانسخ **رمز الوصول**. يحمل دورك الكامل، وهذا
    مناسب لأول استدعاء. لأي شيء يصل إلى الإنتاج، أنشئ
    [مفتاح API محدود النطاق](/ar/api-keys) بدلًا منه.
  </Step>

  <Step title="اعرف معرّف حسابك">
    هو الرقم الظاهر في عنوان لوحة التحكم:
    `https://app.huechat.ai/app/accounts/{account_id}/...`. كل مسار أدناه
    يأخذه في المسار.
  </Step>

  <Step title="اعرض المحادثات">
    ```bash theme={null}
    curl https://app.huechat.ai/core/accounts/$ACCOUNT_ID/conversations \
      -H "Authorization: Bearer $HUECHAT_TOKEN"
    ```

    استجابة `200` مع مصفوفة `payload` تعني أن الرمز يعمل. احتفظ بقيمة
    `conversation_id` من الاستجابة للخطوة التالية.
  </Step>

  <Step title="أرسل رسالة">
    ```bash theme={null}
    curl -X POST https://app.huechat.ai/core/accounts/$ACCOUNT_ID/conversations/$CONVERSATION_ID/messages \
      -H "Authorization: Bearer $HUECHAT_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"content": "مرحبًا من الواجهة البرمجية", "message_type": "outgoing"}'
    ```

    تُرسل الرسالة عبر القناة التي تعيش فيها المحادثة: واتساب أو إنستغرام أو
    ماسنجر أو البريد أو الدردشة المباشرة.
  </Step>

  <Step title="أنشئ جهة اتصال">
    ```bash theme={null}
    curl -X POST https://app.huechat.ai/core/accounts/$ACCOUNT_ID/contacts \
      -H "Authorization: Bearer $HUECHAT_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"name": "محمد علي", "phone_number": "+966501234567", "email": "mohammed@example.com"}'
    ```
  </Step>
</Steps>

<Warning>
  هذه الاستدعاءات تعمل على حسابك الحقيقي. أي `POST` من هذه الصفحة يرسل رسالة
  حقيقية إلى عميل حقيقي. جرّب عمليات الكتابة على محادثة تجريبية أولًا.
</Warning>

## إلى أين بعد ذلك

* [المصادقة](/ar/authentication) لمعرفة الفرق بين بياني الاعتماد.
* [Webhooks](/ar/webhooks) لتصلك الأحداث بدلًا من الاستعلام المتكرر.
* [مرجع API](/ar/api-reference/overview) لكل نقطة نهاية مع لوحة تجربة.