Вебхуки (Webhooks) (исходящие интеграции)
Уведомляйте ВАШИ системы, когда здесь что-то происходит: счёт оплачен, предложение принято, сделка выиграна, заявка создана и лид создан — доставляется по HTTP с подписью.
Что есть на этом экране
Портрет экрана, считанный с самого экрана — меняется вместе с ним.
Доступные действия
Отправить тестовое событие
В списке показаны
СобытиеСтатусПопыткаКогда
Поля формы
DescriçãoPara você reconhecer a integração (ex.: ERP do cliente).
URL de destino*Endpoint HTTPS que receberá o POST com o corpo em JSON.
Ativo
Начните здесь
Для чего это нужно
Интеграция в реальном времени без опроса (polling): зарегистрируйте свой URL и выберите события. Когда событие происходит, мы отправляем POST-запрос с JSON произошедшего.
Вебхуки — списком, доставки — наверху
Список показывает каждый вебхук с описанием, URL, событиями, скрытым секретом и активностью. Наверху — последние доставки (событие, статус, код HTTP, попытка и время) и кнопка «Отправить тест», которая ставит в очередь пинг для всех активных подписок.
Правила
Безопасность (подпись HMAC)
У каждой подписки есть секрет (whsec_...). Каждая отправка идёт с заголовком X-Tenka-Signature (HMAC-SHA256 от тела) — проверяйте его на своём сервере, прежде чем доверять содержимому.
Доставка и повторная отправка
Не удалось (тайм-аут/5xx)? Очередь повторяет отправку с постепенным увеличением задержки. Последние доставки отображаются на экране со статусом — используйте кнопку «Тест», чтобы проверить свой URL.
Доступные события
fatura.paga, proposta.aceita, negocio.ganho, demanda.criada и lead.criado. Каталог показывает только то, что действительно срабатывает — без пустых обещаний.
Секрет и события в карточке
В карточке секрет подписывает тело каждой доставки (заголовок X-Tenka-Signature, HMAC): проверяйте его на своей стороне, чтобы гарантировать источник. Пустой — Tenka сгенерирует; кнопка рядом создаёт новый. В «Событиях» оставьте «Все» или выберите, какие события срабатывают, — хотя бы одно.
Удаление снимает подписку
Вебхук не попадает в корзину: удаление снимает подписку, и ваша система сразу перестаёт получать события. Чтобы приостановить без потери настроек, снимите «Активен».
Частые вопросы
Лучшие практики
Быстро отвечайте кодом 2xx (обрабатывайте асинхронно на своей стороне); обрабатывайте дубликаты по id события (доставки могут повторяться при повторной попытке).
Эта статья была полезной?
В том же модуле: Платформа и безопасность38
Связанный экран справкиЭкран-якорь словаря деталей. Не отображается в меню.Доступы платформыЗапись о том, когда служба поддержки платформы получала доступ к вашему аккаунту, что делала и с каким разреш…Белое пространство (white-space)Увидеть, что ещё можно продать тем, кто уже является клиентом, — сопоставляя установленную базу с тем, что уж…Элемент шаблонаЭкран-якорь словаря деталей (элементы шаблона). Не отображается в меню.Assistente fiscalQuatro passos para a nota sair do Tenka: estado, regime, código de segurança (CSC) e certificado A1 — com a r…ОтгрузкаКонтролирует комплектацию и отгрузку проданного товара. Отгрузка подтверждает, что товар действительно ушёл: …Диапазон должностиЭкран-якорь словаря деталей (диапазоны должности). Не отображается в меню.Блог — подключение WordPressЗдесь вы подключаете WordPress своей компании и учите ИИ писать как вы: тематику (о чём говорить), тон (как г…
Академия Tenka
Открыть АкадемиюПошаговые учебные маршруты для вашей отрасли — внутри платформы.