Skip to main content

​
What Cymph uses it for

Cymph connects to Twilio to send SMS notifications when a playbook execution changes state or is handed over to someone else. The same message that goes to Slack or Microsoft Teams is sent as a text to a list of phone numbers you maintain in the organisation’s notification settings. Twilio is a notification target only. Cymph never reads messages, never receives replies, and Twilio is neither a content source nor a deployment target.

​
Notification events

Only execution-level events are sent to the organisation’s channels. Personal notices, such as a step becoming unblocked for its assignee, go to that person by email and in-app and are not texted. Each event is one SMS per recipient. Line breaks in the notification are flattened to | and the text is cut at 600 characters so a message stays within a few billable segments.

​
Requirements

There is no instance URL — Cymph connects to Twilio’s API at https://api.twilio.com. Both values are on the Account Info panel of the Twilio Console home page.
Only phone numbers purchased on the account can be used as the sender. Alphanumeric sender IDs, short codes and Messaging Services are not supported.

​
Setting it up

Sending SMS takes two steps, in two places: the integration holds the credentials and the sender, and the organisation’s notification settings hold the recipients and the switch.
1

Add the integration

In a workspace, open Integrations → Add Integration → Twilio, enter the Account SID, Auth Token and sender number, and click Test before saving. See Manage integrations.
2

Choose the recipients

From the navigation menu, open the Organisation page, click the name of your organisation, and go to the Notifications tab. Under SMS (Twilio), switch the channel on, select the integration, and add the recipient numbers in international format. Up to 20 numbers are accepted, each must be unique, and at least one is required while the channel is on. Click Save changes.
Recipients are part of the organisation settings rather than the integration, so one Twilio account can serve different number lists over time, and the list is edited without touching the credentials.
Use the same organisation page to combine channels. Slack, Teams and SMS are configured independently and can be enabled in any combination; a failure on one channel never stops the others.

​
What Cymph reads and writes

The test sends nothing. When notifying, Cymph posts one message per recipient and keeps going if a number is rejected, so one bad number does not block the rest.

​
Testing the connection

Test Connection validates the credentials against the account and confirms the sender number:
Twilio is a public service, so the outbound destination is fixed and no allowlisting of a customer endpoint applies. If your Cymph deployment restricts egress, api.twilio.com over HTTPS must be reachable — see Networking.

​
Limitations

  • Outbound SMS only. Inbound messages, delivery receipts and WhatsApp are not supported.
  • Trial Twilio accounts can only text verified numbers and prefix every message with a trial notice.
  • SMS carrier costs apply per segment; see the event list above for what triggers a message.