Skip to content

team-telnyx/ai / providers/claude/plugins/telnyx-platform/skills/telnyx-twilio-migration

telnyx-twilio-migration

Unverified

Migrate from Twilio to Telnyx. Orchestrates a complete 6-phase migration: discovery, planning, setup, code migration, validation, and cleanup. Covers voice (TwiML to TeXML, Call Control API), messaging, WebRTC, SIP trunking, verify, fax, video, IoT, number lookup, and porting. Includes automated scanners, validation scripts, and integration tests.

FileKindSize
SKILL.mdskill md43.3 KB
references/account-setup-guide.mdmarkdown17.8 KB
references/error-code-mapping.mdmarkdown11.0 KB
references/fax-migration.mdmarkdown14.7 KB
references/iot-migration.mdmarkdown17.9 KB
references/lookup-migration.mdmarkdown14.3 KB
references/messaging-migration.mdmarkdown36.5 KB
references/mobile-sdk-migration.mdmarkdown38.6 KB
references/number-porting.mdmarkdown17.0 KB
references/numbers-migration.mdmarkdown21.1 KB
references/product-mapping.mdmarkdown6.7 KB
references/sdk-api-details/10dlc.mdmarkdown9.8 KB
references/sdk-api-details/ai-assistants.mdmarkdown5.8 KB
references/sdk-api-details/messaging.mdmarkdown16.1 KB
references/sdk-api-details/numbers.mdmarkdown10.1 KB
references/sdk-api-details/voice.mdmarkdown9.6 KB
references/sip-trunking-migration.mdmarkdown18.1 KB
references/texml-verbs.mdmarkdown43.7 KB
references/unsupported-products.mdmarkdown3.5 KB
references/verify-migration.mdmarkdown18.4 KB
references/video-migration.mdmarkdown20.6 KB
references/voice-migration.mdmarkdown37.2 KB
references/webhook-migration.mdmarkdown20.3 KB
references/webrtc-migration.mdmarkdown50.0 KB
scripts/lint-telnyx-correctness.shexecutablescript31.4 KB
scripts/migration-state.shexecutablescript7.3 KB
scripts/post-test-diagnostic.shexecutablescript18.9 KB
scripts/preflight-check.shexecutablescript13.4 KB
scripts/run-discovery.shexecutablescript7.7 KB
scripts/run-validation.shexecutablescript13.1 KB
scripts/scan-twilio-deep.pyexecutablescript64.8 KB
scripts/scan-twilio-usage.shexecutablescript29.1 KB
scripts/test-migration/smoke-test.shexecutablescript10.0 KB
scripts/test-migration/test-fax.shexecutablescript8.7 KB
scripts/test-migration/test-lookup.shexecutablescript5.5 KB
scripts/test-migration/test-messaging.shexecutablescript18.8 KB
scripts/test-migration/test-sip.shexecutablescript29.6 KB
scripts/test-migration/test-verify.shexecutablescript13.6 KB
scripts/test-migration/test-voice.shexecutablescript22.4 KB
scripts/test-migration/test-webhooks-local.pyexecutablescript9.7 KB
scripts/test-migration/test-webrtc.shexecutablescript24.0 KB
scripts/test-migration/webhook-receiver.pyexecutablescript11.8 KB
scripts/validate-migration.shexecutablescript31.1 KB
scripts/validate-texml.shexecutablescript61.4 KB
sdk-reference/curl/10dlc.mdmarkdown25.8 KB
sdk-reference/curl/account-access.mdmarkdown15.6 KB
sdk-reference/curl/account-management.mdmarkdown9.5 KB
sdk-reference/curl/account-notifications.mdmarkdown11.0 KB
sdk-reference/curl/account-reports.mdmarkdown45.5 KB
sdk-reference/curl/account.mdmarkdown8.1 KB
sdk-reference/curl/ai-assistants.mdmarkdown34.3 KB
sdk-reference/curl/ai-inference.mdmarkdown34.5 KB
sdk-reference/curl/fax.mdmarkdown19.8 KB
sdk-reference/curl/iot.mdmarkdown49.4 KB
sdk-reference/curl/messaging-hosted.mdmarkdown23.3 KB
sdk-reference/curl/messaging-profiles.mdmarkdown14.2 KB
sdk-reference/curl/messaging.mdmarkdown29.1 KB
sdk-reference/curl/missions.mdmarkdown23.5 KB
sdk-reference/curl/networking.mdmarkdown39.8 KB
sdk-reference/curl/numbers-compliance.mdmarkdown30.2 KB
sdk-reference/curl/numbers-config.mdmarkdown29.7 KB
sdk-reference/curl/numbers-services.mdmarkdown12.6 KB
sdk-reference/curl/numbers.mdmarkdown24.0 KB
sdk-reference/curl/oauth.mdmarkdown15.6 KB
sdk-reference/curl/porting-in.mdmarkdown35.1 KB
sdk-reference/curl/porting-out.mdmarkdown9.8 KB
sdk-reference/curl/sip-integrations.mdmarkdown27.5 KB
sdk-reference/curl/sip.mdmarkdown47.6 KB
sdk-reference/curl/storage.mdmarkdown4.2 KB
sdk-reference/curl/texml.mdmarkdown31.4 KB
sdk-reference/curl/verify.mdmarkdown13.2 KB
sdk-reference/curl/video.mdmarkdown17.2 KB
sdk-reference/curl/voice-advanced.mdmarkdown32.8 KB
sdk-reference/curl/voice-conferencing.mdmarkdown41.6 KB
sdk-reference/curl/voice-gather.mdmarkdown14.7 KB
sdk-reference/curl/voice-media.mdmarkdown17.8 KB
sdk-reference/curl/voice-streaming.mdmarkdown13.3 KB
sdk-reference/curl/voice.mdmarkdown37.6 KB
sdk-reference/curl/webrtc.mdmarkdown6.5 KB
sdk-reference/go/10dlc.mdmarkdown29.0 KB
sdk-reference/go/account-access.mdmarkdown17.0 KB
sdk-reference/go/account-management.mdmarkdown9.9 KB
sdk-reference/go/account-notifications.mdmarkdown12.4 KB
sdk-reference/go/account-reports.mdmarkdown31.5 KB
sdk-reference/go/account.mdmarkdown9.1 KB
sdk-reference/go/ai-assistants.mdmarkdown37.7 KB
sdk-reference/go/ai-inference.mdmarkdown27.1 KB
sdk-reference/go/fax.mdmarkdown20.2 KB
sdk-reference/go/iot.mdmarkdown51.3 KB
sdk-reference/go/messaging-hosted.mdmarkdown24.5 KB
sdk-reference/go/messaging-profiles.mdmarkdown15.2 KB
sdk-reference/go/messaging.mdmarkdown30.1 KB
sdk-reference/go/missions.mdmarkdown26.9 KB
sdk-reference/go/networking.mdmarkdown42.5 KB
sdk-reference/go/numbers-compliance.mdmarkdown28.2 KB
sdk-reference/go/numbers-config.mdmarkdown29.5 KB
sdk-reference/go/numbers-services.mdmarkdown14.1 KB
sdk-reference/go/numbers.mdmarkdown26.7 KB
sdk-reference/go/oauth.mdmarkdown11.7 KB
sdk-reference/go/porting-in.mdmarkdown41.1 KB
sdk-reference/go/porting-out.mdmarkdown10.9 KB
sdk-reference/go/sip-integrations.mdmarkdown32.3 KB
sdk-reference/go/sip.mdmarkdown49.1 KB
sdk-reference/go/storage.mdmarkdown4.8 KB
sdk-reference/go/texml.mdmarkdown35.7 KB
sdk-reference/go/verify.mdmarkdown14.4 KB
sdk-reference/go/video.mdmarkdown18.6 KB
sdk-reference/go/voice-advanced.mdmarkdown33.2 KB
sdk-reference/go/voice-conferencing.mdmarkdown42.3 KB
sdk-reference/go/voice-gather.mdmarkdown14.5 KB
sdk-reference/go/voice-media.mdmarkdown18.1 KB
sdk-reference/go/voice-streaming.mdmarkdown13.5 KB
sdk-reference/go/voice.mdmarkdown39.2 KB
sdk-reference/go/webrtc.mdmarkdown7.5 KB
sdk-reference/java/10dlc.mdmarkdown31.3 KB
sdk-reference/java/account-access.mdmarkdown18.5 KB
sdk-reference/java/account-management.mdmarkdown11.1 KB
sdk-reference/java/account-notifications.mdmarkdown14.3 KB
sdk-reference/java/account-reports.mdmarkdown36.5 KB
sdk-reference/java/account.mdmarkdown10.3 KB
sdk-reference/java/ai-assistants.mdmarkdown39.2 KB
sdk-reference/java/ai-inference.mdmarkdown30.7 KB
sdk-reference/java/fax.mdmarkdown21.5 KB
sdk-reference/java/iot.mdmarkdown57.5 KB
sdk-reference/java/messaging-hosted.mdmarkdown28.4 KB
sdk-reference/java/messaging-profiles.mdmarkdown15.7 KB
sdk-reference/java/messaging.mdmarkdown32.2 KB
sdk-reference/java/missions.mdmarkdown31.6 KB
sdk-reference/java/networking.mdmarkdown47.1 KB
sdk-reference/java/numbers-compliance.mdmarkdown31.1 KB
sdk-reference/java/numbers-config.mdmarkdown32.2 KB
sdk-reference/java/numbers-services.mdmarkdown15.9 KB
sdk-reference/java/numbers.mdmarkdown28.4 KB
sdk-reference/java/oauth.mdmarkdown13.0 KB
sdk-reference/java/porting-in.mdmarkdown46.2 KB
sdk-reference/java/porting-out.mdmarkdown11.9 KB
sdk-reference/java/sip-integrations.mdmarkdown38.1 KB
sdk-reference/java/sip.mdmarkdown51.9 KB
sdk-reference/java/storage.mdmarkdown5.7 KB
sdk-reference/java/texml.mdmarkdown41.3 KB
sdk-reference/java/verify.mdmarkdown16.0 KB
sdk-reference/java/video.mdmarkdown20.3 KB
sdk-reference/java/voice-advanced.mdmarkdown35.0 KB
sdk-reference/java/voice-conferencing.mdmarkdown46.0 KB
sdk-reference/java/voice-gather.mdmarkdown16.1 KB
sdk-reference/java/voice-media.mdmarkdown19.5 KB
sdk-reference/java/voice-streaming.mdmarkdown14.7 KB
sdk-reference/java/voice.mdmarkdown40.8 KB
sdk-reference/java/webrtc.mdmarkdown8.5 KB
sdk-reference/javascript/10dlc.mdmarkdown28.5 KB
sdk-reference/javascript/account-access.mdmarkdown15.9 KB
sdk-reference/javascript/account-management.mdmarkdown9.6 KB
sdk-reference/javascript/account-notifications.mdmarkdown11.7 KB
sdk-reference/javascript/account-reports.mdmarkdown29.3 KB
sdk-reference/javascript/account.mdmarkdown8.7 KB
sdk-reference/javascript/ai-assistants.mdmarkdown37.5 KB
sdk-reference/javascript/ai-inference.mdmarkdown24.4 KB
sdk-reference/javascript/fax.mdmarkdown19.9 KB
sdk-reference/javascript/iot.mdmarkdown47.4 KB
sdk-reference/javascript/messaging-hosted.mdmarkdown22.4 KB
sdk-reference/javascript/messaging-profiles.mdmarkdown14.8 KB
sdk-reference/javascript/messaging.mdmarkdown29.7 KB
sdk-reference/javascript/missions.mdmarkdown23.8 KB
sdk-reference/javascript/networking.mdmarkdown39.3 KB
sdk-reference/javascript/numbers-compliance.mdmarkdown25.9 KB
sdk-reference/javascript/numbers-config.mdmarkdown28.3 KB
sdk-reference/javascript/numbers-services.mdmarkdown13.0 KB
sdk-reference/javascript/numbers.mdmarkdown26.1 KB
sdk-reference/javascript/oauth.mdmarkdown10.8 KB
sdk-reference/javascript/porting-in.mdmarkdown37.4 KB
sdk-reference/javascript/porting-out.mdmarkdown10.2 KB
sdk-reference/javascript/sip-integrations.mdmarkdown28.5 KB
sdk-reference/javascript/sip.mdmarkdown47.4 KB
sdk-reference/javascript/storage.mdmarkdown4.5 KB
sdk-reference/javascript/texml.mdmarkdown31.9 KB
sdk-reference/javascript/verify.mdmarkdown13.3 KB
sdk-reference/javascript/video.mdmarkdown17.2 KB
sdk-reference/javascript/voice-advanced.mdmarkdown32.6 KB
sdk-reference/javascript/voice-conferencing.mdmarkdown40.4 KB
sdk-reference/javascript/voice-gather.mdmarkdown14.3 KB
sdk-reference/javascript/voice-media.mdmarkdown17.8 KB
sdk-reference/javascript/voice-streaming.mdmarkdown13.4 KB
sdk-reference/javascript/voice.mdmarkdown39.4 KB
sdk-reference/javascript/webrtc.mdmarkdown7.2 KB
sdk-reference/python/10dlc.mdmarkdown28.5 KB
sdk-reference/python/account-access.mdmarkdown15.0 KB
sdk-reference/python/account-management.mdmarkdown9.1 KB
sdk-reference/python/account-notifications.mdmarkdown10.9 KB
sdk-reference/python/account-reports.mdmarkdown28.1 KB
sdk-reference/python/account.mdmarkdown8.1 KB
sdk-reference/python/ai-assistants.mdmarkdown37.3 KB
sdk-reference/python/ai-inference.mdmarkdown23.4 KB
sdk-reference/python/fax.mdmarkdown19.5 KB
sdk-reference/python/iot.mdmarkdown45.3 KB
sdk-reference/python/messaging-hosted.mdmarkdown21.7 KB
sdk-reference/python/messaging-profiles.mdmarkdown14.1 KB
sdk-reference/python/messaging.mdmarkdown29.4 KB
sdk-reference/python/missions.mdmarkdown23.2 KB
sdk-reference/python/networking.mdmarkdown37.1 KB
sdk-reference/python/numbers-compliance.mdmarkdown24.6 KB

scripts/test-migration/test-verify.sh

View on GitHub
#!/usr/bin/env bash
#
# test-verify.sh — Send and verify a real OTP via Telnyx Verify API
#
# Usage: bash test-verify.sh --confirm [--dry-run]
#
# Arguments:
#   --confirm    Required to actually send the OTP
#   --dry-run    Validate setup without sending
#   --help       Show this help and exit
#
# Environment variables (required):
#   TELNYX_API_KEY             Your Telnyx API key
#   TELNYX_TO_NUMBER           Destination number (E.164 format) — agent should ask user
#
# Environment variables (optional — auto-detected/created if not set):
#   TELNYX_VERIFY_PROFILE_ID   Verify profile ID (auto-detected/created if not set)
#
# Exit codes:
#   0 — Verification completed successfully
#   1 — Verification failed or setup error

set -euo pipefail

# --- Colors (disabled if not a terminal) ---
if [ -t 1 ]; then
  RED='\033[0;31m'
  YELLOW='\033[0;33m'
  GREEN='\033[0;32m'
  BLUE='\033[0;34m'
  BOLD='\033[1m'
  NC='\033[0m'
else
  RED='' YELLOW='' GREEN='' BLUE='' BOLD='' NC=''
fi

# --- Parse arguments ---
CONFIRMED=false
DRY_RUN=false
SEND_ONLY=false

for arg in "$@"; do
  case "$arg" in
    --confirm) CONFIRMED=true ;;
    --dry-run) DRY_RUN=true ;;
    --send-only) SEND_ONLY=true ;;
    --help|-h)
      echo "Usage: bash test-verify.sh --confirm [--dry-run]"
      echo ""
      echo "Sends a real OTP via Telnyx Verify API and prompts for verification."
      echo ""
      echo "Flags:"
      echo "  --confirm    Required to actually send the OTP"
      echo "  --dry-run    Validate setup without sending"
      echo "  --send-only  Send OTP but skip interactive code entry (for automated testing)"
      echo ""
      echo "Environment variables:"
      echo "  TELNYX_API_KEY             (required) Your Telnyx API key"
      echo "  TELNYX_TO_NUMBER           (required) Destination number, E.164 format"
      echo "  TELNYX_VERIFY_PROFILE_ID   (optional) Verify profile ID (auto-detected/created if not set)"
      exit 0
      ;;
    *)
      echo "Unknown argument: $arg" >&2
      echo "Run with --help for usage." >&2
      exit 2
      ;;
  esac
done

echo -e "${BOLD}Telnyx Verify Test${NC}"
echo "==================="
echo ""
echo -e "${YELLOW}${BOLD}COST WARNING: This test sends a real OTP (~\$0.05)${NC}"
echo ""

# --- Validate prerequisites ---
ERRORS=0

if [ -z "${TELNYX_API_KEY:-}" ]; then
  echo -e "  ${RED}FAIL${NC}  TELNYX_API_KEY is not set"
  ERRORS=$((ERRORS + 1))
else
  echo -e "  ${GREEN}PASS${NC}  TELNYX_API_KEY is set (${TELNYX_API_KEY:0:8}...)"
fi

if [ -z "${TELNYX_VERIFY_PROFILE_ID:-}" ]; then
  echo -e "  ${BLUE}INFO${NC}  TELNYX_VERIFY_PROFILE_ID not set — will auto-detect or create"
else
  echo -e "  ${GREEN}PASS${NC}  TELNYX_VERIFY_PROFILE_ID: ${TELNYX_VERIFY_PROFILE_ID}"
fi

if [ -z "${TELNYX_TO_NUMBER:-}" ]; then
  echo -e "  ${RED}FAIL${NC}  TELNYX_TO_NUMBER is not set"
  echo -e "         The agent should ask the user for their phone number to receive the OTP."
  ERRORS=$((ERRORS + 1))
else
  echo -e "  ${GREEN}PASS${NC}  TELNYX_TO_NUMBER: ${TELNYX_TO_NUMBER}"
fi

if ! command -v curl &>/dev/null; then
  echo -e "  ${RED}FAIL${NC}  curl is not installed"
  ERRORS=$((ERRORS + 1))
fi

HAS_JQ=false
if command -v jq &>/dev/null; then
  HAS_JQ=true
  echo -e "  ${GREEN}PASS${NC}  jq is available"
else
  echo -e "  ${YELLOW}WARN${NC}  jq not installed — required for auto-setup. Install with: brew install jq / apt install jq"
  ERRORS=$((ERRORS + 1))
fi

# Check stdin is a terminal (needed for code input)
if [ ! -t 0 ]; then
  echo -e "  ${YELLOW}WARN${NC}  stdin is not a terminal — code entry may not work"
fi

if [ "$ERRORS" -gt 0 ]; then
  echo ""
  echo -e "${RED}${BOLD}Setup validation failed. Fix the errors above.${NC}"
  exit 1
fi

# --- Validate API key ---
echo ""
echo -e "${BOLD}Validating API key...${NC}"

HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
  -H "Authorization: Bearer ${TELNYX_API_KEY}" \
  "https://api.telnyx.com/v2/balance" 2>/dev/null || echo "000")

if [ "$HTTP_CODE" != "200" ]; then
  echo -e "  ${RED}FAIL${NC}  API key validation failed (HTTP $HTTP_CODE)"
  exit 1
fi
echo -e "  ${GREEN}PASS${NC}  API key is valid"

# --- Auto-detect or create verify profile ---
VERIFY_PROFILE_ID="${TELNYX_VERIFY_PROFILE_ID:-}"
if [ -z "$VERIFY_PROFILE_ID" ]; then
  echo ""
  echo -e "${BOLD}Auto-detecting verify profile...${NC}"

  HAS_JQ_EARLY=false
  if command -v jq &>/dev/null; then
    HAS_JQ_EARLY=true
  fi

  # Try to find an existing verify profile
  # Note: GET /v2/verify_profiles may return 10009 when no profiles exist (API quirk)
  VP_RESPONSE=$(curl -s -g \
    -H "Authorization: Bearer ${TELNYX_API_KEY}" \
    "https://api.telnyx.com/v2/verify_profiles" 2>/dev/null || echo "")
  if [ "$HAS_JQ_EARLY" = true ] && [ -n "$VP_RESPONSE" ]; then
    VP_ERROR_CODE=$(echo "$VP_RESPONSE" | jq -r '.errors[0].code // empty' 2>/dev/null)
    if [ "$VP_ERROR_CODE" != "10009" ]; then
      VERIFY_PROFILE_ID=$(echo "$VP_RESPONSE" | jq -r '.data[0].id // empty' 2>/dev/null)
    fi
  fi

  if [ -n "$VERIFY_PROFILE_ID" ]; then
    echo -e "  ${GREEN}PASS${NC}  Using existing verify profile: ${VERIFY_PROFILE_ID}"

    # Verify the existing profile's SMS whitelisted_destinations include the destination country (or "*")
    TO_COUNTRY="US"
    if [[ "${TELNYX_TO_NUMBER}" == +353* ]]; then TO_COUNTRY="IE"
    elif [[ "${TELNYX_TO_NUMBER}" == +44* ]]; then TO_COUNTRY="GB"
    elif [[ "${TELNYX_TO_NUMBER}" == +1* ]]; then TO_COUNTRY="US"
    elif [[ "${TELNYX_TO_NUMBER}" == +61* ]]; then TO_COUNTRY="AU"
    elif [[ "${TELNYX_TO_NUMBER}" == +49* ]]; then TO_COUNTRY="DE"
    elif [[ "${TELNYX_TO_NUMBER}" == +33* ]]; then TO_COUNTRY="FR"
    fi

    VP_DETAILS=$(curl -s -g \
      -H "Authorization: Bearer ${TELNYX_API_KEY}" \
      "https://api.telnyx.com/v2/verify_profiles/${VERIFY_PROFILE_ID}" 2>/dev/null || echo "")
    VP_WL_MATCH=$(echo "$VP_DETAILS" | jq -r ".data.sms.whitelisted_destinations // [] | map(select(. == \"${TO_COUNTRY}\" or . == \"*\")) | length" 2>/dev/null)
    if [ "${VP_WL_MATCH:-0}" = "0" ]; then
      echo -e "  ${BLUE}INFO${NC}  Profile SMS doesn't whitelist ${TO_COUNTRY} — updating..."
      CURRENT_VP_WL=$(echo "$VP_DETAILS" | jq -r '.data.sms.whitelisted_destinations // []' 2>/dev/null)
      UPDATED_VP_WL=$(echo "$CURRENT_VP_WL" | jq --arg c "$TO_COUNTRY" '. + [$c] | unique' 2>/dev/null)
      VP_UPDATE=$(curl -s -g -X PATCH \
        -H "Authorization: Bearer ${TELNYX_API_KEY}" \
        -H "Content-Type: application/json" \
        -d "{\"sms\": {\"whitelisted_destinations\": ${UPDATED_VP_WL}}}" \
        "https://api.telnyx.com/v2/verify_profiles/${VERIFY_PROFILE_ID}" 2>/dev/null || echo "")
      VP_UPDATE_ERR=$(echo "$VP_UPDATE" | jq -r '.errors[0].detail // empty' 2>/dev/null)
      if [ -n "$VP_UPDATE_ERR" ]; then
        echo -e "  ${YELLOW}WARN${NC}  Could not update verify profile whitelist: $VP_UPDATE_ERR"
      else
        echo -e "  ${GREEN}PASS${NC}  Added ${TO_COUNTRY} to verify profile SMS whitelist"
      fi
    else
      echo -e "  ${GREEN}PASS${NC}  Profile SMS whitelists ${TO_COUNTRY}"
    fi
  else
    # Auto-create a verify profile with SMS channel + whitelisted destinations
    echo -e "  ${BLUE}INFO${NC}  No verify profile found — creating one..."
    VP_CREATE_RESPONSE=$(curl -s -g -X POST \
      -H "Authorization: Bearer ${TELNYX_API_KEY}" \
      -H "Content-Type: application/json" \
      -d "{
        \"name\": \"Migration Test Verify $(date +%s)\",
        \"default_timeout_secs\": 300,
        \"sms\": {
          \"messaging_enabled\": true,
          \"whitelisted_destinations\": [\"*\"]
        }
      }" \
      "https://api.telnyx.com/v2/verify_profiles" 2>/dev/null || echo "")
    if [ "$HAS_JQ_EARLY" = true ] && [ -n "$VP_CREATE_RESPONSE" ]; then
      VERIFY_PROFILE_ID=$(echo "$VP_CREATE_RESPONSE" | jq -r '.data.id // empty' 2>/dev/null)
      VP_CREATE_ERROR=$(echo "$VP_CREATE_RESPONSE" | jq -r '.errors[0].detail // empty' 2>/dev/null)
      if [ -n "$VP_CREATE_ERROR" ]; then
        echo -e "  ${RED}FAIL${NC}  Could not create verify profile: $VP_CREATE_ERROR"
        exit 1
      fi
    fi
    if [ -n "$VERIFY_PROFILE_ID" ]; then
      echo -e "  ${GREEN}PASS${NC}  Created verify profile: ${VERIFY_PROFILE_ID}"
    else
      echo -e "  ${RED}FAIL${NC}  Could not create verify profile"
      echo -e "         Create one manually at: https://portal.telnyx.com/#/app/verify/profiles"
      exit 1
    fi
  fi
  # Export for use in the rest of the script
  TELNYX_VERIFY_PROFILE_ID="$VERIFY_PROFILE_ID"
fi

# --- Dry run exits here ---
if [ "$DRY_RUN" = true ]; then
  echo ""
  echo -e "${BOLD}Dry run complete.${NC} Setup looks good."
  echo "  Would send OTP to: ${TELNYX_TO_NUMBER}"
  echo "  Verify profile: ${TELNYX_VERIFY_PROFILE_ID}"
  echo "  Estimated cost: ~\$0.05"
  echo ""
  echo "Run with --confirm to send the OTP."
  exit 0
fi

# --- Require --confirm ---
if [ "$CONFIRMED" = false ]; then
  echo ""
  echo -e "${BOLD}What this test will do:${NC}"
  echo "  1. Send a verification code to ${TELNYX_TO_NUMBER} via SMS"
  echo "  2. Prompt you to enter the code you receive"
  echo "  3. Verify the code via the Telnyx API"
  echo "  4. Report verification status"
  echo ""
  echo "  Estimated cost: ~\$0.05"
  echo ""
  echo "Run with --confirm to proceed."
  exit 0
fi

# --- Send verification ---
echo ""
echo -e "${BOLD}Sending verification code...${NC}"
echo "  To: ${TELNYX_TO_NUMBER}"
echo "  Profile: ${TELNYX_VERIFY_PROFILE_ID}"
echo ""

VERIFY_RESPONSE=$(curl -s -X POST \
  -H "Authorization: Bearer ${TELNYX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{
    \"phone_number\": \"${TELNYX_TO_NUMBER}\",
    \"verify_profile_id\": \"${TELNYX_VERIFY_PROFILE_ID}\",
    \"type\": \"sms\"
  }" \
  "https://api.telnyx.com/v2/verifications" 2>/dev/null || echo "")

if [ -z "$VERIFY_RESPONSE" ]; then
  echo -e "  ${RED}FAIL${NC}  No response from API"
  exit 1
fi

# Extract verification ID
VERIFICATION_ID=""
if [ "$HAS_JQ" = true ]; then
  VERIFICATION_ID=$(echo "$VERIFY_RESPONSE" | jq -r '.data.id // empty' 2>/dev/null)
  VERIFY_STATUS=$(echo "$VERIFY_RESPONSE" | jq -r '.data.status // empty' 2>/dev/null)
  API_ERROR=$(echo "$VERIFY_RESPONSE" | jq -r '.errors[0].detail // empty' 2>/dev/null)

  if [ -n "$API_ERROR" ]; then
    echo -e "  ${RED}FAIL${NC}  API error: $API_ERROR"
    ERROR_CODE=$(echo "$VERIFY_RESPONSE" | jq -r '.errors[0].code // empty' 2>/dev/null)
    if [ -n "$ERROR_CODE" ]; then
      echo -e "  ${BLUE}INFO${NC}  Error code: $ERROR_CODE"
    fi
    exit 1
  fi
fi

if [ -z "$VERIFICATION_ID" ]; then
  echo -e "  ${RED}FAIL${NC}  Could not extract verification ID from response"
  if [ "$HAS_JQ" = true ]; then
    echo "  Response: $(echo "$VERIFY_RESPONSE" | jq -c . 2>/dev/null || echo "$VERIFY_RESPONSE")"
  fi
  exit 1
fi

echo -e "  ${GREEN}PASS${NC}  Verification sent"
echo "  Verification ID: ${VERIFICATION_ID}"
echo "  Status:          ${VERIFY_STATUS:-pending}"

# --- Send-only mode exits here ---
if [ "$SEND_ONLY" = true ]; then
  echo ""
  echo "==================="
  echo -e "${BOLD}Results (send-only mode)${NC}"
  echo "  Verification ID: ${VERIFICATION_ID}"
  echo "  Phone Number:    ${TELNYX_TO_NUMBER}"
  echo "  Status:          ${VERIFY_STATUS:-pending}"
  echo ""
  echo -e "  ${GREEN}${BOLD}PASS${NC}  OTP sent successfully (code verification skipped — use without --send-only to verify interactively)"
  exit 0
fi

# --- Prompt for code ---
echo ""
echo -e "${BOLD}Enter the verification code you received:${NC}"

# URL-encode the phone number for the API path
# Replace + with %2B
ENCODED_PHONE=$(echo "${TELNYX_TO_NUMBER}" | sed 's/+/%2B/g')

# Read code from stdin
read -r -p "  Code: " VERIFY_CODE

if [ -z "$VERIFY_CODE" ]; then
  echo -e "  ${RED}FAIL${NC}  No code entered"
  exit 1
fi

# Trim whitespace
VERIFY_CODE=$(echo "$VERIFY_CODE" | tr -d '[:space:]')

echo ""
echo -e "${BOLD}Verifying code...${NC}"

# --- Verify the code ---
VERIFY_CHECK_RESPONSE=$(curl -s -X POST \
  -H "Authorization: Bearer ${TELNYX_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "{
    \"code\": \"${VERIFY_CODE}\"
  }" \
  "https://api.telnyx.com/v2/verifications/by_phone_number/${ENCODED_PHONE}/actions/verify" 2>/dev/null || echo "")

if [ -z "$VERIFY_CHECK_RESPONSE" ]; then
  echo -e "  ${RED}FAIL${NC}  No response from verification API"
  exit 1
fi

# Parse result
VERIFY_RESULT=""
if [ "$HAS_JQ" = true ]; then
  VERIFY_RESULT=$(echo "$VERIFY_CHECK_RESPONSE" | jq -r '.data.response_code // empty' 2>/dev/null)
  VERIFY_FINAL_STATUS=$(echo "$VERIFY_CHECK_RESPONSE" | jq -r '.data.status // empty' 2>/dev/null)
  CHECK_ERROR=$(echo "$VERIFY_CHECK_RESPONSE" | jq -r '.errors[0].detail // empty' 2>/dev/null)

  if [ -n "$CHECK_ERROR" ]; then
    echo -e "  ${RED}FAIL${NC}  Verification error: $CHECK_ERROR"
    exit 1
  fi
fi

# --- Report ---
echo ""
echo "==================="
echo -e "${BOLD}Results${NC}"
echo "  Verification ID: ${VERIFICATION_ID}"
echo "  Phone Number:    ${TELNYX_TO_NUMBER}"
echo "  Code Entered:    ${VERIFY_CODE}"
echo "  Response Code:   ${VERIFY_RESULT:-unknown}"
echo "  Status:          ${VERIFY_FINAL_STATUS:-unknown}"

if [ "$VERIFY_RESULT" = "accepted" ] || [ "$VERIFY_FINAL_STATUS" = "accepted" ]; then
  echo ""
  echo -e "  ${GREEN}${BOLD}PASS${NC}  Verification successful"
  exit 0
elif [ "$VERIFY_RESULT" = "rejected" ] || [ "$VERIFY_FINAL_STATUS" = "rejected" ]; then
  echo ""
  echo -e "  ${RED}${BOLD}FAIL${NC}  Verification code was rejected (wrong code)"
  exit 1
elif [ "$VERIFY_RESULT" = "expired" ] || [ "$VERIFY_FINAL_STATUS" = "expired" ]; then
  echo ""
  echo -e "  ${RED}${BOLD}FAIL${NC}  Verification code has expired"
  exit 1
else
  echo ""
  echo -e "  ${YELLOW}${BOLD}WARN${NC}  Unexpected verification result: ${VERIFY_RESULT:-${VERIFY_FINAL_STATUS:-unknown}}"
  echo "  Check the Telnyx portal for details."
  exit 1
fi
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall