Class: Telnyx::Resources::Messages

Inherits:
Object
  • Object
show all
Defined in:
lib/telnyx/resources/messages.rb,
lib/telnyx/resources/messages/rcs.rb

Defined Under Namespace

Classes: Rcs

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(client:) ⇒ Messages

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of Messages.

Parameters:



358
359
360
361
 
# File 'lib/telnyx/resources/messages.rb', line 358

def initialize(client:)
  @client = client
  @rcs = Telnyx::Resources::Messages::Rcs.new(client: client)
end

Instance Attribute Details

#rcs ⇒ Telnyx::Resources::Messages::Rcs (readonly)

Returns:



7
8
9
 
# File 'lib/telnyx/resources/messages.rb', line 7

def rcs
  @rcs
end

Instance Method Details

#cancel_scheduled(id, request_options: {}) ⇒ Telnyx::Models::MessageCancelScheduledResponse

Cancel a scheduled message that has not yet been sent. Only messages with ‘status=scheduled` and `send_at` more than a minute from now can be cancelled.

Parameters:

  • id (String) —

    The id of the message to cancel

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



44
45
46
47
48
49
50
51
 
# File 'lib/telnyx/resources/messages.rb', line 44

def cancel_scheduled(id, params = {})
  @client.request(
    method: :delete,
    path: ["messages/%1$s", id],
    model: Telnyx::Models::MessageCancelScheduledResponse,
    options: params[:request_options]
  )
end

#retrieve(id, request_options: {}) ⇒ Telnyx::Models::MessageRetrieveResponse

Note: This API endpoint can only retrieve messages that are no older than 10 days since their creation. If you require messages older than this, please generate an [MDR report.](developers.telnyx.com/api-reference/mdr-usage-reports/create-mdr-usage-report)

Parameters:

Returns:

See Also:



23
24
25
26
27
28
29
30
 
# File 'lib/telnyx/resources/messages.rb', line 23

def retrieve(id, params = {})
  @client.request(
    method: :get,
    path: ["messages/%1$s", id],
    model: Telnyx::Models::MessageRetrieveResponse,
    options: params[:request_options]
  )
end

#schedule(to:, auto_detect: nil, from: nil, media_urls: nil, messaging_profile_id: nil, send_at: nil, subject: nil, text: nil, type: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {}) ⇒ Telnyx::Models::MessageScheduleResponse

Some parameter documentations has been truncated, see Models::MessageScheduleParams for more details.

Schedule a message with a Phone Number, Alphanumeric Sender ID, Short Code or Number Pool.

This endpoint allows you to schedule a message with any messaging resource. Current messaging resources include: long-code, short-code, number-pool, and alphanumeric-sender-id.

Parameters:

  • to (String) —

    Receiving address (+E.164 formatted phone number or short code).

  • auto_detect (Boolean) —

    Automatically detect if an SMS message is unusually long and exceeds a recommend

  • from (String) —

    Sending address (+E.164 formatted phone number, alphanumeric sender ID, or short

  • media_urls (Array<String>) —

    A list of media URLs. The total media size must be less than 1 MB.

  • messaging_profile_id (String) —

    Unique identifier for a messaging profile.

  • send_at (Time) —

    ISO 8601 formatted date indicating when to send the message - accurate up till a

  • subject (String) —

    Subject of multimedia message

  • text (String) —

    Message body (i.e., content) as a non-empty string.

  • type (Symbol, Telnyx::Models::MessageScheduleParams::Type) —

    The protocol for sending the message, either SMS or MMS.

  • use_profile_webhooks (Boolean) —

    If the profile this number is associated with has webhooks, use them for deliver

  • webhook_failover_url (String) —

    The failover URL where webhooks related to this message will be sent if sending

  • webhook_url (String) —

    The URL where webhooks related to this message will be sent.

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



94
95
96
97
98
99
100
101
102
103
 
# File 'lib/telnyx/resources/messages.rb', line 94

def schedule(params)
  parsed, options = Telnyx::MessageScheduleParams.dump_request(params)
  @client.request(
    method: :post,
    path: "messages/schedule",
    body: parsed,
    model: Telnyx::Models::MessageScheduleResponse,
    options: options
  )
end

#send_(to:, auto_detect: nil, from: nil, media_urls: nil, messaging_profile_id: nil, send_at: nil, subject: nil, text: nil, type: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {}) ⇒ Telnyx::Models::MessageSendResponse

Some parameter documentations has been truncated, see Models::MessageSendParams for more details.

Send a message with a Phone Number, Alphanumeric Sender ID, Short Code or Number Pool.

This endpoint allows you to send a message with any messaging resource. Current messaging resources include: long-code, short-code, number-pool, and alphanumeric-sender-id.

Parameters:

  • to (String) —

    Receiving address (+E.164 formatted phone number or short code).

  • auto_detect (Boolean) —

    Automatically detect if an SMS message is unusually long and exceeds a recommend

  • from (String) —

    Sending address (+E.164 formatted phone number, alphanumeric sender ID, or short

  • media_urls (Array<String>) —

    A list of media URLs. The total media size must be less than 1 MB.

  • messaging_profile_id (String) —

    Unique identifier for a messaging profile.

  • send_at (Time, nil) —

    ISO 8601 formatted date indicating when to send the message - accurate up till a

  • subject (String) —

    Subject of multimedia message

  • text (String) —

    Message body (i.e., content) as a non-empty string.

  • type (Symbol, Telnyx::Models::MessageSendParams::Type) —

    The protocol for sending the message, either SMS or MMS.

  • use_profile_webhooks (Boolean) —

    If the profile this number is associated with has webhooks, use them for deliver

  • webhook_failover_url (String) —

    The failover URL where webhooks related to this message will be sent if sending

  • webhook_url (String) —

    The URL where webhooks related to this message will be sent.

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



146
147
148
149
150
151
152
153
154
155
 
# File 'lib/telnyx/resources/messages.rb', line 146

def send_(params)
  parsed, options = Telnyx::MessageSendParams.dump_request(params)
  @client.request(
    method: :post,
    path: "messages",
    body: parsed,
    model: Telnyx::Models::MessageSendResponse,
    options: options
  )
end

#send_group_mms(from:, to:, media_urls: nil, subject: nil, text: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {}) ⇒ Telnyx::Models::MessageSendGroupMmsResponse

Some parameter documentations has been truncated, see Models::MessageSendGroupMmsParams for more details.

Send a group MMS message

Parameters:

  • from (String) —

    Phone number, in +E.164 format, used to send the message.

  • to (Array<String>) —

    A list of destinations. No more than 8 destinations are allowed.

  • media_urls (Array<String>) —

    A list of media URLs. The total media size must be less than 1 MB.

  • subject (String) —

    Subject of multimedia message

  • text (String) —

    Message body (i.e., content) as a non-empty string.

  • use_profile_webhooks (Boolean) —

    If the profile this number is associated with has webhooks, use them for deliver

  • webhook_failover_url (String) —

    The failover URL where webhooks related to this message will be sent if sending

  • webhook_url (String) —

    The URL where webhooks related to this message will be sent.

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



185
186
187
188
189
190
191
192
193
194
 
# File 'lib/telnyx/resources/messages.rb', line 185

def send_group_mms(params)
  parsed, options = Telnyx::MessageSendGroupMmsParams.dump_request(params)
  @client.request(
    method: :post,
    path: "messages/group_mms",
    body: parsed,
    model: Telnyx::Models::MessageSendGroupMmsResponse,
    options: options
  )
end

#send_long_code(from:, to:, auto_detect: nil, media_urls: nil, subject: nil, text: nil, type: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {}) ⇒ Telnyx::Models::MessageSendLongCodeResponse

Some parameter documentations has been truncated, see Models::MessageSendLongCodeParams for more details.

Send a long code message

Parameters:

  • from (String) —

    Phone number, in +E.164 format, used to send the message.

  • to (String) —

    Receiving address (+E.164 formatted phone number or short code).

  • auto_detect (Boolean) —

    Automatically detect if an SMS message is unusually long and exceeds a recommend

  • media_urls (Array<String>) —

    A list of media URLs. The total media size must be less than 1 MB.

  • subject (String) —

    Subject of multimedia message

  • text (String) —

    Message body (i.e., content) as a non-empty string.

  • type (Symbol, Telnyx::Models::MessageSendLongCodeParams::Type) —

    The protocol for sending the message, either SMS or MMS.

  • use_profile_webhooks (Boolean) —

    If the profile this number is associated with has webhooks, use them for deliver

  • webhook_failover_url (String) —

    The failover URL where webhooks related to this message will be sent if sending

  • webhook_url (String) —

    The URL where webhooks related to this message will be sent.

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



228
229
230
231
232
233
234
235
236
237
 
# File 'lib/telnyx/resources/messages.rb', line 228

def send_long_code(params)
  parsed, options = Telnyx::MessageSendLongCodeParams.dump_request(params)
  @client.request(
    method: :post,
    path: "messages/long_code",
    body: parsed,
    model: Telnyx::Models::MessageSendLongCodeResponse,
    options: options
  )
end

#send_number_pool(messaging_profile_id:, to:, auto_detect: nil, media_urls: nil, subject: nil, text: nil, type: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {}) ⇒ Telnyx::Models::MessageSendNumberPoolResponse

Some parameter documentations has been truncated, see Models::MessageSendNumberPoolParams for more details.

Send a message using number pool

Parameters:

  • messaging_profile_id (String) —

    Unique identifier for a messaging profile.

  • to (String) —

    Receiving address (+E.164 formatted phone number or short code).

  • auto_detect (Boolean) —

    Automatically detect if an SMS message is unusually long and exceeds a recommend

  • media_urls (Array<String>) —

    A list of media URLs. The total media size must be less than 1 MB.

  • subject (String) —

    Subject of multimedia message

  • text (String) —

    Message body (i.e., content) as a non-empty string.

  • type (Symbol, Telnyx::Models::MessageSendNumberPoolParams::Type) —

    The protocol for sending the message, either SMS or MMS.

  • use_profile_webhooks (Boolean) —

    If the profile this number is associated with has webhooks, use them for deliver

  • webhook_failover_url (String) —

    The failover URL where webhooks related to this message will be sent if sending

  • webhook_url (String) —

    The URL where webhooks related to this message will be sent.

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



271
272
273
274
275
276
277
278
279
280
 
# File 'lib/telnyx/resources/messages.rb', line 271

def send_number_pool(params)
  parsed, options = Telnyx::MessageSendNumberPoolParams.dump_request(params)
  @client.request(
    method: :post,
    path: "messages/number_pool",
    body: parsed,
    model: Telnyx::Models::MessageSendNumberPoolResponse,
    options: options
  )
end

#send_short_code(from:, to:, auto_detect: nil, media_urls: nil, subject: nil, text: nil, type: nil, use_profile_webhooks: nil, webhook_failover_url: nil, webhook_url: nil, request_options: {}) ⇒ Telnyx::Models::MessageSendShortCodeResponse

Some parameter documentations has been truncated, see Models::MessageSendShortCodeParams for more details.

Send a short code message

Parameters:

  • from (String) —

    Phone number, in +E.164 format, used to send the message.

  • to (String) —

    Receiving address (+E.164 formatted phone number or short code).

  • auto_detect (Boolean) —

    Automatically detect if an SMS message is unusually long and exceeds a recommend

  • media_urls (Array<String>) —

    A list of media URLs. The total media size must be less than 1 MB.

  • subject (String) —

    Subject of multimedia message

  • text (String) —

    Message body (i.e., content) as a non-empty string.

  • type (Symbol, Telnyx::Models::MessageSendShortCodeParams::Type) —

    The protocol for sending the message, either SMS or MMS.

  • use_profile_webhooks (Boolean) —

    If the profile this number is associated with has webhooks, use them for deliver

  • webhook_failover_url (String) —

    The failover URL where webhooks related to this message will be sent if sending

  • webhook_url (String) —

    The URL where webhooks related to this message will be sent.

  • request_options (Telnyx::RequestOptions, Hash{Symbol=>Object}, nil)

Returns:

See Also:



314
315
316
317
318
319
320
321
322
323
 
# File 'lib/telnyx/resources/messages.rb', line 314

def send_short_code(params)
  parsed, options = Telnyx::MessageSendShortCodeParams.dump_request(params)
  @client.request(
    method: :post,
    path: "messages/short_code",
    body: parsed,
    model: Telnyx::Models::MessageSendShortCodeResponse,
    options: options
  )
end

#send_whatsapp(from:, to:, whatsapp_message:, type: nil, webhook_url: nil, request_options: {}) ⇒ Telnyx::Models::MessageSendWhatsappResponse

Send a Whatsapp message

Parameters:

Returns:

See Also:



344
345
346
347
348
349
350
351
352
353
 
# File 'lib/telnyx/resources/messages.rb', line 344

def send_whatsapp(params)
  parsed, options = Telnyx::MessageSendWhatsappParams.dump_request(params)
  @client.request(
    method: :post,
    path: "messages/whatsapp",
    body: parsed,
    model: Telnyx::Models::MessageSendWhatsappResponse,
    options: options
  )
end