Интеграции · Инструкция
Отправлять события Setvos в другие системы через вебхуки
Сообщайте другой системе, когда здесь что-то происходит — добавлен контакт, выиграна сделка, оплачен счёт, создана запись, — отправляя событие на выбранный вами адрес.
Создайте вебхук
На экране Интеграции › API и вебхуки, который видят люди с правом менять настройки рабочего пространства, нажмите «Новый вебхук». Введите «Адрес», на который должны приходить события, и отметьте нужные «События»:
- контакт добавлен или изменён
- сделка перешла на другой этап или выиграна
- счёт оплачен
- запись создана или отменена
- заказ оплачен
Скопируйте секрет для подписи
«Секрет для подписи» показывается один раз. Каждая доставка подписывается им в заголовке X-Setvos-Signature, чтобы ваша система могла проверить, что сообщение действительно пришло от Setvos.
Отправьте тест
Нажмите у вебхука кнопку «Отправить тест» (молния). Ваша система получит короткое тестовое сообщение — оно показывает, что адрес работает.
Следите за доставками
«Последние доставки» показывает каждую доставку со статусом «В очереди», «Доставлено» или «Ошибка». Доставка, которую ваша система не приняла, остаётся «В очереди» и отправляется повторно — всего шесть попыток примерно за девять часов, — прежде чем получить статус «Ошибка». После двадцати неудачных попыток подряд вебхук приостанавливается и получает пометку «Приостановлен»; когда ваша система снова заработает, нажмите «Возобновить» (кнопка воспроизведения).
Приостановите или удалите его
«Приостановить» (кнопка паузы) останавливает доставки, пока вы не нажмёте «Возобновить». «Удалить» (корзина) сначала переспрашивает: для подтверждения введите хост адреса, например example.com. Удалённый вебхук и его секрет для подписи вернуть нельзя, поэтому, если нужен только перерыв, приостановите его.
Подключите Zapier или Make
В их каталогах пока нет приложения Setvos. Используйте их шаг, который принимает вебхук, и добавьте выданный им адрес здесь как новый вебхук. Тестовое сообщение не содержит записи, поэтому, чтобы сопоставить поля, внесите настоящее изменение того типа, который вы отметили, — например, добавьте тестовый контакт.
Частые вопросы
- Почему мой адрес вебхука отклонён?
Это должен быть публичный адрес http или https. Адрес в частной сети или один из адресов самого Setvos отклоняется.
- Можно ли управлять вебхуками на телефоне?
Да, в разделе для разработчиков: добавьте вебхук, скопируйте секрет для подписи — его показывают один раз, — проверьте его, посмотрите доставки или удалите, введя подтверждение.
Читать дальше
Ещё в разделе «Интеграции»
- Интеграции: подключите сервисы, которыми уже пользуется ваш бизнес
- Подключить сервис, проверить его и следить, чтобы он работал
- Как принимать оплату онлайн картой или банковским переводом
- Отправлять SMS через собственный SMS-шлюз
- Подключить WhatsApp, Instagram и Messenger, а также Viber
- Писать клиентам в Telegram через @Setvos_bot или собственного бота
- Связать свой Telegram, чтобы добавлять лиды и получать уведомления в чате
- Подключить общий почтовый ящик ко Входящим
- Выдавать чеки через кассу Checkbox (ПРРО)
- Подключить перевозчика для доставки: Новая почта, Укрпочта или Meest
- Принимать заказы с Rozetka, Prom.ua и OLX
- Видеть свои записи в Google, Apple или Outlook Calendar
Открыть в Setvos
Вы вошли? Эта статья есть и в меню «Справка» приложения.
Всё ещё не получается?
Расскажите, что вы пытались сделать, — мы отвечаем в чате на шести языках. Написать нам
Переведите записи с бумаги, WhatsApp и трёх таблиц.
Перенесите клиентов, услуги и прошлые визиты из таблицы или выгрузки вашей прежней системы — с предпросмотром до того, как что-либо будет записано, и с помощью в чате на шести языках, когда она понадобится. Большинство студий запускаются в тот же день.