telnyx 3.1.0a0__py3-none-any.whl → 3.2.0__py3-none-any.whl

telnyx/types/fax_delivered_webhook_event.py

@@ -0,0 +1,69 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["FaxDeliveredWebhookEvent", "Payload"]
+
+
+class Payload(BaseModel):
+    call_duration_secs: Optional[int] = None
+    """The duration of the call in seconds."""
+
+    client_state: Optional[str] = None
+    """State received from a command."""
+
+    connection_id: Optional[str] = None
+    """The ID of the connection used to send the fax."""
+
+    direction: Optional[Literal["inbound", "outbound"]] = None
+    """The direction of the fax."""
+
+    fax_id: Optional[str] = None
+    """Identifies the fax."""
+
+    from_: Optional[str] = FieldInfo(alias="from", default=None)
+    """The phone number, in E.164 format, the fax will be sent from."""
+
+    media_name: Optional[str] = None
+    """The media_name used for the fax's media.
+
+    Must point to a file previously uploaded to api.telnyx.com/v2/media by the same
+    user/organization. media_name and media_url/contents can't be submitted
+    together.
+    """
+
+    original_media_url: Optional[str] = None
+    """The original URL to the PDF used for the fax's media.
+
+    If media_name was supplied, this is omitted
+    """
+
+    page_count: Optional[int] = None
+    """Number of transferred pages"""
+
+    status: Optional[Literal["delivered"]] = None
+    """The status of the fax."""
+
+    to: Optional[str] = None
+    """The phone number, in E.164 format, the fax will be sent to or SIP URI"""
+
+    user_id: Optional[str] = None
+    """Identifier of the user to whom the fax belongs"""
+
+
+class FaxDeliveredWebhookEvent(BaseModel):
+    id: Optional[str] = None
+    """Identifies the type of resource."""
+
+    event_type: Optional[Literal["fax.delivered"]] = None
+    """The type of event being delivered."""
+
+    payload: Optional[Payload] = None
+
+    record_type: Optional[Literal["event"]] = None
+    """Identifies the type of the resource."""

telnyx/types/fax_failed_webhook_event.py

@@ -0,0 +1,66 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["FaxFailedWebhookEvent", "Payload"]
+
+
+class Payload(BaseModel):
+    client_state: Optional[str] = None
+    """State received from a command."""
+
+    connection_id: Optional[str] = None
+    """The ID of the connection used to send the fax."""
+
+    direction: Optional[Literal["inbound", "outbound"]] = None
+    """The direction of the fax."""
+
+    failure_reason: Optional[Literal["rejected"]] = None
+    """Cause of the sending failure"""
+
+    fax_id: Optional[str] = None
+    """Identifies the fax."""
+
+    from_: Optional[str] = FieldInfo(alias="from", default=None)
+    """The phone number, in E.164 format, the fax will be sent from."""
+
+    media_name: Optional[str] = None
+    """The media_name used for the fax's media.
+
+    Must point to a file previously uploaded to api.telnyx.com/v2/media by the same
+    user/organization. media_name and media_url/contents can't be submitted
+    together.
+    """
+
+    original_media_url: Optional[str] = None
+    """The original URL to the PDF used for the fax's media.
+
+    If media_name was supplied, this is omitted
+    """
+
+    status: Optional[Literal["failed"]] = None
+    """The status of the fax."""
+
+    to: Optional[str] = None
+    """The phone number, in E.164 format, the fax will be sent to or SIP URI"""
+
+    user_id: Optional[str] = None
+    """Identifier of the user to whom the fax belongs"""
+
+
+class FaxFailedWebhookEvent(BaseModel):
+    id: Optional[str] = None
+    """Identifies the type of resource."""
+
+    event_type: Optional[Literal["fax.failed"]] = None
+    """The type of event being delivered."""
+
+    payload: Optional[Payload] = None
+
+    record_type: Optional[Literal["event"]] = None
+    """Identifies the type of the resource."""

telnyx/types/fax_media_processed_webhook_event.py

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["FaxMediaProcessedWebhookEvent", "Payload"]
+
+
+class Payload(BaseModel):
+    client_state: Optional[str] = None
+    """State received from a command."""
+
+    connection_id: Optional[str] = None
+    """The ID of the connection used to send the fax."""
+
+    direction: Optional[Literal["inbound", "outbound"]] = None
+    """The direction of the fax."""
+
+    fax_id: Optional[str] = None
+    """Identifies the fax."""
+
+    from_: Optional[str] = FieldInfo(alias="from", default=None)
+    """The phone number, in E.164 format, the fax will be sent from."""
+
+    media_name: Optional[str] = None
+    """The media_name used for the fax's media.
+
+    Must point to a file previously uploaded to api.telnyx.com/v2/media by the same
+    user/organization. media_name and media_url/contents can't be submitted
+    together.
+    """
+
+    original_media_url: Optional[str] = None
+    """The original URL to the PDF used for the fax's media.
+
+    If media_name was supplied, this is omitted
+    """
+
+    status: Optional[Literal["media.processed"]] = None
+    """The status of the fax."""
+
+    to: Optional[str] = None
+    """The phone number, in E.164 format, the fax will be sent to or SIP URI"""
+
+    user_id: Optional[str] = None
+    """Identifier of the user to whom the fax belongs"""
+
+
+class FaxMediaProcessedWebhookEvent(BaseModel):
+    id: Optional[str] = None
+    """Identifies the type of resource."""
+
+    event_type: Optional[Literal["fax.media.processed"]] = None
+    """The type of event being delivered."""
+
+    payload: Optional[Payload] = None
+
+    record_type: Optional[Literal["event"]] = None
+    """Identifies the type of the resource."""

telnyx/types/fax_queued_webhook_event.py

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["FaxQueuedWebhookEvent", "Payload"]
+
+
+class Payload(BaseModel):
+    client_state: Optional[str] = None
+    """State received from a command."""
+
+    connection_id: Optional[str] = None
+    """The ID of the connection used to send the fax."""
+
+    direction: Optional[Literal["inbound", "outbound"]] = None
+    """The direction of the fax."""
+
+    fax_id: Optional[str] = None
+    """Identifies the fax."""
+
+    from_: Optional[str] = FieldInfo(alias="from", default=None)
+    """The phone number, in E.164 format, the fax will be sent from."""
+
+    media_name: Optional[str] = None
+    """The media_name used for the fax's media.
+
+    Must point to a file previously uploaded to api.telnyx.com/v2/media by the same
+    user/organization. media_name and media_url/contents can't be submitted
+    together.
+    """
+
+    original_media_url: Optional[str] = None
+    """The original URL to the PDF used for the fax's media.
+
+    If media_name was supplied, this is omitted
+    """
+
+    status: Optional[Literal["queued"]] = None
+    """The status of the fax."""
+
+    to: Optional[str] = None
+    """The phone number, in E.164 format, the fax will be sent to or SIP URI"""
+
+    user_id: Optional[str] = None
+    """Identifier of the user to whom the fax belongs"""
+
+
+class FaxQueuedWebhookEvent(BaseModel):
+    id: Optional[str] = None
+    """Identifies the type of resource."""
+
+    event_type: Optional[Literal["fax.queued"]] = None
+    """The type of event being delivered."""
+
+    payload: Optional[Payload] = None
+
+    record_type: Optional[Literal["event"]] = None
+    """Identifies the type of the resource."""

telnyx/types/fax_sending_started_webhook_event.py

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["FaxSendingStartedWebhookEvent", "Payload"]
+
+
+class Payload(BaseModel):
+    client_state: Optional[str] = None
+    """State received from a command."""
+
+    connection_id: Optional[str] = None
+    """The ID of the connection used to send the fax."""
+
+    direction: Optional[Literal["inbound", "outbound"]] = None
+    """The direction of the fax."""
+
+    fax_id: Optional[str] = None
+    """Identifies the fax."""
+
+    from_: Optional[str] = FieldInfo(alias="from", default=None)
+    """The phone number, in E.164 format, the fax will be sent from."""
+
+    media_name: Optional[str] = None
+    """The media_name used for the fax's media.
+
+    Must point to a file previously uploaded to api.telnyx.com/v2/media by the same
+    user/organization. media_name and media_url/contents can't be submitted
+    together.
+    """
+
+    original_media_url: Optional[str] = None
+    """The original URL to the PDF used for the fax's media.
+
+    If media_name was supplied, this is omitted
+    """
+
+    status: Optional[Literal["sending"]] = None
+    """The status of the fax."""
+
+    to: Optional[str] = None
+    """The phone number, in E.164 format, the fax will be sent to or SIP URI"""
+
+    user_id: Optional[str] = None
+    """Identifier of the user to whom the fax belongs"""
+
+
+class FaxSendingStartedWebhookEvent(BaseModel):
+    id: Optional[str] = None
+    """Identifies the type of resource."""
+
+    event_type: Optional[Literal["fax.sending.started"]] = None
+    """The type of event being delivered."""
+
+    payload: Optional[Payload] = None
+
+    record_type: Optional[Literal["event"]] = None
+    """Identifies the type of the resource."""

telnyx/types/fqdn_connection_create_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List, Optional
+from typing import Optional
 from typing_extensions import Required, TypedDict
 
+from .._types import SequenceNotStr
 from .dtmf_type import DtmfType
 from .encrypted_media import EncryptedMedia
 from .inbound_fqdn_param import InboundFqdnParam
@@ -82,7 +83,7 @@ class FqdnConnectionCreateParams(TypedDict, total=False):
 
     rtcp_settings: ConnectionRtcpSettingsParam
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
     """Tags associated with the connection."""
 
     transport_protocol: TransportProtocol

telnyx/types/fqdn_connection_update_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List, Optional
+from typing import Optional
 from typing_extensions import TypedDict
 
+from .._types import SequenceNotStr
 from .dtmf_type import DtmfType
 from .encrypted_media import EncryptedMedia
 from .inbound_fqdn_param import InboundFqdnParam
@@ -76,7 +77,7 @@ class FqdnConnectionUpdateParams(TypedDict, total=False):
 
     rtcp_settings: ConnectionRtcpSettingsParam
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
     """Tags associated with the connection."""
 
     transport_protocol: TransportProtocol

telnyx/types/global_ip_latency_retrieve_response.py

@@ -97,19 +97,19 @@ class DataPercentileLatency_99(BaseModel):
 
 
 class DataPercentileLatency(BaseModel):
-    api_0: Optional[DataPercentileLatency_0] = FieldInfo(alias="0", default=None)
+    p0: Optional[DataPercentileLatency_0] = FieldInfo(alias="0", default=None)
 
-    api_100: Optional[DataPercentileLatency_100] = FieldInfo(alias="100", default=None)
+    p100: Optional[DataPercentileLatency_100] = FieldInfo(alias="100", default=None)
 
-    api_25: Optional[DataPercentileLatency_25] = FieldInfo(alias="25", default=None)
+    p25: Optional[DataPercentileLatency_25] = FieldInfo(alias="25", default=None)
 
-    api_50: Optional[DataPercentileLatency_50] = FieldInfo(alias="50", default=None)
+    p50: Optional[DataPercentileLatency_50] = FieldInfo(alias="50", default=None)
 
-    api_75: Optional[DataPercentileLatency_75] = FieldInfo(alias="75", default=None)
+    p75: Optional[DataPercentileLatency_75] = FieldInfo(alias="75", default=None)
 
-    api_90: Optional[DataPercentileLatency_90] = FieldInfo(alias="90", default=None)
+    p90: Optional[DataPercentileLatency_90] = FieldInfo(alias="90", default=None)
 
-    api_99: Optional[DataPercentileLatency_99] = FieldInfo(alias="99", default=None)
+    p99: Optional[DataPercentileLatency_99] = FieldInfo(alias="99", default=None)
 
 
 class DataProberLocation(BaseModel):

telnyx/types/inbound_fqdn_param.py

@@ -2,9 +2,11 @@
 
 from __future__ import annotations
 
-from typing import List, Optional
+from typing import Optional
 from typing_extensions import Literal, TypedDict
 
+from .._types import SequenceNotStr
+
 __all__ = ["InboundFqdnParam"]
 
 
@@ -21,7 +23,7 @@ class InboundFqdnParam(TypedDict, total=False):
     associated with this connection.
     """
 
-    codecs: List[str]
+    codecs: SequenceNotStr[str]
     """
     Defines the list of codecs that Telnyx will send for inbound calls to a specific
     number on your portal account, in priority order. This only works when the

telnyx/types/inbound_ip_param.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal, TypedDict
 
+from .._types import SequenceNotStr
+
 __all__ = ["InboundIPParam"]
 
 
@@ -21,7 +22,7 @@ class InboundIPParam(TypedDict, total=False):
     associated with this connection.
     """
 
-    codecs: List[str]
+    codecs: SequenceNotStr[str]
     """
     Defines the list of codecs that Telnyx will send for inbound calls to a specific
     number on your portal account, in priority order. This only works when the

telnyx/types/inbound_message_webhook_event.py

@@ -0,0 +1,227 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+from .messaging_error import MessagingError
+
+__all__ = [
+    "InboundMessageWebhookEvent",
+    "Data",
+    "DataPayload",
+    "DataPayloadCc",
+    "DataPayloadCost",
+    "DataPayloadCostBreakdown",
+    "DataPayloadCostBreakdownCarrierFee",
+    "DataPayloadCostBreakdownRate",
+    "DataPayloadFrom",
+    "DataPayloadMedia",
+    "DataPayloadTo",
+]
+
+
+class DataPayloadCc(BaseModel):
+    carrier: Optional[str] = None
+    """The carrier of the receiver."""
+
+    line_type: Optional[Literal["Wireline", "Wireless", "VoWiFi", "VoIP", "Pre-Paid Wireless", ""]] = None
+    """The line-type of the receiver."""
+
+    phone_number: Optional[str] = None
+    """Receiving address (+E.164 formatted phone number or short code)."""
+
+    status: Optional[
+        Literal["queued", "sending", "sent", "delivered", "sending_failed", "delivery_failed", "delivery_unconfirmed"]
+    ] = None
+
+
+class DataPayloadCost(BaseModel):
+    amount: Optional[str] = None
+    """The amount deducted from your account."""
+
+    currency: Optional[str] = None
+    """The ISO 4217 currency identifier."""
+
+
+class DataPayloadCostBreakdownCarrierFee(BaseModel):
+    amount: Optional[str] = None
+    """The carrier fee amount."""
+
+    currency: Optional[str] = None
+    """The ISO 4217 currency identifier."""
+
+
+class DataPayloadCostBreakdownRate(BaseModel):
+    amount: Optional[str] = None
+    """The rate amount applied."""
+
+    currency: Optional[str] = None
+    """The ISO 4217 currency identifier."""
+
+
+class DataPayloadCostBreakdown(BaseModel):
+    carrier_fee: Optional[DataPayloadCostBreakdownCarrierFee] = None
+
+    rate: Optional[DataPayloadCostBreakdownRate] = None
+
+
+class DataPayloadFrom(BaseModel):
+    carrier: Optional[str] = None
+    """The carrier of the sender."""
+
+    line_type: Optional[Literal["Wireline", "Wireless", "VoWiFi", "VoIP", "Pre-Paid Wireless", ""]] = None
+    """The line-type of the sender."""
+
+    phone_number: Optional[str] = None
+    """
+    Sending address (+E.164 formatted phone number, alphanumeric sender ID, or short
+    code).
+    """
+
+    status: Optional[Literal["received", "delivered"]] = None
+
+
+class DataPayloadMedia(BaseModel):
+    content_type: Optional[str] = None
+    """The MIME type of the requested media."""
+
+    hash_sha256: Optional[str] = None
+    """The SHA256 hash of the requested media."""
+
+    size: Optional[int] = None
+    """The size of the requested media."""
+
+    url: Optional[str] = None
+    """The url of the media requested to be sent."""
+
+
+class DataPayloadTo(BaseModel):
+    carrier: Optional[str] = None
+    """The carrier of the receiver."""
+
+    line_type: Optional[Literal["Wireline", "Wireless", "VoWiFi", "VoIP", "Pre-Paid Wireless", ""]] = None
+    """The line-type of the receiver."""
+
+    phone_number: Optional[str] = None
+    """Receiving address (+E.164 formatted phone number or short code)."""
+
+    status: Optional[
+        Literal[
+            "queued",
+            "sending",
+            "sent",
+            "delivered",
+            "sending_failed",
+            "delivery_failed",
+            "delivery_unconfirmed",
+            "webhook_delivered",
+        ]
+    ] = None
+
+
+class DataPayload(BaseModel):
+    id: Optional[str] = None
+    """Identifies the type of resource."""
+
+    cc: Optional[List[DataPayloadCc]] = None
+
+    completed_at: Optional[datetime] = None
+    """Not used for inbound messages."""
+
+    cost: Optional[DataPayloadCost] = None
+
+    cost_breakdown: Optional[DataPayloadCostBreakdown] = None
+    """Detailed breakdown of the message cost components."""
+
+    direction: Optional[Literal["inbound"]] = None
+    """The direction of the message.
+
+    Inbound messages are sent to you whereas outbound messages are sent from you.
+    """
+
+    encoding: Optional[str] = None
+    """Encoding scheme used for the message body."""
+
+    errors: Optional[List[MessagingError]] = None
+    """
+    These errors may point at addressees when referring to unsuccessful/unconfirmed
+    delivery statuses.
+    """
+
+    from_: Optional[DataPayloadFrom] = FieldInfo(alias="from", default=None)
+
+    media: Optional[List[DataPayloadMedia]] = None
+
+    messaging_profile_id: Optional[str] = None
+    """Unique identifier for a messaging profile."""
+
+    parts: Optional[int] = None
+    """Number of parts into which the message's body must be split."""
+
+    received_at: Optional[datetime] = None
+    """ISO 8601 formatted date indicating when the message request was received."""
+
+    record_type: Optional[Literal["message"]] = None
+    """Identifies the type of the resource."""
+
+    sent_at: Optional[datetime] = None
+    """Not used for inbound messages."""
+
+    tags: Optional[List[str]] = None
+    """Tags associated with the resource."""
+
+    tcr_campaign_billable: Optional[bool] = None
+    """Indicates whether the TCR campaign is billable."""
+
+    tcr_campaign_id: Optional[str] = None
+    """The Campaign Registry (TCR) campaign ID associated with the message."""
+
+    tcr_campaign_registered: Optional[str] = None
+    """The registration status of the TCR campaign."""
+
+    text: Optional[str] = None
+    """Message body (i.e., content) as a non-empty string.
+
+    **Required for SMS**
+    """
+
+    to: Optional[List[DataPayloadTo]] = None
+
+    type: Optional[Literal["SMS", "MMS"]] = None
+    """The type of message. This value can be either 'sms' or 'mms'."""
+
+    valid_until: Optional[datetime] = None
+    """Not used for inbound messages."""
+
+    webhook_failover_url: Optional[str] = None
+    """
+    The failover URL where webhooks related to this message will be sent if sending
+    to the primary URL fails.
+    """
+
+    webhook_url: Optional[str] = None
+    """The URL where webhooks related to this message will be sent."""
+
+
+class Data(BaseModel):
+    id: Optional[str] = None
+    """Identifies the type of resource."""
+
+    event_type: Optional[Literal["message.received"]] = None
+    """The type of event being delivered."""
+
+    occurred_at: Optional[datetime] = None
+    """ISO 8601 formatted date indicating when the resource was created."""
+
+    payload: Optional[DataPayload] = None
+
+    record_type: Optional[Literal["event"]] = None
+    """Identifies the type of the resource."""
+
+
+class InboundMessageWebhookEvent(BaseModel):
+    data: Optional[Data] = None