Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Telnyx Messaging Profiles - Go · team-telnyx | DecimalAI

team-telnyx/telnyx-messaging-profiles-go

SkillScore95Maintained

Create and manage messaging profiles with number pools, sticky sender, and geomatch features. Configure short codes for high-volume messaging. This skill provides Go SDK examples.

codingby team-telnyx

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Coding pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/team-telnyx-telnyx-messaging-profiles-go/SKILL.md

decimalai skills pull team-telnyx-telnyx-messaging-profiles-go --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/team-telnyx-telnyx-messaging-profiles-go/SKILL.md https://app.decimal.ai/s/team-telnyx-telnyx-messaging-profiles-go/SKILL.md

Raw file: /s/team-telnyx-telnyx-messaging-profiles-go/SKILL.md ↗ · machine-readable summary at /s/team-telnyx-telnyx-messaging-profiles-go.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 7d ago

Yes — +55% lift · at higher cost+136% tokens0% turns95% of whole cases pass with skill (21/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	55%	0%
case-02	✗→✓	▲ Improved	142%	0%
case-04	✗→✓	▲ Improved	234%	0%
case-17	✗→✓	▲ Improved	77%	0%
case-10	✗→✓	▲ Improved	149%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/10/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

team-telnyx / ai

skills/telnyx-messaging-profiles-go/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v2

Skill contents

SKILL.md

Telnyx Messaging Profiles - Go

Installation

bash
go get github.com/team-telnyx/telnyx-go

Setup

go
import (
  "context"
  "fmt"
  "os"

  "github.com/team-telnyx/telnyx-go"
  "github.com/team-telnyx/telnyx-go/option"
)

client := telnyx.NewClient(
  option.WithAPIKey(os.Getenv("TELNYX_API_KEY")),
)

All examples below assume client is already initialized as shown above.

Error Handling

All API calls can fail with network errors, rate limits (429), validation errors (422), or authentication errors (401). Always handle errors in production code:

go
import "errors"

result, err := client.Messages.Send(ctx, params)
if err != nil {
  var apiErr *telnyx.Error
  if errors.As(err, &apiErr) {
    switch apiErr.StatusCode {
    case 422:
      fmt.Println("Validation error — check required fields and formats")
    case 429:
      // Rate limited — wait and retry with exponential backoff
      fmt.Println("Rate limited, retrying...")
    default:
      fmt.Printf("API error %d: %s\n", apiErr.StatusCode, apiErr.Error())
    }
  } else {
    fmt.Println("Network error — check connectivity and retry")
  }
}

Common error codes: 401 invalid API key, 403 insufficient permissions, 404 resource not found, 422 validation error (check field formats), 429 rate limited (retry with exponential backoff).

Important Notes

Pagination: Use ListAutoPaging() for automatic iteration: iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }.

List messaging profiles

GET /messaging_profiles

go
	page, err := client.MessagingProfiles.List(context.Background(), telnyx.MessagingProfileListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)

Returns: ai_assistant_id (string | null), alpha_sender (string | null), created_at (date-time), daily_spend_limit (string), daily_spend_limit_enabled (boolean), enabled (boolean), health_webhook_url (url), id (uuid), mms_fall_back_to_sms (boolean), mms_transcoding (boolean), mobile_only (boolean), name (string), number_pool_settings (object | null), organization_id (string), record_type (enum: messaging_profile), redaction_enabled (boolean), redaction_level (integer), resource_group_id (string | null), smart_encoding (boolean), updated_at (date-time), url_shortener_settings (object | null), v1_secret (string), webhook_api_version (enum: 1, 2, 2010-04-01), webhook_failover_url (url), webhook_url (url), whitelisted_destinations (arraystring])

Create a messaging profile

POST /messaging_profiles — Required: name, whitelisted_destinations

Optional: ai_assistant_id (string | null), alpha_sender (string | null), daily_spend_limit (string), daily_spend_limit_enabled (boolean), enabled (boolean), health_webhook_url (url), mms_fall_back_to_sms (boolean), mms_transcoding (boolean), mobile_only (boolean), number_pool_settings (object | null), resource_group_id (string | null), smart_encoding (boolean), url_shortener_settings (object | null), webhook_api_version (enum: 1, 2, 2010-04-01), webhook_failover_url (url), webhook_url (url)

go
	messagingProfile, err := client.MessagingProfiles.New(context.Background(), telnyx.MessagingProfileNewParams{
		Name:                    "My name",
		WhitelistedDestinations: []string{"US"},
	})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", messagingProfile.Data)

Retrieve a messaging profile

GET /messaging_profiles/{id}

go
	messagingProfile, err := client.MessagingProfiles.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", messagingProfile.Data)

Update a messaging profile

PATCH /messaging_profiles/{id}

Optional: ai_assistant_id (string | null), alpha_sender (string | null), created_at (date-time), daily_spend_limit (string), daily_spend_limit_enabled (boolean), enabled (boolean), id (uuid), mms_fall_back_to_sms (boolean), mms_transcoding (boolean), mobile_only (boolean), name (string), number_pool_settings (object | null), record_type (enum: messaging_profile), smart_encoding (boolean), updated_at (date-time), url_shortener_settings (object | null), v1_secret (string), webhook_api_version (enum: 1, 2, 2010-04-01), webhook_failover_url (url), webhook_url (url), whitelisted_destinations (arraystring])

go
	messagingProfile, err := client.MessagingProfiles.Update(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.MessagingProfileUpdateParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", messagingProfile.Data)

Delete a messaging profile

DELETE /messaging_profiles/{id}

go
	messagingProfile, err := client.MessagingProfiles.Delete(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", messagingProfile.Data)

List phone numbers associated with a messaging profile

GET /messaging_profiles/{id}/phone_numbers

go
	page, err := client.MessagingProfiles.ListPhoneNumbers(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.MessagingProfileListPhoneNumbersParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)

Returns: country_code (string), created_at (date-time), eligible_messaging_products (arraystring]), features (object), health (object), id (string), messaging_product (string), messaging_profile_id (string | null), organization_id (string), phone_number (string), record_type (enum: messaging_phone_number, messaging_settings), tags (arraystring]), traffic_type (string), type (enum: long-code, toll-free, short-code, longcode, tollfree, shortcode), updated_at (date-time)

List short codes associated with a messaging profile

GET /messaging_profiles/{id}/short_codes

go
	page, err := client.MessagingProfiles.ListShortCodes(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.MessagingProfileListShortCodesParams{},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)

Returns: country_code (string), created_at (date-time), id (uuid), messaging_profile_id (string | null), record_type (enum: short_code), short_code (string), tags (array), updated_at (date-time)

List short codes

GET /short_codes

go
	page, err := client.ShortCodes.List(context.Background(), telnyx.ShortCodeListParams{})
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", page)

Retrieve a short code

GET /short_codes/{id}

go
	shortCode, err := client.ShortCodes.Get(context.Background(), "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", shortCode.Data)

Update short code

Update the settings for a specific short code. To unbind a short code from a profile, set the messaging_profile_id to null or an empty string. To add or update tags, include the tags field as an array of strings.

PATCH /short_codes/{id} — Required: messaging_profile_id

Optional: tags (array)

go
	shortCode, err := client.ShortCodes.Update(
		context.Background(),
		"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
		telnyx.ShortCodeUpdateParams{
			MessagingProfileID: "abc85f64-5717-4562-b3fc-2c9600000000",
		},
	)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Printf("%+v\n", shortCode.Data)

Want to see if team-telnyx/telnyx-messaging-profiles-go would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/22/2026, 09:27 UTC · 22 cases

Lift

+55%

95% vs 41%

Agent turns

1.0 vs 1.0

Tokens

+136%

5,065.82 vs 2,145

fail → pass · 12pass → pass · 9fail → fail · 1

Per-case results (22)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 I'm building a backend service in Go that needs to set up Telnyx messaging profiles programmatically. Could you provide a Go function that creates a new profile given a name, callback webhook URL, and standard allowed destination countries? Please incorporate proper error handling to catch API errors (like rate limiting or invalid payload parameters) versus client-side connection failures.	fail→pass	19,423	10,929	-44%	1	1	0%	4,001	6,199	+55%	0	0	—
case-02 Can you show me how to reassign or attach a short code to a messaging profile using the Telnyx Go SDK? Write a Go snippet that updates a short code given its ID, linking it to a target messaging profile ID and updating its tags, while handling potential API errors.	fail→pass	11,759	7,490	-36%	1	1	0%	2,310	5,593	+142%	0	0	—
case-03 I need to fetch all phone numbers associated with a specific Telnyx messaging profile in Go. Please write a Go function that receives a messaging profile ID, queries the Telnyx client for its associated numbers, and prints out each phone number's properties while handling errors cleanly.	fail→fail	14,146	10,094	-29%	1	1	0%	2,876	6,227	+117%	0	0	—
case-04 Write a Go snippet that uses the Telnyx Go library to send an outbound SMS message to '+18005550199' with text content 'Your verification code is 123456'.	fail→pass	8,602	8,665	+1%	1	1	0%	1,696	5,661	+234%	0	0	—
case-05 I want to purchase a phone number '+18005550123' programmatically in Go using the official Telnyx Go package. Show how to order this number.	pass→pass	9,094	7,709	-15%	1	1	0%	1,853	5,499	+197%	0	0	—
case-17 Show how to structure Go error handling for Telnyx API calls to specifically catch 422 validation errors.	fail→pass	15,018	5,533	-63%	1	1	0%	2,811	4,971	+77%	0	0	—
case-18 Write a Go error handling snippet that checks if a failed Telnyx API request was caused by HTTP 429 rate limiting.	pass→pass	8,421	5,226	-38%	1	1	0%	1,580	4,973	+215%	0	0	—
case-10 Write a Go function that updates an existing Telnyx messaging profile given its ID and new parameters.	fail→pass	11,165	6,476	-42%	1	1	0%	2,107	5,238	+149%	0	0	—
case-16 I need to iterate through all Telnyx messaging profiles in Go without manually managing page tokens. How is auto-pagination implemented?	fail→pass	12,661	5,248	-59%	1	1	0%	2,222	5,006	+125%	0	0	—
case-06 Write a Go function using the Telnyx Go SDK to create a new Call Control application with a webhook URL 'https://example.com/voice/webhook' for handling voice calls.	pass→pass	10,399	10,077	-3%	1	1	0%	1,999	6,008	+201%	0	0	—
case-07 How do I instantiate an authenticated Telnyx API client instance in Go using an API key from environment variables?	fail→pass	10,442	2,504	-76%	1	1	0%	2,013	4,386	+118%	0	0	—
case-08 Write a Go code snippet to request a list of all messaging profiles from the Telnyx API.	fail→pass	10,445	4,650	-55%	1	1	0%	2,199	4,857	+121%	0	0	—
case-09 In Go, how do I fetch details of a specific messaging profile using its UUID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'?	pass→pass	10,328	2,917	-72%	1	1	0%	2,219	4,592	+107%	0	0	—
case-11 How do I delete a messaging profile in Go given its profile ID string '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'?	pass→pass	10,239	2,542	-75%	1	1	0%	2,137	4,490	+110%	0	0	—
case-12 Write a Go snippet that lists only the short codes assigned to a specific messaging profile ID.	fail→pass	12,099	3,510	-71%	1	1	0%	2,405	4,637	+93%	0	0	—
case-13 How do I fetch all short codes registered across my Telnyx account using Go?	pass→pass	12,070	5,991	-50%	1	1	0%	2,236	5,258	+135%	0	0	—
case-14 Write a Go function to retrieve details for a single short code using its ID '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e'.	fail→pass	12,572	3,684	-71%	1	1	0%	2,694	4,793	+78%	0	0	—
case-15 How do I detach or unbind a short code from its messaging profile in Go?	pass→pass	12,700	3,609	-72%	1	1	0%	2,421	4,703	+94%	0	0	—
case-19 When constructing a new Telnyx messaging profile in Go, how do I restrict allowed destination countries to US and CA?	fail→pass	9,085	3,454	-62%	1	1	0%	1,749	4,541	+160%	0	0	—
case-20 How do I attach custom tags to a short code using the Telnyx Go SDK?	pass→pass	9,685	5,440	-44%	1	1	0%	1,829	5,056	+176%	0	0	—
case-21 Which Go package import path and options import path are required to instantiate the Telnyx Go client?	fail→pass	4,451	2,147	-52%	1	1	0%	803	4,363	+443%	0	0	—
case-22 After calling the create messaging profile endpoint in the Telnyx Go SDK, where is the returned profile object located in the result struct?	pass→pass	5,913	2,217	-63%	1	1	0%	1,030	4,397	+327%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +55 percentage points is the difference between those two pass rates over the 22 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 40.9%
Pass rate with the skill: 95.5%
Cases attempted: 22
Cases counted toward lift: 22
Cases that regressed: 0
Skill version measured: v2
Run completed: 8/22/2026, 09:27 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-01

Prompt

I'm building a backend service in Go that needs to set up Telnyx messaging profiles programmatically. Could you provide a Go function that creates a new profile given a name, callback webhook URL, and standard allowed destination countries? Please incorporate proper error handling to catch API errors (like rate limiting or invalid payload parameters) versus client-side connection failures.

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run95

Live evalNeeds ≥20 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+160% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 7 days ago

Other measured skills in the registry, with their headline benchmark lift.