instagram_connect 0.3.3 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 610d72aa6d017bd24db1f7b670ae377a9d6375c74195f21d2992a4249daadc91
-  data.tar.gz: 453de0f0a35ee225997a54292260e2b40dcf302b32242fe05f108ef3a702917c
+  metadata.gz: 6d411544448610a0b11fa1efc08960a9999008117c8a17f8119311f45ae55764
+  data.tar.gz: bb5c2ec09be740aa03358058b64468fa9e415d7046b003fdd065da499d8488cf
 SHA512:
-  metadata.gz: 833aa49017299e66d1b2b6470ed32299ade4863cd8fd3393aa2790231af47e98c1e33412c200f6e7f5eec319d842b6cf4d5a27951cdf137223731caaa5ae435e
-  data.tar.gz: 62bf43bce6b59381057c3e26b0b201f529cac269eaadaf5497a61f5217d60858f8b2d6c223912aa0703fec3d415c011ba8a8bf4ac6edfd60fdb5927da3fa055e
+  metadata.gz: 02257cd24bb80798df5cc576ac7ccf62dc9efcdde4458b1697bc48e4971bea86927d471e46739ca858c48e3a7c69926ed64518dea62b27ccaa097bc9ccc0f61c
+  data.tar.gz: d617a13ad8229ce7a3d53f46a8aadba6974ce06de7f81e8fe462cb69d3e550d4bc87f71ec793abf89fd97163c4f37a0348ec0ac07da9a1549190bd9874a46ee0

data/CHANGELOG.md

@@ -6,6 +6,28 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.3.4] - 2026-07-26
+
+### Fixed
+
+- **The Page was never subscribed, so Meta delivered nothing at all.**
+  `POST /{page-id}/subscribed_apps` takes Meta's **Page** field vocabulary; the gem sent the
+  **Instagram** object's names. Meta rejects the entire call — every field, not just the offender —
+  on the first name it does not recognise:
+
+      (#100) Param subscribed_fields[4] must be one of {...} - got "messaging_seen"
+
+  So a correctly configured, published app with a valid Page token received zero webhooks. The two
+  lists are now deliberately separate: `subscribed_fields` is what ingest can parse, and
+  `page_subscribed_fields` translates it to Page names (`messaging_seen` → `message_reads`,
+  `messaging_referral` → `messaging_referrals`, `messaging_handover` → `messaging_handovers`) and
+  drops the four that exist only on the `instagram` object and are subscribed in the app dashboard
+  instead (`comments`, `live_comments`, `mentions`, `story_insights`).
+- **Conversation sync was rejected for asking too much.** Meta answered a 50-per-page conversations
+  walk with "Please reduce the amount of data you're asking for". The default page size is now 20;
+  the cursor walk makes a smaller page cost one extra round trip and nothing else.
+
+
 ## [0.3.3] - 2026-07-26
 
 ### Fixed

data/app/jobs/instagram_connect/account_readiness_job.rb

@@ -28,10 +28,19 @@ module InstagramConnect
 
     HTTP_TIMEOUT = 15
 
+    # What we ask Meta to deliver to the webhook endpoint.
     def self.subscribed_fields
       Ingest::Registry.subscribable_fields
     end
 
+    # What `subscribed_apps` will actually accept — the Page object names, minus
+    # the fields that only exist on the `instagram` object. Sending an Instagram
+    # name here fails the ENTIRE call, so the two lists are deliberately
+    # separate rather than one list used twice.
+    def self.page_subscribed_fields
+      Ingest::Registry.page_subscribable_fields
+    end
+
     # Cheap negative check so an install with no connected account never
     # enqueues anything.
     def self.enqueue_if_needed
@@ -105,7 +114,7 @@ module InstagramConnect
     def ensure_subscription(account)
       return if account.page_access_token.blank?
 
-      wanted = self.class.subscribed_fields
+      wanted = self.class.page_subscribed_fields
       current = graph_get(account, "/#{account.page_id}/subscribed_apps", fields: "subscribed_fields")
       subscribed = Array(current["data"]).flat_map { |app| Array(app["subscribed_fields"]) }.map(&:to_s)
 

data/lib/instagram_connect/client.rb

@@ -166,7 +166,11 @@ module InstagramConnect
     # Facebook-Login path that is the PAGE, not the Instagram user — verified
     # in production, where the Instagram user id answered with a capability
     # error while holding a perfectly good Page token.
-    def list_conversations(node_id: @ig_user_id, limit: 50)
+    # limit defaults low deliberately. Meta rejected 50 outright on a live
+    # account with "Please reduce the amount of data you're asking for" — the
+    # conversations edge is expensive per row, and the cursor walk means a
+    # smaller page costs nothing but an extra round trip.
+    def list_conversations(node_id: @ig_user_id, limit: 20)
       collect("/#{require_ig_user_id(node_id)}/conversations",
               { platform: "instagram", fields: "id,updated_time", limit: limit })
     end

data/lib/instagram_connect/ingest/registry.rb

@@ -43,6 +43,33 @@ module InstagramConnect
         story_insights
       ].freeze
 
+      # Meta's Page object and Instagram object use DIFFERENT names for the same
+      # webhook. `POST /{page-id}/subscribed_apps` takes the PAGE vocabulary and
+      # rejects the whole call — every field, not just the offender — on the
+      # first name it does not recognise:
+      #
+      #   (#100) Param subscribed_fields[4] must be one of {...} - got "messaging_seen"
+      #
+      # That one rejection is why a correctly configured Page received nothing at
+      # all. Fields with no Page equivalent (comments, mentions, story_insights)
+      # are subscribed on the `instagram` object in the app dashboard instead,
+      # and must not be sent here.
+      PAGE_FIELD_NAMES = {
+        "messaging_seen" => "message_reads",
+        "messaging_referral" => "messaging_referrals",
+        "messaging_handover" => "messaging_handovers"
+      }.freeze
+
+      INSTAGRAM_ONLY_FIELDS = %w[comments live_comments mentions story_insights].freeze
+
+      # The subset of KNOWN_FIELDS that `subscribed_apps` accepts, translated to
+      # the names Meta uses on a Page.
+      def self.page_subscribable_fields
+        (KNOWN_FIELDS - INSTAGRAM_ONLY_FIELDS)
+          .map { |field| PAGE_FIELD_NAMES.fetch(field, field) }
+          .uniq
+      end
+
       # Shape tests in priority order. `is_echo` must be checked before the
       # plain `message` case, since an echo carries a message too.
       MESSAGING_SHAPES = [

data/lib/instagram_connect/version.rb

@@ -1,3 +1,3 @@
 module InstagramConnect
-  VERSION = "0.3.3"
+  VERSION = "0.3.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: instagram_connect
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.4
 platform: ruby
 authors:
 - Kshitiz Sinha