Webhooks: пускане на поток в Automation от Notes
Пращайте всеки нов, променен или изтрит ред от база и всеки коментар в Notes на адрес — webhook тригер в Automation пуска поток с тях. Настройка, тест и последната доставка.
Notes може да праща подписан POST на адрес всеки път, когато ред в база е добавен, променен или изтрит или е написан коментар. Насочете го към поток в Automation с тригер Webhook и потокът тръгва с това, което е станало в Notes — задача, имейл, промяна в CRM. Webhooks управляват само администраторите на workspace-а.
Свързване на Notes с поток в Automation
- В Automation направете поток, който започва с Webhook, и го публикувайте с Publish. Копирайте Webhook URL и Secret: Как тръгва потокът.
- В Notes отворете Webhooks от менюто (само за администратори).
- В New webhook поставете URL и Secret (optional) — тайната на тригера от Automation.
- Изберете събитията: All events или row.created, row.updated, row.deleted и comment.created.
- Натиснете Create webhook. Съобщението Webhook created — deliveries are signed with the secret you pasted. го потвърждава.
Всяка доставка е подписана с тази тайна така, както Automation я проверява, затова тригерът я приема. Повторен опит за същата доставка пуска потока веднъж.
За всеки друг получател
Оставете Secret (optional) празно. Notes създава тайна и я показва веднъж в The signing secret — shown only now: копирайте я при получателя. Всяка доставка носи X-Pages-Signature: sha256=… (HMAC-SHA256 на тялото) и X-Webhook-Signature: sha256=… (на <X-Webhook-Timestamp>.<тялото>).
Какво носи доставката
Тялото е JSON: event, workspace_id, occurred_at и data — редът или коментарът. В потока на Automation е в {{trigger.body.event}}, {{trigger.body.data.…}} и т.н.
Тест и проследяване
- В таблицата менюто на реда → Send a test праща доставка
test.ping— потокът тръгва веднъж с нея. Резултатът се появява в Last delivery след няколко секунди. - Last delivery показва отговора на получателя и кога:
2xxзначи, че е минало; всеки друг код е в червено. - Превключвателят в On спира и пуска доставките. Delete ги спира веднага.
Ако нещо не работи
Last delivery показва 403
Automation е отказал доставката: Secret не е на тригера или потокът е изключен или няма публикувана версия. Включете потока в Automation; за тайната изтрийте webhook-а и го създайте отново със Secret на тригера.
Last delivery показва 404
Адресът не е webhook на поток — обикновено е копиран само отчасти. Копирайте Webhook URL от тригера отново.
Last delivery показва failed
Notes не е стигнал до адреса с три опита. Проверете адреса; приемат се само адреси с https.
„No spaces in the secret“
Поставете тайната точно както я показва Automation, без интервали и нови редове.
„Webhook limit reached (20)“
Workspace-ът има най-много 20 webhooks. Изтрийте някой, който вече не ползвате.