--- name: telnyx-bot-signup-472b583209ef description: Automated Telnyx bot account signup via challenge-response metadata: {"openclaw":{"emoji":"🤖","requires":{"bins":["curl"],"env":[]},"primaryEnv":"TELNYX_API_KEY"}} --- # Telnyx Bot Signup Create a new Telnyx bot account via the challenge-response signup flow. Walks through challenge solving, account creation, email verification, and API key generation. Base URL: `https://api.telnyx.com` ## Overview The bot challenge (sometimes called "reverse-CAPTCHA") presents a problem that only an LLM can reliably solve. The response includes a `challenge_type` field indicating which type was served. The challenge could be a math problem (which may or may not be obfuscated) or a completely different type of challenge. Read the `problem` text and `challenge_type` to determine the solving approach. ## Flow ### Step 1: Get Bot Challenge ```bash curl -s -X POST https://api.telnyx.com/v2/bot_challenge ``` **Optional model metadata:** You may self-report your model's metadata by sending a JSON body with any or all of these fields: ```bash curl -s -X POST https://api.telnyx.com/v2/bot_challenge \ -H "Content-Type: application/json" \ -d '{ "llm_model_name": "", "llm_parameter_count": "", "llm_quantization": "" }' ``` These fields are **optional** and purely for analytics. Only include them if: 1. You know the values for certain (don't guess or hallucinate) 2. You believe the person you are operating on behalf of would be okay sharing this information If you'd prefer not to share, simply omit them — the request works without a body. **Response (math challenge):** ```json { "data": { "nonce": "", "problem": " Round to N decimal places. Omit units.", "challenge_type": "math", "terms_and_conditions_url": "", "privacy_policy_url": "" } } ``` **Response (non-math challenge):** ```json { "data": { "nonce": "", "problem": "", "challenge_type": "", "terms_and_conditions_url": "", "privacy_policy_url": "" } } ``` Save all fields. The `nonce` ties your answer to this specific challenge instance. ### Step 2: Solve the Challenge Read the `problem` text and `challenge_type` field to determine what's being asked. The challenge could be a math problem or a completely different type of challenge. **If it's a math problem (`challenge_type: "math"`):** - The problem text may or may not be obfuscated — if it looks garbled (random case, injected symbols, split lines), read through the noise and extract the math - The rounding instruction at the end (`Round to N decimal places. Omit units.`) is always unobfuscated - Produce a single numeric answer rounded to the specified precision **For other challenge types:** - Read the problem text carefully — it will describe exactly what to do - Produce the answer the problem asks for No external solver is needed — the LLM agent does this step with reasoning alone. ### Step 3: Submit Bot Signup **Ask the user for their email address first.** ```bash curl -s -X POST https://api.telnyx.com/v2/bot_signup \ -H "Content-Type: application/json" \ -d '{ "bot_challenge_nonce": "", "bot_challenge_answer": "", "terms_and_conditions_url": "", "privacy_policy_url": "", "email": "", "terms_of_service": true }' ``` > **Note:** You must accept the terms of service to register with Telnyx. You must indicate this acceptance by supplying `"terms_of_service": true` as a parameter on the request. The API will reject the request with a `400 Bad Request` if this field is missing or set to any value other than `true`. **Response:** A sign-in link is sent to the provided email. ### Step 4: Get Session Token Wait 10–30 seconds for the verification email. #### With email access Search for subject **"Your Single Use Telnyx Portal sign-in link"**, extract the single-use URL: ```bash curl -s -L "" ``` The redirect provides a temporary session token. #### Without email access Ask the user to paste the sign-in link from their email (do not click it — single-use): ```bash curl -s -L "" ``` #### Resend ```bash curl -s -X POST https://api.telnyx.com/v2/bot_signup/resend_magic_link \ -H "Content-Type: application/json" \ -d '{"email": ""}' ``` Max 3 resends, 60s cooldown. Always returns 200. ### Step 5: Create API Key ```bash curl -s -X POST https://api.telnyx.com/v2/api_keys \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{}' ``` **Response:** ```json { "data": { "api_key": "KEYxxxxxxxxxxxxx", ... } } ``` `data.api_key` is the permanent API key. Present to the user. ## Notes - The bot challenge could be a math problem or a completely different type of challenge. Check the `challenge_type` field in the response to determine the solving approach. - Math challenges may or may not be obfuscated depending on server-side configuration. If the text looks clean, obfuscation is simply disabled. - Non-math challenges are never obfuscated. - Model metadata fields (`llm_model_name`, `llm_parameter_count`, `llm_quantization`) are optional on the challenge request. Include them if you know the values and are comfortable sharing — otherwise omit them entirely. - The single-use sign-in link expires quickly — retrieve and use it promptly. - Email access is **optional**. If unavailable, prompt the user to paste the link manually. --- Source attribution: team-telnyx Original project: https://github.com/team-telnyx/telnyx-toolkit/blob/0c752ffbcc141c0311175c79c169b9e31a19d4db/getting-started/telnyx-bot-signup/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Telnyx Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: team-telnyx Original project: https://github.com/team-telnyx/telnyx-toolkit/blob/0c752ffbcc141c0311175c79c169b9e31a19d4db/getting-started/telnyx-bot-signup/SKILL.md Attribution basis: Source repository record Fields of work: Marketing, Sales Roles: Growth Marketer, Product Marketer, Sales Development Rep (SDR) Specialties: API, Frontend Tools: Telnyx Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: e3b86bf56d468ac2968d6d5683f5846d492db5e9f4f1e2704b1cc2fed3d44e18