メニュー

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Twilio Ruby ヘルパーライブラリー

Deprecation notice: New functionality will only be added to the new library (Ruby Helper Library 5.x). The old library (4.x) will be officially supported until 10/15/2017. After that day, Twilio will stop providing bug fixes and Support might ask you to upgrade before debugging issues. Learn how to migrate your existing application.

The twilio-ruby helper library lets you write Ruby code to make HTTP requests to the Twilio API. If you are interested in migrating to the newer 5.x version of the Twilio Ruby Helper Library from the 4.x version, check out this guide.

このライブラリーはオープンソースのため、機能の不足やバグを見つけた場合は、twilio-ruby プロジェクトGitHub までフィードバックを頂けると助かります。

ライブラリーをインストールする

最も簡単にTwilio-RubyをRubyGemsでインストール

gem install twilio-ruby

手動インストール

もしくはtwilio-rubyのためにコピーできます。そこからライブラリをインストールします。

"Permission Denied" (権限がありません)

もしコマンドラインが"Permission Denied"のエラーを返した時上記のコマンドをsudoと共に実行して下さい。例はsudo gem install twilio-ruby

インストールをテストする

このようにSMSメッセージ送信を試します

require 'twilio-ruby'

account_sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" # Your Account SID from www.twilio.com/console
auth_token = "your_auth_token"   # Your Auth Token from www.twilio.com/console

@client = Twilio::REST::Client.new account_sid, auth_token
message = @client.messages.create(
    body: "Hello from Ruby",
    to: "+12345678901",    # Replace with your phone number
    from: "+12345678901")  # Replace with your Twilio number

puts message.sid

Gemを使う

Try the Ruby quickstarts and refer to the open source twilio-ruby specific documentation for details about the methods and classes contained in the library. Here are some simple examples of how to use the gem.

Authenticate the Client

require 'twilio-ruby'

account_sid = "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" 
auth_token = "your_auth_token" 

@client = Twilio::REST::Client.new account_sid, auth_token

Create a New Record

require 'twilio-ruby'

account_sid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
auth_token = 'your_auth_token'

# Initialize Twilio Client
@client = Twilio::REST::Client.new(account_sid, auth_token)

@call = @client.calls.create(
  url: 'http://demo.twilio.com/docs/voice.xml',
  to: '+14155551212',
  from: '+15017250604'
)

puts @call.sid

Get Existing Record

require 'twilio-ruby'

account_sid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
auth_token = 'your_auth_token'

# Initialize Twilio Client
@client = Twilio::REST::Client.new(account_sid, auth_token)

@call = @client.api.calls('CA42ed11f93dc08b952027ffbc406d0868').fetch

puts @call.to

Iterate Through Records

require 'twilio-ruby'

account_sid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
auth_token = 'your_auth_token'

# Initialize Twilio Client
@client = Twilio::REST::Client.new(account_sid, auth_token)

@client.calls.list
       .each do |call|
         puts call.direction
       end

例外ハンドリング

Twilio APIが400, 500番台のHTTPレスポンスを返した場合 twilio-rubyライブラリーはTwilio::REST::RequestErrorを返します。400番代のエラーは通常のエラーで(無効な番号、 SMSを送信できない番号など)あり、 適切に取り扱われるべきです。

require 'twilio-ruby'

account_sid = "{{ account_sid }}" # Your Account SID from www.twilio.com/console
auth_token = "auth_token"   # Your Auth Token from www.twilio.com/console

begin
    @client = Twilio::REST::Client.new account_sid, auth_token
    message = @client.messages.create(
        body: "Hello from Ruby",
        to: "+12345678901",    # Replace with your phone number
        from: "+12345678901")  # Replace with your Twilio number
rescue Twilio::REST::TwilioError => e
    puts e.message
end

追加ドキュメント

Twilioがどう動作するのか知りたい場合、もしくは構築に興味を持った場合、Rubyクイックスタートにトライしましょう。

残りのAPIドキュメントはRubyで、Twilio APIで取ることのできるいずれのアクション毎に書かれています。Rubyライブラリーでできることを知るためにここからスタートしましょう。

モジュールに含まれる機能の詳細をオープンソースtwilio-rubyのドキュメントでご覧いただけます。

バージョン4.xのヘルパーライブラリーにアクセスする

Rubyヘルパーライブラリーの最新バージョンは、以前開発されたTwilioアプリケーションで使用されていた可能性のある4.xバージョンとAPIの互換性がありません。 旧バージョンは引き続き機能し、引き続きドキュメント全体にわたってサンプルコードをご利用いただけます。 このバージョンのインストールが必要な場合、下記コマンドで行います。

gem install twilio-ruby -v 4.13.0

お問い合わせ

まだ問題がありますか?

Rate this page:

ヘルプが必要ですか?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.