sms-best-practiceslisted
Install: claude install-skill SendlyHQ/sendly-skills
# SMS Best Practices
## Phone number formatting
Always use E.164 format: `+{country_code}{number}` with no spaces, dashes, or parentheses.
| Input | E.164 | Valid? |
|---|---|---|
| (415) 555-1234 | +14155551234 | After formatting |
| 415-555-1234 | +14155551234 | After formatting |
| +14155551234 | +14155551234 | Yes |
| 4155551234 | +14155551234 | Need country code |
## Message types and compliance
**transactional**: OTP codes, order confirmations, appointment reminders, account alerts, shipping updates. Allowed 24/7. The recipient has an existing relationship with the sender.
**marketing**: Promotions, sales, newsletters, product announcements. Subject to:
- Quiet hours: 9pm–8am in the recipient's local timezone
- Prior express written consent required (TCPA)
- Must include opt-out instructions
Misclassifying marketing as transactional violates TCPA and can result in fines up to $1,500 per message.
## Opt-out handling
Sendly automatically handles opt-outs. When a recipient replies STOP, UNSUBSCRIBE, CANCEL, END, or QUIT:
- The number is added to the opt-out list
- Future sends to that number return `opted_out` error
- An `opt_out.created` webhook event fires
Do not attempt to send to opted-out numbers. Check `message.status` for `opted_out` errors.
Opt-out status is checked automatically when sending — the API returns an `opted_out` error if the recipient has unsubscribed.
## Quiet hours
Marketing messages are blocked during quiet hours (9pm–8am recipient loca