***

id: 2527e387-5b39-4977-9bfc-305c8b9f5b9e
title: 'Relay::Messaging'
slug: /ruby/reference/messaging
max-toc-depth: 3
----------------

This namespace represents the API interface for the Messaging Relay Service. It is used to send and receive text messages.

## Methods

### send

Send an outbound SMS or MMS message.

**Parameters**

| Parameter | Type   | Required | Description                                                                                                 |
| --------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------- |
| `to`      | String | required | The number you are attempting to send the message to.                                                       |
| `from`    | String | required | The phone number to place the message from. *Must be a SignalWire phone number or short code that you own.* |
| `context` | String | required | The SignalWire context on which you will receive updates about the message state.                           |
| `body`    | String | optional | The text body to send. Either `body` or `media` *must* be specified.                                        |
| `media`   | Array  | optional | An array of media URLs to send with an MMS. Either `body` or `media` *must* be specified.                   |
| `tags`    | Array  | optional | An array of tags to tag the message with. For searching in the UI and identifying messages.                 |

**Returns**

`Signalwire::Relay::Messaging::SendResult` - the result of the `send` command.

**Examples**

Send a message in the *office* context.

```ruby
result = client.messaging.send(
  from: '+1XXXXXXXXXX',
  to: '+1YYYYYYYYYY',
  context: 'office',
  body: 'SignalWire says hello!'
)

puts "Message #{result.message_id} was successfully sent" if result.successful
```