telnyx 3.2.0a0__py3-none-any.whl → 3.4.0a0__py3-none-any.whl

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/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

telnyx/types/ip_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 Literal, TypedDict
 
+from .._types import SequenceNotStr
 from .dtmf_type import DtmfType
 from .encrypted_media import EncryptedMedia
 from .outbound_ip_param import OutboundIPParam
@@ -72,7 +73,7 @@ class IPConnectionCreateParams(TypedDict, total=False):
 
     rtcp_settings: ConnectionRtcpSettingsParam
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
     """Tags associated with the connection."""
 
     transport_protocol: Literal["UDP", "TCP", "TLS"]
@@ -113,7 +114,7 @@ class Inbound(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/ip_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 Literal, TypedDict
 
+from .._types import SequenceNotStr
 from .dtmf_type import DtmfType
 from .encrypted_media import EncryptedMedia
 from .inbound_ip_param import InboundIPParam
@@ -73,7 +74,7 @@ class IPConnectionUpdateParams(TypedDict, total=False):
 
     rtcp_settings: ConnectionRtcpSettingsParam
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
     """Tags associated with the connection."""
 
     transport_protocol: Literal["UDP", "TCP", "TLS"]

telnyx/types/media_list_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import TypedDict
 
+from .._types import SequenceNotStr
+
 __all__ = ["MediaListParams", "Filter"]
 
 
@@ -17,5 +18,5 @@ class MediaListParams(TypedDict, total=False):
 
 
 class Filter(TypedDict, total=False):
-    content_type: List[str]
+    content_type: SequenceNotStr[str]
     """Filters files by given content types"""

telnyx/types/message_schedule_params.py

@@ -2,10 +2,11 @@
 
 from __future__ import annotations
 
-from typing import List, Union
+from typing import Union
 from datetime import datetime
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = ["MessageScheduleParams"]
@@ -30,7 +31,7 @@ class MessageScheduleParams(TypedDict, total=False):
     ID.**
     """
 
-    media_urls: List[str]
+    media_urls: SequenceNotStr[str]
     """A list of media URLs. The total media size must be less than 1 MB.
 
     **Required for MMS**

telnyx/types/message_send_group_mms_params.py

@@ -2,9 +2,9 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Required, Annotated, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = ["MessageSendGroupMmsParams"]
@@ -14,10 +14,10 @@ class MessageSendGroupMmsParams(TypedDict, total=False):
     from_: Required[Annotated[str, PropertyInfo(alias="from")]]
     """Phone number, in +E.164 format, used to send the message."""
 
-    to: Required[List[str]]
+    to: Required[SequenceNotStr[str]]
     """A list of destinations. No more than 8 destinations are allowed."""
 
-    media_urls: List[str]
+    media_urls: SequenceNotStr[str]
     """A list of media URLs. The total media size must be less than 1 MB."""
 
     subject: str

telnyx/types/message_send_long_code_params.py

@@ -2,9 +2,9 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = ["MessageSendLongCodeParams"]
@@ -23,7 +23,7 @@ class MessageSendLongCodeParams(TypedDict, total=False):
     recommended limit of message parts.
     """
 
-    media_urls: List[str]
+    media_urls: SequenceNotStr[str]
     """A list of media URLs. The total media size must be less than 1 MB.
 
     **Required for MMS**

telnyx/types/message_send_number_pool_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal, Required, TypedDict
 
+from .._types import SequenceNotStr
+
 __all__ = ["MessageSendNumberPoolParams"]
 
 
@@ -21,7 +22,7 @@ class MessageSendNumberPoolParams(TypedDict, total=False):
     recommended limit of message parts.
     """
 
-    media_urls: List[str]
+    media_urls: SequenceNotStr[str]
     """A list of media URLs. The total media size must be less than 1 MB.
 
     **Required for MMS**

telnyx/types/message_send_params.py

@@ -2,10 +2,11 @@
 
 from __future__ import annotations
 
-from typing import List, Union
+from typing import Union
 from datetime import datetime
 from typing_extensions import Literal, Required, Annotated, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = ["MessageSendParams"]
@@ -30,7 +31,7 @@ class MessageSendParams(TypedDict, total=False):
     ID.**
     """
 
-    media_urls: List[str]
+    media_urls: SequenceNotStr[str]
     """A list of media URLs. The total media size must be less than 1 MB.
 
     **Required for MMS**