telnyx-account-reports-go_skill
- Python
1.4k
GitHub Stars
1
Bundled Files
2 months ago
Catalog Refreshed
4 months ago
First Indexed
Readme & install
Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.
Installation
Preview and clipboard use veilstrat where the catalogue uses aiagentskills.
npx veilstrat add skill openclaw/skills --skill telnyx-account-reports-go- SKILL.md11.8 KB
Overview
This skill lets you generate and retrieve Telnyx account usage and billing reports using Go examples. It covers messaging (MDR), voice (CDR), telco data, speech-to-text, and product-level usage queries. Examples show listing, creating, fetching, synchronously generating, and deleting reports via the Telnyx Go SDK.
How this skill works
The skill demonstrates initializing the Telnyx Go client with an API key and calling report endpoints for legacy and current APIs. It includes examples for listing previous report requests, creating new report requests with time filters, fetching reports by ID, synchronous report generation, and deleting requests. Code snippets use context-aware client methods and typed parameter structs for each report type.
When to use it
- Automate monthly billing and reconciliation exports for messaging and voice.
- Generate on-demand usage snapshots for analytics or dashboards.
- Fetch detailed call or message detail records for dispute resolution.
- Submit and retrieve telco data or speech-to-text usage reports.
- Explore product-level metrics and dimensions in beta Usage Reports.
Best practices
- Keep API keys in environment variables and initialize the client once per process.
- Use start_time and end_time filters for precise report ranges to limit data volumes.
- Prefer synchronous fetch endpoints only for short ad-hoc queries; use async create/list for large exports.
- Handle pagination when listing reports and check response.Data fields for payload.
- Wrap report calls with retries and exponentional backoff for transient network errors.
Example use cases
- Create a monthly MDR usage report for messaging volume and export CSV for accounting.
- Request a CDR report for a specific date range to reconcile carrier charges.
- Generate a synchronous MDR report to power an on-demand usage dashboard widget.
- Submit and retrieve number lookup usage reports for telco data billing.
- Query beta product usage to break down metrics by dimensions for product analytics.
FAQ
Use your Telnyx secret API key. Store it in TELNYX_API_KEY and initialize the client with option.WithAPIKey(os.Getenv("TELNYX_API_KEY")).
When should I use synchronous vs asynchronous report endpoints?
Use synchronous endpoints for small, quick queries or testing. Use async create/list endpoints for larger exports that may take longer to prepare and should be polled or processed once ready.
