SMS Relentless Workflow
To be able to use this application, any admin user has to have the API keys for at least one SMSprovider (Telnyx/Plivo/Twilio/Flowroute) entered on the SMS Relentless’ settings page, in his own Nextcloud account (in ‘Administration settings; on the left panel, under ‘Administration, “SMS Relentless’).
In the most simple use case, where there is only one Telnyx/Plivo/Twilio/Flowroute account with one phone number associated with it, the admin enters the API keys for that provider on his settings page. If the admin wants to share his API credentials with non-admin users, so that they can use the same phone number to send and receive SMS messages, the admin can specify the group of users with whom he wants to share his credentials, or the Display Name of each user, in the corresponding boxes, under ‘Allow the following groups and non-admin users to send and receive messages .... However, in this case, to properly use the shared credentials, the non-admin users have to access their app settings page, generate the two webhook URLsfor that provider by clicking the corresponding ‘Generate new webhook URL ...’ buttons and then click the ‘Save’ button at the bottom of that page. In this case, each message sent by a user will appear in the Sent Messages table as being sent by that respective user, and all the received messages will appear in the ‘Received messages’ table as being received by the admin user whose credentials were used. If in one Telnyx/Plivo/Twilio/Flowroute account there are multiple SMS-enabled phone numbers, each phone number can be restricted to a specific non-admin user in the ‘Restrict access to the following phone numbers’ section. In this way, only the person to whom the number was restricted will be able to use the number to send messages.
Another use case is when different app users have different phone numbers in the sameTelnyx/Plivo/Twilio/Flowroute account. In this situation, each user can be a Nextcloud admin and can enter the same API credentials on his settings page, but they will have different webhook URLs for receiving messages since separate phone numbers allow setting up separate webhook URLs for receiving messages.
The admin can restrict the use of the application to certain user groups by clicking on the profile picture in the upper right corner > Apps, then by clicking on ‘SMS Relentless’ in the list of apps, then by checking the ‘Limit to groups’ checkbox, then entering the name of the group whose members will be allowed to use the application.
