assistant-storefront/TEST_SEARCH_IMAGE.md

测试 search_image 消息发送

方法 1: 使用 Rails Console（推荐）

在你的终端中执行：

cd /home/lxj/project/chatwoot-develop

# 确保已初始化 rbenv
eval "$(rbenv init -)"

# 启动 Rails console
bundle exec rails c

然后在 Rails console 中复制粘贴以下代码：

# 配置参数
ACCOUNT_ID = 2
INBOX_ID = 1
USER_IDENTIFIER = '211845'

# 1. 查找联系人
contact = Contact.find_by(identifier: USER_IDENTIFIER)

if contact.nil?
  puts "❌ 联系人不存在，请先通过 widget 创建会话"
else
  puts "✅ 联系人: #{contact.name} (ID: #{contact.id})"

  # 2. 获取会话
  conversation = Conversation.where(
    contact_id: contact.id,
    inbox_id: INBOX_ID
  ).order(created_at: :desc).first

  if conversation.nil?
    puts "❌ 会话不存在"
  else
    puts "✅ 会话: #{conversation.display_id}"

    # 3. 创建 search_image 消息
    test_image_url = "https://img.gaia888.com/image/www/test_#{SecureRandom.uuid}.jpg"

    message = Message.create!(
      account_id: ACCOUNT_ID,
      conversation_id: conversation.id,
      inbox_id: INBOX_ID,
      sender: contact,
      sender_type: 'Contact',
      sender_id: contact.id,
      message_type: :incoming,
      content_type: :search_image,
      content: '',
      content_attributes: {
        url: test_image_url
      },
      status: :sent
    )

    puts "\n✅ 消息创建成功!"
    puts "   Message ID: #{message.id}"
    puts "   content_type: #{message.content_type}"
    puts "   URL: #{test_image_url}"
  end
end

方法 2: 使用 Rails Runner

cd /home/lxj/project/chatwoot-develop
eval "$(rbenv init -)"
bundle exec rails runner test_search_image_console.rb

预期结果

成功后会看到：

✅ 联系人: 测试用户 211845 (ID: 24)
✅ 会话: 16

✅ 消息创建成功!
   Message ID: 427
   content_type: search_image
   URL: https://img.gaia888.com/image/www/test/...

验证消息

1. Dashboard 查看:

   • 访问: http://localhost:3000/app/accounts/2/inbox/1/conversations/16
   • 应该看到新发送的图片消息

2. Webhook 日志:

   • 查看 webhook 接收到的数据
   • 应该看到 content_type: "search_image"

3. Widget 查看:

   • 刷新 /widget_tests 页面
   • 应该看到图片显示在聊天界面

错误排查

错误: 联系人不存在

原因: 还没有通过 widget 创建过会话 解决: 先访问 /widget_tests 页面并发送一条消息

错误: 会话不存在

原因: 联系人没有在此 inbox 中的会话 解决: 先通过 widget 发送消息创建会话

错误: content_type 未知

原因: 数据库没有 search_image 枚举值 解决: 运行迁移添加 search_image 到 content_type 枚举