Provisioning Phone Numbers

Messaging via Telgorithm requires either a 10DLC phone number attached to an approved campaign or a verified Toll Free number. You can migrate existing numbers to the Telgorithm platform or purchase new ones through us.

10DLC Numbers

Port-in an existing number

Initiate the Port request via API

Port-in requests can be initiated via this endpoint. This allows you to migrate existing numbers to Telgorithm. A phone number can be ported over for SMS/MMS (Messaging-only), calling (Voice-only), or both (Full Port). When a port request is submitted, service will stay active with the previous provider up until the point that party releases the number. As the number goes through the porting process, you can be notified via webhook and listen for events relating to the number status. The requirements for a port request are:

1. A "Letter of Authorization" (LOA) that attests to your right to transfer service for the number

2. A valid Messaging Config in Telgorithm must be specified as the destination for the migrated number

3. (If migrating voice) Authorization details, including current account holder information and port out PIN

Once your port request has been submitted, you can view the number status via the My Numbers section of the Telgorithm dashboard. Depending on the losing provider's policy, a port can take up to 78 hours to complete. When a number's status is "Active", it is available for messaging.

Attach number to a 10DLC campaign
By default a ported number must be assigned to a Messaging Config, which is tied to a TCR Campaign. A number assigned to a Messaging Config can also be de-associated and subsequently associated with a new one. By doing this it is possible to change the campaign that a number is assigned to. Numbers in the process of being provisioned to a Campaign will show the status PendingTcrCampaignAdd. Typically these attachments will only take a few minutes to complete.

Purchase a new number

To purchase a net new number via Telgorithm, you can make use of the Purchase Numbers interface in the dashboard. When purchasing a new number, you can assign it to an existing Messaging Config and optionally give it a name. If the Campaign tied to the Messaging Configuration is approved, the number will be available to start messaging within minutes.

Toll Free Numbers

Toll Free numbers can be ported-in or purchased via the above steps. Toll Free verification is required for each number, as otherwise outbound traffic will fail. Verification is completed manually by a downstream Toll Free authority, so you will need to submit a VSR Document for any Toll Free number you wish to use. Once filled out, email this document to support@telgorithm.com so we can submit the verification request. Once submitted, Toll Free verifications usually take 3 business days.

Need help?

Email support@telgorithm.com with any questions, or check the full API documentation at any time.