> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signalproptech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enquiries

> Hand Signal an enquiry that started in your system.

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

| `conversation` | Meaning |
| - | - |
| `starting` | First contact with this person for this agency. The greeting is on its way. |
| `existing_contact` | We already have a conversation with this mobile number for this agency. |
| `not_started` | Recorded, nothing sent. `reason` says why: `no_phone`, `not_mobile`, `no_consent`, `opted_out`, `stale`, `suppressed`, `transaction_type_off` (the agency hasn't switched Signal on for sales, or for lettings) or `whatsapp_not_connected`. |

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](https://docs.signalproptech.com/guides/viewings.md)).

## 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.

## Consent

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](https://docs.signalproptech.com/guides/listings.md)). An unknown development is a `422`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.