Consent and STOP
PeakIDX will not send a text to a number unless consent has been recorded for it. This page explains how consent is recorded and how opt-out keywords work.
This page describes how the software behaves. It is not legal advice. Text messaging is regulated (for example by the TCPA in the United States). Site owners are responsible for obtaining their own legal review of their consent wording and practices.
Consent Is Required Before Sending
A message is refused, before anything is sent to Twilio, when there is no consent record for the number or when the person has opted out. Consent is stored per site and per phone number, with the source, the date and, for form checkboxes, the visitor's IP address.
Consent is recorded in two ways:
| Source | How it works |
|---|---|
| Form checkbox | A form that includes a field named sms_consent with a true value (1, on, true, yes or y) records consent for the phone number submitted with the lead. |
| START reply | A person who had opted out replies START (or UNSTOP) to your number. |
Consent is not inferred from simply having a phone number on a lead.
The sms_consent Form Field
To collect consent, add a checkbox named sms_consent to your lead form, next to the phone field. When the lead is saved and the box is checked and a phone number was entered, PeakIDX records the consent. If the box is not checked, nothing is recorded.
The checkbox should not be pre-checked. The wording next to it is your responsibility. Your wording, reviewed by your own legal counsel, should generally cover:
- That the person agrees to receive text messages from your business name.
- What kinds of messages to expect and roughly how often.
- That message and data rates may apply.
- That they can reply STOP to opt out and HELP for help.
- That consent is not a condition of purchase or of using your site.
- Links to your privacy policy and terms.
Example only, to be adapted and reviewed: "I agree to receive text messages from [Business Name] at the number above. Message frequency varies. Message and data rates may apply. Reply STOP to opt out or HELP for help."
Automatic Checkbox on Public Forms
When SMS is enabled and set up for the site, PeakIDX adds an optional, unchecked SMS consent checkbox to its built-in public forms (contact, property inquiry, CMA request, mortgage quote), to forms you build in the form manager, and to the public booking page. The wording uses your Business name from SMS Settings and ends with "Msg & data rates may apply. Reply STOP to opt out." The checkbox is never required, and whether the phone field is required does not change. If the site does not have SMS set up, the checkbox does not appear.
When the visitor checks the box and enters a phone number, consent is recorded for that number the same way as described above. Leads sent to the /submit-lead/ address can include sms_consent=1 for the same result.
Keywords
When a person texts your number, PeakIDX checks the whole message against these keywords. Case is ignored, as are surrounding spaces and punctuation. A keyword inside a longer sentence does not count.
| Keyword | Words recognized | What happens |
|---|---|---|
| STOP | STOP, STOPALL, UNSUBSCRIBE, CANCEL, END, QUIT | The number is marked opted out and an automatic reply confirms it. |
| START | START, UNSTOP | Consent is recorded again, clearing the opt-out, and an automatic reply confirms it. |
| HELP | HELP | An automatic reply names your business and explains STOP and START. |
The automatic replies use the Business name from SMS Settings. If it is blank, "us" is used. Replies are sent in the response to Twilio's webhook and are logged in the conversation with the status auto_reply.
Opt-Out Handling
- After STOP, sending to that number is blocked, including from the lead page. The conversation page says the number has opted out.
- Only a START reply to your number restores sending. Re-submitting a form with the checkbox also records consent again.
- Every inbound message, including keywords, is logged and appears on the lead's timeline when the number matches a lead.
First Message Wording
The first message PeakIDX sends to a number is changed to read: Business name: your message followed by a new line and Reply STOP to opt out. This does not replace your consent wording on the form.