ایجاد شخص
شخص یعنی یکی از مخاطبان واقعی کسبوکار؛ مثل مشتری، سرنخ فروش یا فردی که در یک شرکت کار میکند. با این Endpoint میتوانید شخص جدیدی همراه با اطلاعات تماس، مسئول، شرکت مرتبط، آدرس، گروهبندیها و فیلدهای اضافه در دیدار ثبت کنید.POST {{baseURL}}/api/contact/save?apikey={{API_KEY}}
پارامترهای Query
| پارامتر | نوع | وضعیت | توضیح |
|---|---|---|---|
apikey | string | الزامی | کلید API دیدار. |
Header درخواست
Content-Type: application/json
بدنه درخواست
object
required
اطلاعات شخص جدید داخل این آبجکت ارسال میشود. شخص یعنی مشتری یا مخاطبی که با او در ارتباط هستید، نه Userی که وارد دیدار میشود.
Show property
Show property
string
نوع مخاطب؛ تعیین میکند داده ارسالی بهعنوان شخص یا شرکت ذخیره شود. در ایجاد شخص باید مقدار این فیلد برابر با مقدار زیر باشد:
PersonShow مقادیر مجاز
Show مقادیر مجاز
Person— رکورد بهعنوان شخص ساخته میشود
string
نام شخص؛ ساخت نام نمایشی مخاطب استفاده میشود.
string
required
نام خانوادگی شخص؛ در ایجاد مخاطب از نوع شخص برای شناسایی و نمایش او استفاده میشود.
string
عنوانی که قبل از نام و نام خانوادگی شخص نمایش داده میشه. به عنوان مثال “آقای” یا “خانم”
string
required
شناسه User مسئول پیگیری این شخص یا شرکت است.
Show وابستگیها
Show وابستگیها
این فیلد نام کاربر را نمیپذیرد؛ باید
UserId یک User موجود در دیدار را بفرستید.- User List — مقدار
UserIdکاربر موردنظر را بردارید
string
نام شرکتی است که شخص به آن مرتبط است. از این فیلد زمانی استفاده میشود که میخواهید همزمان با ساخت شخص، شرکت جدیدی هم با همین نام ساخته شود.
Show شرایط ارسال
Show شرایط ارسال
اگر
Contact.CompanyId را میفرستید، نیازی به این فیلد نیست. اگر CompanyId ارسال نشود و این فیلد مقدار داشته باشد، شرکت جدیدی با همین نام ساخته میشود.string
شناسه شرکتی است که این شخص به آن مرتبط است؛ مثلا شرکتی که شخص در آن کار میکند.
Show وابستگیها
Show وابستگیها
این فیلد نام شرکت را نمیپذیرد؛ باید
Id شرکت موجود در دیدار را بفرستید.- Create Company — اگر شرکت هنوز ساخته نشده است
- Get Company By Id — اگر
Idشرکت را دارید - Search Company — برای جستوجوی شرکت
string
تاریخ تولد شخص؛ برای اطلاعات پروفایل و برنامههای یادآوری تولد استفاده میشود.
string
شناسه پیام یا الگوی مرتبط با یادآوری تولد مخاطب.
string
شماره تلفن همراه اصلی شخص که برای جستوجو، تماس و شناسایی مخاطب استفاده میشود. این مقدار باید منحصر به فرد باشد و تکراری نباشد
string
شماره تلفن ثابت یا محل کار مخاطب.
string
عنوان یا داخلی ثبتشده کنار شماره محل کار است؛ مثلا «دفتر» یا شماره داخلی واحد مربوط.
string
شماره فکس شخص یا شرکت.
string
نشانی ایمیل اصلی مخاطب برای ارتباط و جستوجو.
boolean
مشخص میکند مخاطب بهعنوان مشتری ویژه علامتگذاری شود یا خیر.
Show مقادیر مجاز
Show مقادیر مجاز
true— مخاطب بهعنوان مشتری ویژه علامت میخوردfalse— مخاطب ویژه نیست
string
یادداشت زمینهای درباره شخص یا شرکت؛ برای ثبت اطلاعات مهمی که در فیلدهای ساختاریافته قرار نمیگیرند.
string
عنوان شغلی یا سمت شخص در شرکت مرتبط.
string
کد مشتری در سیستم یا فرایند مالی کسبوکار؛ برای تطبیق مخاطب با رکوردهای خارجی نیز قابل استفاده است.
string
کد ملی شخص برای اطلاعات هویتی یا مالی.
string
کد پستی نشانی اصلی مخاطب.
string
شناسه شهر مخاطب است و باید از فهرست مکانهای دیدار انتخاب شود.
Show وابستگیها
Show وابستگیها
شناسه را از فهرست استانها و شهرهای دیدار بردارید.
- Get Locations —
Idاستان یا شهر موردنظر را بردارید
string
شناسه استان مخاطب است و باید از فهرست مکانهای دیدار انتخاب شود.
Show وابستگیها
Show وابستگیها
شناسه را از فهرست استانها و شهرهای دیدار بردارید.
- Get Locations —
Idاستان یا شهر موردنظر را بردارید
string
سطح مشاهده مخاطب؛ تعیین میکند چه کاربران یا گروههایی بر اساس دسترسیها امکان مشاهده رکورد را دارند.
Show مقادیر مجاز
Show مقادیر مجاز
0 / Owner— فقط مسئول رکورد1 / OwnerGroup— مسئول و گروه او2 / OwnerSubGroup— مسئول، گروه و زیرگروه او3 / All— همه کاربران مجاز
object
مقدار Custom Fieldهای شخص یا شرکت است. هر کلید باید متعلق به فیلد اضافه مخاطب باشد.
Show وابستگیها
Show وابستگیها
فقط از کلید Custom Fieldهایی استفاده کنید که
FieldType آنها مربوط به Contact است.- Get Custom Fields — کلید فنی فیلد متناسب با Entity را بردارید
object
object
object
object
اطلاعات حسابهای بانکی مخاطب برای استفاده در فرایندهای مالی.
Show property
Show property
array
فهرست حسابهای بانکی مخاطب؛ اجزای هر عضو، اطلاعات یک حساب را در ساختار داخلی دیدار نگهداری میکنند.
Show property
Show property
string
بخش اول اطلاعات حساب بانکی در ساختار داخلی دیدار؛ جایگاه دقیق آن مانند شماره حساب یا شبا باید با قرارداد Backend تطبیق داده شود.
string
بخش دوم اطلاعات حساب بانکی؛ معنای دقیق آن به ساختار حساب بانکی Backend وابسته است.
string
بخش سوم اطلاعات حساب بانکی؛ معنای دقیق آن به ساختار حساب بانکی Backend وابسته است.
string
بخش چهارم اطلاعات حساب بانکی؛ معنای دقیق آن به ساختار حساب بانکی Backend وابسته است.
array
فهرست شناسه گروههایی است که شخص یا شرکت باید عضو آنها شود.
Show وابستگیها
Show وابستگیها
این فیلد باید
Id یک گروه موجود در دیدار را بگیرد.- Segments —
Idگروه موردنظر را بردارید
{
"Contact": {
"Type": "Person",
"FirstName": "12",
"LastName": "آشنasasا",
"Title": "جناب آقای",
"OwnerId": "f1599895-3d58-44a8-a830-e77b42d8e4c6",
"CompanyName": "نام شرکت مرتبط به شخص",
"CompanyId": "39e05281-f35a-4923-bed4-8d2db9947be8",
"BirthDate": "2025-08-31T08:02:06.5247888Z",
"BirthDateMessageId": "88356367-c004-4263-98e5-6b4e8bbc9852",
"MobilePhone": "09391232",
"WorkPhone": "02155587458",
"WorkPhoneExtension": "تلفن منشی",
"Fax": "فکس منشی 023934443",
"Email": "",
"IsVIP": true,
"BackgroundInfo": "12312sdsd",
"Position": "مدیر واحد",
"CustomerCode": "12311213",
"NationalCode": "asdfdsdd2132",
"ZipCode": "123assdddf",
"CityId": "314409ce-ee7f-424e-ab88-c578d0ca187f",
"ProvinceId": "c990e86b-a13a-40f4-b21d-79bf09e6e579",
"VisibilityType": "All",
"Fields": {
"Field_996_0_7": "asdfasdfasdf",
"Field_996_0_8": "asdfasdfasdf"
},
"OtherPhones": {
"KeyValues": [
{
"Key": "همراه",
"Value": "تلفن 0123"
},
{
"Key": "محل کار",
"Value": "موبایل 09123"
}
]
},
"OtherEmails": {
"KeyValues": [
{
"Key": "کاری",
"Value": "mamo@sd.comsd"
}
]
},
"Websites": {
"KeyValues": [
{
"Key": "asdf",
"Value": "asdfasdfasdf"
}
]
},
"BankAccounts": {
"Values": [
{
"Value1": "Card",
"Value2": "asdfasfd",
"Value3": "asdfasdf",
"Value4": "asdfasdf"
},
{
"Value1": "Account",
"Value2": "sadfasdf",
"Value3": "asdfasdf",
"Value4": "asdfasdf"
}
]
},
"Addresses": {
"KeyValues": [
{
"Key": "محل کار",
"Value": "ASDF"
},
{
"Key": "منزل",
"Value": "ASDFASDF"
}
]
}
},
"SegmentIds": [
"e09a05a9-bf99-4f8b-9017-e06b42480078",
"0837c9fc-2018-4834-82f8-b505a5a51de6"
]
}
curl --location 'https://app.didar.me/api/contact/save?apikey={{API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"Contact": {
"Type": "Person",
"FirstName": "12",
"LastName": "آشنasasا",
"Title": "جناب آقای",
"OwnerId": "f1599895-3d58-44a8-a830-e77b42d8e4c6",
"CompanyName": "نام شرکت مرتبط به شخص",
"CompanyId": "39e05281-f35a-4923-bed4-8d2db9947be8",
"BirthDate": "2025-08-31T08:02:06.5247888Z",
"BirthDateMessageId": "88356367-c004-4263-98e5-6b4e8bbc9852",
"MobilePhone": "09391232",
"WorkPhone": "02155587458",
"WorkPhoneExtension": "تلفن منشی",
"Fax": "فکس منشی 023934443",
"Email": "",
"IsVIP": true,
"BackgroundInfo": "12312sdsd",
"Position": "مدیر واحد",
"CustomerCode": "12311213",
"NationalCode": "asdfdsdd2132",
"ZipCode": "123assdddf",
"CityId": "314409ce-ee7f-424e-ab88-c578d0ca187f",
"ProvinceId": "c990e86b-a13a-40f4-b21d-79bf09e6e579",
"VisibilityType": "All",
"Fields": {
"Field_996_0_7": "asdfasdfasdf",
"Field_996_0_8": "asdfasdfasdf"
},
"OtherPhones": {
"KeyValues": [
{
"Key": "همراه",
"Value": "تلفن 0123"
},
{
"Key": "محل کار",
"Value": "موبایل 09123"
}
]
},
"OtherEmails": {
"KeyValues": [
{
"Key": "کاری",
"Value": "mamo@sd.comsd"
}
]
},
"Websites": {
"KeyValues": [
{
"Key": "asdf",
"Value": "asdfasdfasdf"
}
]
},
"BankAccounts": {
"Values": [
{
"Value1": "Card",
"Value2": "asdfasfd",
"Value3": "asdfasdf",
"Value4": "asdfasdf"
},
{
"Value1": "Account",
"Value2": "sadfasdf",
"Value3": "asdfasdf",
"Value4": "asdfasdf"
}
]
},
"Addresses": {
"KeyValues": [
{
"Key": "محل کار",
"Value": "ASDF"
},
{
"Key": "منزل",
"Value": "ASDFASDF"
}
]
}
},
"SegmentIds": [
"e09a05a9-bf99-4f8b-9017-e06b42480078",
"0837c9fc-2018-4834-82f8-b505a5a51de6"
]
}'
{
"Response": {
"Id": "c15ab449-4432-4ebc-9b96-d39db57af988",
"Code": 14503,
"Title": "جناب آقای",
"FirstName": "12",
"LastName": "آشنasasا",
"DisplayName": "12 آشنasasا",
"OwnerId": "f1599895-3d58-44a8-a830-e77b42d8e4c6",
"CompanyId": "39e05281-f35a-4923-bed4-8d2db9947be8",
"BirthDate": "2025-08-31T08:02:06.5247888Z",
"BirthDateMessageId": "88356367-c004-4263-98e5-6b4e8bbc9852",
"BirthDateisValid": false,
"MobilePhone": "09391232",
"WorkPhone": "02155587458",
"WorkPhoneExtension": "تلفن منشی",
"Fax": "فکس منشی 023934443",
"Email": "",
"CanDelete": true,
"CanEdit": true,
"IsDeleted": false,
"IsVIP": true,
"IsMine": true,
"HasAccess": true,
"LeadGenerationType": "Manual",
"LeadStatus": "None",
"LeadType": "General",
"ContactType": "General",
"IsCustomer": false,
"IsProspect": false,
"Type": "Person",
"BackgroundInfo": "12312sdsd",
"RegisterTime": "2026-07-28T09:03:58.7530665Z",
"Position": "مدیر واحد",
"CustomerCode": "12311213",
"EconomicIssue": "",
"NationalCode": "asdfdsdd2132",
"RegistrationNumber": "",
"NationalID": "",
"ZipCode": "123assdddf",
"CityTitle": "اسکو",
"ProvinceTitle": "آذربایجان شرقی",
"ProvinceId": "c990e86b-a13a-40f4-b21d-79bf09e6e579",
"CityId": "314409ce-ee7f-424e-ab88-c578d0ca187f",
"HasCompany": true,
"CompanyName": "",
"CompanyIsCustomer": false,
"CompanyIsProspect": false,
"CompanyCode": 164,
"CompanyAndPosition": " - مدیر واحد",
"Feedback": 0.0,
"VisibilityType": "All",
"OtherPhones": {
"KeyValues": [
{
"Key": "همراه",
"Value": "تلفن 0123",
"Title": "همراه"
},
{
"Key": "محل کار",
"Value": "موبایل 09123",
"Title": "محل کار"
}
]
},
"OtherEmails": {
"KeyValues": [
{
"Key": "کاری",
"Value": "mamo@sd.comsd",
"Title": "کاری"
}
]
},
"Websites": {
"KeyValues": [
{
"Key": "asdf",
"Value": "asdfasdfasdf",
"Title": "asdf"
}
]
},
"Addresses": {
"KeyValues": [
{
"Key": "محل کار",
"Value": "ASDF",
"Title": "محل کار"
},
{
"Key": "منزل",
"Value": "ASDFASDF",
"Title": "منزل"
}
]
},
"BankAccounts": {
"Values": [
{
"Values": [
"Card",
"asdfasfd",
"asdfasdf",
"asdfasdf",
""
],
"Value1": "Card",
"Value2": "asdfasfd",
"Value3": "asdfasdf",
"Value4": "asdfasdf",
"Value5": "",
"Value6": "",
"Value7": "",
"Value8": "",
"Value9": "",
"Value10": "",
"Value11": "",
"Value12": "",
"Value13": "",
"Value14": "",
"Value15": ""
},
{
"Values": [
"Account",
"sadfasdf",
"asdfasdf",
"asdfasdf",
""
],
"Value1": "Account",
"Value2": "sadfasdf",
"Value3": "asdfasdf",
"Value4": "asdfasdf",
"Value5": "",
"Value6": "",
"Value7": "",
"Value8": "",
"Value9": "",
"Value10": "",
"Value11": "",
"Value12": "",
"Value13": "",
"Value14": "",
"Value15": ""
}
]
},
"Owner": {
"UserId": "f1599895-3d58-44a8-a830-e77b42d8e4c6",
"DisplayName": " محمد علی مزینی",
"PictureUrl": "/PortalData/Subsystems/Profile/UserPics/52c406aa-ae3d-4699-b253-6c5af7648549.jpg",
"Email": "mamozayyani@gmail.com"
},
"ContactStatus": {},
"Fields": {
"Field_996_0_7": "asdfasdfasdf",
"Field_996_0_8": "asdfasdfasdf"
},
"Segments": [],
"KeepInTouch": null,
"LastUpdateTime": "2026-07-28T09:03:58.7530665Z",
"OwnerId_Old": "00000000-0000-0000-0000-000000000000"
}
}