SMS opt-ins for government organizations

Record SMS opt-ins from government customers.

When requesting a callback via API for a government organization, you can specify that a customer has opted in to receive SMS notifications.

In order to track that a customer has opted in to receive callback notifications, you can include an opt_ins property with API requests to Mindful Scheduler widget API endpoints.

See the example cURL request below:

curl --request POST \ 
--url 'https://<ORG_ID>.gov-scheduler-rt.getmindful.com/api/widget/<WIDGET_ID>/request_callback?time_zone=240' \ 
--header 'content-type: application/json' \ 
--data '{ "contact_number":"<PHONE_NUMBER>", "appointment_time":"<APPT_TIME>", "opt_ins": [ { "use_case": "callback-notifications", "channel": "sms", "timestamp": 1718372902847 } ] }'

To indicate that a customer has opted in to receive notifications, add the opt_ins property and specify an array of objects containing the following members:

  • use_case — Assign the value callback-notifications.

  • channel — Assign the value sms.

  • timestamp — Provide a Unix-formatted time stamp to record the time the customer opted in.

When receiving a request to a Mindful Scheduler widget API endpoint that includes the opt_ins property, Mindful will assess whether the opt_ins object for the relevant use case and channel includes a timestamp property before proceeding with any SMS notifications configured for the relevant Call Target.

Initially, the only use_case and channel supported are callback-notifications and sms, respectively. For callback requests submitted via the widget API endpoint, callback notifications will only be sent by SMS for requests where either:

  • The opt_ins object includes a timestamp, or...

  • The opt_ins property is not present (for backwards compatibility)

Important: SMS messages will not be sent to a customer phone number on the Handoff Block List, even if an opt-in has been submitted for that number.