X and Telegram messages
Hermoso reads the direct messages people send every X account on your brand, and the messages people send every Telegram bot on your brand. They arrive in the same inbox as your WhatsApp, Messenger, Instagram, LINE, Slack and Discord conversations, in the app (the Inbox page) and through list_inbox. A reply always goes out from the account or bot the person wrote to.
Several accounts on one channel
Connect as many X accounts and Telegram bots as you run: Connectors, then the X or Telegram card, then Add another account. Every one of them is read. Each conversation carries the account that received it (account, with its id and @handle), the app shows "to @handle" on the conversation when a channel has more than one, and list_inbox takes account to show only what reached one of them.
A conversation's id names its account: x_dm:<your X account id>|<conversation id> and telegram_dm:<bot id>|<chat id>. reply_to_inbox_item with that id answers from that account. An id for an account or bot that is not on this brand is refused before anything is sent.
X direct messages
- What is read: the last 30 days of direct messages, which is all X keeps for an app. Messages sent in X Chat are end-to-end encrypted and do not appear.
- Replying: the reply is an X direct message from the account the person wrote to. X refuses a message to someone who does not accept messages from that account, and its own reason is shown.
- Limits X sets: each account can read its messages 15 times in 15 minutes and send 15 messages in 15 minutes, 1,440 a day. Each account has its own allowance.
- Cost: X charges for each message read, so reading X messages uses credits. X charges for a message once a day however often it is read, and Hermoso charges the same way: a refresh that finds nothing new costs nothing. Each account's read is kept for five minutes and shared by every open tab, so new X messages can take up to five minutes to show. A reply costs credits too.
Telegram
- What is read: the messages people sent each bot, in private chats and in groups where the bot can see them, from the last 24 hours. Telegram keeps a bot's messages for 24 hours and has no way to read older ones. A channel's own posts are not listed.
- Replying: the reply goes from the bot the person wrote to, up to Telegram's 4,096 characters. A longer reply is refused, never cut.
- A webhook set elsewhere: if another tool has set a webhook on a bot, Telegram sends its messages there only, and the inbox says so for that bot.
- Cost: free.
Tools
| Tool | What it does |
|---|---|
list_inbox | Every conversation waiting on the brand, X DMs and Telegram included with no argument. sources: ["x_dm", "telegram_dm"] limits it to these two; account to one account; conversationId reads one conversation. |
reply_to_inbox_item | Answers one conversation from the account or bot it reached. |
list_x_dms, send_x_dm | The X tools, one account at a time (account names it). |
Over HTTP the same reads are GET /api/x/inbox, GET /api/x/inbox/thread?id= and POST /api/x/inbox/reply, and the same three under /api/telegram/inbox.