POST /viewings. Send it when a viewing is booked, moved or cancelled, before it happens.
Who it’s for
One of:enquiry_external_id: an enquiry you sent us;contact_id: Signal’s id for the person, from any event;contactwith a phone number, plustransaction_type: someone who never enquired through Signal.
enquiry_external_id wins, then contact_id, then contact. An id we’ve never seen is
skipped when the next one tells us who it is; it’s a 422 only when nothing does. So always include the contact, with a phone number, and transaction_type.
Send updated_at (when it last changed in your system) and an older update than the one we hold is ignored, so a
retried booked can’t undo a later cancelled. Without it, the last call wins.
Statuses
When feedback is asked for
Feedback is asked for in the evening, between 19:00 and 21:00 Irish and UK time: a viewing that starts by 17:00 is asked about at 19:00, a later one about two hours after it starts, and one after 19:00 the next evening. A viewing we first hear about more than two hours after its start is recorded but never triggers feedback: the response says"feedback": "not_scheduled", with reason too_late. Once feedback has been asked for, later changes are
recorded and do nothing else. It’s never asked twice.
The reminder the day before
On the afternoon before, Signal sends the viewer a reminder with two buttons: still coming, or can’t make it. If they tap can’t make it, you receiveviewing.cant_make_it, Signal asks when else would suit, and no feedback is asked
for. Signal changes nothing in your system: the negotiator cancels or moves the viewing there, and you send us the
update. The agency can switch reminders off.
Show-home bookings made in Signal
New-homes buyers can book show-home visits in Signal itself. You receive those asshowhome.booking_made /
_changed / _cancelled, keyed by viewing_id. Don’t send them back to us with POST /viewings, or they’ll be
counted twice.
Several people at one viewing
Send one call per person, each with its ownexternal_id (for example vw_88213:con_5531). Two people sharing one
phone get one feedback conversation.