← ClaudeAtlas

sms-best-practiceslisted

Provides SMS compliance, formatting, and delivery best practices for the Sendly API. Covers TCPA compliance, quiet hours, opt-out handling, E.164 phone formatting, message segmentation, and carrier verification. Applies when building SMS features that must be compliant and deliverable.
SendlyHQ/sendly-skills · ★ 0 · AI & Automation · score 62
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