sendly 3.21.1 → 3.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ecce7836de0fe84c6c10ac40b1fa6da2623280863271baf3db46cade5c9cdcee
-  data.tar.gz: a4ec369ee6ead60e8999e446d2be7945684b63b1fc680688720f25dc602567b1
+  metadata.gz: 2dc2c09c04faa2543613b476696a2106e1a7e2edd16a788bd0f16bb3ba8c3c56
+  data.tar.gz: d9a9c53078fb5a52272abaaf989cec2c95f59cc73d0c7046a3018371c1df3434
 SHA512:
-  metadata.gz: '0682b8f55f344db0effff21d4ba7bdd5a501a522719af9fcd51968e1eb76e3b33ec1fa747a50219a4aab7ced7a32b879d7b6923e36bde1ce5d718e406ffcfa92'
-  data.tar.gz: 424e836b39344a0e31e0861719d09f3784673c057763fdac923d1b41ab0840e3eb4c2652f25b9b35c2c3bc7ee89930f6e7291363e21647a7733f5a6c9c940367
+  metadata.gz: 00a1a0fbbcd66dc72009109dcb3dae50615c59a01cf1290461d1a0d95857f117fad8190e3ffaa7641810abb624c9eab145f2b1e942d19953ef02c9ef9df57a1b
+  data.tar.gz: b75222058daa05a0e408cf4f054e68c7dfb83203894daabfdf42e1fc1f5cd50fec806bc2fe875eb8199df042df1c2a14240779298387c69159bdd12129a58afd

data/Gemfile.lock

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

data/lib/sendly/client.rb

@@ -100,6 +100,27 @@ module Sendly
       @contacts ||= ContactsResource.new(self)
     end
 
+    # Access the Conversations resource
+    #
+    # @return [Sendly::ConversationsResource]
+    def conversations
+      @conversations ||= ConversationsResource.new(self)
+    end
+
+    # Access the Labels resource
+    #
+    # @return [Sendly::LabelsResource]
+    def labels
+      @labels ||= LabelsResource.new(self)
+    end
+
+    # Access the Drafts resource
+    #
+    # @return [Sendly::DraftsResource]
+    def drafts
+      @drafts ||= DraftsResource.new(self)
+    end
+
     # Access the Enterprise resource
     #
     # @return [Sendly::EnterpriseResource]

data/lib/sendly/conversations_resource.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+module Sendly
+  class ConversationsResource
+    def initialize(client)
+      @client = client
+    end
+
+    def list(limit: 20, offset: 0, status: nil)
+      params = {
+        limit: [limit, 100].min,
+        offset: offset
+      }
+      params[:status] = status if status
+
+      response = @client.get("/conversations", params.compact)
+      ConversationList.new(response)
+    end
+
+    def get(id, include_messages: false, message_limit: nil, message_offset: nil)
+      raise ValidationError, "Conversation ID is required" if id.nil? || id.empty?
+
+      params = {}
+      params[:include_messages] = true if include_messages
+      params[:message_limit] = message_limit if message_limit
+      params[:message_offset] = message_offset if message_offset
+
+      encoded_id = URI.encode_www_form_component(id)
+      response = @client.get("/conversations/#{encoded_id}", params.compact)
+      ConversationWithMessages.new(response)
+    end
+
+    def reply(id, text:, media_urls: nil, metadata: nil)
+      raise ValidationError, "Conversation ID is required" if id.nil? || id.empty?
+      raise ValidationError, "Message text is required" if text.nil? || text.empty?
+
+      body = { text: text }
+      body[:mediaUrls] = media_urls if media_urls
+      body[:metadata] = metadata if metadata
+
+      encoded_id = URI.encode_www_form_component(id)
+      response = @client.post("/conversations/#{encoded_id}/messages", body)
+      Message.new(response)
+    end
+
+    def update(id, metadata: nil, tags: nil)
+      raise ValidationError, "Conversation ID is required" if id.nil? || id.empty?
+
+      body = {}
+      body[:metadata] = metadata unless metadata.nil?
+      body[:tags] = tags unless tags.nil?
+
+      encoded_id = URI.encode_www_form_component(id)
+      response = @client.patch("/conversations/#{encoded_id}", body)
+      Conversation.new(response)
+    end
+
+    def close(id)
+      raise ValidationError, "Conversation ID is required" if id.nil? || id.empty?
+
+      encoded_id = URI.encode_www_form_component(id)
+      response = @client.post("/conversations/#{encoded_id}/close")
+      Conversation.new(response)
+    end
+
+    def reopen(id)
+      raise ValidationError, "Conversation ID is required" if id.nil? || id.empty?
+
+      encoded_id = URI.encode_www_form_component(id)
+      response = @client.post("/conversations/#{encoded_id}/reopen")
+      Conversation.new(response)
+    end
+
+    def mark_read(id)
+      raise ValidationError, "Conversation ID is required" if id.nil? || id.empty?
+
+      encoded_id = URI.encode_www_form_component(id)
+      response = @client.post("/conversations/#{encoded_id}/mark-read")
+      Conversation.new(response)
+    end
+
+    def add_labels(id, label_ids:)
+      raise ValidationError, "Conversation ID is required" if id.nil? || id.empty?
+      raise ValidationError, "Label IDs are required" if label_ids.nil? || label_ids.empty?
+
+      encoded_id = URI.encode_www_form_component(id)
+      @client.post("/conversations/#{encoded_id}/labels", { labelIds: label_ids })
+    end
+
+    def remove_label(id, label_id:)
+      raise ValidationError, "Conversation ID is required" if id.nil? || id.empty?
+      raise ValidationError, "Label ID is required" if label_id.nil? || label_id.empty?
+
+      encoded_id = URI.encode_www_form_component(id)
+      encoded_label_id = URI.encode_www_form_component(label_id)
+      @client.delete("/conversations/#{encoded_id}/labels/#{encoded_label_id}")
+    end
+
+    def each(status: nil, batch_size: 100, &block)
+      return enum_for(:each, status: status, batch_size: batch_size) unless block_given?
+
+      offset = 0
+      loop do
+        page = list(limit: batch_size, offset: offset, status: status)
+        page.each(&block)
+
+        break unless page.has_more
+
+        offset += batch_size
+      end
+    end
+  end
+end

data/lib/sendly/drafts_resource.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Sendly
+  class DraftsResource
+    def initialize(client)
+      @client = client
+    end
+
+    def create(conversation_id:, text:, media_urls: nil, metadata: nil, source: nil)
+      body = { conversationId: conversation_id, text: text }
+      body[:mediaUrls] = media_urls if media_urls
+      body[:metadata] = metadata if metadata
+      body[:source] = source if source
+
+      response = @client.post("/drafts", body)
+      Draft.new(response)
+    end
+
+    def list(conversation_id: nil, status: nil, limit: nil, offset: nil)
+      params = {}
+      params[:conversation_id] = conversation_id if conversation_id
+      params[:status] = status if status
+      params[:limit] = limit if limit
+      params[:offset] = offset if offset
+
+      response = @client.get("/drafts", params.compact)
+      DraftList.new(response)
+    end
+
+    def get(id)
+      raise ValidationError, "Draft ID is required" if id.nil? || id.empty?
+
+      response = @client.get("/drafts/#{URI.encode_www_form_component(id)}")
+      Draft.new(response)
+    end
+
+    def update(id, text: nil, media_urls: nil, metadata: nil)
+      raise ValidationError, "Draft ID is required" if id.nil? || id.empty?
+
+      body = {}
+      body[:text] = text if text
+      body[:mediaUrls] = media_urls if media_urls
+      body[:metadata] = metadata unless metadata.nil?
+
+      response = @client.patch("/drafts/#{URI.encode_www_form_component(id)}", body)
+      Draft.new(response)
+    end
+
+    def approve(id)
+      raise ValidationError, "Draft ID is required" if id.nil? || id.empty?
+
+      response = @client.post("/drafts/#{URI.encode_www_form_component(id)}/approve")
+      Draft.new(response)
+    end
+
+    def reject(id, reason: nil)
+      raise ValidationError, "Draft ID is required" if id.nil? || id.empty?
+
+      body = {}
+      body[:reason] = reason if reason
+
+      response = @client.post("/drafts/#{URI.encode_www_form_component(id)}/reject", body)
+      Draft.new(response)
+    end
+  end
+end

data/lib/sendly/labels_resource.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Sendly
+  class LabelsResource
+    def initialize(client)
+      @client = client
+    end
+
+    def create(name:, color: nil, description: nil)
+      body = { name: name }
+      body[:color] = color if color
+      body[:description] = description if description
+
+      response = @client.post("/labels", body)
+      Label.new(response)
+    end
+
+    def list
+      response = @client.get("/labels")
+      (response["data"] || []).map { |l| Label.new(l) }
+    end
+
+    def delete(id)
+      raise ValidationError, "Label ID is required" if id.nil? || id.empty?
+
+      @client.delete("/labels/#{URI.encode_www_form_component(id)}")
+    end
+  end
+end

data/lib/sendly/types.rb

@@ -36,7 +36,7 @@ module Sendly
     # @return [String, nil] How the message was sent (number_pool, alphanumeric, sandbox)
     attr_reader :sender_type
 
-    # @return [String, nil] Telnyx message ID for tracking
+    # @return [String, nil] Carrier message ID for tracking
     attr_reader :telnyx_message_id
 
     # @return [String, nil] Warning message
@@ -60,6 +60,9 @@ module Sendly
     # @return [Hash, nil] Custom metadata attached to the message
     attr_reader :metadata
 
+    # @return [Hash, nil] AI classification metadata for inbound messages
+    attr_reader :ai_metadata
+
     # Message status constants (sending removed - doesn't exist in database)
     STATUSES = %w[queued sent delivered failed bounced retrying].freeze
 
@@ -86,6 +89,7 @@ module Sendly
       @error_code = data["errorCode"]
       @retry_count = data["retryCount"] || 0
       @metadata = data["metadata"]
+      @ai_metadata = data["aiMetadata"]
     end
 
     # Check if message was delivered
@@ -128,7 +132,8 @@ module Sendly
         delivered_at: delivered_at&.iso8601,
         error_code: error_code,
         retry_count: retry_count,
-        metadata: metadata
+        metadata: metadata,
+        ai_metadata: ai_metadata
       }.compact
     end
 
@@ -495,4 +500,250 @@ module Sendly
       nil
     end
   end
+
+  # ============================================================================
+  # Conversations
+  # ============================================================================
+
+  class Conversation
+    attr_reader :id, :phone_number, :status, :unread_count, :message_count,
+                :last_message_text, :last_message_at, :last_message_direction,
+                :metadata, :tags, :contact_id, :created_at, :updated_at
+
+    STATUSES = %w[active closed].freeze
+
+    def initialize(data)
+      @id = data["id"]
+      @phone_number = data["phoneNumber"] || data["phone_number"]
+      @status = data["status"]
+      @unread_count = data["unreadCount"] || data["unread_count"] || 0
+      @message_count = data["messageCount"] || data["message_count"] || 0
+      @last_message_text = data["lastMessageText"] || data["last_message_text"]
+      @last_message_at = parse_time(data["lastMessageAt"] || data["last_message_at"])
+      @last_message_direction = data["lastMessageDirection"] || data["last_message_direction"]
+      @metadata = data["metadata"] || {}
+      @tags = data["tags"] || []
+      @contact_id = data["contactId"] || data["contact_id"]
+      @created_at = parse_time(data["createdAt"] || data["created_at"])
+      @updated_at = parse_time(data["updatedAt"] || data["updated_at"])
+    end
+
+    def active?
+      status == "active"
+    end
+
+    def closed?
+      status == "closed"
+    end
+
+    def to_h
+      {
+        id: id, phone_number: phone_number, status: status,
+        unread_count: unread_count, message_count: message_count,
+        last_message_text: last_message_text,
+        last_message_at: last_message_at&.iso8601,
+        last_message_direction: last_message_direction,
+        metadata: metadata, tags: tags, contact_id: contact_id,
+        created_at: created_at&.iso8601, updated_at: updated_at&.iso8601
+      }.compact
+    end
+
+    private
+
+    def parse_time(value)
+      return nil if value.nil?
+      Time.parse(value)
+    rescue ArgumentError
+      nil
+    end
+  end
+
+  class ConversationList
+    include Enumerable
+
+    attr_reader :data, :total, :limit, :offset, :has_more
+
+    def initialize(response)
+      @data = (response["data"] || []).map { |c| Conversation.new(c) }
+      pagination = response["pagination"] || {}
+      @total = pagination["total"] || @data.length
+      @limit = pagination["limit"] || 20
+      @offset = pagination["offset"] || 0
+      @has_more = pagination["hasMore"] || pagination["has_more"] || false
+    end
+
+    def each(&block)
+      data.each(&block)
+    end
+
+    def count
+      data.length
+    end
+
+    alias size count
+    alias length count
+
+    def empty?
+      data.empty?
+    end
+
+    def first
+      data.first
+    end
+
+    def last
+      data.last
+    end
+  end
+
+  # ============================================================================
+  # Labels
+  # ============================================================================
+
+  class Label
+    attr_reader :id, :name, :color, :description, :created_at
+
+    def initialize(data)
+      @id = data["id"]
+      @name = data["name"]
+      @color = data["color"]
+      @description = data["description"]
+      @created_at = parse_time(data["createdAt"] || data["created_at"])
+    end
+
+    def to_h
+      {
+        id: id, name: name, color: color, description: description,
+        created_at: created_at&.iso8601
+      }.compact
+    end
+
+    private
+
+    def parse_time(value)
+      return nil if value.nil?
+      Time.parse(value)
+    rescue ArgumentError
+      nil
+    end
+  end
+
+  # ============================================================================
+  # Drafts
+  # ============================================================================
+
+  class Draft
+    attr_reader :id, :conversation_id, :text, :media_urls, :metadata, :status,
+                :source, :created_by, :reviewed_by, :reviewed_at,
+                :rejection_reason, :message_id, :created_at, :updated_at
+
+    STATUSES = %w[pending approved rejected sent failed].freeze
+
+    def initialize(data)
+      @id = data["id"]
+      @conversation_id = data["conversationId"] || data["conversation_id"]
+      @text = data["text"]
+      @media_urls = data["mediaUrls"] || data["media_urls"] || []
+      @metadata = data["metadata"] || {}
+      @status = data["status"]
+      @source = data["source"]
+      @created_by = data["createdBy"] || data["created_by"]
+      @reviewed_by = data["reviewedBy"] || data["reviewed_by"]
+      @reviewed_at = parse_time(data["reviewedAt"] || data["reviewed_at"])
+      @rejection_reason = data["rejectionReason"] || data["rejection_reason"]
+      @message_id = data["messageId"] || data["message_id"]
+      @created_at = parse_time(data["createdAt"] || data["created_at"])
+      @updated_at = parse_time(data["updatedAt"] || data["updated_at"])
+    end
+
+    def pending?
+      status == "pending"
+    end
+
+    def approved?
+      status == "approved"
+    end
+
+    def rejected?
+      status == "rejected"
+    end
+
+    def to_h
+      {
+        id: id, conversation_id: conversation_id, text: text,
+        media_urls: media_urls, metadata: metadata, status: status,
+        source: source, created_by: created_by, reviewed_by: reviewed_by,
+        reviewed_at: reviewed_at&.iso8601, rejection_reason: rejection_reason,
+        message_id: message_id, created_at: created_at&.iso8601,
+        updated_at: updated_at&.iso8601
+      }.compact
+    end
+
+    private
+
+    def parse_time(value)
+      return nil if value.nil?
+      Time.parse(value)
+    rescue ArgumentError
+      nil
+    end
+  end
+
+  class DraftList
+    include Enumerable
+
+    attr_reader :data, :total, :limit, :offset, :has_more
+
+    def initialize(response)
+      @data = (response["data"] || []).map { |d| Draft.new(d) }
+      pagination = response["pagination"] || {}
+      @total = pagination["total"] || @data.length
+      @limit = pagination["limit"] || 20
+      @offset = pagination["offset"] || 0
+      @has_more = pagination["hasMore"] || pagination["has_more"] || false
+    end
+
+    def each(&block)
+      data.each(&block)
+    end
+
+    def count
+      data.length
+    end
+
+    alias size count
+    alias length count
+
+    def empty?
+      data.empty?
+    end
+
+    def first
+      data.first
+    end
+
+    def last
+      data.last
+    end
+  end
+
+  class ConversationWithMessages < Conversation
+    attr_reader :messages
+
+    def initialize(data)
+      super(data)
+      if data["messages"]
+        msgs = data["messages"]
+        @messages = {
+          data: (msgs["data"] || []).map { |m| Message.new(m) },
+          pagination: {
+            total: msgs.dig("pagination", "total") || 0,
+            limit: msgs.dig("pagination", "limit") || 20,
+            offset: msgs.dig("pagination", "offset") || 0,
+            has_more: msgs.dig("pagination", "hasMore") || msgs.dig("pagination", "has_more") || false
+          }
+        }
+      end
+    end
+  end
 end

data/lib/sendly/version.rb

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

data/lib/sendly.rb

@@ -16,6 +16,9 @@ require_relative "sendly/verify"
 require_relative "sendly/templates_resource"
 require_relative "sendly/campaigns_resource"
 require_relative "sendly/contacts_resource"
+require_relative "sendly/conversations_resource"
+require_relative "sendly/labels_resource"
+require_relative "sendly/drafts_resource"
 require_relative "sendly/enterprise"
 
 # Sendly Ruby SDK

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendly
 version: !ruby/object:Gem::Version
-  version: 3.21.1
+  version: 3.23.0
 platform: ruby
 authors:
 - Sendly
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-03-13 00:00:00.000000000 Z
+date: 2026-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -128,8 +128,11 @@ files:
 - lib/sendly/campaigns_resource.rb
 - lib/sendly/client.rb
 - lib/sendly/contacts_resource.rb
+- lib/sendly/conversations_resource.rb
+- lib/sendly/drafts_resource.rb
 - lib/sendly/enterprise.rb
 - lib/sendly/errors.rb
+- lib/sendly/labels_resource.rb
 - lib/sendly/media.rb
 - lib/sendly/messages.rb
 - lib/sendly/templates_resource.rb