Skip to main content
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.