postproxy-sdk 1.10.0 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2852d366a306a698457955ea9e631fb4cd05fbc0f55949a772f0b872b19ce0af
-  data.tar.gz: 74845607657bcea29116fe1a3d509daea04f0afba3e0ded079068f03b17d3506
+  metadata.gz: c459486395f3eed2f4199f1946ed7a71c7b6b5de5ae270e46b088e779c772459
+  data.tar.gz: 38788f6fd45363f0c229af3cd7fd28a79a21511d1a7b8c4c417bb2d0c5c93f48
 SHA512:
-  metadata.gz: 0650f24d42af376d663521ced5c78be0fe97dc99d117534a132479a02f8290a18404426d5791ea5f90f3ed786041ccb2d3a15486533b149e7ab0c94324839238
-  data.tar.gz: 39699c4a07a238f45fc1e12545dfc97b88d85299f03cd3eb1ba97380a1f7bfa79da004abd170c3da87aa707d486a7a103c298c0b34fb9371d9d0c4ada45e3014
+  metadata.gz: 8458cc1ca2c4bd873fe980d9b18db5d81b2871c3d027f914a0555ce686cbca1daba5400464f2a950ceb2ba3602657d6e2bf1daa5d5d23c891addbdc0c5b2c54b
+  data.tar.gz: 3b9fa99981232895852351741ebdaf2cf5675d585b298100bb29ae1fdca054f67b6e16d9e909ba1db6a15f2fda1b0b06a69f37f6443eceb2680af253e0ca27a3

data/README.md

@@ -431,6 +431,24 @@ profile = client.profiles.get("prof-id")
 # Get placements for a profile
 placements = client.profiles.placements("prof-id").data
 
+# Move a placement (e.g. a Facebook Page or Telegram channel) to another group
+placement = client.profiles.assign_placement_to_group("prof-id",
+  placement_id: "placement-external-id",
+  target_profile_group_id: "pg-other"
+)
+puts placement.profile_group_id # => "pg-other"
+
+# Ice breakers (Instagram DMs): FAQ prompts shown when a user opens a chat
+result = client.profiles.ice_breakers("prof-id")
+puts result.ice_breakers.map(&:question)
+
+client.profiles.set_ice_breakers("prof-id", [
+  { question: "What services do you offer?", payload: "services" },
+  { question: "What are your hours?", payload: "hours" }
+]) # 1-4 items
+
+client.profiles.delete_ice_breakers("prof-id")
+
 # Delete a profile
 client.profiles.delete("prof-id")
 
@@ -521,6 +539,9 @@ platforms = PostProxy::PlatformParams.new(
     board_id: "board-123"
   ),
   threads: PostProxy::ThreadsParams.new(format: "post"),
+  # Twitter also supports polls:
+  # twitter: PostProxy::TwitterParams.new(format: "poll",
+  #   poll_options: ["Yes", "No"], poll_duration_minutes: 1440),
   twitter: PostProxy::TwitterParams.new(format: "post"),
   bluesky: PostProxy::BlueskyParams.new(format: "post"),
   telegram: PostProxy::TelegramParams.new(

data/lib/postproxy/resources/profiles.rb

@@ -36,6 +36,41 @@ module PostProxy
         ProfileStatsResponse.new(data: result[:data])
       end
 
+      # Moves a placement (e.g. a Facebook Page or Telegram channel) to another
+      # profile group. `placement_id` is the placement's external ID as
+      # returned by #placements.
+      def assign_placement_to_group(id, placement_id:, target_profile_group_id:, profile_group_id: nil)
+        result = @client.request(:patch, "/profiles/#{id}/assign_placement_to_group",
+          json: {
+            placement_id: placement_id,
+            target_profile_group_id: target_profile_group_id
+          },
+          profile_group_id: profile_group_id
+        )
+        Placement.new(**result)
+      end
+
+      # Lists DM ice breakers. Supported for Instagram profiles only.
+      def ice_breakers(id, profile_group_id: nil)
+        result = @client.request(:get, "/profiles/#{id}/ice_breakers", profile_group_id: profile_group_id)
+        IceBreakersResponse.new(**result)
+      end
+
+      # Replaces the DM ice breakers for a profile (1-4 items).
+      def set_ice_breakers(id, ice_breakers, profile_group_id: nil)
+        items = ice_breakers.map { |ib| ib.is_a?(IceBreaker) ? ib.to_h : ib }
+        result = @client.request(:post, "/profiles/#{id}/ice_breakers",
+          json: { ice_breakers: items },
+          profile_group_id: profile_group_id
+        )
+        SuccessResponse.new(**result)
+      end
+
+      def delete_ice_breakers(id, profile_group_id: nil)
+        result = @client.request(:delete, "/profiles/#{id}/ice_breakers", profile_group_id: profile_group_id)
+        SuccessResponse.new(**result)
+      end
+
       def delete(id, profile_group_id: nil)
         result = @client.request(:delete, "/profiles/#{id}", profile_group_id: profile_group_id)
         SuccessResponse.new(**result)

data/lib/postproxy/types.rb

@@ -235,7 +235,29 @@ module PostProxy
   end
 
   class Placement < Model
-    attr_accessor :id, :name
+    # `metadata` and `profile_group_id` are present in placements and
+    # assign_placement_to_group responses.
+    attr_accessor :id, :name, :metadata, :profile_group_id
+  end
+
+  # Instagram DM ice breaker (FAQ prompt). May carry extra platform fields.
+  class IceBreaker < Model
+    attr_accessor :question, :payload
+
+    def to_h
+      { question: question, payload: payload }
+    end
+  end
+
+  class IceBreakersResponse < Model
+    attr_accessor :ice_breakers
+
+    def initialize(**attrs)
+      @ice_breakers = (attrs.delete(:ice_breakers) || []).map do |ib|
+        ib.is_a?(IceBreaker) ? ib : IceBreaker.new(**ib)
+      end
+      super
+    end
   end
 
   class StatsRecord < Model
@@ -596,7 +618,9 @@ module PostProxy
   end
 
   class TwitterParams < Model
-    attr_accessor :format
+    # poll_options and poll_duration_minutes are required when format is
+    # "poll": 2-4 options (max 25 chars each), duration 5 to 10080 minutes.
+    attr_accessor :format, :poll_options, :poll_duration_minutes
   end
 
   class BlueskyParams < Model

data/lib/postproxy/version.rb

@@ -1,3 +1,3 @@
 module PostProxy
-  VERSION = "1.10.0"
+  VERSION = "1.11.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: postproxy-sdk
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.11.0
 platform: ruby
 authors:
 - PostProxy