Chat and SMS-text Messaging Configuration options:

Configuring the messaging for each contact is determined by two separate configurations; the first is the Premium Texting Option (for SMS texting only) in the account-level configuration form and the second is the Messaging service option in the contact form.

Note: These configurations are only for Chat and SMS-text Messaging and DO NOT apply to emails. Emails are configured separately and enabled/disabled independently of Chat and SMS-text Messages.

Though the contact form has the option to select the preferred form of chat/SMS messaging, the account configuration form has SMS messaging options that can affect or even override the contact form options.

CONTACT-LEVEL OPTIONS: Below are the details for the contact-level and account-level configuration settings for messaging options.

1. No SMS Service - No SMS/chat messaging service is configured for this contact. Email and other independently configured notification options are not affected.
2. No SMS Service - No SMS/chat messaging service is configured for this contact. Email and other independently configured notification options are not affected.
3. ClickSend® SMS - Personal account. Very reliable but requires prepaid services. Follow below steps to configure ClickSend® SMS texting:
   1. Create an account and purchase any amount of prepaid texts from ClickSend.com. Make note of the phone number.
   2. Test the account by sending a text to yourself from the dashboard using this SMS test procedure.
   3. Enter your ClickSend® account ID (your email address) in the contact-form field "Message Service UserID".
      Note: The contact-form field "Message Service UserID" can also be used for the PushOver user ID/Key. Also note that ClickSend can be configured at the account-level in the configuration form to make it available for all contacts to use.
   4. From the ClickSend® dashboard, click on the key icon at the top of the page to get your account key.
   5. Copy/past your ClickSend® account key to the contact-form field "Message Service Token".
   6. Test your ClickSend® account configuration by sending a text to yourself by clicking on the [Test] button in the "SMS/Chat Messaging service option" field.
4. PushOver® App - This is not a SMS text service, but a chat app with exposed APIs to allow other services push notifications to subscribers. As of October 2022, the App is free to test for 90 days, then you will be charged a one-time fee of about $5 for the app. The app can then recieve 10k chat texts per month (likely way beyond the MyCalendarAlerts limit).
   This is the recommended option for MyCalendarAlerts and below are the steps to use this option.
   1. Install the PushOver® app on your phone
   2. Use the app to create an account on PushOver.net
   3. After creating the account, got to PushOver.net and use the "Push a Notification" fields at the top to send your app a message to confirm the app and account are properly configured.
   4. After confirming the app and account configuration, you will see "Your User Key" at the top right. Copy/paste that value into the into the contact-form field "Message Service UserID".
      Note: The contact-form field "Message Service UserID" can also be used for a ClickSend user ID
   5. Next you will need a 'token'. From your dashboard in the "Your Applications" section, click on the link "(Create an Application/API Token)". You can call the app anything (e.g. MyCalendarAlerts). Fill out the form and create an API token. If brought back to the dashboard, click on your app at the bottom to get the token.
   6. After creating the token, (you will see "API Token/Key" at the top of the application page) Copy/paste the token into the into the contact-form field "Message Service Token".
      Note: The contact-form field "Message Service Token" can also be used for a ClickSend password/token
   7. OPTIONAL SOUNDS: In the contact form "Message App Sound" field, you can optionally type in any of the available sounds at PushOver.net/api#sounds. The typed (or copy/pasted) sound name must be spelled exactly as on this page.
   8. Ensure you already selected "PushOver App" in the contact-form field Messaging service option, then press the [Test] button in the "SMS/Chat Messaging service option" field. If configured properly, you should get a chat text on your app. If you encounter problems you cannot figure out, contact MyCalendarAlerts for assistance.
   9. Press the SAVE button on the contact-form to save the configuration. If all went well, you will now receive PushOver notifications for your MyCalendarAlerts!

NOTES FOR CONTACT-LEVEL OPTIONS:

• Texting can optionally be completely disabled by selecting "No SMS Service". In this case, no SMS/chat message is sent unless the account-level configuration is set to "ALWAYS - Account-level paid SMS service AVAILABLE and ALWAYS used".
• These options can be overridden with the account-level configuration's SMS option "ALWAYS - Account-level paid SMS service AVAILABLE and ALWAYS used".

ACCOUNT-LEVEL CONFIGURATION OPTIONS: Below are the details for the account-level configurations affecting SMS premium texting options.

1. N/A - Account-level paid SMS service NOT available. This option indicates there is no prepaid/premium SMS texting service available for individual contacts to use. However, contact-level premium SMS texting service through ClickSend® is possible as is the option to use the PushOver® App.
2. OPTIONAL - Account-level paid SMS service AVAILABLE but OPTIONAL. With this option, contacts can optionally select the account-level premium SMS service.
   
   Note: This option requires a prepaid ClickSend® account configured or a MyCalendarAlerts Premium account. See below configuration instructions when using your own personal ClickSend® account.
3. ALWAYS - Account-level paid SMS service AVAILABLE and ALWAYS used. When this option is selected, ALL contacts will use the premium SMS option specified in the account-level configurations regardless of the selected contact-level messaging option. That is, this option will override the contact-level option.
   
   Note: This option requires a prepaid ClickSend® account configured or a MyCalendarAlerts Premium account. See below configuration instructions when using your own personal ClickSend® account.

CONFIGURING ACCOUNT-LEVEL ClickSend® FIELDS:
Follow the below instructions when using your own personal ClickSend® SMS account:

1. Create an account and purchase any amount of prepaid texts from ClickSend.com. Make note of the phone number.
2. Test the account by sending a text to yourself from the dashboard using this SMS test procedure.
3. Enter your ClickSend® account ID (your email address) in the configuration-form field "SMS Service UserID".
4. From the ClickSend® dashboard, click on the key icon at the top of the page to get your account key.
5. Copy/past your ClickSend® account key to the configuration-form field "SMS Service Token/Psw".
6. Test your ClickSend® account configuration by sending a text to yourself by clicking on the [Test] button in the "SMS Service UserID" field.

NOTES FOR ACCOUNT-LEVEL CONFIGURATION OPTIONS:

• There are no account-level configuration settings for using the PushOver® Chat app. However, as mentioned above, the account-level configuration option "ALWAYS - Account-level paid SMS service AVAILABLE and ALWAYS used" can be used to override the contact-level messaging option including the PushOver® Chat app.
• The OPTIONAL and ALWAYS SMS options are only valid if the account has a prepaid ClickSend® account configured or a MyCalendarAlerts Premium account. These two options are ignored if these prepaid SMS options are not enabled and the contacts will not have access to an account-level SMS prepaid option. In this case, the rules will apply as if the account-level configuration is set to "N/A - Account-level paid SMS service NOT available" and as mentioned in this option's description, the contact can still use the PushOver® App or contact-level prepaid ClickSend® account.

ACCOUNT-LEVEL + CONTACT-LEVEL CONFIGURATION OPTION MATRIX:

The below table shows the MyCalendarAlerts policy/logic for determining how to send contacts messages based on these to configuration settings.

Configuration Option selected at Account-level	Configuration Option selected for Contact	Expected message type sent to contact
N/A - Account-level paid SMS service NOT available.	No SMS Service	No SMS/chat message sent.
MyCalendarAlerts SMS - Requires MyCalendarAlerts premium account	No SMS message sent (Account-level SMS is not enabled)
N/A - Account-level paid SMS service NOT available.	ClickSend SMS - Personal account	SMS attempted using ClickSend SMS.
N/A - Account-level paid SMS service NOT available.	Pushover App	Message attempted using PushOver chat.
OPTIONAL - Account-level paid SMS service AVAILABLE but OPTIONAL.	No SMS Service	No SMS/chat message sent.
OPTIONAL - Account-level paid SMS service AVAILABLE but OPTIONAL.	MyCalendarAlerts SMS - Requires MyCalendarAlerts premium account	SMS attempted using account-level Prepaid SMS account
OPTIONAL - Account-level paid SMS service AVAILABLE but OPTIONAL.	ClickSend SMS - Personal account	SMS attempted using Personal ClickSend SMS.
OPTIONAL - Account-level paid SMS service AVAILABLE but OPTIONAL.	Pushover App	Message attempted using PushOver chat.
ALWAYS - Account-level paid SMS service AVAILABLE and ALWAYS used.	No SMS Service	SMS attempted using Account-level paid SMS service (Overriding contact option)
ALWAYS - Account-level paid SMS service AVAILABLE and ALWAYS used.	MyCalendarAlerts SMS - Requires MyCalendarAlerts premium account	SMS attempted using Account-level paid SMS service (Overriding contact option)
ALWAYS - Account-level paid SMS service AVAILABLE and ALWAYS used.	ClickSend SMS - Personal account	SMS attempted using Account-level paid SMS service (Overriding contact option)
ALWAYS - Account-level paid SMS service AVAILABLE and ALWAYS used.	Pushover App	SMS attempted using Account-level paid SMS service (Overriding contact option)

---