# یکپارچه‌سازی‌ها و پیوند تیکت

> https://docs.errora.org/products/integrations

یکپارچه‌سازی، ارورا را به سامانهٔ کنترل نسخهٔ شما وصل می‌کند. این کار دو چیز را باز می‌کند:
**رفع خودکار با هوش مصنوعی** (خواندن کد و باز کردن مرج‌ریکوئست) و **پیوند تیکت** (ساخت یا
وصل‌کردن تیکت گیت‌لب از دل یک خطای ارورا).

## اتصال گیت‌لب

**تنظیمات ← یکپارچه‌سازی‌ها ← افزودن یکپارچه‌سازی**:

| فیلد | توضیح |
| --- | --- |
| `provider` | `gitlab` (خودمیزبان یا gitlab.com). `github` برای انتشار بعدی آماده شده است. |
| `base_url` | نشانی نمونهٔ شما، مثل `https://gitlab.example.com`. پیش‌فرض `https://gitlab.com` است. |
| `access_token` | توکن دسترسی شخصی یا گروهی. **رمزگذاری‌شده** ذخیره می‌شود. |
| `name` | برچسبی که چند نمونه را از هم تفکیک می‌کند |

اسکوپ توکن: ساده‌ترین اسکوپ کارآمد `api` است — ارورا باید بتواند پروژه‌ها را فهرست کند، محتوای
فایل بخواند، شاخه بسازد و مرج‌ریکوئست و تیکت باز کند.

```bash
curl -X POST "$ERRORA/api/v1/organizations/$ORG_ID/integrations" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider":"gitlab","base_url":"https://gitlab.example.com","access_token":"glpat-…","name":"Company GitLab"}'
```

مدیریت یکپارچه‌سازی‌ها به توانمندی **`integration:manage`** نیاز دارد.

## همگام‌سازی مخزن‌ها

بعد از اتصال، **همگام‌سازی** مخزن‌هایی را که توکن می‌بیند می‌آورد:

```text
POST /api/v1/organizations/{org_id}/integrations/{id}/sync
GET  /api/v1/organizations/{org_id}/integrations/{id}/repositories
```

هر مخزن با شناسهٔ ارائه‌دهنده، `path_with_namespace`، آدرس وب و شاخهٔ پیش‌فرض ذخیره می‌شود.

## پیوند مخزن به پروژه

در تنظیمات پروژه، مخزنی را انتخاب کنید که کدش خطاهای آن پروژه را تولید می‌کند. همین مخزن است
که [رفع خودکار](/products/ai-autofix) از آن می‌خواند و رویش مرج‌ریکوئست باز می‌کند.

## پیوند تیکت از صفحهٔ خطا

روی هر خطای ارورا می‌توانید:

- **تیکت گیت‌لب بسازید** — عنوان و توضیح از استثنا، ردپای فراخوانی و پیوند بازگشت به ارورا
  از پیش پر می‌شود.
- **تیکت موجود را وصل کنید** — میان تیکت‌های مخزن جست‌وجو کنید و یکی را بچسبانید، در صورت
  تمایل همراه با یک کامنت حاوی پیوند ارورا.

تیکت‌های وصل‌شده در صفحهٔ خطا فهرست می‌شوند تا نفر بعدی بدون جست‌وجو آن‌ها را ببیند.

```text
GET  /api/v1/projects/{project_id}/issues/{issue_id}/external-issues
POST /api/v1/projects/{project_id}/issues/{issue_id}/external-issues
GET  /api/v1/projects/{project_id}/external-issues/search?q=
GET  /api/v1/projects/{project_id}/issues/{issue_id}/repositories
```

## عیب‌یابی

| نشانه | علت / راه‌حل |
| --- | --- |
| همگام‌سازی چیزی برنمی‌گرداند | توکن هیچ پروژه‌ای نمی‌بیند — اسکوپ و گروه آن را بررسی کنید |
| پاسخ `401` از سمت ارائه‌دهنده | توکن منقضی یا باطل شده؛ دوباره واردش کنید (توکن‌ها در API فقط‌نوشتنی‌اند) |
| نمونهٔ گیت‌لب شما در دسترس نیست | ارورا از سرورهای خودش صدایش می‌زند نه از مرورگر شما — نمونه باید از اینترنت با گواهی معتبر در دسترس باشد |
| ساخت MR شکست می‌خورد | توکن دسترسی نوشتن ندارد، یا شاخهٔ پیش‌فرض در برابر ساخت شاخه محافظت شده است |