Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

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.

caution

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.

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:

SourceHow it works
Form checkboxA 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 replyA 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.

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.

KeywordWords recognizedWhat happens
STOPSTOP, STOPALL, UNSUBSCRIBE, CANCEL, END, QUITThe number is marked opted out and an automatic reply confirms it.
STARTSTART, UNSTOPConsent is recorded again, clearing the opt-out, and an automatic reply confirms it.
HELPHELPAn 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.