SignalWire.Relay.TaskingAPI

This represents the API interface for the Tasking RELAY Service. A SignalWire.Relay.RelayTask is simple way to send jobs to your SignalWire.Relay.Consumer from a short lived process, like a web framework. RELAY Tasks allow you to pass commands down to your Consumers without blocking your short lived request. Think of a RELAY Task as a way to queue a job for your background workers to processes asynchronously.

For example, if you wanted to make an outbound call and play a message when your user clicks a button on your web application, since RELAY is a realtime protocol and relies on you to tell it what to do in realtime, if you did this within your web application, your web server would block until the call was finished… this may take a long time! Instead, simply create a new RELAY Task. This task will be handled by a running RELAY Consumer process and your web application can respond back to your user immediately.

Methods

Deliver

Deliver the specified message.

Parameters

Returns

bool - true if the delivery is successfully started, false if a problem is encountered.

Examples

Send a message.

1
bool isSuccessful = client.Tasking.Deliver(
2
    validContext,
3
    new JObject() {
4
        ["number_to_call"] = "+1555XXXXXXX",
5
        ["message_to_play"] = "We have a message for you",
6
    });
7
8
if (isSuccessful)
9
{
10
    // Message has been queued, you can subscribe to TaskingAPI.OnTaskReceived to receive further updates
11
}

Events

All these events can be used to track a task.

Receive Events

SignalWire.Relay.RelayTask

A SignalWire.Relay.RelayTask is a simple way to send jobs to your SignalWire.Relay.Consumer from a short lived process, like a web framework. RELAY Tasks allow you to pass commands down to your Consumers without blocking your short lived request. Think of a RELAY Task as a way to queue a job for your background workers to processes asynchronously.

For example, if you wanted to make an outbound call and play a message when your user clicks a button on your web application, since RELAY is a realtime protocol and relies on you to tell it what to do in realtime, if you did this within your web application, your web server would block until the call was finished… this may take a long time! Instead, simply create a new RELAY Task. This task will be handled by a running RELAY Consumer process and your web application can respond back to your user immediately.

Constructor

The only constructor is the default constructor, properties should all be assigned by initializer or after construction.

Parameters

None

Examples

Basic Example

1
RelayTask task = new RelayTask
2
{
3
    SpaceID = validSpaceID,
4
    ProjectID = validProjectID,
5
    Context = validContext,
6
    Message = new JObject {
7
        ["greet"] = "Hello"
8
    },
9
}

Properties

Methods

Deliver

Deliver a message to the specified host. This is typically not used directly, TaskingAPI.Deliver is used instead.

Parameters

Returns

void

Examples

Send a message.

1
RelayTask.Deliver(validHost, validProjectID, validToken, validContext, new JObject {
2
    ["number_to_call"] = "+1555XXXXXXX",
3
    ["message_to_play"] = "We have a message for you",
4
});

Events

None