API-ключи, вебхуки и Zapier
Подключите другие инструменты через API-ключи и вебхуки
В тарифе Chain другая система может работать с вашим рабочим пространством: API-ключ — для запросов в Setvos, вебхуки — для новостей из него. Приложения в Zapier пока нет; рецепт ниже использует шаги с вебхуками, которые уже есть в Zapier и Make.
Создайте ключ
Откройте Интеграции → API и вебхуки и в блоке «API-ключи» выберите «Новый ключ». Назовите его по системе, которая будет им пользоваться, и отметьте только нужное: ключ действует от вашего имени и никогда не может больше, чем вы. Скопируйте его сразу — он показывается один раз и не хранится.
Отправляйте запросы
Передавайте ключ в заголовке Authorization как «Bearer stv_live_…» и отправляйте запросы на адрес API, указанный на той же карточке. Ключ делает до 300 запросов в минуту, а список адресов в ключе ограничивает, откуда им можно пользоваться.
Заменяйте ключ до истечения срока
Ключ перестаёт работать через год после выпуска. Замените его на карточке: новый ключ сохраняет название, доступ и список адресов, а старый работает, пока вы его не отзовёте, поэтому сначала можно переключить другую систему.
Подпишитесь на события
В разделе «Вебхуки» выберите «Новый вебхук», вставьте адрес, который будет принимать события, и отметьте их: контакт добавлен или изменён, сделка перемещена на другой этап или выиграна, счёт оплачен, запись создана или отменена, заказ оплачен. Каждая доставка — POST с названием события в X-Setvos-Event и подписью в X-Setvos-Signature: sha256= и HMAC тела, сделанный секретом подписи, который показали при создании вебхука.
Соберите сценарий в Zapier или Make
В Zapier начните Zap с Webhooks by Zapier → Catch Hook, в Make — сценарий с Webhooks → Custom webhook. Вставьте полученный адрес в новый вебхук здесь, нажмите «Отправить тест» и сопоставьте поля. Чтобы действовать в Setvos из сценария, используйте Webhooks by Zapier → Custom Request или HTTP-модуль Make с вашим ключом в заголовке Authorization.
Частые вопросы
- В каком тарифе есть API-ключи?
- В Chain. Рабочее пространство, перешедшее с Chain, сохраняет ключи, но они перестают работать в тот же день.
- Что будет, если доставка не удалась?
- Её повторят — всего шесть попыток почти за сутки. Карточка вебхука показывает последние доставки, а вебхук, не сработавший двадцать раз подряд, ставится на паузу, пока вы его не возобновите.
- Есть ли приложение Setvos в каталоге Zapier?
- Пока нет. Шаги Catch Hook и Custom Request выше уже сегодня делают то же самое.
Где это в продукте
Читать дальше
Рабочее пространство и профиль: как настроен ваш бизнес
Настройки, которые определяют всё рабочее пространство, — данные бизнеса, модули, свои поля, ИИ и журнал аудита, — а также ваш собственный профиль.
Контакты: ваши клиенты и компании, в которых они работают
Одна карточка на клиента — с историей, заметками, тегами и файлами. Находите нужного человека за секунды и не допускайте дубликатов.
Счета: выставляйте счета клиентам и следите, кто вам должен
Для чего нужны экраны счетов, как счёт проходит путь от черновика до оплаты и что настроить, прежде чем отправить первый.
Переведите записи с бумаги, WhatsApp и трёх таблиц.
Перенесите клиентов, услуги и прошлые визиты из таблицы или выгрузки вашей прежней системы — с предпросмотром до того, как что-либо будет записано, и с помощью в чате на шести языках, когда она понадобится. Большинство студий запускаются в тот же день.