Hookshot интеграция с matrix

Эта страница также доступна на: English, Deutsch

Предлагаемая нами интеграция с Hookshot работает на hookshot.

Ранее мы предлагали установку appservice-webhooks , но он слабее развивается и ограничен в плане функциональности.

Hookshot поддерживает интеграцию с популярными сервисами управления проектам, такими как GitHub , GitLab , JIRA и Figma , а так же универсальными вебхуками .

Ниже мы описываем базовое использование Hookshot для:

Использование

Создайте комнату и пригласите @hookshot:your-server.com в нее. Когда бот присоединится, отправьте !hookshot help в чат для получения инструкций.

Убедитесь, что бот может отправлять state events (обычно для этого требуется уровень доступа Moderator и выше).

Вебхуки

Теперь, когда Вы пригласили бота в комнату и убедились, что он имеет адекватный уровень доступа, отправьте сообщение !hookshot webhook yourwebhook в чат и получите ссылку на этот вебхук в приватном сообщении.

Вы можете использовать эту ссылку для внешних систем, которые поддерживают вебхуки.

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

{
    "text": "Привет, Мир!",
    "username": "Мой Бот"
}

Вы можете отправить его при помощи curl:

curl --header "Content-Type: application/json" \
--data '{
"text": "Привет, Мир!",
"username": "Мой Бот"
}' \
ССЫЛКА_КОТОРУЮ_ВЫ_ПОЛУЧИЛИ_РАНЬШЕ

Для дополнительной информации о вебхуках, посмотрите документацию Hookshot .

Ленты новостей (RSS, Atom)

Теперь, когда Вы пригласили бота в комнату и убедились, что он имеет адекватный уровень доступа, отправьте сообщение !hookshot feed ЗДЕСЬ_ССЫЛКА для регистрации этого фида. (ЗДЕСЬ_ССЫЛКА нужно заменить на RSS или Atom фид).

Для того, чтобы отобразить список фидов, на которые бот сейчас подписан, используйте команду !hookshot feed list.

Для удаления фидов из списка, используйте !hookshot feed remove ЗДЕСЬ_ССЫЛКА)

Для дополнительной информации о фидах, посмотрите документацию Hookshot .