Исходящие вебхуки
Подписки на события, передаваемые данные, журнал и повторы доставки.
В этой статьеВебхук — автоматическое уведомление вашей внешней программы о событии в PROChat. Например, о новом сообщении клиента. Настройка находится в Интеграции → Исходящие вебхуки и доступна владельцу и администратору при наличии функции в подписке.
Для чего нужен раздел
Он передаёт разрешённые события на адрес другой системы. Это не рассылка клиентам и не возможность отвечать от их имени. Для обычной работы в PROChat вебхуки настраивать не обязательно.
Подготовьте получателя
Попросите разработчика внешней системы подготовить адрес приёма уведомлений и проверку их подписи. Подпись помогает отличить PROChat от постороннего отправителя.
Нужен защищённый публичный адрес HTTPS. Локальные адреса, нестандартные порты и перенаправления не поддерживаются. Точные требования к формату и проверке подписи находятся в документации для разработчиков.
Создайте подписку
- Нажмите кнопку создания в Исходящих вебхуках.
- Укажите понятное название, подключение, адрес получателя и доступные события.
- Выберите, какие сведения разрешено передавать. Не включайте текст переписки, если внешней системе он не нужен.
- Проверьте настройки и сохраните.
- Если показан секрет для проверки подписи, передайте его только вашему разработчику и храните как пароль.
Сохранение не отправляет старую историю. Внешняя система получает новые подходящие события после включения.
Изменение и остановка
Выключение останавливает новые доставки с сохранением настроек. Удаление убирает подписку из рабочего списка. Уже начавшаяся передача может завершиться.
При одновременном редактировании обновите сохранённые сведения, сравните изменения и подтвердите заново. Сам просмотр страницы ничего не отправляет.
Журнал и повторы
Откройте журнал нужной подписки. Здесь видны успешные попытки, ожидание и ошибки. Если получатель недоступен, проверьте адрес и журнал вместе с разработчиком.
Повторно доставленное событие не должно создавать вторую запись во внешней системе: разработчик должен учитывать номер события. Перед ручным повтором выясните, приняла ли внешняя система прежнюю попытку.
Границы первой версии
Уведомления передают только предусмотренные события и разрешённые данные выбранного подключения. Они не изменяют карточку обращения, не запускают произвольные команды и не дают обратную отправку сообщений.