verb.sh [Ruby Client]

The official Ruby Client for the Verb messaging platform.

gem install verb-rb

• Ruby 2.3.0+

require 'verb'

Verb.configure(token: '<Project API Key>')

The API is non-blocking so you can simply send and forget. The processing happens in the background on a highly efficient queue system.

message = Verb.email({
  to: 'me@me.com', text: 'Email Text', html: 'Email HTML', subject: 'Testing!'
})

message.send

Files can only be attached to email messages (this is also dependent on the service you are using to send the emails). Only pass the path to the file.

message = Verb.email({
  to: 'me@me.com', text: 'Email Text', html: 'Email HTML', subject: 'Testing!'
})

message.attach('file.pdf')

# OR

message.attach(['file1.pdf', 'file2.pdf'])

# OR

message.attach('file1.pdf')
message.attach('file2.pdf')
message.attach('file3.pdf')

message.send

These file types are generally not allowed and will be blocked.

vbs, exe, bin, bat, chm, com, cpl,
crt, hlp, hta, inf, ins, isp, jse,
lnk, mdb, pcd, pif, reg, scr, sct,
shs, vbe, vba, wsf, wsh, wsl, msc,
msi, msp, mst

Verb has a built-in scheduler that allows you schedule messages to be delivered in the future. These are quite useful in the sense that you can target future user behavior or events.

message = Verb.email({
  to: 'me@me.com', text: 'Email Text', html: 'Email HTML', subject: 'Testing!'
})

message.send(in: '1h')

There is no limit to how far in the future a message can be scheduled for.

Schedule Examples:

• '1h' # 1 hour
• '1h20m' # 1 hour 20 minutes
• '3Y2W' # 3 years 2 weeks

Available Date Tokens:

• 's' seconds
• 'h' hours
• 'm' minutes
• 'D' days
• 'M' months
• 'W' weeks
• 'Y' years

message = Verb.sms({
  to: '+20830000000', text: 'SMS Text'
})

message.send(in: '1h')

Templates are a powerful way to add reusable message (SMS / Email) templates on the server side where you can edit content without requiring direct access to source code or perform re-deployments.

Templates are available for the following message types:

• Email Messages
• SMS Messages

Example:

message = Verb.sms({
  template: 'welcome-sms-template', to: '+20830000000', data: { name: 'My Name', other: 'More data' }
})

message.send(in: '20m')

Templates are created in the Verb admin dashboard using Text, HTML or Mustache. If your template contains variables, you can specify these by adding a data: {} field into the parameters list.

The SDK has purposely been kept simple to use in attempt to keep code as minimal as possible. There are however two additional methods that can be used to determine if messages were sent successfully.

puts message.status  # Integer, the response code from the API
puts message.sent?   # Boolean, based on if the message was sent or not
puts message.error   # Hash, contains all the error details from the API if a message was not delivered

To test the current stable version of verb-sh, simply run:

rake test

Please see LICENSE for licensing details.

Sean Nieuwoudt, @seannieuwoudt