Troubleshooting & Best Practices for SMS Notifications

Overview

Once your SMS Gateway is configured in Taskify, you may encounter issues like failed deliveries, incorrect formats, or throttling. This article covers common problems, best practices, and optimization tips to ensure reliable SMS notifications.

Common Issues and Fixes

1. Invalid Credentials (401 Unauthorized)

• Cause: Wrong Account SID or Auth Token.

• Fix:

  • Recheck the credentials entered in Taskify Admin Panel.

  • Regenerate a new Auth Token from your provider if needed.

  • Make sure the .env file is updated (if using environment variables).

2. SMS Not Delivered

• Cause: Recipient number format not supported, or country blocked by provider.

• Fix:

  • Always store numbers in E.164 format (e.g., +14155552671).

  • Check your provider’s coverage list.

  • Ensure your account has sufficient SMS credits.

3. Delayed Messages

• Cause: SMS provider rate-limits or queues.

• Fix:

  • Upgrade to a higher-tier plan if you need bulk SMS.

  • Spread out notifications (batching) instead of sending hundreds at once.

  • Monitor provider logs for “queued” messages.

4. Wrong Base URL

• Cause: Using the wrong API endpoint.

• Fix:

  • Double-check that you’re using the “Send SMS” endpoint.

  • Refer to your provider’s documentation.

5. Number Formatting Errors

• Cause: Missing country code or incorrect formatting.

• Fix:

  • Enforce international format in user input.

  • Validate phone numbers before saving in Taskify.

Best Practices

1. Use Environment Variables (.env):

   • Store ACCOUNT_SID, AUTH_TOKEN, and BASE_URL in .env.

   • Example:

     SMS_BASE_URL=https://api.twilio.com/2010-04-01/Accounts/xxxx/Messages.json
     SMS_ACCOUNT_SID=xxxxxxxx
     SMS_AUTH_TOKEN=xxxxxxxx
     

2. Test with Multiple Numbers:

   • Test both domestic and international numbers before production rollout.

3. Enable Logging:

   • Monitor System Logs → Integrations → SMS Gateway in Taskify.

   • Check for failed messages or provider error codes.

4. Monitor SMS Credits:

   • Set up reminders with your provider to avoid running out of credits.

5. Fallback Notifications:

   • Combine SMS with email or WhatsApp for critical updates.

Security Considerations

• 🔒 Never expose API keys in the frontend or share them in team chats.

• 🔒 Rotate tokens regularly.

• 🔒 Enable IP restrictions if your SMS provider supports it.