telnyx-messaging-profiles-javascript_skill

Overview

This skill helps you create and manage Telnyx messaging profiles using the JavaScript SDK. It covers operations for messaging profiles, phone numbers, short codes, and auto-response configurations, with examples for listing, creating, updating, and deleting resources. The examples assume a Telnyx client initialized with an API key and demonstrate pagination-aware listing and per-resource CRUD operations.

How this skill works

Initialize the Telnyx JavaScript client with your API key and call the messagingProfiles or shortCodes methods to perform REST operations. The SDK provides async iterators for paginated list endpoints and direct methods for create, retrieve, update, and delete actions. Auto-response settings are managed via nested autorespConfigs endpoints tied to a messaging profile ID.

When to use it

• When you need to provision or update messaging profiles with number pools, sticky sender, or geomatch behavior.
• When configuring short codes for high-volume or campaign messaging linked to specific profiles.
• When binding phone numbers to a messaging profile or auditing which numbers belong to a profile.
• When creating auto-response rules (op, keywords, country_code) for inbound message handling.
• When automating profile management workflows from a Node.js backend or CI job.

Best practices

• Keep your TELNYX_API_KEY in environment variables and never commit it to source control.
• Use the SDK's async iterators to handle pagination automatically for list endpoints.
• Validate required fields (e.g., name, whitelisted_destinations for profiles; messaging_profile_id for short codes).
• Test auto-response rules in a staging profile before applying to production short codes or numbers.
• Use explicit IDs returned by create calls when linking resources to avoid race conditions.

Example use cases

• Automate creation of messaging profiles per customer with regional whitelisted_destinations and geomatch settings.
• Bulk-assign phone numbers to a messaging profile and verify messaging settings via listPhoneNumbers.
• Switch a short code to a different messaging profile during campaign rollout using shortCodes.update.
• Implement localized auto-responses by country and keywords using autorespConfigs.create and update.