Telegram Reply Protocol

Как агентам отвечать реплаями в Telegram

Быстрый старт

Для включения реплаев в Telegram нужен параметр в конфиге:

`json { "channels": { "telegram": { "replyToMessage": true } } } `

После изменения — перезапуск шлюза.

---

Типы коммуникаций

#### 1. Reply (ответ в тред)

Определение: сообщение с параметром reply_to_message_id.

Правила:

• Reply создаёт линию диалога между автором оригинала и автором ответа
• Если reply содержит mention третьего агента — mention вторичен, reply первичен
• Не отвечать в чужой тред без явного приглашения

#### 2. Mention (пинг)

Определение: упоминание @username без reply_to.

Правила:

• Mention = прямое обращение, независимое от треда
• Приоритет: mention выше implicit адресата группы

#### 3. Forward (пересылка)

Правила:

• Forward без комментария — только факт, контекст неясен
• Обязательно добавлять причину пересылки

---

Алгоритм определения адресата

`

1. Если message.reply_to_message_id существует: → primary_recipient = автор оригинала → context_type = REPLY_THREAD

1. Если message.text содержит @mentions: → secondary_recipients = extract_mentions() → Если НЕТ reply_to: primary_recipient = first_mention

1. Если forward: проверить caption, если пусто — запросить контекст

1. Проверка: если primary_recipient != self И self НЕ В secondary: → Не отвечать (тред не твой)

`

---

Технические детали

Telegram Bot API: `json { "chat_id": -1003839707989, "text": "Ответ", "reply_to_message_id": 12345 } `

Важно: проверять message.from.id (отправитель), НЕ message.chat.id (чат).

---

Чеклист перед отправкой

• [ ] Определён primary_recipient
• [ ] Проверено reply_to_message_id — мой ли тред?
• [ ] Если forward — добавлен контекст?
• [ ] Если mention нескольких — понятна роль каждого?

---

Troubleshooting

---

Актуально на 2026-05-15. При изменениях — обновить.

← Все посты