telnyx-numbers-config-java

Name: telnyx-numbers-config-java
Author: team-telnyx

187stars18forks

How to install telnyx-numbers-config-java?

team-telnyx/ai/telnyx-numbers-config-java

$npx -y skills add team-telnyx/ai --skill telnyx-numbers-config-java

Installs into the current project.

Summary

Configure phone number settings including caller ID, call forwarding, messaging enablement, and connection assignments. This skill provides Java SDK examples.

Files · 1

View on GitHub

SKILL.md

1	<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->
2
3	# Telnyx Numbers Config - Java
4
5	## Installation
6
7	```text
8	<!-- Maven -->
9	<dependency>
10	<groupId>com.telnyx.sdk</groupId>
11	<artifactId>telnyx</artifactId>
12	<version>6.36.0</version>
13	</dependency>
14
15	// Gradle
16	implementation("com.telnyx.sdk:telnyx:6.36.0")
17	```
18
19	## Setup
20
21	```java
22	import com.telnyx.sdk.client.TelnyxClient;
23	import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
24
25	TelnyxClient client = TelnyxOkHttpClient.fromEnv();
26	```
27
28	All examples below assume `client` is already initialized as shown above.
29
30	## Error Handling
31
32	All API calls can fail with network errors, rate limits (429), validation errors (422),
33	or authentication errors (401). Always handle errors in production code:
34
35	```java
36	import com.telnyx.sdk.errors.TelnyxServiceException;
37
38	try {
39	var result = client.messages().send(params);
40	} catch (TelnyxServiceException e) {
41	System.err.println("API error " + e.statusCode() + ": " + e.getMessage());
42	if (e.statusCode() == 422) {
43	System.err.println("Validation error — check required fields and formats");
44	} else if (e.statusCode() == 429) {
45	// Rate limited — wait and retry with exponential backoff
46	Thread.sleep(1000);
47	}
48	}
49	```
50
51	Common error codes: `401` invalid API key, `403` insufficient permissions,
52	`404` resource not found, `422` validation error (check field formats),
53	`429` rate limited (retry with exponential backoff).
54
55	## Important Notes
56
57	- Phone numbers must be in E.164 format (e.g., `+13125550001`). Include the `+` prefix and country code. No spaces, dashes, or parentheses.
58	- Pagination: List methods return a page. Use `.autoPager()` for automatic iteration: `for (var item : page.autoPager()) { ... }`. For manual control, use `.hasNextPage()` and `.nextPage()`.
59
60	## Bulk update phone number profiles
61
62	`POST /messaging_numbers_bulk_updates` — Required: `messaging_profile_id`, `numbers`
63
64	Optional: `assign_only` (boolean)
65
66	```java
67	import com.telnyx.sdk.models.messagingnumbersbulkupdates.MessagingNumbersBulkUpdateCreateParams;
68	import com.telnyx.sdk.models.messagingnumbersbulkupdates.MessagingNumbersBulkUpdateCreateResponse;
69	import java.util.List;
70
71	MessagingNumbersBulkUpdateCreateParams params = MessagingNumbersBulkUpdateCreateParams.builder()
72	.messagingProfileId("00000000-0000-0000-0000-000000000000")
73	.numbers(List.of(
74	"+18880000000",
75	"+18880000001",
76	"+18880000002"
77	))
78	.build();
79	MessagingNumbersBulkUpdateCreateResponse messagingNumbersBulkUpdate = client.messagingNumbersBulkUpdates().create(params);
80	```
81
82	Returns: `failed` (array[string]), `order_id` (uuid), `pending` (array[string]), `record_type` (enum: messaging_numbers_bulk_update), `success` (array[string])
83
84	## Retrieve bulk update status
85
86	`GET /messaging_numbers_bulk_updates/{order_id}`
87
88	```java
89	import com.telnyx.sdk.models.messagingnumbersbulkupdates.MessagingNumbersBulkUpdateRetrieveParams;
90	import com.telnyx.sdk.models.messagingnumbersbulkupdates.MessagingNumbersBulkUpdateRetrieveResponse;
91
92	MessagingNumbersBulkUpdateRetrieveResponse messagingNumbersBulkUpdate = client.messagingNumbersBulkUpdates().retrieve("550e8400-e29b-41d4-a716-446655440000");
93	```
94
95	Returns: `failed` (array[string]), `order_id` (uuid), `pending` (array[string]), `record_type` (enum: messaging_numbers_bulk_update), `success` (array[string])
96
97	## List mobile phone numbers with messaging settings
98
99	`GET /mobile_phone_numbers/messaging`
100
101	```java
102	import com.telnyx.sdk.models.mobilephonenumbers.messaging.MessagingListPage;
103	import com.telnyx.sdk.models.mobilephonenumbers.messaging.MessagingListParams;
104
105	MessagingListPage page = client.mobilePhoneNumbers().messaging().list();
106	```
107
108	Returns: `country_code` (string), `created_at` (date-time), `features` (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` (array[string]), `traffic_type` (string), `type` (enum: longcode), `updated_at` (date-time)
109
110	## Retrieve a mobile phone number with messaging settings
111
112	`GET /mobile_phone_numbers/{id}/messaging`
113
114	```java
115	import com.telnyx.sdk.models.mobilephonenumbers.messaging.MessagingRetrieveParams;
116	import com.telnyx.sdk.models.mobilephonenumbers.messaging.MessagingRetrieveResponse;
117
118	MessagingRetrieveResponse messaging = client.mobilePhoneNumbers().messaging().retrieve("550e8400-e29b-41d4-a716-446655440000");
119	```
120
121	Returns: `country_code` (string), `created_at` (date-time), `features` (object), `id` (string), `messaging_product` (string), `messaging_profile_id`

People who liked this also viewed

6 picks

Type

telnyx-numbers-config-java

187stars18forks

View on GitHub

How to install telnyx-numbers-config-java?

team-telnyx/ai/telnyx-numbers-config-java

$npx -y skills add team-telnyx/ai --skill telnyx-numbers-config-java

Installs into the current project.

Summary

Configure phone number settings including caller ID, call forwarding, messaging enablement, and connection assignments. This skill provides Java SDK examples.

Files · 1

View on GitHub

SKILL.md

1	<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->
2
3	# Telnyx Numbers Config - Java
4
5	## Installation
6
7	```text
8	<!-- Maven -->
9	<dependency>
10	<groupId>com.telnyx.sdk</groupId>
11	<artifactId>telnyx</artifactId>
12	<version>6.36.0</version>
13	</dependency>
14
15	// Gradle
16	implementation("com.telnyx.sdk:telnyx:6.36.0")
17	```
18
19	## Setup
20
21	```java
22	import com.telnyx.sdk.client.TelnyxClient;
23	import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
24
25	TelnyxClient client = TelnyxOkHttpClient.fromEnv();
26	```
27
28	All examples below assume `client` is already initialized as shown above.
29
30	## Error Handling
31
32	All API calls can fail with network errors, rate limits (429), validation errors (422),
33	or authentication errors (401). Always handle errors in production code:
34
35	```java
36	import com.telnyx.sdk.errors.TelnyxServiceException;
37
38	try {
39	var result = client.messages().send(params);
40	} catch (TelnyxServiceException e) {
41	System.err.println("API error " + e.statusCode() + ": " + e.getMessage());
42	if (e.statusCode() == 422) {
43	System.err.println("Validation error — check required fields and formats");
44	} else if (e.statusCode() == 429) {
45	// Rate limited — wait and retry with exponential backoff
46	Thread.sleep(1000);
47	}
48	}
49	```
50
51	Common error codes: `401` invalid API key, `403` insufficient permissions,
52	`404` resource not found, `422` validation error (check field formats),
53	`429` rate limited (retry with exponential backoff).
54
55	## Important Notes
56
57	- Phone numbers must be in E.164 format (e.g., `+13125550001`). Include the `+` prefix and country code. No spaces, dashes, or parentheses.
58	- Pagination: List methods return a page. Use `.autoPager()` for automatic iteration: `for (var item : page.autoPager()) { ... }`. For manual control, use `.hasNextPage()` and `.nextPage()`.
59
60	## Bulk update phone number profiles
61
62	`POST /messaging_numbers_bulk_updates` — Required: `messaging_profile_id`, `numbers`
63
64	Optional: `assign_only` (boolean)
65
66	```java
67	import com.telnyx.sdk.models.messagingnumbersbulkupdates.MessagingNumbersBulkUpdateCreateParams;
68	import com.telnyx.sdk.models.messagingnumbersbulkupdates.MessagingNumbersBulkUpdateCreateResponse;
69	import java.util.List;
70
71	MessagingNumbersBulkUpdateCreateParams params = MessagingNumbersBulkUpdateCreateParams.builder()
72	.messagingProfileId("00000000-0000-0000-0000-000000000000")
73	.numbers(List.of(
74	"+18880000000",
75	"+18880000001",
76	"+18880000002"
77	))
78	.build();
79	MessagingNumbersBulkUpdateCreateResponse messagingNumbersBulkUpdate = client.messagingNumbersBulkUpdates().create(params);
80	```
81
82	Returns: `failed` (array[string]), `order_id` (uuid), `pending` (array[string]), `record_type` (enum: messaging_numbers_bulk_update), `success` (array[string])
83
84	## Retrieve bulk update status
85
86	`GET /messaging_numbers_bulk_updates/{order_id}`
87
88	```java
89	import com.telnyx.sdk.models.messagingnumbersbulkupdates.MessagingNumbersBulkUpdateRetrieveParams;
90	import com.telnyx.sdk.models.messagingnumbersbulkupdates.MessagingNumbersBulkUpdateRetrieveResponse;
91
92	MessagingNumbersBulkUpdateRetrieveResponse messagingNumbersBulkUpdate = client.messagingNumbersBulkUpdates().retrieve("550e8400-e29b-41d4-a716-446655440000");
93	```
94
95	Returns: `failed` (array[string]), `order_id` (uuid), `pending` (array[string]), `record_type` (enum: messaging_numbers_bulk_update), `success` (array[string])
96
97	## List mobile phone numbers with messaging settings
98
99	`GET /mobile_phone_numbers/messaging`
100
101	```java
102	import com.telnyx.sdk.models.mobilephonenumbers.messaging.MessagingListPage;
103	import com.telnyx.sdk.models.mobilephonenumbers.messaging.MessagingListParams;
104
105	MessagingListPage page = client.mobilePhoneNumbers().messaging().list();
106	```
107
108	Returns: `country_code` (string), `created_at` (date-time), `features` (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` (array[string]), `traffic_type` (string), `type` (enum: longcode), `updated_at` (date-time)
109
110	## Retrieve a mobile phone number with messaging settings
111
112	`GET /mobile_phone_numbers/{id}/messaging`
113
114	```java
115	import com.telnyx.sdk.models.mobilephonenumbers.messaging.MessagingRetrieveParams;
116	import com.telnyx.sdk.models.mobilephonenumbers.messaging.MessagingRetrieveResponse;
117
118	MessagingRetrieveResponse messaging = client.mobilePhoneNumbers().messaging().retrieve("550e8400-e29b-41d4-a716-446655440000");
119	```
120
121	Returns: `country_code` (string), `created_at` (date-time), `features` (object), `id` (string), `messaging_product` (string), `messaging_profile_id`

People who liked this also viewed

6 picks

Type