Mobile App Deeplinking ====================== With deeplinking, you can provide a link to a specific page within your mobile app. For example, you may send congregants an email with a link to an important announcement that has been made available in the app. If a recipient opens the email on a mobile device, clicking the link will open the mobile app directly to the announcement. The domain used for these links is ``yourchurch.app.tpsdb.co``, where "yourchurch" is replaced with the domain for your database. Read below for how to use your own domain for deeplinking, how to set up a deeplink, what deeplinks are available and more... .. admonition:: Safelinks' Impact on Deeplinks If your email system is a Microsoft Exchange Server or certain Outlook services, Safelinks may be enabled for your email. Safelinks convert links before they arrive in your Inbox and *will usually break deeplinks so that they do not work as intended*. To be clear, deeplinks as they are sent out through TouchPoint email are not affected by Safelinks; it is only when the email is delivered to a recipient who has Safelinks that the deeplink is altered. If the Safelinks feature is negatively impacting one or more of your email recipients, it can be turned off. Below are some helpful links: |link1| |link2| |link3| .. |link1| raw:: html How to turn off Safelinks for an individual Office 365 subscriber .. |link2| raw:: html How to disable Safelinks for an Organization .. |link3| raw:: html Exclude specific URLs from Safelinks modification (for an Organization) | How to Use Your Own Domain for Deeplinking ------------------------------------------ If you want to use your own domain for these, you will need to create a CNAME entry in your domain's DNS settings, associating your desired domain name with the actual domain used. For example, if you want to use app.yourchurch.org, create the CNAME record with app.yourchurch.org as the alias and yourchurch.app.tpsdb.co as the destination (again, where "yourchurch" is replaced with the domain for your database). *Then you will need to notify Support of the domain name you are using since it will require an update to your app for a nominal fee.* Available Deeplinks ------------------- Listed below are deeplinks available for use. For all of them, replace the domain name with your own. When you include the protocol (http or https) in the address when sending in an SMS message through TouchPoint, the link will automatically be translated to a shortened URL. - https://mychurch.app.tpsdb.co/profile/giving : takes user to their giving history page - https://mychurch.app.tpsdb.co/giving/history : an alternate link to the giving history page - https://mychurch.app.tpsdb.co/ : takes user directly to the enabled giving page created in your database under `Adminstration > Setup > Online Giving` by using the text after the ``.com/`` from the Public URL and adding it to the end of this URL. Example: If the Public URL to your giving page is ``https://mychurch.tpsdb.com/Give/now``, the deeplink URL will be ``https://mychurch.app.tpsdb.co/Give/now`` - https://mychurch.app.tpsdb.co/registrations/landing : takes user to the Registrations page - https://mychurch.app.tpsdb.co/registrations/register/100 : takes user directly to the registration page for the Involvement whose ID is the number at the end of the deeplink - https://mychurch.app.tpsdb.co/registrations/details/100 : takes user directly to the registration Details page for the Involvement whose ID is the number at the end of the deeplink - https://mychurch.app.tpsdb.co/profile/information : takes user to their own profile information - https://mychurch.app.tpsdb.co/profile/family : takes user to My Family page where family members are listed - https://mychurch.app.tpsdb.co/profile/involvement : takes user to their Involvements page - https://mychurch.app.tpsdb.co/tools/attendance : takes user to the Attendance page - https://mychurch.app.tpsdb.co/tools/peoplesearch : takes user to the People Search page - https://mychurch.app.tpsdb.co/tools/tasks : takes user to the Tasks page - https://mychurch.app.tpsdb.co/location/select : takes user to the Select Location page - https://mychurch.app.tpsdb.co/location/information : takes user to the Location Information page - https://mychurch.app.tpsdb.co/location/view : takes user to the Location Information page - https://mychurch.app.tpsdb.co/precheckin/ : takes user directly to Pre Check-In (the trailing ``/`` is required) - https://mychurch.app.tpsdb.co/prayerrequest/ : takes user directly to Prayer Requests (the trailing ``/`` is required) Deeplink Redirections --------------------- Some of these deeplinks, when clicked on a desktop/laptop will take the user to the corresponding page in the web application. Below are the links that will work in this way, along with the URL to the matching web page: .. csv-table:: :header: "Deeplink", "Desktop Redirect" :widths: 70,70 https://mychurch.app.tpsdb.co/profile/giving, https://mychurch.tpsdb.com/person2/0#tab-contributions https://mychurch.app.tpsdb.co/profile/history, https://mychurch.tpsdb.com/person2/0#tab-contributions https://mychurch.app.tpsdb.co/giving/recurring/33, https://mychurch.tpsdb.com/onlinereg/33 https://mychurch.app.tpsdb.co/giving/give/34, https://mychurch.tpsdb.com/onlinereg/34 https://mychurch.app.tpsdb.co/giving/onepage/34, https://mychurch.tpsdb.com/onepagegiving/34 https://mychurch.app.tpsdb.co/registrations/register/100, https://mychurch.tpsdb.com/onlinereg/100 https://mychurch.app.tpsdb.co/profile/information, https://mychurch.tpsdb.com/person2/0#tab-personal https://mychurch.app.tpsdb.co/profile/family, https://mychurch.tpsdb.com/person2/0#tab-personal https://mychurch.app.tpsdb.co/profile/involvement, https://mychurch.tpsdb.com/person2/0#tab-current https://mychurch.app.tpsdb.co/tools/peoplesearch, https://mychurch.tpsdb.com/peoplesearch https://mychurch.app.tpsdb.co/tools/tasks, https://mychurch.tpsdb.com/person2/0#tab-tasksassigned The following deeplinks will not redirect to a corresponding web page. Instead the user is brought to an App Store Promo page with button links for getting the app from the Google Play Store or from the Apple App Store. If you would like to customize this page (perhaps with additional explanation or instructions), create a Special Content HTML file named AppStorePromoPage. We recommend you start with the HTML code of the default page and modify it with your changes. Generic code for the page is provided below, but you may find it more convenient to copy the page source from the actual web page so you have the URL for your app icon. - https://mychurch.app.tpsdb.co/registrations/landing - https://mychurch.app.tpsdb.co/tools/attendance - https://mychurch.app.tpsdb.co/location/select - https://mychurch.app.tpsdb.co/location/information - https://mychurch.app.tpsdb.co/location/view When any deeplink is clicked on a mobile device but the user does not have the app installed, the user is brought directly into the app store with the app selected so they can download it. Sample HTML code for AppStorePromoPage -------------------------------------- .. literalinclude:: Files/AppStorePromoPage.html :language: html :linenos: | | +--------------------+------------------+ | **Latest Update** | **5/17/2022** | +--------------------+------------------+ Added trailing slash to Pre Check-In and Prayer Requests