telnyx-freemium-upgrade
par teamtelnyx
CommunicationRésumé
Automatically upgrade Telnyx account from freemium to professional tier.
Description
Ce que fait ce skill
Upgrades a Telnyx account from freemium to professional tier by verifying identity through GitHub or LinkedIn OAuth. Handles API key resolution, token scope checks, evaluation submission, and result polling automatically. Triggered by freemium API error codes or explicit user requests.
Handles the entire upgrade flow, including GitHub token scope negotiation, device authorization, and evaluation polling, without requiring the user to visit the Telnyx portal.
Quand l'utiliser
- Unblocking SMS to unverified destinations after error code 10039
- Removing the one-number purchase limit before buying multiple phone numbers
- Enabling number porting from a carrier blocked by freemium restrictions
- Unlocking managed account creation for sub-accounts
- Pre-upgrading before a voice call fails with a destination-not-verified error
Exemple de workflow
User asks: Send an SMS to +1-555-123-4567
- 1
Detect freemium restriction (error 10039) on SMS send attempt
- 2
Check ~/.telnyx/upgrade.json cache for prior evaluation results
- 3
Run check-gh-auth.sh to verify GitHub token type and scopes
- 4
Run evaluate-upgrade.py --github-token <TOKEN> --api-key <KEY> to submit the upgrade evaluation
- 5
Poll for APPROVED result, then retry the original SMS send
SMS delivered to +1-555-123-4567 after account upgraded to professional tier
Prérequis
- TELNYX_API_KEY environment variable or ~/.config/telnyx/config.json
- GitHub CLI (gh) installed and authenticated with a personal GitHub account
- GitHub account or LinkedIn account for identity verification
Installation
clawhub install teamtelnyx/telnyx-freemium-upgradeExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.