شروع کنید

​

این مجموعه مستندات چیست؟

این‌جا مرجع فنی کامل و متمرکز برای هر نوع اینتگریشن با نرم افزار دیدار است، شما قرار است خودتان با تکیه بر همین مستندات بتوانید اینتگریشن خود را از صفر تا آصد پیاده‌سازی کنید. این مجموعه شامل این بخش‌هاست:

• راهنمای توسعه‌دهنده (همین بخش) — مفاهیم پایه دیدار و نکات عمومی شروع کار با API، پیش‌نیاز فهم بقیه بخش‌ها
• API Reference — مستند دقیق تک‌تک Endpointهای دیدار: چه Requestای باید بسازید، چه Responseای برمی‌گردد، چه فیلدهایی الزامی‌اند و هرکدام از این فیلدها به چه معنایی هستند
• Webhook Reference — رویدادهایی که دیدار می‌تواند به شما اطلاع بدهد و ساختار دقیق Payload هرکدام
• مستندات نودهای اختصاصی n8n — نحوه استفاده از دیدار در گردش‌کارهای n8n بدون نوشتن کد

هدف این است که این مستندات، قرارداد فنی رسمی و قابل‌اعتماد بین دیدار و شما باشد؛ چیزی که هم برای ساخت integration کافی است، هم می‌توانید به آن ارجاع بدهید.

​

این مستندات برای چه کسانی نوشته شده؟

​

دیدار چیست؟

دیدار یک نرم‌افزار CRM ایرانی است؛ یعنی ابزاری که به شرکت‌ها کمک می‌کند فرآیند فروش‌شان را، از اولین تماس با یک مشتری بالقوه تا فروش موفق و صدور فاکتور، در یک‌جا مدیریت کنند. به زبان ساده‌تر، یک تیم فروش هر روز باید به سوالاتی مثل این‌ها جواب بدهد:

• الان با کدام مشتری‌ها در حال مذاکره هستیم؟
• هرکدام از این معامله‌ها در چه مرحله‌ای از فرآیند فروش قرار دارند؟
• آخرین تماس یا جلسه با این مشتری کِی بوده و چه نتیجه‌ای داشته؟
• این مشتری چه محصول یا خدماتی خریده و چقدر برایش فاکتور صادر شده؟
• بعد از فروش، درخواست یا مشکل این مشتری در چه وضعیتی است؟

دیدار دقیقاً همین اطلاعات را نگه می‌دارد، سازمان‌دهی می‌کند و قابل پیگیری می‌سازد. نکته‌ای که برای شما به‌عنوان دولوپر مهم است: لازم نیست کاربر دیدار باشید یا پنلش را دیده باشید، اما باید بدانید این نرم‌افزار حول چه مفاهیمی می‌چرخد؛ چون تقریباً هر Object و Endpoint در API دیدار، معادل دقیق یک چیزی است که یک فروشنده یا کارشناس پشتیبانی هر روز با آن سروکار دارد.

​

دیدار چه راه‌هایی برای یکپارچه‌سازی جلوی شما می‌گذارد؟

بسته به چیزی که می‌خواهید بسازید، یکی از این سه راه مناسب شماست: این سه راه با هم در تضاد نیستند و معمولاً ترکیبی از آن‌ها استفاده می‌شود. API برای ساخت رکورد و Webhook

​

مسیر پیشنهادی مطالعه

1. همین صفحه
   یک تصویر کلی از دیدار و مسیر مطالعه به دست آوردید.
2. مفاهیم پایه دیدار
   اجزای اصلی دیدار (شخص، شرکت، معامله، کاریز، فعالیت، محصول، فاکتور، پرونده) و رابطه‌شان با هم را یاد می‌گیرید. این صفحه پیش‌نیاز فهم درست همه صفحات بعدی است.
3. شروع کار با اینتگریشن دیدار
   آدرس پایه، احراز هویت، ساخت کلید API، ساختار پاسخ‌ها و محدودیت‌ها را می‌بینید.
4. براساس نیازتان ادامه دهید
   اگر با کد کار می‌کنید سراغ API Reference بروید. اگر می‌خواهید از رویدادهای آنی باخبر شوید سراغ Webhook. اگر بدون کد می‌سازید سراغ مستندات n8n.

​

دیگر لازم نیست تک‌تک این صفحات را بخوانید

راستش را بخواهید، خواندن پشت‌سرهم ده‌ها صفحه مستندات برای پیدا کردن یک Endpoint یا فهمیدن یک فیلد، روش قدیمی است. ما یک دستیار هوشمند اختصاصی ساخته‌ایم که دقیقاً روی همین مستندات فنی دیدار — همین API Reference، همین Webhook Docs، همین مفاهیم پایه — سوار است و می‌تواند به‌جای شما در این صفحات بگردد. کافی است سوال‌تان را به زبان معمولی بپرسید، مثل:

• «چطور یک معامله جدید بسازم که چند محصول هم بهش وصل باشه؟»
• «فیلد discountType دقیقاً چه مقادیری می‌تونه بگیره؟»
• «برای وقتی یک معامله Won می‌شه، چه Webhookـی باید فعال کنم؟»
• «یک نمونه کد برای ساخت مخاطب جدید از طریق n8n بهم بده»

و به‌جای این‌که خودتان دنبال جواب در بین صفحات بگردید، جواب دقیق، مبتنی بر همین مستندات — نه حدس و گمان — تحویل می‌گیرید.