Message platform integration

更新时间:
复制 MD 格式

This document describes how to integrate Hermes Agent with personal WeChat and QQ, so you can interact with Hermes Agent directly using natural language in group or one-on-one chats.

Integration steps by platform

WeChat

  1. Log on to the terminal password-free: Log on to the Simple Application Server console, find the target server card, and click Remote Connection. In the Connect with One-click on Workbench area, click Log on Now.

  2. Run the integration command: In the terminal, run the following command and select WeChat.

    hermes gateway setup
  3. When prompted to continue, enter y and press Enter.

  4. Log on to WeChat via QR code: The terminal displays a URL. Copy the URL and open it in your browser. Scan the QR code on the page with your WeChat app and authorize the logon on your phone.

    image

    image

  5. Select Done to complete the configuration.

  6. Start the gateway and test the connection: In the terminal, run hermes gateway. To start a conversation, send a message to the linked WeChat account.

QQ

  1. Log on to the terminal password-free: Log on to the Simple Application Server console, find the target server card, and click Remote Connection. In the Connect with One-click on Workbench area, click Log on Now.

  2. Create a QQ bot.

    1. Go to the official Tencent QQ Open Platform website. At the bottom of the page, in the dedicated portal for Longxia, click Go to Use.

    2. In the Mobile Login section, scan the QR code to log on to your QQ account.

    3. Click Create Bot to generate a new QQ bot. Save the bot's AppID and AppSecret.

      Important

      Store this key information securely. The AppSecret (bot secret) for a QQ bot is not stored in plaintext. If this is the first time you are viewing the AppSecret or if you have forgotten it, you must regenerate it.

  3. Run the integration command: In the terminal, run the following command and select QQ bot.

    hermes gateway setup
  4. Enter the Bot ID and Secret when prompted.

  5. Configure the access policy: When prompted, specify who can access the bot. You can press Enter to use the default public access mode.

    image

    image

    image

  6. Start the gateway and test the connection: In the terminal, run hermes gateway. In QQ, add the bot to a group chat. To talk to the bot in the group, mention it using @bot. In a one-on-one chat, a mention is not required.