Send SMS text and bulk messages via TelTel.io API

Send SMS text messages via TelTel (teltel.io) using the REST API (api.teltel.io). Includes bulk send, delivery report, and bulk sms.

Security Scan

The skill's files, instructions, and requested API key are consistent with a TelTel SMS sender; it only contacts the TelTel API and does not request unrelated credentials or install arbitrary code.

Purpose & Capability

Name/description, declared primaryEnv (TELTEL_API_KEY), SKILL.md, and the two bundled Node scripts all align: they implement single and bulk SMS sends against api.teltel.io and require an API key and optional sender/base URL. No unrelated services or credentials are requested.

Instruction Scope

SKILL.md explicitly instructs running the included Node scripts. The scripts only read TELTEL_API_KEY, TELTEL_SMS_FROM, TELTEL_BASE_URL and CLI args, and send POST requests to the TelTel endpoints. There are no instructions to read arbitrary local files, other env vars, or to transmit data to unexpected third-party endpoints. Callbacks are optionally allowed (expected for delivery reports).

Install Mechanism

There is no install spec (instruction-only with bundled scripts). No external downloads or package installs are performed by the skill itself, and the included source is plain, unobfuscated JavaScript.

Credentials

The skill's only required credential is TELTEL_API_KEY (declared as primary). Optional env vars (TELTEL_SMS_FROM, TELTEL_BASE_URL) are reasonable for this purpose. No unrelated secrets or multiple unrelated credentials are requested.

Persistence & Privilege

always is false and the skill does not request persistent system-wide privileges or modify other skills' configurations. It can be invoked by the agent (normal), but it does not elevate persistence or access beyond its scope.

Assessment

This skill appears to do exactly what it says: send SMS via TelTel. Before installing, verify you trust the skill owner and keep your TELTEL_API_KEY secret (it can send messages and incur charges). Use the --dry-run to preview payloads, test with a small controlled recipient list, and ensure any callback URL you provide is a trusted endpoint (TelTel will call it). Also confirm your runtime Node version supports global fetch or provide a compatible runtime; and monitor your TelTel account for unexpected usage/billing after enabling the skill.

Use the bundled Node scripts to send SMS via the TelTel API.

Before you use the skill (TelTel prerequisites)

1. Register at https://www.teltel.io/
2. Add funds / credit to your TelTel account
3. From the TelTel SMS section, send a test SMS first to confirm your sender name/phone is accepted/verified
4. In TelTel Settings, find your API key
5. Enjoy

Configure from the OpenClaw Skills panel

API key field (shown in the Skills UI)

This skill declares TELTEL_API_KEY as its primary env var, so the OpenClaw Skills UI can show an API key input for it.

Under the hood it maps to:

• skills.entries.teltel-send-sms-text-message.apiKey → TELTEL_API_KEY

Default sender

Set a default sender name/number (used when you do not pass --from):

• skills.entries.teltel-send-sms-text-message.env.TELTEL_SMS_FROM

Configure via environment variables (alternative)

• TELTEL_API_KEY (required)
• TELTEL_SMS_FROM (optional) — default sender name/number
• TELTEL_BASE_URL (optional) — defaults to https://api.teltel.io/v2

Send a single SMS

node {baseDir}/scripts/send_sms.js \
  --to "+3712xxxxxxx" \
  --message "Hello from TelTel" \
  --from "37167881855"

If you omit --from, the script uses TELTEL_SMS_FROM.

Dry-run (prints URL + payload, does not send):

node {baseDir}/scripts/send_sms.js \
  --dry-run \
  --to "[phone]" \
  --message "test" \
  --from "37167881855"

Send bulk SMS

node {baseDir}/scripts/send_sms_bulk.js \
  --from "37167881855" \
  --to "+3712...,+1..." \
  --message "Hello everyone"

The --to list can be comma/newline/semicolon separated.

API details (for reference)

• Base URL: https://api.teltel.io/v2
• Single SMS: POST /sms/text
  • JSON body: { "data": { "from": "...", "to": "+...", "message": "...", "callback": "https://..."? } }
• Bulk SMS: POST /sms/bulk/text
  • JSON body: { "data": { "from": "...", "to": ["+...", "+..."], "message": "...", "callback": "https://..."? } }

Notes:

• to must be in international format.