Connecting a Twilio Account

Where Twilio Lives

Twilio is a telephone provider account, not a generic
integration. Two sidebar paths reach it:

Integrations > Manage Integrations lists Twilio as an installable card. Clicking Install routes to /providers/twilio_accounts/connect_account.
Integrations > Telephone Accounts opens /provider_configurations, the canonical index for all telephone provider accounts.

Both paths lead to the same connection form where you
configure your Twilio credentials for the current company.

Required Credentials

A Twilio account requires two values:

Account SID: length 34, beginning with AC.
Auth Token: length 32.

The system validates the credentials by attempting a live
connection and confirming the returned account SID matches
the supplied value. Bad credentials are rejected at save
time.

Importing Numbers

After the account is connected, the wizard offers two
paths to bring numbers into TrackDrive:

Browse the provider's number list at /provider_configurations/:id/provider_numbers and import individually.
Import every number on the account at once via /provider_configurations/:id/import_all_numbers.

Imported numbers become available for assignment to offers,
ring pools, and tracking campaigns.

SMS Sending

Outbound SMS messages are sent through the connected Twilio
account. Unless the message is flagged as manual,
TrackDrive appends the opt-out message configured in your
text message settings.

10DLC and TCR Registration

US carriers require A2P 10DLC registration for non-toll-free
SMS traffic. TrackDrive models this as a TCR campaign
(belonging to a brand) with a use case (default MIXED) and
one to five sub-use cases (required for LOW_VOLUME and
MIXED use cases). Monthly auto-renewal charges are pulled
from the account's rate sheet.

The campaign registration process handles the upstream
workflow: TCR ID assignment, retries on assignment failure,
and SMS provisioning failure recovery. Numbers inherit
their campaign registry assignment from their ring pool
configuration.