ExTwilio.Message

Represents an Message resource in the Twilio API.

Source

Summary

all(options \\ [])

Retrieve all of the Message records from the Twilio API, paging through all the API response pages

children()
create(data, options \\ [])

Create a new Message in the Twilio API. Any field supported by Twilio's Message API can be passed in the 'data' keyword list

destroy(sid, options \\ [])

Delete any Message from your Twilio account, using its SID

find(sid, options \\ [])

Find any Message by its Twilio SID

first_page(metadata)

Get the first page of messages, using metadata from any page's response

last_page(metadata)

Get the last page of messages, using metadta from any page's response

list(options \\ [])

Retrieve a list of Messages from the API

new()

Creates a new ExTwilio.Message struct. Optionally, you can pass in attributes to set their initial value in the struct

new(attrs)
next_page(metadata)

Get the next page of messages, using the metadata from the previous response. See all/0 for an easy way to get all the records

parents()
previous_page(metadata)

Get the previous page of messages, using metadata from a previous response

resource_collection_name()

Underscored and lowercased collection name for a given resource. Delegates the real work to ExTwilio.Api.resource_collection_name/1 by default

resource_name()

CamelCase resource name as it would be used in Twilio's API. Delegates the real work to ExTwilio.Api.resource_name/1 by default

stream(options \\ [])

Create a stream of all Message records from the Twilio API

update(sid, data, options \\ [])

Update an Message in the Twilio API. You can pass it a binary SID as the identifier, or a whole %ExTwilio.Message{} struct

Functions

all(options \\ [])

Specs:

  • all(list) :: [%{}]

Retrieve all of the Message records from the Twilio API, paging through all the API response pages.

Delegates to ExTwilio.Api.all/2.

Examples

messages = ExTwilio.Message.all
Source
children()

Specs:

  • children :: list
Source
create(data, options \\ [])

Specs:

Create a new Message in the Twilio API. Any field supported by Twilio's Message API can be passed in the 'data' keyword list.

Delegates to ExTwilio.Api.create/3.

Source
destroy(sid, options \\ [])

Specs:

Delete any Message from your Twilio account, using its SID.

Delegates to ExTwilio.Api.destroy/3.

Source
find(sid, options \\ [])

Specs:

Find any Message by its Twilio SID.

Delegates to ExTwilio.Api.find/3.

Examples

{:ok, message} = ExTwilio.Message.find("...")
{:error, msg, http_status} = ExTwilio.Message.find("...")
Source
first_page(metadata)

Specs:

Get the first page of messages, using metadata from any page's response.

Delegates to ExTwilio.Api.fetch_page/2.

Examples

{:ok, page10, meta} = ExTwilio.Message.list(page: 10)
{:ok, page1, meta}  = ExTwilio.Message.first_page(meta)
Source
last_page(metadata)

Specs:

Get the last page of messages, using metadta from any page's response.

Delegates to ExTwilio.Api.fetch_page/2.

Examples

{:ok, page10, meta}    = ExTwilio.Message.list(page: 10)
{:ok, last_page, meta} = ExTwilio.Message.last_page(meta)
Source
list(options \\ [])

Specs:

Retrieve a list of Messages from the API.

Delegates to ExTwilio.Api.list/2.

Examples

# Successful response
{:ok, messages, metadata} = ExTwilio.Message.list

# Error response
{:error, msg, http_code} = ExTwilio.Message.list
Source
new()

Specs:

  • new :: %ExTwilio.Message{account_sid: term, api_version: term, body: term, date_created: term, date_sent: term, date_updated: term, direction: term, error_code: term, error_message: term, from: term, num_media: term, num_segments: term, price: term, price_unit: term, sid: term, status: term, subresource_uri: term, to: term, uri: term}

Creates a new ExTwilio.Message struct. Optionally, you can pass in attributes to set their initial value in the struct.

Example

%ExTwilio.Message{} = ExTwilio.Message.new
%ExTwilio.Message{sid: "sid"} = ExTwilio.Message.new(sid: "sid")
Source
new(attrs)

Specs:

  • new(list) :: %ExTwilio.Message{account_sid: term, api_version: term, body: term, date_created: term, date_sent: term, date_updated: term, direction: term, error_code: term, error_message: term, from: term, num_media: term, num_segments: term, price: term, price_unit: term, sid: term, status: term, subresource_uri: term, to: term, uri: term}
Source
next_page(metadata)

Specs:

Get the next page of messages, using the metadata from the previous response. See all/0 for an easy way to get all the records.

Delegates to ExTwilio.Api.fetch_page/2.

Examples

{:ok, page1, meta} = ExTwilio.Message.list
{:ok, page2, meta} = ExTwilio.Message.next_page(meta)
Source
parents()

Specs:

  • parents :: list
Source
previous_page(metadata)

Specs:

Get the previous page of messages, using metadata from a previous response.

Delegates to ExTwilio.Api.fetch_page/2.

Examples

{:ok, page2, meta} = ExTwilio.Message.list(page: 2)
{:ok, page1, meta} = ExTwilio.Message.previous_page(meta)
Source
resource_collection_name()

Underscored and lowercased collection name for a given resource. Delegates the real work to ExTwilio.Api.resource_collection_name/1 by default.

Override in your module before use ExTwilio.Resource if you need something different.

Source
resource_name()

CamelCase resource name as it would be used in Twilio's API. Delegates the real work to ExTwilio.Api.resource_name/1 by default.

Override in your module before use ExTwilio.Resource if you need something different.

Source
stream(options \\ [])

Create a stream of all Message records from the Twilio API.

Delegates to ExTwilio.Api.stream/2.

Source
update(sid, data, options \\ [])

Specs:

Update an Message in the Twilio API. You can pass it a binary SID as the identifier, or a whole %ExTwilio.Message{} struct.

Delegates to ExTwilio.Api.update/4.

Examples

{:ok, message} = ExTwilio.Message.update(%ExTwilio.Message{...}, field: "new_value")
{:ok, message} = ExTwilio.Message.update("<SID HERE>", field: "new_value")
Source