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

# Contacts

> Linking Signal's people to yours.

Every event about a person carries `contact_id`, Signal's id for the person. **Store it.** `webhook.test` carries none, and `note.added` only when the note is about a person.

## Someone you don't have yet

Some people reach Signal directly, for example by a portal enquiry email the agency forwards to Signal. The first you
hear of them may be `enquiry.qualified`. When that happens:

1. Read `contact` on the event: their name, phone and email as Signal holds them.
2. Look them up in your system by phone and email, and create them only if they aren't there.
3. Store Signal's `contact_id` against them.

## Telling us your id

Send your own contact id as `contact.external_id` on your next call about them, such as a viewing. We link the two, and
from then on events carry it as `contact_external_id`.

## Opt-outs

`enquiry.opted_out` means the person asked Signal to stop WhatsApp messages. It applies to messages from Signal only,
across all their enquiries with the agency. The agency may choose to honour it more widely.


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