instagram_connect 0.3.1 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d1a0dd271f5e3f830351ddd25d62794b512c7786f125b6aa2f5ea8167db1423
-  data.tar.gz: 0e211865a1e788987b1fdb64f739bb2cde4c08ef57821b6b7602e23b22689cf3
+  metadata.gz: 610d72aa6d017bd24db1f7b670ae377a9d6375c74195f21d2992a4249daadc91
+  data.tar.gz: 453de0f0a35ee225997a54292260e2b40dcf302b32242fe05f108ef3a702917c
 SHA512:
-  metadata.gz: 8df4d4149716e96900c767391f73c820b6777f0962c0f7e1d3c4e2522984f7af27da083ce75ada8092bd188dd9897053767e6c1fb2e7654291f6bff7a0c0ce66
-  data.tar.gz: 97a67eb17002fd5611fb76f53fc6e5a852ed8d8a62875f07a367258fe16758fa16556194b82fa61eea270ca131649df78027821618f3aadfb6c9fa92e5f0d269
+  metadata.gz: 833aa49017299e66d1b2b6470ed32299ade4863cd8fd3393aa2790231af47e98c1e33412c200f6e7f5eec319d842b6cf4d5a27951cdf137223731caaa5ae435e
+  data.tar.gz: 62bf43bce6b59381057c3e26b0b201f529cac269eaadaf5497a61f5217d60858f8b2d6c223912aa0703fec3d415c011ba8a8bf4ac6edfd60fdb5927da3fa055e

data/CHANGELOG.md

@@ -6,6 +6,39 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.3.3] - 2026-07-26
+
+### Fixed
+
+- **Conversation sync imported nothing on the Facebook-Login path.** The conversations edge belongs
+  to the PAGE, not the Instagram user — `/{ig-user-id}/conversations` answers with a capability
+  error even when holding a valid Page token. The sync now targets the Page and falls back to the
+  Instagram user id only when there is no Page (the Instagram-Login path). Found in production,
+  where the job "succeeded" in 600ms twice while importing zero threads.
+- **That failure was silent.** The job returned quietly when the listing call failed, so nothing —
+  logs, health, operator — ever learned why. It now logs the account, the node it asked, and Meta's
+  own error message.
+
+
+## [0.3.2] - 2026-07-26
+
+### Added
+
+- **Existing conversations are now imported.** The gem only ever created threads from inbound
+  webhooks, and webhooks only announce NEW activity — so a freshly connected account showed an
+  empty inbox beside an Instagram account full of conversations, and stayed empty until somebody
+  happened to message in. `SyncConversationsJob` pulls every thread and the 20 most recent messages
+  in each, which is the whole history Meta exposes to any app. It runs on connect and is safe to
+  re-run: threads are located by igsid and messages dedupe on `ig_message_id`.
+- `Client#list_conversations` and `Client#conversation_messages`.
+
+### Note
+
+The Conversations API is a **Page-token** operation. An account still holding the OAuth user token
+gets `(#3) Application does not have the capability to make this API call` — verified against a live
+account. `AccountReadinessJob` performs that swap, so it must have run before a sync can succeed.
+
+
 ## [0.3.1] - 2026-07-26
 
 ### Fixed

data/app/jobs/instagram_connect/sync_conversations_job.rb

@@ -0,0 +1,90 @@
+module InstagramConnect
+  # Pulls the threads that already exist on the account.
+  #
+  # Webhooks only ever announce NEW activity, so a freshly connected account
+  # shows an empty inbox until somebody happens to message in — even though the
+  # operator has years of conversations sitting in Instagram. This fetches what
+  # Meta will give us: every thread, and the 20 most recent messages in each,
+  # which is the entire history the API exposes to any app.
+  #
+  # Safe to re-run. Threads are located by igsid and messages are deduped on
+  # ig_message_id, so a second pass updates rather than duplicates.
+  class SyncConversationsJob < ApplicationJob
+    queue_as :default
+
+    def perform(account_id)
+      account = Account.find_by(id: account_id)
+      return if account.nil? || !account.active?
+
+      # The conversations edge lives on the Page for Facebook-Login accounts and
+      # on the Instagram user for Instagram-Login ones.
+      node = account.page_id.presence || account.ig_user_id
+      threads = account.client.list_conversations(node_id: node)
+      unless threads.success?
+        # A sync that fails must say so. Swallowing this once cost a production
+        # afternoon: the job "succeeded" in 600ms and imported nothing.
+        logger.error("[instagram_connect] conversation sync failed for " \
+                     "account=#{account.id} node=#{node}: #{threads.error_message}")
+        return
+      end
+
+      Array(threads.data["data"]).each { |thread| sync_thread(account, thread["id"]) }
+    end
+
+    private
+
+    def sync_thread(account, conversation_id)
+      result = account.client.conversation_messages(conversation_id: conversation_id)
+      return unless result.success?
+
+      messages = Array(result.data.dig("messages", "data"))
+      # A thread with no readable messages tells us nothing and would show as an
+      # empty row in the inbox, so it is skipped rather than created.
+      return if messages.empty?
+
+      conversation = Conversation.locate(account: account, igsid: counterpart(messages, account))
+      messages.reverse_each { |message| import(conversation, account, message) }
+    end
+
+    # Meta reports both ends of every message; the thread belongs to whichever
+    # participant is not us.
+    def counterpart(messages, account)
+      messages.each do |message|
+        [ message.dig("from", "id"), *Array(message.dig("to", "data")).map { |t| t["id"] } ]
+          .compact.each { |id| return id.to_s if id.to_s != account.ig_user_id.to_s }
+      end
+      account.ig_user_id.to_s
+    end
+
+    def import(conversation, account, payload)
+      mid = payload["id"].to_s
+      return if mid.blank?
+
+      message = Message.find_or_initialize_by(conversation_id: conversation.id, ig_message_id: mid)
+      return unless message.new_record?
+
+      outbound = payload.dig("from", "id").to_s == account.ig_user_id.to_s
+      message.assign_attributes(
+        direction: outbound ? "outbound" : "inbound",
+        # Historical rows: an outbound message we are reading back has already
+        # been delivered, and an inbound one has already arrived.
+        status: outbound ? "sent" : "received",
+        body: payload["message"],
+        source: "sync",
+        sent_at: parse_time(payload["created_time"])
+      )
+      message.account_id = account.id
+      message.save!
+      conversation.register_message(message)
+    rescue ActiveRecord::RecordNotUnique
+      # Raced a webhook for the same message. The webhook's copy is the one that
+      # matters; ours would have been identical.
+    end
+
+    def parse_time(value)
+      Time.zone.parse(value.to_s)
+    rescue ArgumentError, TypeError
+      nil
+    end
+  end
+end

data/lib/instagram_connect/client.rb

@@ -157,6 +157,25 @@ module InstagramConnect
       get("/me/accounts", { fields: "id,name,access_token,instagram_business_account" })
     end
 
+    # Threads that already exist on the account. Webhooks only ever tell us about
+    # NEW activity, so without this an inbox starts empty and stays empty until
+    # somebody happens to message in. Meta returns the 20 most recent messages
+    # per thread and no more — that is the whole history available to any app.
+    #
+    # node_id is the object that OWNS the conversations edge, and on the
+    # 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)
+      collect("/#{require_ig_user_id(node_id)}/conversations",
+              { platform: "instagram", fields: "id,updated_time", limit: limit })
+    end
+
+    def conversation_messages(conversation_id:, limit: 20)
+      get("/#{conversation_id}",
+          { fields: "messages.limit(#{limit}){id,created_time,from,to,message}" })
+    end
+
     # One Page by id. /me/accounts answers for the Pages a token may *enumerate*;
     # this answers for a Page it may *read*. Those are not the same set — a Page
     # granted through the Login-for-Business asset picker is readable here while

data/lib/instagram_connect/connect.rb

@@ -25,6 +25,10 @@ module InstagramConnect
       )
       account.connected_by_id = connected_by_id unless connected_by_id.nil?
       account.save!
+      # Webhooks only announce new activity, so without this the operator
+      # connects and stares at an empty inbox beside an Instagram account full
+      # of conversations.
+      SyncConversationsJob.perform_later(account.id)
       account
     end
 

data/lib/instagram_connect/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: instagram_connect
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.3
 platform: ruby
 authors:
 - Kshitiz Sinha
@@ -100,6 +100,7 @@ files:
 - app/jobs/instagram_connect/refresh_tokens_job.rb
 - app/jobs/instagram_connect/replay_events_job.rb
 - app/jobs/instagram_connect/send_message_job.rb
+- app/jobs/instagram_connect/sync_conversations_job.rb
 - app/models/instagram_connect/account.rb
 - app/models/instagram_connect/api_budget.rb
 - app/models/instagram_connect/application_record.rb