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 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.
- Open your Skyetel local numbers Open in Skyetel
- Open the number. Click the gear icon on the row of the number that you use with CommSync. The
Edit Phone Numberdialog opens. - Set the call routing. On the
Generaltab, setCall RoutingtoSIP Credential. Then choose the SIP credential that has the name of the API key you made for CommSync. - Forward texts to a callback address. Open the
SMS & MMStab. SetForwardtoCallback URL. - Paste the CommSync address. Paste the webhook address into the
URLfield. SetMethodtoPOST. SetDelivery ConfirmationstoEnabled, so the sent and failed reports reach CommSync. - 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/skyetelCommSync 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 see | What it means | What to do |
|---|---|---|
| Reconnect needed | Skyetel 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 number | The number does not point at the CommSync webhook address yet. | Do the six portal steps under Connect Skyetel for that number. |