Troubleshooting Guide

1.1 Direct SMS Not Sending (Android)

Symptom: You tap "Send Alert" but the SMS fails. The alert history shows an error for one or more recipients.

• No cellular signal: Check the status bar. The Status page in the app shows your current cellular status.
• No SIM card: Direct SMS requires a working SIM card. Check SIM status on the Status page.
• Permissions: Ensure SMS permission is allowed in phone settings.
• Invalid format: Use international format with country code (e.g., +34600123456).

1.2 Twilio SMS Not Sending

Symptom: Alert fails with a Twilio error message.

• Internet required: Twilio needs Wi-Fi or cellular data.
• Credentials: Verify Account SID, Auth Token, and Twilio phone number in Settings.
• Trial limitations: Trial accounts can only send to verified phone numbers.
• Balance: Check your Twilio account balance.

1.3 iOS SMS Composer Issues

Symptom: On iPhone, the SMS composer opens but the message doesn't get delivered.

• Signal: The Messages app needs cellular signal (or WiFi Calling if active).
• Cancellation: If you tap Cancel in the composer, the alert is cancelled.
• Invalid number: iOS will queue the message and fail silently. Check the Messages app for red exclamation marks.

2.1 Email Test Fails

• SMTP Settings: Verify host and port (Gmail/iCloud use 587).
• App Password: Most providers require an App Password if 2FA is enabled.
• Internet: Email requires an active data connection.

3.1 Location Missing in Alert

• Permissions: Ensure Location permission is set to "While Using" or "Always".
• GPS Disabled: Verify phone location services are turned on.
• Reception: Indoors or dense areas may cause a GPS timeout.

4.2 Shield Icon Meanings

• Green: Ready for reliable SMS/Twilio delivery.
• Orange: Uncertain. WiFi only, no Twilio. WiFi Calling might work.
• Red: Disconnected. Both cellular and WiFi are off.

5.1 Timer Doesn't Fire

• App Closed: Avoid force-closing the app. On iOS, you must tap the notification to trigger.
• Battery Optimization: Set TapAlert to "Unrestricted" in Android battery settings.
• Notifications: Ensure notification permissions are granted.

6.1 Voice Recognition Not Working

• Permissions: Ensure Microphone and Speech Recognition (iOS) permissions are granted.
• Internet: Most recognition engines require an active connection for processing.
• Wrong Language: The recognition uses the app's current language setting. Check **Settings > Language**.

7.1 Cannot See Contacts

• iOS Limited Access: If you previously chose "Select Contacts...", go to **Settings > Privacy & Security > Contacts > TapAlert** and change to **"All Contacts"**.
• Android Permissions: Ensure **Contacts** permission is set to "Allow" in system settings.
• Format: Ensure numbers include the country code with a **+** prefix.

8.2 Purchased But Still Shows Free

• Restore Purchases: In the Upgrade screen, tap the **Restore** button to re-validate your purchase with the store.
• Same Account: Ensure you're signed in with the same store account used for the original purchase.

9.1 Widget Not Appearing

• Manual Add: Try adding the widget from **Settings > Widget > Add** within the app if it doesn't appear in the system widget picker.
• Battery Optimization: Aggressive optimization may prevent the widget from launching the app correctly.

10.2 Recipients Not Noticing Calls/SMS

• iPhone: Have recipients enable **Emergency Bypass** for your contact number.
• Android: Have recipients set notification priority to **"High"** or **"Urgent"** for your messages.

11.1 Alert Fires Immediately on Open

Go to **Settings** and disable **"Auto-Start on Launch"**. This feature is intended for physical panic buttons.

12.1 Twilio vs. iOS Messages

• Twilio (Automatic): Silent background sending, requires internet.
• iOS Messages (Manual): Requires you to tap Send in the composer, works via cellular.

13.1 Battery Optimization

Some manufacturers (Xiaomi, Samsung, Huawei) require manual steps to prevent the app from being killed in the background. Check your phone's battery settings for **"No restrictions"**.