hermosodocs

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

Telegram

Tools

ToolWhat it does
list_inboxEvery 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_itemAnswers one conversation from the account or bot it reached.
list_x_dms, send_x_dmThe 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.