postproxy-sdk 1.14.0 → 1.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7aef460a3a9d2e2188dc5098adf89fe29e1a917417e965c2234fc23a43019ca
-  data.tar.gz: 14c146f3c9b8fab34ff17b9a87e4fb4c4464a600b90fe5610bd93a3dc4a9baa1
+  metadata.gz: 71cc2ca73303c214ca35568812a214fd9beffe5db6d32cf9f41d59300266262d
+  data.tar.gz: c5536be0f5e7dc3a600959ea0168ed13f875cadd5563307f12edc053c70f0147
 SHA512:
-  metadata.gz: 4e3e06d85a609de033c1918c55c6388d1ff17fcf604576ee3aec7231e906d2328ffd6f57b6e5747c08ee16f9d5f3b5c04affb99eef012be43fdcd2dcf6e0a1b8
-  data.tar.gz: 66d7d324060a481a24002ecbaf00238478904e5fdd40916258f1f1aec88e67d8cbfef46d380ab8062304b9364ef3109774834335423a11d0ff56d186c1ffb5b4
+  metadata.gz: d236100a3164098822f53d8bcc7d7b3c094a07df5fd250b745465a063c0efe8bc45b1bb6cb2955142fa6c75a235635b2708da200a9cea0f048de88788d61d867
+  data.tar.gz: 06f7f18856bf30b06e03aa0afa28ab5ca1ff0b4a0d9e03447a8d755cab139ea2016a085c114428c555c1fc3a257a4d6da223832aca51ce57ee569dd354eff36e

data/README.md

@@ -318,8 +318,8 @@ Subscribe to any of these events (or pass `["*"]` for all):
 
 - **Posts:** `post.processed`, `post.imported`, `platform_post.published`, `platform_post.failed`, `platform_post.failed_waiting_for_retry`, `platform_post.edited`, `platform_post.edit_failed`, `platform_post.insights`, `media.failed`
 - **Profiles:** `profile.connected`, `profile.disconnected`, `profile.stats`, `profile.placements_synced`, `placement.orphaned`, `placement.restored`
-- **Comments:** `comment.created`, `comment.failed`, `comment.failed_waiting_for_retry`, `comment.delivery_unconfirmed`, `comment.edited`, `comment.edit_failed`, `profile_comment.created`, `profile_comment.failed`, `profile_comment.failed_waiting_for_retry`, `profile_comment.deleted`
-- **Messages:** `message.received`, `message.sent`, `message.delivered`, `message.read`, `message.edited`, `message.deleted`, `message.failed_waiting_for_retry`, `message.failed`, `reaction.received`, `referral.received`
+- **Comments:** `comment.created`, `comment.failed`, `comment.failed_waiting_for_retry`, `comment.delivery_unconfirmed`, `comment.edited`, `comment.edit_failed`, `profile_comment.created`, `profile_comment.failed`, `profile_comment.failed_waiting_for_retry`, `profile_comment.edited`, `profile_comment.deleted`
+- **Messages:** `message.received`, `message.sent`, `message.delivered`, `message.read`, `message.edited`, `message.deleted`, `message.failed_waiting_for_retry`, `message.failed`, `reaction.received`, `referral.received`, `chat.thread_control_changed`, `chat.thread_control_requested`
 - **WhatsApp:** `message_template.status_updated`, `message_template.category_updated`, `placement.name_status_updated`, `placement.quality_updated`, `whatsapp.automatic_event`
 
 `PostProxy::WebhookEvents.parse` validates the envelope and returns a typed `Event` — `event.data` is the right model for the event:
@@ -344,13 +344,19 @@ when "profile_comment.created"
   puts "#{event.data.author_username}: #{event.data.body}"
 when "platform_post.edited"
   puts "Edit went live on #{event.data.platform}"
+when "chat.thread_control_changed"
+  # ThreadControlChangedEventData
+  puts "Chat #{event.data.chat.id} now owned by #{event.data.new_owner_app_id}"
+when "profile.disconnected"
+  # ProfileEventData — error / error_details explain an automated disconnect
+  puts "#{event.data.name} disconnected (#{event.data.origin}): #{event.data.error}"
 when "message_template.status_updated"
   # MessageTemplateEventData
   puts "#{event.data.name}: #{event.data.status}"
 end
 ```
 
-The direct-message events (`message.*`) carry a `MessageEventData` (`data.message` is a full `Message`); `reaction.received` carries a `ReactionEventData`; the `profile_comment.*` events carry a `ProfileCommentCreatedData` and the `comment.*` events a `CommentCreatedData` (with `error` / `error_details` on failures). `platform_post.edited` / `edit_failed` reuse `PlatformPostData`; `profile.placements_synced` carries a `PlacementsSyncedData`, the `placement.*` events a `PlacementEventData`, `referral.received` a `ReferralEventData`, `message_template.*` a `MessageTemplateEventData` and `whatsapp.automatic_event` a `WhatsAppAutomaticEventData`.
+The direct-message events (`message.*`) carry a `MessageEventData` (`data.message` is a full `Message`); `reaction.received` carries a `ReactionEventData`; the `profile_comment.*` events carry a `ProfileCommentCreatedData` and the `comment.*` events a `CommentCreatedData` (with `error` / `error_details` on failures). `platform_post.edited` / `edit_failed` reuse `PlatformPostData`; `profile.placements_synced` carries a `PlacementsSyncedData`, the `placement.*` events a `PlacementEventData`, `referral.received` a `ReferralEventData`, `chat.thread_control_changed` a `ThreadControlChangedEventData` and `chat.thread_control_requested` a `ThreadControlRequestedEventData` (each with `data.chat` as a `WebhookChatData`), `message_template.*` a `MessageTemplateEventData` and `whatsapp.automatic_event` a `WhatsAppAutomaticEventData`.
 
 ## Comments
 
@@ -494,6 +500,7 @@ client.messages.send(chat.id, body: "Following up.", tag: "HUMAN_AGENT")
 client.messages.send(chat.id, media: ["https://cdn.example.com/photo.png"])
 client.messages.send(chat.id, media_files: ["./photo.png"])
 
+# Telegram, WhatsApp & Instagram: quote a message with reply_to_external_id
 # Telegram: reply threading + inline keyboard
 client.messages.send(
   chat.id,
@@ -520,6 +527,14 @@ client.chats.mark_read(chat.id)
 client.chats.start_typing(chat.id)
 client.chats.stop_typing(chat.id)
 
+# Thread control (Facebook & Instagram): move the conversation between Meta apps
+# sharing the inbox. Each returns the chat; metadata[:thread_control] holds the owner.
+client.chats.pass_thread_control(chat.id, target_app_id: "263902037430900", metadata: "escalated to support")
+client.chats.take_thread_control(chat.id)
+client.chats.release_thread_control(chat.id)
+client.chats.request_thread_control(chat.id)
+owner = client.chats.thread_owner(chat.id) # ThreadOwner: app_id, expires_at (both nil when idle)
+
 # Private reply to a comment's author (Instagram/Facebook) — returns a Message
 message = client.comments.private_reply("post-id", "comment-id", profile_id: "profile-id", text: "DM-ing you the details.")
 puts message.chat_id, message.status
@@ -743,6 +758,27 @@ audio = client.profiles.instagram_available_audio("ig-profile-id",
 )
 puts audio[:data].map { |a| a[:id] }
 
+# Instagram (Facebook login): incoming collaboration invites
+invites = client.profiles.instagram_collaboration_invites("ig-profile-id") # after: invites.next_cursor
+client.profiles.accept_instagram_collaboration_invite("ig-profile-id", invites.collaboration_invites.first.media_id)
+client.profiles.decline_instagram_collaboration_invite("ig-profile-id", "17890000000000001")
+
+# Pinterest boards — a board is a placement; its id is the board_id you publish to
+board = client.profiles.create_pinterest_board("pin-profile-id", "Summer Recipes",
+  description: "Light dinners for hot days",
+  privacy: "PUBLIC" # or "PROTECTED"
+)
+client.profiles.delete_pinterest_board("pin-profile-id", board.id) # also deletes its Pins
+
+# YouTube playlists — publish into one with platforms.youtube.playlist_id
+page = client.profiles.youtube_playlists("yt-profile-id") # page_token: page.next_page_token
+playlist = client.profiles.create_youtube_playlist("yt-profile-id", "Tutorials",
+  description: "Step-by-step guides",
+  privacy_status: "public"
+)
+client.profiles.update_youtube_playlist("yt-profile-id", playlist.id, privacy_status: "unlisted")
+client.profiles.delete_youtube_playlist("yt-profile-id", playlist.id)
+
 # Facebook Page about / contact info (returned as a hash)
 page = client.profiles.facebook_page("fb-profile-id", "page-id")
 client.profiles.update_facebook_page("fb-profile-id", "page-id", {
@@ -991,6 +1027,14 @@ gbp.create_media("gbp-profile-id", "location-id", "https://example.com/storefron
   category: "EXTERIOR", media_format: "PHOTO")
 media = gbp.media("gbp-profile-id", "location-id")
 gbp.delete_media("gbp-profile-id", "location-id", "accounts/1/locations/1/media/9")
+
+# Search keywords that showed the location, month by month (max 12 months).
+# Unlike the rest, this returns a typed SearchKeywordsResponse.
+result = gbp.search_keywords("gbp-profile-id", "location-id", from_month: "2026-07", to_month: "2026-09")
+result.months.each do |month|
+  # Low-volume keywords have impressions nil and an impressions_threshold bound
+  month.keywords.each { |k| puts "#{month.month} #{k.keyword} #{k.impressions || "<#{k.impressions_threshold}"}" }
+end
 ```
 
 ## WhatsApp management
@@ -1149,9 +1193,21 @@ client.posts.create("New drop", profiles: ["threads-profile", "tt-profile"],
 client.posts.create("Summer vibes", profiles: ["ig-profile"],
   media: ["https://example.com/reel.mp4"],
   platforms: { instagram: { format: "reel", audio_id: "1234567890", audio_volume: 60, video_volume: 30 } })
+
+# Instagram: comments off, location tag, reel kept out of the feed; LinkedIn
+# document title and first comment; YouTube playlist
+client.posts.create("Behind the scenes", profiles: ["ig-profile", "li-profile", "yt-profile"],
+  media: ["https://example.com/clip.mp4"],
+  platforms: PostProxy::PlatformParams.new(
+    instagram: PostProxy::InstagramParams.new(format: "reel", disable_comment: true,
+      location_id: "110843418940484", share_to_feed: false),
+    linkedin: PostProxy::LinkedInParams.new(first_comment: "Full write-up: https://example.com/bts"),
+    youtube: PostProxy::YouTubeParams.new(title: "Behind the scenes", playlist_id: "PLxxxxxxxx")
+  )
+)
 ```
 
-`InstagramParams#trial_strategy` takes `"MANUAL"` or `"SS_PERFORMANCE"`.
+`InstagramParams#trial_strategy` takes `"MANUAL"` or `"SS_PERFORMANCE"`. `disable_comment` and `location_id` (a Facebook Page with an address) apply to posts and reels, `share_to_feed` to reels only. `LinkedInParams#document_title` titles an attached document (defaults to the file name); `first_comment` is not available on polls, and LinkedIn profiles connected before 2026-10-28 must reconnect to use it. `YouTubeParams#playlist_id` comes from `client.profiles.youtube_playlists`.
 
 ### Custom covers
 

data/lib/postproxy/constants.rb

@@ -36,6 +36,8 @@ module PostProxy
 
   INSTAGRAM_AUDIO_TYPES = %w[music original_sound].freeze
 
+  PINTEREST_BOARD_PRIVACIES = %w[PUBLIC PROTECTED].freeze
+
   # Facebook and Instagram profiles connect through Facebook login; WhatsApp
   # through the Cloud API or the WhatsApp Business app.
   CONNECTION_ONBOARDINGS = %w[instagram facebook api business_app].freeze
@@ -77,6 +79,7 @@ module PostProxy
     profile_comment.created
     profile_comment.failed
     profile_comment.failed_waiting_for_retry
+    profile_comment.edited
     profile_comment.deleted
     message.received
     message.sent
@@ -88,6 +91,8 @@ module PostProxy
     message.failed
     reaction.received
     referral.received
+    chat.thread_control_changed
+    chat.thread_control_requested
     message_template.status_updated
     message_template.category_updated
     placement.name_status_updated

data/lib/postproxy/resources/chats.rb

@@ -86,8 +86,54 @@ module PostProxy
         AcceptedResponse.new(**result)
       end
 
+      # --- Thread control (Facebook & Instagram) ---
+      #
+      # Meta gives one app at a time control of a conversation when several
+      # share a Page or Instagram inbox. These return the chat, whose
+      # `metadata[:thread_control]` holds the owner Meta reports back.
+
+      # Hand the conversation to another Meta app, e.g. Page Inbox
+      # `263902037430900` or Instagram Inbox `1217981644879628`.
+      def pass_thread_control(chat_id, target_app_id:, metadata: nil, profile_group_id: nil, idempotency_key: nil)
+        thread_control(chat_id, "pass_thread_control", { target_app_id: target_app_id },
+          metadata, profile_group_id, idempotency_key)
+      end
+
+      # Take the conversation from whichever app holds it. Needs Conversation
+      # Routing; Instagram must be connected via Facebook.
+      def take_thread_control(chat_id, metadata: nil, profile_group_id: nil, idempotency_key: nil)
+        thread_control(chat_id, "take_thread_control", {}, metadata, profile_group_id, idempotency_key)
+      end
+
+      # Give up control; the conversation goes idle.
+      def release_thread_control(chat_id, metadata: nil, profile_group_id: nil, idempotency_key: nil)
+        thread_control(chat_id, "release_thread_control", {}, metadata, profile_group_id, idempotency_key)
+      end
+
+      # Ask the current owner to pass the conversation. Nothing changes until
+      # it does — watch for `chat.thread_control_changed`.
+      def request_thread_control(chat_id, metadata: nil, profile_group_id: nil, idempotency_key: nil)
+        thread_control(chat_id, "request_thread_control", {}, metadata, profile_group_id, idempotency_key)
+      end
+
+      # Ask Meta who controls the conversation right now.
+      def thread_owner(chat_id, profile_group_id: nil)
+        result = @client.request(:get, "/chats/#{chat_id}/thread_owner", profile_group_id: profile_group_id)
+        ThreadOwner.new(**result)
+      end
+
       private
 
+      def thread_control(chat_id, action, json_body, metadata, profile_group_id, idempotency_key)
+        json_body[:metadata] = metadata unless metadata.nil?
+        result = @client.request(:post, "/chats/#{chat_id}/#{action}",
+          json: json_body,
+          profile_group_id: profile_group_id,
+          idempotency_key: idempotency_key
+        )
+        Chat.new(**result)
+      end
+
       def format_time(value)
         return value if value.is_a?(String)
         value.iso8601

data/lib/postproxy/resources/google_business.rb

@@ -162,6 +162,18 @@ module PostProxy
         remove(profile_id, "delete_media", location_id, { media_name: media_name }, profile_group_id, idempotency_key)
       end
 
+      # --- Search keywords ---
+
+      # The searches that showed the location in Google Search and Maps, month
+      # by month. Months are "YYYY-MM"; the range is at most 12 months. Unlike
+      # the rest of this resource, the response is PostProxy-shaped
+      # (snake_case) and returned as a SearchKeywordsResponse.
+      def search_keywords(profile_id, location_id, from_month: nil, to_month: nil, profile_group_id: nil)
+        result = read(profile_id, "search_keywords", location_id,
+          { from_month: from_month, to_month: to_month }, profile_group_id)
+        SearchKeywordsResponse.new(**result)
+      end
+
       private
 
       def path(profile_id, action)

data/lib/postproxy/resources/messages.rb

@@ -32,6 +32,9 @@ module PostProxy
       # `elements` sends a carousel of up to 10 cards (Facebook and Instagram);
       # it can't be combined with body, buttons or card.
       #
+      # `reply_to_external_id` (Telegram, WhatsApp and Instagram) is the
+      # `external_id` of the message to quote.
+      #
       # WhatsApp: send exactly one of body, media, `template`, `interactive`,
       # `location` or `contacts`. Outside the 24-hour window only a `template`
       # gets through. `category: "utility"` sends a text message under the

data/lib/postproxy/resources/profiles.rb

@@ -100,6 +100,119 @@ module PostProxy
         )
       end
 
+      # Posts from other accounts that invited this Instagram profile as a
+      # collaborator. Profiles connected via Facebook login only. Pass the
+      # returned `next_cursor` as `after:` for the next page.
+      def instagram_collaboration_invites(id, after: nil, profile_group_id: nil)
+        params = {}
+        params[:after] = after if after
+
+        result = @client.request(:get, "/profiles/#{id}/instagram/collaboration_invites",
+          params: params.empty? ? nil : params,
+          profile_group_id: profile_group_id
+        )
+        InstagramCollaborationInvitesResponse.new(**result)
+      end
+
+      def accept_instagram_collaboration_invite(id, media_id, profile_group_id: nil, idempotency_key: nil)
+        result = @client.request(:post, "/profiles/#{id}/instagram/accept_collaboration_invite",
+          json: { media_id: media_id },
+          profile_group_id: profile_group_id,
+          idempotency_key: idempotency_key
+        )
+        InstagramCollaborationInviteResult.new(**result)
+      end
+
+      def decline_instagram_collaboration_invite(id, media_id, profile_group_id: nil, idempotency_key: nil)
+        result = @client.request(:post, "/profiles/#{id}/instagram/decline_collaboration_invite",
+          json: { media_id: media_id },
+          profile_group_id: profile_group_id,
+          idempotency_key: idempotency_key
+        )
+        InstagramCollaborationInviteResult.new(**result)
+      end
+
+      # Pinterest only. Boards are the profile's placements; the new board's
+      # `id` is the `board_id` you publish to. `privacy` is "PUBLIC" or
+      # "PROTECTED".
+      def create_pinterest_board(id, name, description: nil, privacy: nil, profile_group_id: nil,
+        idempotency_key: nil)
+        json_body = { name: name }
+        json_body[:description] = description unless description.nil?
+        json_body[:privacy] = privacy unless privacy.nil?
+
+        result = @client.request(:post, "/profiles/#{id}/pinterest/create_board",
+          json: json_body,
+          profile_group_id: profile_group_id,
+          idempotency_key: idempotency_key
+        )
+        Placement.new(**result)
+      end
+
+      # Also deletes every Pin on the board, on Pinterest. Cannot be undone.
+      def delete_pinterest_board(id, board_id, profile_group_id: nil, idempotency_key: nil)
+        result = @client.request(:delete, "/profiles/#{id}/pinterest/delete_board",
+          params: { board_id: board_id },
+          profile_group_id: profile_group_id,
+          idempotency_key: idempotency_key
+        )
+        PinterestBoardDeleted.new(**result)
+      end
+
+      # YouTube only. Up to 50 playlists per page; pass the returned
+      # `next_page_token` as `page_token:` for the next one.
+      def youtube_playlists(id, page_token: nil, profile_group_id: nil)
+        params = {}
+        params[:page_token] = page_token if page_token
+
+        result = @client.request(:get, "/profiles/#{id}/youtube/playlists",
+          params: params.empty? ? nil : params,
+          profile_group_id: profile_group_id
+        )
+        YouTubePlaylistsResponse.new(**result)
+      end
+
+      # `privacy_status` is "public", "unlisted" or "private".
+      def create_youtube_playlist(id, title, description: nil, privacy_status: nil, profile_group_id: nil,
+        idempotency_key: nil)
+        json_body = { title: title }
+        json_body[:description] = description unless description.nil?
+        json_body[:privacy_status] = privacy_status unless privacy_status.nil?
+
+        result = @client.request(:post, "/profiles/#{id}/youtube/create_playlist",
+          json: json_body,
+          profile_group_id: profile_group_id,
+          idempotency_key: idempotency_key
+        )
+        YouTubePlaylist.new(**result)
+      end
+
+      # Fields left out keep their current value; `description: ""` clears it.
+      def update_youtube_playlist(id, playlist_id, title: nil, description: nil, privacy_status: nil,
+        profile_group_id: nil, idempotency_key: nil)
+        json_body = { playlist_id: playlist_id }
+        json_body[:title] = title unless title.nil?
+        json_body[:description] = description unless description.nil?
+        json_body[:privacy_status] = privacy_status unless privacy_status.nil?
+
+        result = @client.request(:patch, "/profiles/#{id}/youtube/update_playlist",
+          json: json_body,
+          profile_group_id: profile_group_id,
+          idempotency_key: idempotency_key
+        )
+        YouTubePlaylist.new(**result)
+      end
+
+      # The videos in the playlist are not deleted.
+      def delete_youtube_playlist(id, playlist_id, profile_group_id: nil, idempotency_key: nil)
+        result = @client.request(:delete, "/profiles/#{id}/youtube/delete_playlist",
+          params: { playlist_id: playlist_id },
+          profile_group_id: profile_group_id,
+          idempotency_key: idempotency_key
+        )
+        YouTubePlaylistDeleted.new(**result)
+      end
+
       # Facebook only. `page_id` is the placement id from #placements. Returns
       # the Page fields as a hash.
       def facebook_page(id, page_id, fields: nil, profile_group_id: nil)

data/lib/postproxy/types.rb

@@ -491,7 +491,9 @@ module PostProxy
     # `external_placement_id` is the page / phone number the chat runs through;
     # `group` marks a WhatsApp group chat. `within_messaging_window` is
     # WhatsApp-only: whether the 24-hour customer service window is open —
-    # when it's closed only a template can be sent.
+    # when it's closed only a template can be sent. Facebook and Instagram
+    # chats carry `thread_control` in `metadata` once known (`owner_app_id`,
+    # `expires_at`, `updated_at`).
     attr_accessor :id, :profile_id, :platform, :external_placement_id, :group,
                   :participant_external_id, :participant_username,
                   :participant_name, :participant_avatar_url,
@@ -1079,6 +1081,145 @@ module PostProxy
     attr_accessor :urn, :type, :name, :vanity_name
   end
 
+  # --- Instagram collaboration invites ---
+
+  # `media_url` is left out by Instagram for videos with copyrighted or
+  # licensed audio.
+  class InstagramCollaborationInvite < Model
+    attr_accessor :media_id, :media_owner_username, :caption, :media_url
+
+    def initialize(**attrs)
+      @media_owner_username = nil
+      @caption = nil
+      @media_url = nil
+      super
+    end
+  end
+
+  # `next_cursor` is nil on the last page.
+  class InstagramCollaborationInvitesResponse < Model
+    attr_accessor :collaboration_invites, :next_cursor
+
+    def initialize(**attrs)
+      @collaboration_invites = []
+      @next_cursor = nil
+      super
+      @collaboration_invites = (@collaboration_invites || []).map do |i|
+        i.is_a?(InstagramCollaborationInvite) ? i : InstagramCollaborationInvite.new(**i.transform_keys(&:to_sym))
+      end
+    end
+  end
+
+  # `accepted` is set by accept, `declined` by decline.
+  class InstagramCollaborationInviteResult < Model
+    attr_accessor :media_id, :accepted, :declined
+  end
+
+  # --- Pinterest ---
+
+  class PinterestBoardDeleted < Model
+    attr_accessor :deleted, :board_id
+  end
+
+  # --- YouTube ---
+
+  class YouTubePlaylist < Model
+    attr_accessor :id, :title, :description, :privacy_status, :item_count,
+                  :thumbnail_url, :published_at
+
+    def initialize(**attrs)
+      @thumbnail_url = nil
+      @item_count = 0
+      super
+      @published_at = parse_time(@published_at)
+    end
+
+    private
+
+    def parse_time(value)
+      return nil if value.nil?
+      value.is_a?(Time) ? value : Time.parse(value.to_s)
+    end
+  end
+
+  # `next_page_token` is nil on the last page.
+  class YouTubePlaylistsResponse < Model
+    attr_accessor :data, :next_page_token
+
+    def initialize(**attrs)
+      @data = []
+      @next_page_token = nil
+      super
+      @data = (@data || []).map do |p|
+        p.is_a?(YouTubePlaylist) ? p : YouTubePlaylist.new(**p.transform_keys(&:to_sym))
+      end
+    end
+  end
+
+  class YouTubePlaylistDeleted < Model
+    attr_accessor :deleted, :playlist_id
+  end
+
+  # --- Chat thread control ---
+
+  # Who controls a Facebook / Instagram conversation. Both nil when idle.
+  class ThreadOwner < Model
+    attr_accessor :app_id, :expires_at
+
+    def initialize(**attrs)
+      @app_id = nil
+      @expires_at = nil
+      super
+      @expires_at = parse_time(@expires_at)
+    end
+
+    private
+
+    def parse_time(value)
+      return nil if value.nil?
+      value.is_a?(Time) ? value : Time.parse(value.to_s)
+    end
+  end
+
+  # --- Google Business search keywords ---
+
+  # `impressions` is nil for low-volume keywords; `impressions_threshold`
+  # is then the upper bound Google reports instead.
+  class SearchKeyword < Model
+    attr_accessor :keyword, :impressions, :impressions_threshold
+
+    def initialize(**attrs)
+      @impressions = nil
+      @impressions_threshold = nil
+      super
+    end
+  end
+
+  # `month` is "YYYY-MM".
+  class SearchKeywordsMonth < Model
+    attr_accessor :month, :keywords
+
+    def initialize(**attrs)
+      @keywords = []
+      super
+      @keywords = (@keywords || []).map do |k|
+        k.is_a?(SearchKeyword) ? k : SearchKeyword.new(**k.transform_keys(&:to_sym))
+      end
+    end
+  end
+
+  class SearchKeywordsResponse < Model
+    attr_accessor :months
+
+    def initialize(**attrs)
+      @months = []
+      super
+      @months = (@months || []).map do |m|
+        m.is_a?(SearchKeywordsMonth) ? m : SearchKeywordsMonth.new(**m.transform_keys(&:to_sym))
+      end
+    end
+  end
+
   # Platform-specific parameter structs
 
   # `alt_text` on every params class that has it takes a single string or an
@@ -1108,11 +1249,17 @@ module PostProxy
   # `audio_volume` / `video_volume` (1-100) need a profile connected via
   # Facebook login. `strip_audio` removes the video's own track (reel, story).
   # `trial_strategy` is "MANUAL" or "SS_PERFORMANCE".
+  #
+  # `disable_comment` turns comments off right after publishing and
+  # `location_id` (the numeric id of a Facebook Page with an address) tags a
+  # location — both on posts and reels, not stories. `share_to_feed` is
+  # reels-only: `false` publishes to the Reels tab only, not the feed/grid.
   class InstagramParams < Model
     attr_accessor :format, :first_comment, :collaborators, :cover_url,
                   :cover_file, :audio_name, :audio_id, :audio_volume,
                   :video_volume, :strip_audio, :trial_strategy, :thumb_offset,
-                  :user_tags, :alt_text, :made_with_ai
+                  :user_tags, :alt_text, :made_with_ai, :disable_comment,
+                  :location_id, :share_to_feed
 
     def initialize(**attrs)
       @user_tags = nil
@@ -1151,14 +1298,21 @@ module PostProxy
   # for organization pages only (up to 25 codes). For format "poll",
   # `poll_question` (140 chars max) and `poll_options` (2-4, 30 chars max
   # each) are required; `poll_duration_days` is 1, 3, 7 (default) or 14.
+  # `document_title` is shown above an attached document (defaults to the
+  # file name). `first_comment` (1,250 characters or fewer) is posted right
+  # after publishing, as the same author; not on polls, and profiles
+  # connected before 2026-10-28 must reconnect.
   class LinkedInParams < Model
     attr_accessor :format, :organization_id, :reshare_urn, :alt_text, :countries,
-                  :poll_question, :poll_options, :poll_duration_days
+                  :poll_question, :poll_options, :poll_duration_days,
+                  :document_title, :first_comment
   end
 
+  # `playlist_id` adds the video to a playlist from Profiles#youtube_playlists.
   class YouTubeParams < Model
     attr_accessor :format, :title, :privacy_status, :cover_url, :cover_file,
-                  :made_for_kids, :tags, :category_id, :contains_synthetic_media
+                  :made_for_kids, :tags, :category_id, :contains_synthetic_media,
+                  :playlist_id
   end
 
   class PinterestParams < Model

data/lib/postproxy/version.rb

@@ -1,3 +1,3 @@
 module PostProxy
-  VERSION = "1.14.0"
+  VERSION = "1.15.0"
 end

data/lib/postproxy/webhook_events.rb

@@ -53,8 +53,18 @@ module PostProxy
 
     class ProfileEventData < Model
       # `origin` is set on `profile.disconnected`: "user" or "automated".
+      # With "automated", `error` says why PostProxy deactivated it (e.g.
+      # "Twitter access revoked") and `error_details` carries the raw platform
+      # error, when available.
       attr_accessor :id, :name, :platform, :profile_group_id, :status, :uid,
-                    :platform_id, :username, :origin
+                    :platform_id, :username, :origin, :error, :error_details
+
+      def initialize(**attrs)
+        @error = nil
+        @error_details = nil
+        super
+        @error_details = ErrorDetails.new(**@error_details.transform_keys(&:to_sym)) if @error_details.is_a?(Hash)
+      end
     end
 
     # `id` is the placement's id on the platform (page id, phone number id,
@@ -157,6 +167,36 @@ module PostProxy
       end
     end
 
+    # Another Meta app passed or took a Facebook / Instagram conversation.
+    # `previous_owner_app_id` is nil when the conversation was idle.
+    class ThreadControlChangedEventData < Model
+      attr_accessor :chat, :previous_owner_app_id, :new_owner_app_id, :metadata, :occurred_at
+
+      def initialize(**attrs)
+        @chat = nil
+        @previous_owner_app_id = nil
+        @new_owner_app_id = nil
+        @metadata = nil
+        @occurred_at = nil
+        super
+        @chat = WebhookChatData.new(**@chat.transform_keys(&:to_sym)) if @chat.is_a?(Hash)
+      end
+    end
+
+    # Another Meta app asked PostProxy to pass a conversation.
+    class ThreadControlRequestedEventData < Model
+      attr_accessor :chat, :requested_owner_app_id, :metadata, :occurred_at
+
+      def initialize(**attrs)
+        @chat = nil
+        @requested_owner_app_id = nil
+        @metadata = nil
+        @occurred_at = nil
+        super
+        @chat = WebhookChatData.new(**@chat.transform_keys(&:to_sym)) if @chat.is_a?(Hash)
+      end
+    end
+
     class MessageTemplateEventData < Model
       attr_accessor :id, :external_id, :profile_id, :platform, :name, :language,
                     :category, :status, :rejected_reason, :quality_score
@@ -192,6 +232,7 @@ module PostProxy
       "profile_comment.created" => ProfileCommentCreatedData,
       "profile_comment.failed" => ProfileCommentCreatedData,
       "profile_comment.failed_waiting_for_retry" => ProfileCommentCreatedData,
+      "profile_comment.edited" => ProfileCommentCreatedData,
       "profile_comment.deleted" => ProfileCommentCreatedData,
       "message.received" => MessageEventData,
       "message.sent" => MessageEventData,
@@ -203,6 +244,8 @@ module PostProxy
       "message.failed" => MessageEventData,
       "reaction.received" => ReactionEventData,
       "referral.received" => ReferralEventData,
+      "chat.thread_control_changed" => ThreadControlChangedEventData,
+      "chat.thread_control_requested" => ThreadControlRequestedEventData,
       "message_template.status_updated" => MessageTemplateEventData,
       "message_template.category_updated" => MessageTemplateEventData,
       "placement.name_status_updated" => PlacementEventData,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: postproxy-sdk
 version: !ruby/object:Gem::Version
-  version: 1.14.0
+  version: 1.15.0
 platform: ruby
 authors:
 - Postproxy