Для разработчиков

Unfurl (разворачивание ссылок)

POST/messages/{id}/link_previews

Подставляет в сообщение предпросмотр ссылки, собранный самим ботом: заголовок, описание и картинку. Так внутренние адреса компании, которые Пачка сама открыть не может, показываются в переписке карточкой.

Метод доступен только боту, у которого исходящий вебхук настроен на разворачивание ссылок. Такой бот получает событие message_link_shared и отвечает на него этим методом, причём состоять в чате с сообщением ему не нужно — достаточно, чтобы чат был в его пространстве.

Домен ссылки должен быть в списке разрешённых у бота, а сама ссылка — присутствовать в тексте сообщения, иначе метод ответит ошибкой. Ответ приходит пустым даже тогда, когда ни одно превью не применилось: результат проверяют повторным чтением сообщения.

Параметры пути

id
integer, (int32)
*
Идентификатор сообщения
Пример:194275

Тело запроса

application/json

Ответ

204No Content
There is no content to send for this request, but the headers may be useful.
Unfurl (разворачивание ссылок)
pachca messages unfurl 194275 \  --link-previews='{"https://website.com/articles/123":{"title":"Статья: Отправка файлов","description":"Пример отправки файлов на удаленный сервер","image_url":"https://website.com/img/landing.png","image":{"key":"attaches/files/93746/e354fd79-9jh6-f2hd-fj83-709dae24c763/${filename}","name":"files-to-server.jpg","size":695604}}}' \  --json \  --token YOUR_ACCESS_TOKEN