Messages

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

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

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

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

post/messages/{id}/link_previews

Request

  • Base URL: https://api.pachca.com/api/shared/v1
  • URL: https://api.pachca.com/api/shared/v1/messages/{id}/link_previews
  • Auth: HTTP bearer

Path parameters

idinteger required
Example:194275

Идентификатор сообщения

Request body

link_previewsobject required

JSON карта предпросмотров ссылок, где каждый ключ — URL, который был получен в исходящем вебхуке о новом сообщении

Response

There is no content to send for this request, but the headers may be useful.

Changes

No recorded changes to this operation across all 1 revision of this API.