#twilio #async #hyper #api-wrapper #api-bindings #api #twiml

twilio-async

An async and ergonomic wrapper around Twilio API & TwiML

7 releases (4 breaking)

0.5.0 Sep 16, 2021
0.4.1 Mar 22, 2020
0.3.0 Mar 22, 2020
0.2.0 Feb 2, 2019
0.1.1-beta Jun 30, 2018

#1959 in Network programming

Download history 641/week @ 2024-02-12 361/week @ 2024-02-19 975/week @ 2024-02-26 1174/week @ 2024-03-04 1264/week @ 2024-03-11 1350/week @ 2024-03-18 929/week @ 2024-03-25 819/week @ 2024-04-01 834/week @ 2024-04-08 795/week @ 2024-04-15 857/week @ 2024-04-22 1124/week @ 2024-04-29 851/week @ 2024-05-06 842/week @ 2024-05-13 782/week @ 2024-05-20 619/week @ 2024-05-27

3,106 downloads per month

MIT license

55KB
1.5K SLoC

twilio-async

Example Usage

An async and ergonomic wrapper around Twilio API & TwiML.

All types can run run() or a similar function. They return a value that implements Deserialize.

The examples/ dir has up to date working example code.

Messages:


#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let twilio = Twilio::new(account_sid, token)?;
    // sending a message
    twilio.send_msg("from", "to", "Hello World").run().await?;
    // sending a body-less message with media
    twilio
        .send_msg("from", "to", "body")
        .media("http://i0.kym-cdn.com/photos/images/newsfeed/000/377/946/0b9.jpg")
        .run().await?;
    // get details about a message
    twilio.msg("messagesid").run().await?;
    // redact a message
    twilio.msg("messagesid").redact().await?;
    // get a msg media url
    twilio.msg("messagesid").media().await?;
    // delete a msg
    twilio.msg("messagesid").delete().await?;
    // get all messages
    twilio.msgs().run().await?;
    // get all messages between some time
    twilio.msgs().between("start date", "end date").run().await?;
    // get all messages on a specific date
    twilio.msgs().on("date").run().await?;
}

Calls:

let twilio = Twilio::new(env::var("TWILIO_SID")?, env::var("TWILIO_TOKEN")?)?;
let (status, resp) = twilio
    .call("from", "to", "http://demo.twilio.com/docs/voice.xml")
    .run().await?;

Twiml:

use twilio_async::twiml::Response;

let resp = Response::new()
    .say("Hello World") // builder pattern also supports say(Say::new("Hello World").lang("de")...)
    .play("https://api.twilio.com/Cowbell.mp3")
    .build();
let s = "<Response><Say voice=\"man\" language=\"en\" loop=\"1\">Hello World</Say><Play loop=\"1\">https://api.twilio.com/Cowbell.mp3</Play></Response>";
assert_eq!(resp.unwrap(), s.to_string());

Contributing

There is untested code for conferences/recordings.

The TwiML work is complete and has some test coverage.

PRs and suggestions are welcome.

Dependencies

~8–20MB
~312K SLoC