sendly 3.5.2 → 3.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9f2ad54d0076b2469fdc4a1e8a92b3dc9f9f18560dadb2de6e1f413020141b7
-  data.tar.gz: a59aef91a48ade5ddc20fe421c50052478a6a81fc89ba8154d4d8c1885158bbf
+  metadata.gz: acdd7d0e32f947707ee880aa448bf6d609fdf04b0276c3db3e13eb8d437981bb
+  data.tar.gz: 2c53e468cefc039756589b372c1e1f3ba521dd0785beae1ecfdc63278c852b90
 SHA512:
-  metadata.gz: 235398343d26c88df121653069e7b26d0d9f451349c386388a9d169801b7d1f1c13be32376a0a1c95fa659827f5e60271e51031e906268e998551a9d4b2c7ff2
-  data.tar.gz: 90774d9831c0e41665ce4a499b22c5072a45512395eed8e1b545117ccad98f5c5077ff8caae75d6e38d3666944b03579cfa603b0295f9e3c55b2878d4f5de651
+  metadata.gz: a4089829bd5495482eab7d32e1ab3ffd4c8ab4ec6183eee5d865f8df12c5944d02cf47791e2403b50b44184bf8939dc47122378caaec9c5080475664523cf633
+  data.tar.gz: c6bc73e5563d6d91d3c6c13cefd5681cad855c1ba0781a60137dd5e442e77c6d12267a659f01181a360247b12ba588a1ded139352f957af02c0c0cd0624777c1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    sendly (3.5.2)
+    sendly (3.5.4)
       faraday (~> 2.0)
       faraday-retry (~> 2.0)
 

data/README.md

@@ -86,9 +86,17 @@ client = Sendly::Client.new(
 ### Send an SMS
 
 ```ruby
+# Marketing message (default)
 message = client.messages.send(
   to: "+15551234567",
-  text: "Hello from Sendly!"
+  text: "Check out our new features!"
+)
+
+# Transactional message (bypasses quiet hours)
+message = client.messages.send(
+  to: "+15551234567",
+  text: "Your verification code is: 123456",
+  message_type: "transactional"
 )
 
 puts message.id
@@ -127,6 +135,55 @@ puts message.status
 puts message.delivered_at
 ```
 
+### Scheduling Messages
+
+```ruby
+# Schedule a message for future delivery
+scheduled = client.messages.schedule(
+  to: "+15551234567",
+  text: "Your appointment is tomorrow!",
+  scheduled_at: "2025-01-15T10:00:00Z"
+)
+
+puts scheduled.id
+puts scheduled.scheduled_at
+
+# List scheduled messages
+result = client.messages.list_scheduled
+result.data.each { |msg| puts "#{msg.id}: #{msg.scheduled_at}" }
+
+# Get a specific scheduled message
+msg = client.messages.get_scheduled("sched_xxx")
+
+# Cancel a scheduled message (refunds credits)
+result = client.messages.cancel_scheduled("sched_xxx")
+puts "Refunded: #{result.credits_refunded} credits"
+```
+
+### Batch Messages
+
+```ruby
+# Send multiple messages in one API call (up to 1000)
+batch = client.messages.send_batch(
+  messages: [
+    { to: "+15551234567", text: "Hello User 1!" },
+    { to: "+15559876543", text: "Hello User 2!" },
+    { to: "+15551112222", text: "Hello User 3!" }
+  ]
+)
+
+puts batch.batch_id
+puts "Queued: #{batch.queued}"
+puts "Failed: #{batch.failed}"
+puts "Credits used: #{batch.credits_used}"
+
+# Get batch status
+status = client.messages.get_batch("batch_xxx")
+
+# List all batches
+batches = client.messages.list_batches
+```
+
 ### Iterate All Messages
 
 ```ruby
@@ -141,6 +198,66 @@ client.messages.each(status: "delivered") do |message|
 end
 ```
 
+## Webhooks
+
+```ruby
+# Create a webhook endpoint
+webhook = client.webhooks.create(
+  url: "https://example.com/webhooks/sendly",
+  events: ["message.delivered", "message.failed"]
+)
+
+puts webhook.id
+puts webhook.secret  # Store securely!
+
+# List all webhooks
+webhooks = client.webhooks.list
+
+# Get a specific webhook
+wh = client.webhooks.get("whk_xxx")
+
+# Update a webhook
+client.webhooks.update("whk_xxx",
+  url: "https://new-endpoint.example.com/webhook",
+  events: ["message.delivered", "message.failed", "message.sent"]
+)
+
+# Test a webhook
+result = client.webhooks.test("whk_xxx")
+
+# Rotate webhook secret
+rotation = client.webhooks.rotate_secret("whk_xxx")
+
+# Delete a webhook
+client.webhooks.delete("whk_xxx")
+```
+
+## Account & Credits
+
+```ruby
+# Get account information
+account = client.account.get
+puts account.email
+
+# Check credit balance
+credits = client.account.get_credits
+puts "Available: #{credits.available_balance} credits"
+puts "Reserved: #{credits.reserved_balance} credits"
+puts "Total: #{credits.balance} credits"
+
+# View credit transaction history
+result = client.account.get_credit_transactions
+result.data.each do |tx|
+  puts "#{tx.type}: #{tx.amount} credits - #{tx.description}"
+end
+
+# List API keys
+result = client.account.list_api_keys
+result.data.each do |key|
+  puts "#{key.name}: #{key.prefix}*** (#{key.type})"
+end
+```
+
 ## Error Handling
 
 ```ruby
@@ -211,11 +328,12 @@ Use test API keys (`sk_test_v1_xxx`) with these test numbers:
 
 | Number | Behavior |
 |--------|----------|
-| +15550001234 | Success |
-| +15550001001 | Invalid number |
-| +15550001002 | Carrier rejected |
-| +15550001003 | No credits |
-| +15550001004 | Rate limited |
+| +15005550000 | Success (instant) |
+| +15005550001 | Fails: invalid_number |
+| +15005550002 | Fails: unroutable_destination |
+| +15005550003 | Fails: queue_full |
+| +15005550004 | Fails: rate_limit_exceeded |
+| +15005550006 | Fails: carrier_violation |
 
 ## Requirements
 

data/lib/sendly/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sendly
-  VERSION = "3.5.2"
+  VERSION = "3.5.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendly
 version: !ruby/object:Gem::Version
-  version: 3.5.2
+  version: 3.5.4
 platform: ruby
 authors:
 - Sendly
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2025-12-26 00:00:00.000000000 Z
+date: 2026-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday