Texting
Text athletes and parents from one business number inside the app: connect a Telnyx or Twilio account, start conversations, read replies, and understand delivery status and STOP opt-outs.
Overview
Texting is a shared SMS inbox for your staff. Your organization brings its own Telnyx or Twilio account and one phone number on it; Connected Performance sends and receives messages through that number and keeps every conversation in one place. Everyone on staff sees the same conversations, so a coach can pick up a thread an admin started.
You pay the carrier directly and keep your own A2P 10DLC registration. The app stores the credentials, relays messages, and records delivery status.
Texting is off by default. An admin turns it on under My App > Settings > Texting, which adds Texting to the sidebar for coaches and admins. Athletes and parents never see the inbox; they receive ordinary text messages on their phone.
How To
Turn Texting on
- Go to My App > Settings and open the Texting tab under Communication.
- Switch on Enable Texting.
- Click Save changes.
- Click Open Texting, or pick Texting from the sidebar.
Admins only. While the feature is off, every texting request is rejected with "Texting is not enabled for this organization", and the Texting page shows "Texting is not enabled" with a pointer to Settings.
Connect your business number
Admins only. Coaches see the "Connect your business number" screen but no button; they are told to ask an admin.
-
On the Texting page, click Connect a number. If a number is already connected, click Number settings instead.
-
Choose a Provider: Telnyx or Twilio.
-
Enter the credentials the provider needs:
Provider Fields Telnyx API key (a V2 API key) and Messaging profile public key Twilio Account SID and Auth token -
Click Load my numbers. The app asks the provider for the numbers on that account. If there is exactly one, it is selected for you; otherwise pick one under Send from.
-
Click Connect.
What the app checks before saving:
- The provider accepts the credentials. Otherwise you see "Telnyx rejected that API key" or "Twilio rejected that account SID and auth token".
- Telnyx needs the messaging profile public key; without it inbound webhooks cannot be verified and the save is refused.
- The number you chose must be on that account. Otherwise: "+1... is not one of the numbers on that account".
Credentials are stored encrypted and are never sent back to the browser. Saving records the time of verification and marks the number active.
Point the provider's webhooks at the app
Inbound texts and delivery receipts arrive through webhooks. After connecting, open Number settings: the panel shows the connected number and two URLs, an inbound URL and a status URL. Paste both into your provider's webhook settings for that number or messaging profile.
Telnyx sends both message kinds to one URL on the messaging profile, so either URL works there. Twilio uses separate inbound and status URLs. Every delivery is checked against your own provider key; a delivery with a bad signature, or one addressed to a number other than the one you connected, is dropped.
Start a conversation
- Click New text.
- Either search under Find someone and pick a person, or type a number under Text a number directly and click Start.
The people list only shows users who have a phone number on their profile; otherwise it says "Nobody matching has a phone number on their profile." Picking a person uses the phone number from their profile. If that number is missing or unusable you see "[name] has no phone number set".
Numbers are normalized before use. Ten digits are treated as a North American number and get +1; anything else must start with + and a country code. An unusable number is refused with "Phone number is not a valid phone number".
Conversations are keyed by phone number, one per number. Starting a text to someone who already has a conversation reopens it rather than creating a second one. When someone texts your number for the first time, a conversation is created and matched to a user by the last ten digits of their profile phone, so inbound threads show the person's name where possible.
Send a message
- Select a conversation from the list on the left.
- Type in the box and click Send.
Rules the app enforces:
| Rule | Detail |
|---|---|
| Empty messages | Rejected: "Message cannot be empty". |
| Length | 1,600 characters maximum: "Message cannot be longer than 1600 characters". |
| Segments | The counter under the box shows characters used and how many 160-character segments the carrier will bill. |
| Opted out | If the contact replied STOP, the reply box is replaced with a warning and sending is blocked. |
Each outbound bubble shows who on staff sent it, the time, and its status.
Read delivery status
Outbound messages start as queued and update as the provider reports back:
| Status | Meaning |
|---|---|
queued | Accepted by the provider, not yet sent. |
sent | Handed to the carrier. |
delivered | The carrier confirmed delivery. |
failed | Not delivered. The provider's error code is shown next to it. |
Inbound messages show as received. Status updates only arrive if the status webhook URL is configured at the provider.
Track unread conversations
A conversation gets a dot in the list when a new inbound message arrives. Opening it clears the dot for everyone, since the inbox is shared. The list refreshes every 20 seconds and an open conversation every 8 seconds; there is no need to reload the page.
Conversations are ordered by most recent message. A conversation with no messages yet sits where it was created.
Handle STOP and START
When a contact texts STOP, STOPALL, UNSUBSCRIBE, CANCEL, END or QUIT, the conversation is marked opted out and shows a STOP badge. Sending is blocked with "[number] replied STOP. Carriers block further messages until they text START." If they later text START, UNSTOP or YES, the block lifts. The carrier enforces the same rule on its side; the app mirrors it so staff can see why a reply is not possible.
Disconnect a number
Admins only. Open Number settings and click Disconnect. Credentials are removed and sending stops. Conversations and transcripts are kept, and a new number can be connected later.
If Texting is turned off in Settings while a number is still connected, inbound texts are still stored. Staff cannot read or answer them until the feature is turned back on.
Tips
- Add phone numbers to athlete and parent profiles before you start. The Find someone picker only lists people with a number, and inbound threads only show a name when the number matches a profile.
- Keep the two webhook URLs pasted at the provider. Without them you can send, but replies and delivery receipts never reach the inbox.
- Watch the segment counter. Carriers bill per 160-character segment, and a long message with emoji can cost several.
- Only one number per organization. Connecting again replaces the existing configuration.
Troubleshooting
"Texting is not enabled for this organization." An admin has to switch on Enable Texting under My App > Settings > Texting and save.
"No texting number is connected for this organization." A message was sent while no active number exists. An admin needs to connect one from the Texting page.
Replies never show up. The inbound webhook URL is not set at the provider, or the request failed signature verification. Open Number settings, copy the inbound URL exactly, and for Telnyx confirm the messaging profile public key matches the profile the number is on.
A message stays at queued.
The provider accepted it but has not reported further. Configure the status webhook URL so sent, delivered and failed updates arrive.
"+1... is not one of the numbers on that account." The number you picked belongs to a different provider account or sub-account than the credentials you entered.
"SMS_WEBHOOK_BASE_URL is not configured on the API." A server configuration issue, not something you can fix in the app. Contact support.
I can see the page but not the Connect button. Only admins can connect, change or disconnect a number. Coaches can read and send once one is connected.
Related
- Chat
- Organization Settings
- Managing Coaches
Referenced by
- 'Organization Settings'getting started