Worlds / Comms and scheduling / Twilio
Twilio world
A local Twilio account with phone numbers, messaging services, SMS and calls, opt-outs and delivery status callbacks. Test the agent that sends reminders and replies by text, and respects who opted out.
SMSCallsNumbersOpt-outsDelivery Receipts
SMS · +1 415 555 0142
+1 415 555 0142 8:10Can I move my appointment to Thursday?
Clinic agent 8:11Yes, you're now booked Thursday at 10:00.SM8a1 · delivered
+1 415 555 0177 8:20STOP
Clinic agent 8:30Reminder: your appointment is tomorrow at 9:00.SM8c4 to 0177 · opted out
+1 415 555 0188 8:32HELP
fig. 1 · illustrative replica · the agent's changes land as you scroll
What's in this world
What you get when you open Twilio. Seeded, local, yours to break.
Seeded records
- numbers
- 3 long codes and 1 toll-free number on a messaging service
- messages
- 800 messages, queued, sent, delivered, undelivered and failed
- opt-outs
- 40 recipients who replied STOP
- calls
- Call logs with status and duration
- status callbacks
- Delivery callbacks for every message
Agent jobs you can test
- Send appointment reminders from the right number
- Reply to inbound texts in the same conversation
- Honor STOP and HELP keywords
What your agent can get wrong here
The reply sounds right. The record is what counts.
ActionWhat the world recordsCommon mistake
Send a reminder
message To against the opt-out listTexts a number that replied STOPReply to a text
From number and conversationReplies from a different number than the patient textedRetry a failed message
message status and retriesResends a delivered message after a slow callbackCall a customer
call record and statusPlaces a call outside allowed hoursExample test
Describe the job. Review the checks before anything runs.
Send tomorrow's appointment reminders and answer reschedule requests. Skip anyone who has opted out, and reply from the number each patient texted.
- 01No messages to opted-out numbers
- 020142 reply sent from the number they texted
- 03One reminder per patient, no duplicates
- 04HELP reply sent to 0188
- 05No calls placed
fig. 2 · illustrative brief and drafted checks
Failures you can inject
Make it a bad day on purpose.
effect
Sending to a STOP recipient returns error 21610fires before the handler · state untouched · same result every runEvidence
StatusIncluded in the closed beta, like every world in the catalog. Apply and tell us the workflow you want to test.Known limitations
