Sharing

Werehouse currently supports sharing to Telegram and Discord. Both of these are configured through the Share Options system.

Share Options

To add a share option:

1. Click the Add a Share Option… link under Share Options and Ping Lists on your account settings page.
2. Choose a name for the share option (which will only ever be shown to you).
3. Choose the service through which you want to share: Telegram or Discord.
   • For Telegram: Enter the Telegram chat ID of the chat or channel that you want Werehouse to send records to. Since this is a fairly esoteric detail, WerehouseBot has a command to help. Once you have added it to the group or channel (or convinced the admins to do it for you), you can send /chatid, and WerehouseBot will reply with the ID of the chat.
   • For Discord: Werehouse can share into a particular Discord channel using Discord’s Webhook API. Follow Discord’s instructions for creating a Webhook, then paste the Webhook URL that Discord gives you into the Webhook field.

If you would like to also have Werehouse @-mention (also sometimes called ping) specific members of the chat when Werehouse is sending something that they might like, you can add a ping list to the share option.

1. Click the disclosure triangle that says Include a ping list….
2. This step differs based on which service you chose:
   • For Telegram: Enter the full username (including the @ symbol) of a chat member you’d like Werehouse to automatically mention.
   • For Discord: Enter a nickname (only shown to you) in the first field, and the channel member’s Discord User ID in the second field. Note: Discord User IDs are not the same as Discord usernames. A Discord User ID is a number with 15–20 digits. Follow Discord’s directions for finding User IDs if you aren’t sure how to get them.
3. Click Add Tags…. A new set of fields will appear below the username.
4. Enter all the tags from your archive that the chat member is interested in. If you enter a tag name that doesn’t exist already, Werehouse will create it for you.
5. Enter all the tags from your archive that the chat member is not interested in. The same rule about creating tags applies here too.

Here’s how the sharing system works: When you share a record from your archive using a share option that includes a ping list, Werehouse will reply to the share messages with another message that pings/mentions the usernames who:

• like at least one tag for that record, and
• dislike none of the tags for that record.

Linked Telegram Account

In addition to sharing to groups using Share Options, Werehouse can also share directly to any Telegram account that you have linked with your Werehouse account. This is particularly useful when you want to share with another person directly, or when adding the Werehouse bot to a group would be unwelcome or infeasable.

To link a Telegram account with Werehouse, send a message that says /start to @WerehouseBot on Telegram. The bot will send you back a link that should show you a confirmation dialog (and possibly a login page, if you're not already logged in to Werehouse in the browser window that opens).

Once you have linked a Telegram account, it will appear in the drop-down menu anywhere that you can share a record (or record group).