وبهوکهای شخص اطلاعات شخص را پس از ایجاد یا ویرایش آن به آدرس مقصد ارسال میکنند. ساختار کلی Payload در هر دو رویداد یکسان است؛ با این تفاوت که در وبهوک ویرایش، آرایه changes مشخص میکند کدام اطلاعات شخص در همان عملیات تغییر کردهاند.
اطلاعات کامل شخصی است که این وبهوک برای او ارسال شده است. در وبهوک ایجاد، این Object اطلاعات شخصی را نشان میدهد که تازه در دیدار ثبت شده و در وبهوک ویرایش، آخرین وضعیت همان شخص را پس از ذخیره تغییرات نمایش میدهد.
شناسه شخصی است که این وبهوک برای او ارسال شده است. در وبهوک ایجاد، این مقدار شناسه شخصی است که تازه در دیدار ساخته شده و در وبهوک ویرایش، شناسه همان شخصی است که اطلاعاتش ویرایش شده است.
کد عددی شخص در دیدار است که برای نمایش، ارجاع و جستوجوی سادهتر مخاطب استفاده میشود. این کد با data.Id فرق دارد؛ Id شناسه فنی رکورد است، اما Code یک شماره قابلخواندنتر برای کاربران و سیستمهای متصل است.
عنوانی است که قبل از نام و نام خانوادگی این شخص نمایش داده میشود؛ برای مثال «آقای»، «خانم» یا «دکتر». این مقدار بخشی از نحوه نمایش نام شخص در دیدار است.
نام کامل و آمادهنمایش شخص در دیدار است. این مقدار معمولاً از ترکیب نام، نام خانوادگی و اطلاعات نمایشی مخاطب ساخته میشود و همان متنی است که در فهرستها، جستوجو و بخشهای مختلف CRM دیده میشود.
شناسه Userی است که در حال حاضر مسئول پیگیری این شخص در دیدار است. این کاربر وظیفه دارد ارتباط با مخاطب را مدیریت کند و فعالیتها یا پیگیریهای مربوط به او را پیش ببرد.
شناسه شرکتی است که این شخص به آن متصل شده است؛ برای مثال شرکتی که شخص در آن کار میکند. اگر شخص به هیچ شرکتی متصل نباشد، این مقدار میتواند شناسه خالی سیستم باشد.
مشخص میکند مقدار موجود در data.BirthDate بهعنوان تاریخ تولد معتبر قابل استفاده است یا خیر. مقدار true یعنی تاریخ تولد معتبر ثبت شده و مقدار false یعنی مقدار فعلی نباید بهعنوان تاریخ تولد قطعی شخص در نظر گرفته شود.
شناسه پیام یا الگوی پیام مرتبط با یادآوری تولد این شخص است. این مقدار ارتباط میان تاریخ تولد مخاطب و تنظیمات پیام یا یادآوری مربوط به تولد را مشخص میکند.
شماره موبایل اصلی شخصی است که ایجاد یا ویرایش شده است. این شماره برای تماس، جستوجوی مخاطب، تشخیص رکورد و هماهنگسازی شخص با سیستمهای دیگر استفاده میشود.
مشخص میکند رکورد این شخص در Context فعلی قابل حذف است یا خیر. مقدار true یعنی حذف شخص مجاز است و مقدار false یعنی براساس وضعیت رکورد یا دسترسیها نمیتوان او را حذف کرد.
مشخص میکند رکورد این شخص در Context فعلی قابل ویرایش است یا خیر. مقدار true یعنی اطلاعات شخص قابل تغییر است و مقدار false یعنی ویرایش رکورد مجاز نیست.
مشخص میکند این شخص بهعنوان مخاطب ویژه علامتگذاری شده است یا خیر. مقدار true یعنی شخص VIP است و مقدار false یعنی بهعنوان مخاطب ویژه علامت نخورده است.
مشخص میکند این شخص در حوزه مسئولیت کاربری قرار دارد که Context این داده براساس او ساخته شده است یا خیر. مقدار true یعنی رکورد متعلق به همان کاربر یا تحت مسئولیت اوست و مقدار false یعنی مسئول شخص کاربر دیگری است.
مشخص میکند کاربر مربوط به Context این داده اجازه مشاهده شخص را دارد یا خیر. مقدار true یعنی رکورد برای او قابل مشاهده است و مقدار false یعنی قواعد دسترسی اجازه مشاهده این شخص را نمیدهند.
نحوه ورود یا ایجاد این شخص بهعنوان سرنخ در دیدار را مشخص میکند. این مقدار نشان میدهد مخاطب از چه نوع فرایندی وارد CRM شده است؛ برای مثال در پاسخ Endpoint ایجاد شخص، مقدار Manual یعنی شخص بهصورت دستی ثبت شده است.
وضعیت این شخص در فرایند سرنخ را نشان میدهد. این مقدار مشخص میکند مخاطب در حال حاضر در چه وضعیت تجاری قرار گرفته و آیا برای او وضعیت مشخصی در چرخه سرنخ ثبت شده است یا خیر.
یادداشت و اطلاعات زمینهای ثبتشده درباره این شخص است. این فیلد برای نگهداری نکاتی مثل سابقه ارتباط، نیازهای مخاطب یا اطلاعاتی استفاده میشود که جای مشخصی در فیلدهای ساختاریافته ندارند.
زمانی است که این شخص برای اولین بار در دیدار ثبت شده است. در وبهوک ویرایش نیز این مقدار زمان ایجاد اولیه شخص را نشان میدهد و نباید با زمان آخرین ویرایش اشتباه گرفته شود.
شناسه ملی موجود در ساختار مشترک مخاطبان است. برای رکورد شخص معمولاً خالی است، چون شناسه ملی به شرکت یا شخص حقوقی مربوط میشود و کد ملی شخص در data.NationalCode قرار میگیرد.
شناسه استانی است که در اطلاعات نشانی این شخص انتخاب شده است. این شناسه مشخص میکند مخاطب در کدام استان قرار دارد و عنوان همان استان در data.ProvinceTitle ارسال میشود.
شناسه شهری است که در اطلاعات نشانی این شخص انتخاب شده است. این شناسه مشخص میکند مخاطب در کدام شهر قرار دارد و عنوان همان شهر در data.CityTitle ارسال میشود.
مشخص میکند این شخص به یک شرکت در دیدار متصل است یا خیر. مقدار true یعنی برای شخص شرکت مرتبط ثبت شده و مقدار false یعنی شخص بدون ارتباط با شرکت ذخیره شده است.
مشخص میکند شرکت مرتبط با این شخص، در دیدار مشتری محسوب میشود یا خیر. مقدار true یعنی شرکت مشتری است، مقدار false یعنی مشتری نیست و مقدار null یعنی شرکت مرتبطی وجود ندارد یا این وضعیت برای آن مشخص نشده است.
مشخص میکند شرکت مرتبط با این شخص، مشتری بالقوه محسوب میشود یا خیر. مقدار true یعنی شرکت Prospect است، مقدار false یعنی در این وضعیت نیست و مقدار null یعنی شرکت مرتبطی وجود ندارد یا وضعیت آن مشخص نشده است.
کد عددی شرکت مرتبط با این شخص در دیدار است. این کد برای نمایش، جستوجو یا تطبیق شرکت مرتبط در سیستم مقصد استفاده میشود و در صورت نداشتن شرکت میتواند null باشد.
متن ترکیبی نام شرکت و سمت شغلی این شخص است. این مقدار برای نمایش سریع جایگاه فرد استفاده میشود؛ یعنی خواننده بدون بررسی جداگانه فیلدهای شرکت و سمت میتواند ارتباط شغلی مخاطب را ببیند.
سطح مشاهده این شخص را مشخص میکند و تعیین میکند براساس تنظیمات دسترسی، چه کاربرانی امکان دیدن رکورد او را دارند؛ برای مثال فقط مسئول، مسئول و گروه او یا همه کاربران مجاز.
فهرست شمارههای تلفن فرعی ثبتشده برای این شخص است. هر عضو Array یک شماره اضافه را همراه عنوان کاربرد آن، مثل «همراه»، «محل کار» یا «منزل»، نمایش میدهد.
فهرست اطلاعات حسابهای بانکی ثبتشده برای این شخص است. هر عضو Array اطلاعات یک کارت یا حساب بانکی را در ساختار داخلی دیدار نگهداری میکند و برای فرایندهای مالی قابل استفاده است.
مقادیر فیلدهای اضافهای است که برای شخص تعریف شده و روی همین مخاطب مقدار گرفتهاند. نام هر property کلید فنی یک Custom Field و مقدار آن، داده ذخیرهشده در همان فیلد است.
مقدار ثبتشده در فیلد اضافهای است که کلید فنی آن Field_996_0_3 است. مفهوم این مقدار به عنوان و نوع Custom Field متناظر در تنظیمات همین بیزدامنه بستگی دارد.
فهرست گروههایی است که این شخص عضو آنهاست. هر عضو Array یک Segment را نشان میدهد که برای دستهبندی مخاطبان، فیلترکردن آنها یا اجرای فرایندهای هدفمند استفاده میشود.
زمان آخرین تغییری است که روی اطلاعات این شخص ذخیره شده است. در وبهوک ویرایش، این مقدار زمان بهروزرسانی نهایی رکورد را نشان میدهد؛ در حالی که data.RegisterTime زمان ایجاد اولیه شخص است.
تغییراتی که باعث ارسال وبهوک ویرایش شخص شدهاند در این Array قرار میگیرند. در وبهوک ایجاد، changes خالی است؛ چون شخص تازه ساخته شده و نسخه قبلیای برای مقایسه وجود ندارد. در وبهوک ویرایش، هر عضو مشخص میکند کدام فیلد تغییر کرده، مقدار آن پیش از ویرایش چه بوده و پس از ویرایش به چه مقداری تبدیل شده است. Object data وضعیت نهایی شخص را نشان میدهد و changes فقط تغییرات همان عملیات را گزارش میکند.
مقدار فیلد پیش از انجام این ویرایش است. با مقایسه آن با changes[].after میتوانید دقیقاً تشخیص دهید اطلاعات شخص از چه مقداری تغییر کرده است. نوع مقدار به فیلد نوشتهشده در propertyName بستگی دارد و میتواند رشته، عدد، Boolean، Object، Array یا null باشد.
اطلاعات فنی مربوط به خود رویداد وبهوک است، نه اطلاعات شخص. این Object مشخص میکند چه عملیاتی انجام شده، رویداد متعلق به کدام بیزدامنه و شخص است، چه کاربری آن را ایجاد کرده، تغییر از چه منبعی آمده و Payload توسط کدام تنظیم وبهوک و در چندمین تلاش ارسال شده است.
شناسه شخصی است که رویداد وبهوک برای آن ثبت شده است. این مقدار باید به همان رکوردی اشاره کند که اطلاعات کامل آن داخل data قرار گرفته و معمولاً با data.Id یکسان است.
شناسه رویدادی است که پس از ایجاد یا ویرایش شخص در سیستم ثبت شده و این Payload براساس آن ساخته شده است. این شناسه مربوط به خود رویداد است، نه شناسه شخص.
مشخص میکند تغییر شخص در قالب یک عملیات گروهی انجام شده است یا خیر. مقدار true یعنی این رویداد نتیجه ویرایش گروهی بوده و مقدار false یعنی شخص بهصورت تکی ایجاد یا ویرایش شده است.
زمانی است که رویداد ایجاد یا ویرایش شخص در دیدار ثبت شده و Payload وبهوک براساس آن تولید شده است. این زمان لزوماً با تاریخهای داخل خود شخص یکسان نیست.
شناسه کاربری است که عملیات منجر به ارسال این وبهوک را انجام داده است. در رویداد ایجاد، کاربری را نشان میدهد که شخص را ساخته و در رویداد ویرایش، کاربری را مشخص میکند که تغییر را انجام داده است.
شناسه تنظیم وبهوکی است که این Payload را به آدرس مقصد ارسال کرده است. این مقدار برای تشخیص وبهوک تعریفشدهای که رویداد از طریق آن ارسال شده کاربرد دارد.
وبهوک ایجاد شخص زمانی ارسال میشود که یک شخص جدید با موفقیت در دیدار ثبت شود. آبجکت data شامل اطلاعات شخص تازه ایجادشده است و آرایه changes خالی ارسال میشود، چون پیش از این عملیات رکوردی وجود نداشته که فیلدی از آن تغییر کرده باشد.
وبهوک ویرایش شخص زمانی ارسال میشود که حداقل یکی از اطلاعات موجود در data تغییر کند. فیلدهایی که تغییر آنها میتواند باعث ارسال این وبهوک شود عبارتاند از:
data.Id
data.Code
data.Title
data.FirstName
data.LastName
data.DisplayName
data.OwnerId
data.CompanyId
data.BirthDate
data.BirthDateisValid
data.BirthDateMessageId
data.MobilePhone
data.WorkPhone
data.WorkPhoneExtension
data.Fax
data.Email
data.CanDelete
data.CanEdit
data.IsDeleted
data.IsVIP
data.IsMine
data.HasAccess
data.LeadGenerationType
data.LeadStatus
data.LeadType
data.ContactType
data.IsCustomer
data.IsProspect
data.Type
data.BackgroundInfo
data.RegisterTime
data.Position
data.CustomerCode
data.EconomicIssue
data.NationalCode
data.RegistrationNumber
data.NationalID
data.ZipCode
data.CityTitle
data.ProvinceTitle
data.ProvinceId
data.CityId
data.HasCompany
data.CompanyName
data.CompanyIsCustomer
data.CompanyIsProspect
data.CompanyCode
data.CompanyAndPosition
data.Feedback
data.VisibilityType
data.OtherPhones
data.OtherEmails
data.Websites
data.Addresses
data.BankAccounts
data.Fields.Field_996_0_3
data.Segments
data.LastUpdateTime
اگر هیچکدام از فیلدهای موجود در data تغییر نکنند، وبهوک ویرایش شخص ارسال نمیشود. آرایه changes عامل Trigger نیست؛ این آرایه نتیجه تغییرات انجامشده را گزارش میکند و data آخرین وضعیت شخص را پس از ویرایش نشان میدهد.
.svg?fit=max&auto=format&n=5dFUa43uNFVHhpls&q=85&s=0676273c9e1c58f0a7d6694269d14045)