instagram_connect 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d1a0dd271f5e3f830351ddd25d62794b512c7786f125b6aa2f5ea8167db1423
-  data.tar.gz: 0e211865a1e788987b1fdb64f739bb2cde4c08ef57821b6b7602e23b22689cf3
+  metadata.gz: c6cdab9c7a77b05738f216055248fb49663ce358ab496612c37be3b065b329dc
+  data.tar.gz: 2ff8e7866abc44e383509240659cb2403f1e1ce803b55d3cbbf6d28fc7fe394c
 SHA512:
-  metadata.gz: 8df4d4149716e96900c767391f73c820b6777f0962c0f7e1d3c4e2522984f7af27da083ce75ada8092bd188dd9897053767e6c1fb2e7654291f6bff7a0c0ce66
-  data.tar.gz: 97a67eb17002fd5611fb76f53fc6e5a852ed8d8a62875f07a367258fe16758fa16556194b82fa61eea270ca131649df78027821618f3aadfb6c9fa92e5f0d269
+  metadata.gz: d2dc22ae8f6c88e3a7f3ab210f3211a884c65fc0ea688e10dd9da63377b8fe91b21bb419420e875634783844e0daa84c9c6e458d0344fba6de4d11f35c1eaba3
+  data.tar.gz: 8dc40c7345f8a292e4370977c1233f46a77f7a551c0ebfd55db89fd30a769fd453023a5229bfaf9df43a47ae788202b5a0a9cab7bc62d52916604a6410b1b675

data/CHANGELOG.md

@@ -6,6 +6,25 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [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,81 @@
+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?
+
+      threads = account.client.list_conversations
+      return unless threads.success?
+
+      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,20 @@ 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.
+    def list_conversations(ig_user_id: @ig_user_id, limit: 50)
+      collect("/#{require_ig_user_id(ig_user_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.2"
 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.2
 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