وبهوکهای شخص
وبهوکهای شخص اطلاعات شخص را پس از ایجاد یا ویرایش آن به آدرس مقصد ارسال میکنند. ساختار کلی Payload در هر دو رویداد یکسان است؛ با این تفاوت که در وبهوک ویرایش، آرایهchanges مشخص میکند کدام اطلاعات شخص در همان عملیات تغییر کردهاند.
ساختار داده ارسالی
object
اطلاعات کامل شخصی است که این وبهوک برای او ارسال شده است. در وبهوک ایجاد، این Object اطلاعات شخصی را نشان میدهد که تازه در دیدار ثبت شده و در وبهوک ویرایش، آخرین وضعیت همان شخص را پس از ذخیره تغییرات نمایش میدهد.
array
تغییراتی که باعث ارسال وبهوک ویرایش شخص شدهاند در این Array قرار میگیرند. در وبهوک ایجاد،
changes خالی است؛ چون شخص تازه ساخته شده و نسخه قبلیای برای مقایسه وجود ندارد. در وبهوک ویرایش، هر عضو مشخص میکند کدام فیلد تغییر کرده، مقدار آن پیش از ویرایش چه بوده و پس از ویرایش به چه مقداری تبدیل شده است. Object data وضعیت نهایی شخص را نشان میدهد و changes فقط تغییرات همان عملیات را گزارش میکند.object
اطلاعات فنی مربوط به خود رویداد وبهوک است، نه اطلاعات شخص. این Object مشخص میکند چه عملیاتی انجام شده، رویداد متعلق به کدام بیزدامنه و شخص است، چه کاربری آن را ایجاد کرده، تغییر از چه منبعی آمده و Payload توسط کدام تنظیم وبهوک و در چندمین تلاش ارسال شده است.
وبهوک ایجاد شخص چه زمانی ارسال میشود؟
وبهوک ایجاد شخص زمانی ارسال میشود که یک شخص جدید با موفقیت در دیدار ثبت شود. آبجکتdata شامل اطلاعات شخص تازه ایجادشده است و آرایه changes خالی ارسال میشود، چون پیش از این عملیات رکوردی وجود نداشته که فیلدی از آن تغییر کرده باشد.
وبهوک ویرایش شخص چه زمانی ارسال میشود؟
وبهوک ویرایش شخص زمانی ارسال میشود که حداقل یکی از اطلاعات موجود درdata تغییر کند. فیلدهایی که تغییر آنها میتواند باعث ارسال این وبهوک شود عبارتاند از:
data.Iddata.Codedata.Titledata.FirstNamedata.LastNamedata.DisplayNamedata.OwnerIddata.CompanyIddata.BirthDatedata.BirthDateisValiddata.BirthDateMessageIddata.MobilePhonedata.WorkPhonedata.WorkPhoneExtensiondata.Faxdata.Emaildata.CanDeletedata.CanEditdata.IsDeleteddata.IsVIPdata.IsMinedata.HasAccessdata.LeadGenerationTypedata.LeadStatusdata.LeadTypedata.ContactTypedata.IsCustomerdata.IsProspectdata.Typedata.BackgroundInfodata.RegisterTimedata.Positiondata.CustomerCodedata.EconomicIssuedata.NationalCodedata.RegistrationNumberdata.NationalIDdata.ZipCodedata.CityTitledata.ProvinceTitledata.ProvinceIddata.CityIddata.HasCompanydata.CompanyNamedata.CompanyIsCustomerdata.CompanyIsProspectdata.CompanyCodedata.CompanyAndPositiondata.Feedbackdata.VisibilityTypedata.OtherPhonesdata.OtherEmailsdata.Websitesdata.Addressesdata.BankAccountsdata.Fields.Field_996_0_3data.Segmentsdata.LastUpdateTime
data تغییر نکنند، وبهوک ویرایش شخص ارسال نمیشود. آرایه changes عامل Trigger نیست؛ این آرایه نتیجه تغییرات انجامشده را گزارش میکند و data آخرین وضعیت شخص را پس از ویرایش نشان میدهد.