Send each record again whenever it changes, and send the whole record each time: a field you leave out is cleared.
References travel in the body, so slashes are fine. A development’s
house_types is the full list: a type you leave
out is removed, and renaming one is a removal plus an addition.
Order
Every record carriesupdated_at: when it last changed in your system. An update older than the one we hold is
ignored, and the response says "applied": false. So retries and out-of-order deliveries are safe.
Listings
portal_ids (your Daft and MyHome ids) let Signal match a portal enquiry to your listing, so events about it carry
your ref. A listing that leaves available stops Signal starting new conversations about it, and stops it chasing
people who haven’t replied. People mid-conversation are flagged to the negotiator instead.
Units
A unit’sref is your id for it; plot_number is what buyers see (“Plot 7”) and is unique within the development.
A unit’s status is what Signal’s new-homes conversation offers: once it leaves available, it isn’t offered. To take
a unit off sale, send unreleased.
Reservations
Each reservation has its own
ref: a new buyer for the same unit is a new reservation. We find the lead buyer by
contact_id, then your buyer external_id, then phone. A reservation also sets the unit’s status (fell_through puts
it back to available), so you needn’t send the unit as well.