SMS Notifications
SMS Notifications hedgesstOPLIN offers a free service that allows libraries to send notification messages directly to patrons' cellphones via standard Short Message Service (SMS) "text messages" instead of sending messages to their email accounts.
NOTE this service is intended only for patron alerts which they've opted in for. Blasts of marketing messages are governed by a different set of laws due to SPAM, which is outside the scope of this service.
Prerequisites:
- Your existing Integrated Library System (ILS) must be capable of sending notifications to patrons' email addresses.
- You must inform OPLIN of the IP address of the server (usually your ILS server) that sends your email notifications.
Procedure
To use the service, you should ask a patron if they wish to receive messages by cell phone instead of by email; their normal text messaging charges will apply. (There is no cost to the library.)
If they want cell phone messages, you will enter their email address in your ILS as <cellphone_number>@sms.oplin.org.
-
Example
-
If the patron wishes to receive notifications at their cell phone number 614-123-4567, then you would put
6141234567@sms.oplin.org
in the email field of their patron record. Notifications will now be sent to their cell phone rather than to their normal email address.
If you would like notices of errors and patron STOP requests via email, please let us know which email address the messages should go to.
By default nothing is done with patron replies. To change this let us know which email address you would like the replies forwarded to, or provide us with a message you'd rather be texted back to the patron.
The OPLIN SMS system accepts notices 24 hours a day, but only sends text messages between 9 AM and 9 PM. This is to allow libraries to continue sending email notices in the middle of the night, without possibly waking up patrons who keep their phones on the night stand.
Message format
All notifications sent to patrons' cell phones will be limited to 152 characters, which is the maximum length of a single text message, so your standard notification language must include all important information (library name, phone number, etc.) within those 152 characters.
The OPLIN SMS system uses *** as its delimiter to determine what text from your regular email messages will be sent to people's cell phones.
- If you send an email to the system and no occurrence of *** is found, the system will discard the email.
- If you send an email with one occurrence of *** the system uses that as the beginning of your 152 character message.
- If the system finds two or more occurrences of *** it uses whatever you have between the first pair as your text message, taking the first 152 characters of that snippet.
-
Good examples of notices we've seen:
-
***This is a reminder from the UAPL that 1 item(s) will soon be due. Please return or renew them by their due date. Visit www.ualibrary.org for more information.***
-
***You have items ready to pick up at the Lane Libraries.***
-
***Your hold is available from the Lakewood Public Library. It will be held for 10 days. Call 216-226-8275 for more information.***
The Microsoft SMTP daemon typically uses an encoding for plain text that can cause "=" to appear at the end of lines. The OPLIN SMS system automatically strips those unwanted characters from your message.
The system also strips out any carriage returns or new-line codes that may be embedded in your message, so your message is formatted for optimum cell phone display.
The system automatically handles any base64 encoded email.
Service objectives:
- Incident Response: OPLIN staff will respond within one hour to malfunctions of sending notifications to cell phones during regular business hours Monday through Friday from 8:00 a.m. to 5:00 p.m., excluding State of Ohio holidays; contact us through the OPLIN Support site.
- Incident Resolution: OPLIN staff will either resolve the incident within 4 business hours or will open an incident ticket with the messaging vendor(s) and work collaboratively toward resolving the incident within the timeframe specified in the vendor's agreed service objective.
Questions?
Contact OPLIN Support.
Error Codes and Resolution
Code | Meaning | Resolution |
---|---|---|
DR001 | Mobile number has opted-out of future messages | Having patron text "unstop" to 877-675-4632 will remove the block, and will automatically respond with a generic subscription confirmation message. If the automatic response does not arrive, patron should contact their vendor about being able to receive shortcode messages from 877-675-4632. |
DR002 | The gateway is not routing messages to this network prefix. | Number is likely a landline or unknown carrier. |
DR005 | The messaging gateway failed to deliver the message to the phone provided | Message failed at patron carrier level. If previous attempt was successful, one retry will be attempted. Troubleshooting would involve patron reaching out to their carrier to ensure successful delivery of messages in the future. |
DR006 | The mobile number is invalid and cannot receive messages. Do not retry. | Check for a typo in the patron's @sms.oplin.org email address in the patron record |
DR008 | The message expired and was not delivered to the subscriber. | Message failed at patron carrier level. If previous attempt was successful, one retry will be attempted. Troubleshooting would involve patron reaching out to their carrier to ensure successful delivery of messages in the future. |
DR009 | The carrier rejected the message. This can be due to short code messaging blocked, anti-spam policies, or their wireless plan. | Message failed at patron carrier level. If previous attempt was successful, one retry will be attempted. Troubleshooting would involve patron reaching out to their carrier to ensure successful delivery of messages in the future. |
DR010 | The message was not sent due to a temporary system error. | Message delivery failed at the carrier due to a temporary error. |
DR013 | The mobile number does not support text messages. | Check for a typo in the patron's @sms.oplin.org email address in the patron record. |
DR015 | SMS could not be delivered due to a phone error | Message failed at patron carrier level. If previous attempt was successful, one retry will be attempted. Troubleshooting would involve patron reaching out to their carrier to ensure successful delivery of messages in the future. |
DR017 | Unknown reason | Message delivery failed at the carrier for an unknown reason. OPLIN will make one retry to deliver the message. |
DR019 | Message will be retried by carrier. | |
MPCE3202 | Cannot send to international number | Check for a typo in the patron's @sms.oplin.org email address in the patron record |
MPME0601 | Inappropriate Message Content. | The content of the text message was rejected by filters at the SMS bulk carrier. The message may contain spammy words like "naked." |
MPME1204 | Special Characters are not allowed | Check message for odd characters or punctuation. |
MPME2301 | The subscription ID OPLIN has on file for this number is no longer valid. | No action needed. Main reason to see this is if a patron blocks the texting service. When OPLIN receives this message we automatically delete the old subscription ID and retry the message. Retrying the message will either successfully generate a new ID, or will cause a different error to fire. |
MPSE0501 | User has a block in place | Having patron text "unstop" to 877-675-4632 will remove the block, and will automatically respond with a generic subscription confirmation message. If the automatic response does not arrive, patron should contact their vendor about being able to receive shortcode messages from 877-675-4632. |
MPSE2201 | Invalid mobile number format | Check for a typo in the patron's @sms.oplin.org email address in the patron record |
MPSE2208 | Invalid mobile number | Check for a typo in the patron's @sms.oplin.org email address in the patron record |