وبهوکهای شرکت
وبهوکهای شرکت اطلاعات شرکت را پس از ایجاد یا ویرایش آن به آدرس مقصد ارسال میکنند. ساختار کلی 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.Segments[].Iddata.Segments[].Titledata.LastUpdateTime
data تغییر نکنند، وبهوک ویرایش شرکت ارسال نمیشود. آرایه changes عامل Trigger نیست؛ این آرایه نتیجه تغییرات انجامشده را گزارش میکند و data آخرین وضعیت شرکت را پس از ویرایش نشان میدهد.