Incoming Webhooks
Что это
Incoming Webhooks позволяют внешним системам отправлять сообщения в чаты Aulynk через HTTP POST-запрос. Полезно для:
- CI/CD уведомлений (Jenkins, GitHub Actions, GitLab CI)
- Мониторинга (Grafana, Prometheus Alertmanager)
- Любых внешних интеграций
Создание webhook
- Откройте групповой чат
- Меню ... > Webhooks
- Нажмите Создать webhook
- Задайте имя (отображается как автор сообщения)
- Скопируйте URL вида
https://your-server/api/webhooks/TOKEN
Отправка сообщения
curl -X POST https://your-server/api/webhooks/YOUR_TOKEN \
-H "Content-Type: application/json" \
-d '{
"text": "Build #42 succeeded!",
"username": "Jenkins",
"avatarUrl": "https://example.com/jenkins.png"
}'
Параметры запроса
| Поле | Тип | Описание |
|---|---|---|
text | string | Текст сообщения (поддерживает Markdown) |
username | string | Имя отправителя (опционально, по умолчанию имя webhook) |
avatarUrl | string | URL аватара (опционально) |
Markdown
Поле text поддерживает Markdown:
{
"text": "## Deploy завершён\n\n- **Версия**: v1.2.3\n- **Среда**: production\n- **Статус**: `success`\n\n> Время: 2 мин 34 сек"
}
Отображение
Сообщения от webhook отображаются с:
- Именем и аватаром webhook
- Бейджем BOT
- Полной поддержкой Markdown-рендеринга
Управление
В диалоге Webhooks можно:
- Просмотреть список webhook'ов чата
- Скопировать URL
- Удалить webhook