SMS Notifications

Zephyr documentation

How SMS Notifications Work

Pro and Enterprise users can receive SMS notifications from any workflow. When a workflow triggers, the 'Send SMS' action sends a text message to your verified phone number. The message defaults to the result of the previous action (e.g. an AI summary), or you can write a custom message. SMS always goes to your own verified number ? you cannot send to third-party numbers.

Setting Up Your Phone Number

Go to Settings > Notifications. Select your country code from the dropdown, then enter your mobile number. Tap Verify ? you will receive a 6-digit code by SMS. Enter the code to confirm you own the number. Once verified, a green badge appears next to your number. You must verify your number before any SMS workflow action will send.

Creating an SMS Workflow

In the Workflows tab, tap Create and describe what you want in plain English. Examples: 'When I get an email from my boss, summarize it and text me the summary', 'When a new email arrives from support@company.com, text me the subject', 'Every morning at 9am, text me a reminder to check my inbox'. The AI generates the workflow automatically. You can also add a 'Send SMS' action manually to any existing workflow by editing it.

SMS Monthly Limits

SMS usage is counted per calendar month and resets on the 1st of each month. Pro users get 50 SMS per month. Enterprise users get 200 SMS per month per user. Free users cannot use SMS workflow actions. When you reach your monthly limit, the action records a failure in workflow history and resets automatically the following month. Limits can be adjusted by your platform administrator.

Message Content

If you leave the message field empty in the workflow action, Zephyr automatically uses the result of the previous action as the SMS body. For example, if you have an 'ai.summarize' action before 'sms_notify', the summary becomes the SMS text. If there is no preceding action, the SMS contains the email subject and sender. You can also write a fixed message in the action config, or use template variables: {{subject}} for the email subject, {{sender}} for the sender's email address.

Delivery Tracking

Every SMS send creates a delivery record in your workflow history. The status starts as 'pending' and updates to 'delivered' or 'failed' once AWS SNS reports back. You can see SMS delivery status alongside your other workflow execution history in the Workflows tab > Recent Activity.

Troubleshooting

If SMS is not delivering:

Check that your phone number is verified in Settings > Notifications (look for the green verified badge).

Check your monthly limit has not been reached in workflow history.

Make sure your number is in international format (e.g. +61412345678).

If you just set up SMS, the AWS account may still be in sandbox mode ? contact your platform administrator. Common error messages: 'No verified phone number configured' means you need to add and verify a number in Settings. 'SMS monthly limit reached' means you have used all your SMS for this month.