CommSyncdocs
Open app
Phone providers

Skyetel

Connect a Skyetel API key, add your numbers, and point each number at CommSync in the Skyetel portal.


Skyetel

Add your Skyetel credentials, register your numbers, and point the inbound webhook.

Skyetel is a carrier you buy numbers from directly. You connect it with an API key, you add each number by hand, and you point each number at CommSync in the Skyetel portal.

Phone providers explains what every connection does. This page adds what Skyetel does differently.

Before you start

  • A login to the Skyetel portal that can create API keys.

Good to know

  • CommSync makes the API token from the SID and the Secret. It encrypts the Secret at rest (AES-256-GCM) and uses it only to send your texts.
  • Each workspace connects its own Skyetel account.
  • Skyetel cannot tell CommSync where to send new texts. After you add your numbers, you paste one webhook address on each number in Skyetel.

Connect Skyetel

Open Settings → Phone numbers and pick Skyetel.

Use a Skyetel API key

Log in to the Skyetel portal

Open in Skyetel

Open Settings

Click the gear icon in the top-right corner.

Create an API key

Open the API Keys tab and click Create. Give the key a name, for example CommSync.

Copy the SID and the Secret

They show in the confirmation dialog. Skyetel shows the Secret only once, so save it before you close the dialog.

Keep the key name ready

On the next page, use the key name as the label. Then you can find the credential later, when you assign it to a number.

Connect the account

Click I have my SID and Secret. Enter a label, the SID, and the Secret, then click Connect. CommSync encrypts the Secret at rest and uses it only to send your texts. Each workspace connects its own Skyetel account.

Finish in CommSync

Add your numbers

Add each Skyetel number and an optional label. Add as many as you need. You can add more later with Add numbers in the account menu.

Paste the webhook address in Skyetel

The Webhook step shows the one address to paste, with a Copy button, and the six portal steps below. For each number, set the call routing to your API key, and set the SMS callback to the CommSync address. Inbound texts do not arrive until you do this. The address also stays on each Skyetel account card.

  1. Open your Skyetel local numbers Open in Skyetel
  2. Open the number. Click the gear icon on the row of the number that you use with CommSync. The Edit Phone Number dialog opens.
  3. Set the call routing. On the General tab, set Call Routing to SIP Credential. Then choose the SIP credential that has the name of the API key you made for CommSync.
  4. Forward texts to a callback address. Open the SMS & MMS tab. Set Forward to Callback URL.
  5. Paste the CommSync address. Paste the webhook address into the URL field. Set Method to POST. Set Delivery Confirmations to Enabled, so the sent and failed reports reach CommSync.
  6. Save. Click Save. Do these steps again for each Skyetel number that you added.

History starts when you connect

Skyetel shares no past texts, so your conversations start at the moment you connect.

How the webhook works

Skyetel delivers inbound SMS, delivery confirmations, and failure events to a single webhook URL. CommSync handles all three event types at the same endpoint.

Webhook URL:

https://your-domain.com/api/webhooks/skyetel

CommSync uses the tag field Skyetel includes on every message as a deduplication key. If Skyetel retries a delivery, CommSync recognises the duplicate and skips it safely.

Local development

Use ngrok to expose your local server (port 4001) for tests: run ngrok http 4001. ngrok prints an HTTPS URL. Paste that URL into the Skyetel portal — for example, https://abc123.ngrok-free.app/api/webhooks/skyetel. Free ngrok URLs reset on every restart, so update the portal URL each time.

No shared-secret validation

The Skyetel webhook endpoint does not validate a signing secret. Restrict access at the network level: use an IP allowlist for Skyetel’s egress ranges (check Skyetel’s documentation for the current list). Also make sure the endpoint is only reachable over HTTPS in production.

What syncs

  • CallsNo calls
  • VoicemailNo voicemail
  • PicturesPictures, up to 10
  • Group textsNo group replies
  • Delivery receiptsNo delivery receipts
  • History importHistory starts at connect

Limits

  • Pictures you send: up to 10 per text, 1.5 MB in total.

  • Group replies: none. A group conversation says “Reply to this group in Skyetel.” in place of the reply box.

  • Access is per number. An owner or admin gives a member each Skyetel number on its own, from the Access control on the row of the number.

When something needs your attention

The account card in Settings → Phone numbers shows the state of the account, and each error names the one thing to do.

What you seeWhat it meansWhat to do
Reconnect neededSkyetel no longer accepts the saved SID and Secret.Open the account menu on the Skyetel page (the button, or a right-click on the card), and pick Change the credentials.
No inbound texts on a numberThe number does not point at the CommSync webhook address yet.Do the six portal steps under Connect Skyetel for that number.