Skip to main content
Signal doesn’t book resale or letting viewings: the negotiator books in your system and you tell us, with 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;
  • contact with a phone number, plus transaction_type: someone who never enquired through Signal.
If you send more than one, 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 receive viewing.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 as showhome.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 own external_id (for example vw_88213:con_5531). Two people sharing one phone get one feedback conversation.