Skip to main content
Send enquiries that start in your system: phone calls, walk-ins, your own web forms. If the agency already sends its portal enquiry emails to Signal, don’t send those again. POST /enquiries. external_id is the enquiry’s id, so one person asking about three properties is three enquiries. transaction_type (sale or letting) picks the questions Signal asks.

What comes back

The greeting goes out at any hour, because it answers an enquiry made moments earlier. Follow-ups only go out between 08:00 and 21:00, and feedback requests in the evening (see Viewings).

The same person again

A person is a mobile number within an agency, with one WhatsApp thread however many properties they ask about.
  • The same external_id again: 200, nothing changes, nobody is messaged.
  • A new enquiry for the same property: recorded, no new message.
  • A new enquiry for a different property: they get a message about it. If they’ve already answered the questions for that transaction type, they’re only asked to confirm and say when they can view.
  • A different transaction type (rented before, buying now): the full question set for the new type.
The agency decides its basis for contacting enquirers. By default, someone who enquires with their mobile number has asked to be contacted about that property.
  • contact_by_whatsapp: true, or no consent object: the agency’s policy applies, which by default starts the conversation.
  • contact_by_whatsapp: false: recorded, never messaged.
  • Someone who opted out isn’t messaged on later enquiries, unless one carries contact_by_whatsapp: true with a captured_at later than their opt-out.

Old enquiries

An enquiry whose received_at is more than 24 hours old is recorded and never messaged (stale), so switching an agency on can never WhatsApp last month’s enquirers. Please don’t backfill.

New homes

A new-homes enquiry is a sale with property.development. Add property.ref too when a particular unit was chosen; leave it out when the enquiry is about the development as a whole. Send the development first (see Listings and new homes). An unknown development is a 422.