# سامسل

> سامسل یک CRM فروش تلفنی است. این فایل برای ابزارهای هوش مصنوعی است: مستندات عمومی همهٔ وب‌سرویس‌های یکپارچه‌سازی.

## Docs

- [مرجع کامل وب‌سرویس‌ها](https://xoteam.space/developers/reference.md): احراز هویت، پارامترها، پاسخ‌ها، خطاها و نمونه‌کد curl/Python/JavaScript
- [قرارداد رویدادهای اپ](https://xoteam.space/developers/app-events.md): قالب رویداد، فهرست رویدادها، نگاشت به CRM، واحدها، تست

## Endpoints

- POST https://xoteam.space/api/ingest/events — ارسال دستهٔ رویداد
- WS wss://xoteam.space/ws/app — اتصال و Push دسته‌ای
- WS wss://xoteam.space/ws/app — Pull روی همان سوکت
- GET https://xoteam.space/api/ingest/status — وضعیت دریافت
- GET {APP_BASE}/events/ — رویدادهای بعد از یک seq
- GET {APP_BASE}/cursor/ — آخرین seq موجود
- POST https://xoteam.space/api/pbx/webhook — ثبت تماس از سانترال (PBX)
- POST https://xoteam.space/api/telina/webhook — رویدادهای تلفن ابری تلینا
- GET https://xoteam.space/api/report-history — فهرست گزارش‌ها
- GET https://xoteam.space/api/report-history/{id} — یک گزارش (تحلیل کامل)
- GET https://xoteam.space/api/report-history/{id}/pdf — PDF گزارش
- POST https://xoteam.space/api/report-history/generate — ساخت گزارش بازه‌ای
- POST https://xoteam.space/api/report-history/{id}/analyze — تحلیل دوبارهٔ هوش مصنوعی
- GET https://xoteam.space/api/reports/build/meta — گزینه‌های گزارش‌ساز
- POST https://xoteam.space/api/reports/build — گزارش‌ساز دلخواه
- GET https://xoteam.space/api/directory/agents — فهرست کارشناسان و نگاشت به اپ
- GET https://xoteam.space/api/directory/assignments — تخصیص مشتری‌ها به کارشناسان
- GET https://xoteam.space/api/phone-info — اطلاعات و تحلیل یک شماره
- POST https://xoteam.space/api/copilot/ticket — بلیت اتصال
- WS wss://xoteam.space/ws/copilot — جریان زندهٔ گفتار و پیشنهاد
- POST /crm-webhook — دریافت رویداد روی سرور شما
- POST https://xoteam.space/mcp — سرور MCP

## Updates

- 2026-10-07: فهرست کارشناسان و تخصیص مشتری‌ها
- 2026-10-07: رویدادهای اپ روی WebSocket (دسته‌ای و بلادرنگ)
- 2026-10-07: دستیار تماس: کارت‌های وضعیت و نوار پیشرفت اسکریپت
- 2026-10-07: دستیار زندهٔ تماس (WebSocket)