instagram_connect 0.1.0

data/app/models/instagram_connect/account.rb

@@ -0,0 +1,36 @@
+module InstagramConnect
+  # A connected Instagram professional account. Holds the (encrypted) access
+  # token and the identity the Graph client sends as. One row per connected
+  # account — the gem supports connecting several.
+  class Account < ApplicationRecord
+    self.table_name = "instagram_connect_accounts"
+
+    has_many :conversations, class_name: "InstagramConnect::Conversation",
+             foreign_key: :account_id, dependent: :destroy
+    has_many :comments, class_name: "InstagramConnect::Comment",
+             foreign_key: :account_id, dependent: :destroy
+
+    validates :ig_user_id, presence: true, uniqueness: true
+    validates :auth_path, presence: true
+
+    scope :active, -> { where(active: true) }
+    scope :token_expiring_before, ->(time) { where.not(token_expires_at: nil).where(token_expires_at: ..time) }
+
+    # Called from the engine initializer (and specs) when token encryption is
+    # enabled. Kept as an explicit toggle so a host without Active Record
+    # Encryption configured can opt out via config.encrypt_tokens = false.
+    def self.enable_token_encryption!
+      encrypts :access_token
+    end
+
+    def token_expired?
+      token_expires_at.present? && token_expires_at <= Time.current
+    end
+
+    # Refresh via the account's auth strategy and persist the rotated token.
+    def refresh_access_token!
+      data = InstagramConnect::Auth.for(InstagramConnect.configuration).refresh_token(access_token: access_token)
+      update!(access_token: data[:access_token], token_expires_at: data[:expires_at])
+    end
+  end
+end

data/app/models/instagram_connect/application_record.rb

@@ -0,0 +1,5 @@
+module InstagramConnect
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/instagram_connect/comment.rb

@@ -0,0 +1,26 @@
+module InstagramConnect
+  # A comment on one of the account's media objects. Upserted from the
+  # `comments` webhook; moderation state (hidden/replied) is tracked here.
+  class Comment < ApplicationRecord
+    self.table_name = "instagram_connect_comments"
+
+    belongs_to :account, class_name: "InstagramConnect::Account"
+
+    validates :comment_id, presence: true, uniqueness: true
+
+    scope :visible, -> { where(hidden_at: nil) }
+
+    # Upsert by Meta comment id — the same comment can arrive more than once.
+    def self.record(account:, comment_id:, media_id:, text:, from_username:, parent_id: nil)
+      comment = find_or_initialize_by(comment_id: comment_id)
+      comment.account = account
+      comment.assign_attributes(media_id: media_id, text: text, from_username: from_username, parent_id: parent_id)
+      comment.save!
+      comment
+    end
+
+    def hidden?
+      hidden_at.present?
+    end
+  end
+end

data/app/models/instagram_connect/conversation.rb

@@ -0,0 +1,43 @@
+module InstagramConnect
+  # One DM thread — a connected account talking to one Instagram user (igsid).
+  # Threads are shared across the host's operators; ownership lives on the
+  # account, not per-operator.
+  class Conversation < ApplicationRecord
+    self.table_name = "instagram_connect_conversations"
+
+    belongs_to :account, class_name: "InstagramConnect::Account"
+    has_many :messages, class_name: "InstagramConnect::Message",
+             foreign_key: :conversation_id, dependent: :destroy
+
+    validates :igsid, presence: true, uniqueness: { scope: :account_id }
+
+    scope :unread, -> { where("unread_count > 0") }
+    scope :recent, -> { order(Arel.sql("last_message_at IS NULL, last_message_at DESC")) }
+
+    # Race-safe find-or-create on the unique [account_id, igsid] pair.
+    def self.locate(account:, igsid:)
+      find_or_create_by!(account_id: account.id, igsid: igsid)
+    rescue ActiveRecord::RecordNotUnique
+      find_by!(account_id: account.id, igsid: igsid)
+    end
+
+    # Denormalizes the thread summary + unread count atomically (SQL-side) so
+    # concurrent inbound writes can't lose an unread increment.
+    def register_message(message)
+      stamp = message.created_at || Time.current
+      if message.inbound?
+        self.class.where(id: id).update_all([
+          "last_message_at = ?, last_message_preview = ?, last_inbound_at = ?, " \
+          "unread_count = unread_count + 1, updated_at = ?",
+          stamp, message.preview, stamp, Time.current
+        ])
+      else
+        self.class.where(id: id).update_all([
+          "last_message_at = ?, last_message_preview = ?, updated_at = ?",
+          stamp, message.preview, Time.current
+        ])
+      end
+      reload
+    end
+  end
+end

data/app/models/instagram_connect/inbound_message.rb

@@ -0,0 +1,15 @@
+module InstagramConnect
+  # At-least-once dedupe ledger keyed by Meta's message id. Lets the webhook
+  # (and any future backfill/poll) run without double-processing a message.
+  class InboundMessage < ApplicationRecord
+    self.table_name = "instagram_connect_inbound_messages"
+
+    # Returns true only the first time a given message id is claimed.
+    def self.claim(ig_message_id:, account_id: nil)
+      create!(ig_message_id: ig_message_id, account_id: account_id, processed_at: Time.current)
+      true
+    rescue ActiveRecord::RecordNotUnique
+      false
+    end
+  end
+end

data/app/models/instagram_connect/message.rb

@@ -0,0 +1,37 @@
+module InstagramConnect
+  # One message bubble in a DM thread (or a story reply mirrored as a DM).
+  class Message < ApplicationRecord
+    self.table_name = "instagram_connect_messages"
+
+    DIRECTIONS = %w[inbound outbound].freeze
+    STATUSES = %w[received pending sending sent failed].freeze
+    KINDS = %w[dm story_reply reaction].freeze
+    SOURCES = %w[inbound manual api operator_app].freeze
+    MEDIA_STATUSES = %w[none pending downloadable attached unavailable].freeze
+    PREVIEW_LIMIT = 140
+
+    belongs_to :conversation, class_name: "InstagramConnect::Conversation"
+
+    validates :direction, inclusion: { in: DIRECTIONS }
+    validates :status, inclusion: { in: STATUSES }
+    validates :kind, inclusion: { in: KINDS }
+
+    scope :inbound, -> { where(direction: "inbound") }
+    scope :outbound, -> { where(direction: "outbound") }
+    scope :chronological, -> { order(:created_at, :id) }
+
+    def inbound?
+      direction == "inbound"
+    end
+
+    def outbound?
+      direction == "outbound"
+    end
+
+    # Short summary used for the inbox row preview.
+    def preview
+      return body.to_s.truncate(PREVIEW_LIMIT) if body.present?
+      "[#{kind}]"
+    end
+  end
+end

data/app/views/instagram_connect/comments/_comment.html.erb

@@ -0,0 +1,19 @@
+<li class="ic-comment <%= 'ic-comment--hidden' if comment.hidden? %>" id="<%= dom_id(comment) %>">
+  <span class="ic-comment__author"><%= comment.from_username %></span>
+  <span class="ic-comment__text"><%= comment.text %></span>
+
+  <div class="ic-comment__actions">
+    <%= form_with url: reply_comment_path(comment), method: :post, class: "ic-comment__reply" do |f| %>
+      <%= f.text_field :text, placeholder: "Reply…", class: "ic-comment__reply-input" %>
+      <%= f.submit "Reply" %>
+    <% end %>
+
+    <% if comment.hidden? %>
+      <%= button_to "Unhide", unhide_comment_path(comment), method: :post %>
+    <% else %>
+      <%= button_to "Hide", hide_comment_path(comment), method: :post %>
+    <% end %>
+
+    <%= button_to "Delete", comment_path(comment), method: :delete, data: { turbo_confirm: "Delete this comment?" } %>
+  </div>
+</li>

data/app/views/instagram_connect/comments/index.html.erb

@@ -0,0 +1,11 @@
+<section class="ic-comments">
+  <h1 class="ic-comments__title">Comments</h1>
+
+  <% if @comments.any? %>
+    <ul class="ic-comments__list" id="instagram_connect_comments">
+      <%= render partial: "comment", collection: @comments, as: :comment %>
+    </ul>
+  <% else %>
+    <p class="ic-empty">No comments captured yet. They appear here as people comment on your posts.</p>
+  <% end %>
+</section>

data/app/views/instagram_connect/conversations/_composer.html.erb

@@ -0,0 +1,15 @@
+<% if window.open? %>
+  <%= form_with url: conversation_messages_path(conversation), method: :post, class: "ic-composer" do |f| %>
+    <%= f.text_area :body, class: "ic-composer__input", placeholder: "Write a reply…", rows: 2 %>
+    <% if window.state == :human_agent %>
+      <p class="ic-composer__note">
+        Outside the 24-hour window — this reply is sent under the human-agent tag (valid up to 7 days).
+      </p>
+    <% end %>
+    <%= f.submit "Send", class: "ic-composer__send" %>
+  <% end %>
+<% else %>
+  <p class="ic-composer__closed">
+    The reply window has closed. The customer must message you again before you can reply.
+  </p>
+<% end %>

data/app/views/instagram_connect/conversations/_conversation.html.erb

@@ -0,0 +1,11 @@
+<li class="ic-conversation" id="<%= dom_id(conversation) %>">
+  <%= link_to conversation_path(conversation), class: "ic-conversation__link" do %>
+    <span class="ic-conversation__name">
+      <%= conversation.display_name.presence || conversation.username.presence || conversation.igsid %>
+    </span>
+    <span class="ic-conversation__preview"><%= conversation.last_message_preview %></span>
+    <% if conversation.unread_count.positive? %>
+      <span class="ic-conversation__unread"><%= conversation.unread_count %></span>
+    <% end %>
+  <% end %>
+</li>

data/app/views/instagram_connect/conversations/_message.html.erb

@@ -0,0 +1,6 @@
+<div class="ic-message ic-message--<%= message.direction %>" id="<%= dom_id(message) %>">
+  <div class="ic-message__body"><%= message.body.presence || "[#{message.kind}]" %></div>
+  <span class="ic-message__meta">
+    <%= message.status %><%= " · #{message.failure_reason}" if message.failure_reason.present? %>
+  </span>
+</div>

data/app/views/instagram_connect/conversations/index.html.erb

@@ -0,0 +1,11 @@
+<section class="ic-inbox">
+  <h1 class="ic-inbox__title">Instagram inbox</h1>
+
+  <% if @conversations.any? %>
+    <ul class="ic-conversations" id="instagram_connect_conversations">
+      <%= render @conversations %>
+    </ul>
+  <% else %>
+    <p class="ic-empty">No conversations yet. They appear here as soon as someone messages your account.</p>
+  <% end %>
+</section>

data/app/views/instagram_connect/conversations/show.html.erb

@@ -0,0 +1,12 @@
+<section class="ic-thread-view">
+  <p class="ic-thread-view__back"><%= link_to "← Inbox", conversations_path %></p>
+  <h1 class="ic-thread-view__title">
+    <%= @conversation.display_name.presence || @conversation.username.presence || @conversation.igsid %>
+  </h1>
+
+  <div class="ic-thread" id="instagram_connect_messages">
+    <%= render partial: "message", collection: @messages, as: :message %>
+  </div>
+
+  <%= render "composer", conversation: @conversation, window: @window %>
+</section>

data/app/views/instagram_connect/posts/index.html.erb

@@ -0,0 +1,23 @@
+<section class="ic-posts">
+  <h1 class="ic-posts__title">Your posts</h1>
+  <p class="ic-posts__actions"><%= link_to "Publish a post", new_post_path, class: "ic-posts__new" %></p>
+
+  <% if @quota_usage %>
+    <p class="ic-posts__quota">Published in the last 24 hours: <%= @quota_usage %> / 100</p>
+  <% end %>
+
+  <% if @media.any? %>
+    <ul class="ic-posts__list" id="instagram_connect_media">
+      <% @media.each do |item| %>
+        <li class="ic-post" id="ic-media-<%= item["id"] %>">
+          <span class="ic-post__caption"><%= item["caption"] %></span>
+          <% if item["permalink"].present? %>
+            <%= link_to "View on Instagram", item["permalink"], class: "ic-post__link" %>
+          <% end %>
+        </li>
+      <% end %>
+    </ul>
+  <% else %>
+    <p class="ic-empty">No posts published through the API yet.</p>
+  <% end %>
+</section>

data/app/views/instagram_connect/posts/new.html.erb

@@ -0,0 +1,17 @@
+<section class="ic-publish">
+  <h1 class="ic-publish__title">Publish a post</h1>
+
+  <%= form_with url: posts_path, method: :post, class: "ic-publish__form" do |f| %>
+    <div class="ic-field">
+      <%= f.label :image_url, "Image URL (public HTTPS)" %>
+      <%= f.url_field :image_url, required: true, class: "ic-field__input" %>
+    </div>
+    <div class="ic-field">
+      <%= f.label :caption %>
+      <%= f.text_area :caption, rows: 3, class: "ic-field__input" %>
+    </div>
+    <%= f.submit "Publish", class: "ic-publish__submit" %>
+  <% end %>
+
+  <p class="ic-publish__hint">The image must be reachable at a public HTTPS URL at publish time.</p>
+</section>

data/app/views/layouts/instagram_connect/application.html.erb

@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Instagram — instagram_connect</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <%= csrf_meta_tags %>
+    <%= yield :head %>
+  </head>
+  <body class="ic-body">
+    <nav class="ic-nav">
+      <%= link_to "Inbox", conversations_path, class: "ic-nav__link" %>
+      <%= link_to "Comments", comments_path, class: "ic-nav__link" %>
+      <%= link_to "Publish", posts_path, class: "ic-nav__link" %>
+    </nav>
+    <% if flash[:notice] %><p class="ic-flash ic-flash--notice"><%= flash[:notice] %></p><% end %>
+    <% if flash[:alert] %><p class="ic-flash ic-flash--alert"><%= flash[:alert] %></p><% end %>
+    <main class="ic-main"><%= yield %></main>
+  </body>
+</html>

data/bin/instagram_connect

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require "instagram_connect"
+require "instagram_connect/cli"
+
+InstagramConnect::CLI.start(ARGV)

data/config/routes.rb

@@ -0,0 +1,28 @@
+InstagramConnect::Engine.routes.draw do
+  # Meta webhook: GET verify handshake, POST event delivery.
+  get "webhooks", to: "webhooks#verify"
+  post "webhooks", to: "webhooks#receive"
+
+  # OAuth connect flow.
+  get "oauth/start", to: "oauth#start"
+  get "oauth/callback", to: "oauth#callback"
+
+  # DM inbox.
+  resources :conversations, only: %i[index show] do
+    resources :messages, only: :create
+  end
+
+  # Comment moderation.
+  resources :comments, only: %i[index destroy] do
+    member do
+      post :reply
+      post :hide
+      post :unhide
+    end
+  end
+
+  # Publishing.
+  resources :posts, only: %i[index new create]
+
+  root to: "conversations#index"
+end

data/docs/app_review_guide.md

@@ -0,0 +1,57 @@
+# Meta App Review checklist
+
+To message real Instagram users (anyone without a role on your Meta app) you need
+**Advanced Access**, which requires **App Review** *and* **Business Verification**.
+Until then, development/standard access lets you message only accounts you add as
+app roles/testers (~25). Budget weeks — the queue is slow and each rejection adds days.
+
+## Permissions to request
+
+**Instagram Login path** (`graph.instagram.com`):
+
+- `instagram_business_basic`
+- `instagram_business_manage_messages` — DMs
+- `instagram_business_manage_comments` — comment moderation
+- `instagram_business_content_publish` — publishing
+- Human Agent — only if you need to reply beyond the 24-hour window (7-day human-agent
+  replies)
+
+**Facebook Login path** (`graph.facebook.com`):
+
+- `instagram_basic`, `instagram_manage_messages`, `instagram_manage_comments`,
+  `instagram_content_publish`
+- `pages_show_list`, `pages_manage_metadata` (to subscribe the Page to webhooks),
+  `pages_read_engagement`
+
+> Scope names in the `instagram_business_*` family were finalized on 27 Jan 2025 —
+> confirm the exact current strings in Meta's live Permissions Reference before you
+> submit.
+
+## Before you submit
+
+1. **Business Verification** in Meta Business Manager (legal name, address, and a
+   verifiable document / domain / phone).
+2. A **public Privacy Policy URL** that clearly describes the data each requested
+   permission touches.
+3. App set to **Live** mode, with an app icon and category.
+4. **Test credentials + step-by-step reviewer instructions.**
+5. A **screencast per permission** in English, showing the real end-to-end flow
+   (log in → connect the IG account → the actual DM read/send / comment / publish),
+   with narration or captions.
+
+## Common rejection reasons
+
+- Screencasts that use dummy data, lack narration, or don't actually demonstrate the
+  permission in use.
+- Requesting more scopes than the demoed use case needs.
+- A privacy policy that isn't publicly reachable or doesn't cover the requested data.
+- No clear answer to "why does this app need this permission."
+- App misconfiguration (not Live, missing test users, wrong app type).
+- For messaging: missing opt-out/consent flows or inadequate webhook handling.
+
+## Webhook subscription
+
+Point the webhook at `https://<your-host>/instagram/webhooks`, set the verify token to
+match `config.verify_token`, and subscribe: `messages`, `messaging_postbacks`,
+`comments`, `mentions`. Meta must reach the URL publicly — localhost won't receive
+callbacks; use a staging host or a tunnel while developing.

data/docs/auth_paths.md

@@ -0,0 +1,42 @@
+# Auth paths
+
+`instagram_connect` supports both of Meta's Instagram integration paths. Pick one via
+`config.auth_path`. They differ in the Graph host, whether a Facebook Page is required,
+the scope names, and the token lifetime.
+
+## `:instagram_login` — Instagram API with Instagram Login
+
+- **Host:** `graph.instagram.com`
+- **Facebook Page:** not required — the operator logs in with Instagram credentials.
+- **Scopes:** `instagram_business_basic`, `instagram_business_manage_messages`,
+  `instagram_business_manage_comments`, `instagram_business_content_publish`.
+- **Tokens:** a 60-day long-lived token, refreshable (the `RefreshTokensJob` handles
+  this — run it daily).
+- **Use when:** you're a single business connecting your own account, or you want the
+  lightest setup. This is Meta's recommended path for new integrations.
+
+## `:facebook_login` — Instagram API with Facebook Login
+
+- **Host:** `graph.facebook.com`
+- **Facebook Page:** required — the Instagram professional account must be linked to a
+  Facebook Page inside Meta Business Manager.
+- **Scopes:** `instagram_basic`, `instagram_manage_messages`,
+  `instagram_manage_comments`, `instagram_content_publish`, `pages_show_list`,
+  `pages_manage_metadata`, `pages_read_engagement`.
+- **Tokens:** long-lived Page / Business-Manager System-User tokens, effectively
+  non-expiring (the refresh job treats them as a no-op).
+- **Use when:** your account is already managed through a Facebook Page + Business
+  Manager, or you want the most durable server-to-server token story.
+
+## Switching
+
+Change `config.auth_path` and re-run the OAuth connect flow
+(`GET /instagram/oauth/start`). Existing `Account` rows store the path they were
+connected with. An app uses one path at a time.
+
+## Adding a new path
+
+Strategies are plain objects registered in `InstagramConnect::Auth::STRATEGIES` — the
+same config-symbol dispatch used across the house gems. Implement `graph_host`,
+`scopes`, `authorize_url`, `exchange_code`, and `refresh_token` on a subclass of
+`InstagramConnect::Auth::Strategy` and add it to the registry.

data/docs/roadmap.md

@@ -0,0 +1,27 @@
+# Roadmap
+
+## v0.1 (current)
+
+- Both auth paths (Instagram Login / Facebook Login) via pluggable strategies
+- Graph client (DMs, comments, publishing, reads, media) returning `Result`
+- OAuth connect + encrypted-token accounts + scheduled token refresh
+- HMAC-verified webhook + ingest (DMs incl. echoes, comments, postbacks) with dedupe
+- Messaging-window enforcement (24h / 7d human-agent) + at-most-once send job
+- Mounted inbox UI: DM inbox + composer, comment moderation, image publishing
+- Generators (`install`, `views`, `controllers`) + `doctor` CLI
+- 100% line + branch coverage on business logic
+
+## v0.2 (next)
+
+- **Turbo realtime broadcasting** — inbox rows and message bubbles update live via
+  Turbo Streams from model callbacks (no polling).
+- **Active Storage media** — inbound media fetch + attach (MIME sniff + size checks),
+  and outbound file send via a signed, TTL'd blob URL that Meta fetches.
+
+## Later
+
+- Reels / video / carousel / story publishing (container status polling).
+- Story mentions and replies (they arrive as DM events).
+- Multiple connected accounts per host with per-account auth paths.
+- Keyset pagination for high-volume inboxes.
+- Optional AI reply drafting hook.

data/lib/generators/instagram_connect/controllers_generator.rb

@@ -0,0 +1,16 @@
+require "rails/generators"
+
+module InstagramConnect
+  module Generators
+    # `rails g instagram_connect:controllers` — copy the engine's controllers
+    # into the host app for deeper customization. Overridden controllers take
+    # precedence over the engine's.
+    class ControllersGenerator < ::Rails::Generators::Base
+      source_root InstagramConnect::Engine.root.join("app/controllers").to_s
+
+      def copy_controllers
+        directory "instagram_connect", "app/controllers/instagram_connect"
+      end
+    end
+  end
+end

data/lib/generators/instagram_connect/install/install_generator.rb

@@ -0,0 +1,40 @@
+require "rails/generators"
+require "rails/generators/active_record"
+
+module InstagramConnect
+  module Generators
+    # `rails g instagram_connect:install` — writes the initializer, mounts the
+    # engine at /instagram, and copies the database migrations.
+    class InstallGenerator < ::Rails::Generators::Base
+      include ::Rails::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+
+      MIGRATIONS = %w[
+        create_instagram_connect_accounts
+        create_instagram_connect_conversations
+        create_instagram_connect_messages
+        create_instagram_connect_inbound_messages
+        create_instagram_connect_comments
+      ].freeze
+
+      def self.next_migration_number(dirname)
+        ActiveRecord::Generators::Base.next_migration_number(dirname)
+      end
+
+      def create_initializer
+        template "instagram_connect.rb.tt", "config/initializers/instagram_connect.rb"
+      end
+
+      def mount_engine
+        route %(mount InstagramConnect::Engine => "/instagram")
+      end
+
+      def copy_migrations
+        MIGRATIONS.each do |name|
+          migration_template "#{name}.rb.tt", "db/migrate/#{name}.rb"
+        end
+      end
+    end
+  end
+end

data/lib/generators/instagram_connect/install/templates/create_instagram_connect_accounts.rb.tt

@@ -0,0 +1,16 @@
+class CreateInstagramConnectAccounts < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :instagram_connect_accounts do |t|
+      t.string :auth_path, null: false
+      t.string :ig_user_id, null: false
+      t.string :page_id
+      t.string :username
+      t.text :access_token
+      t.datetime :token_expires_at
+      t.boolean :active, default: true, null: false
+      t.bigint :connected_by_id
+      t.timestamps
+    end
+    add_index :instagram_connect_accounts, :ig_user_id, unique: true
+  end
+end

data/lib/generators/instagram_connect/install/templates/create_instagram_connect_comments.rb.tt

@@ -0,0 +1,17 @@
+class CreateInstagramConnectComments < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :instagram_connect_comments do |t|
+      t.bigint :account_id, null: false
+      t.string :media_id
+      t.string :comment_id, null: false
+      t.string :parent_id
+      t.string :from_username
+      t.text :text
+      t.datetime :hidden_at
+      t.datetime :replied_at
+      t.timestamps
+    end
+    add_index :instagram_connect_comments, :comment_id, unique: true
+    add_index :instagram_connect_comments, :account_id
+  end
+end

data/lib/generators/instagram_connect/install/templates/create_instagram_connect_conversations.rb.tt

@@ -0,0 +1,16 @@
+class CreateInstagramConnectConversations < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :instagram_connect_conversations do |t|
+      t.bigint :account_id, null: false
+      t.string :igsid, null: false
+      t.string :username
+      t.string :display_name
+      t.datetime :last_message_at
+      t.datetime :last_inbound_at
+      t.string :last_message_preview
+      t.integer :unread_count, default: 0, null: false
+      t.timestamps
+    end
+    add_index :instagram_connect_conversations, [ :account_id, :igsid ], unique: true
+  end
+end

data/lib/generators/instagram_connect/install/templates/create_instagram_connect_inbound_messages.rb.tt

@@ -0,0 +1,11 @@
+class CreateInstagramConnectInboundMessages < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :instagram_connect_inbound_messages do |t|
+      t.string :ig_message_id, null: false
+      t.bigint :account_id
+      t.datetime :processed_at
+      t.timestamps
+    end
+    add_index :instagram_connect_inbound_messages, :ig_message_id, unique: true
+  end
+end

data/lib/generators/instagram_connect/install/templates/create_instagram_connect_messages.rb.tt

@@ -0,0 +1,25 @@
+class CreateInstagramConnectMessages < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    create_table :instagram_connect_messages do |t|
+      t.bigint :conversation_id, null: false
+      t.string :direction, null: false
+      t.string :status, null: false
+      t.string :kind, default: "dm", null: false
+      t.string :source
+      t.text :body
+      t.string :ig_message_id
+      t.string :message_tag
+      t.bigint :sent_by_id
+      t.string :media_status, default: "none", null: false
+      t.string :media_mime
+      t.string :media_filename
+      t.integer :media_size
+      t.string :media_error
+      t.string :error_message
+      t.string :failure_reason
+      t.timestamps
+    end
+    add_index :instagram_connect_messages, :conversation_id
+    add_index :instagram_connect_messages, :ig_message_id, unique: true
+  end
+end