i18n - docs translations (#17433)
Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
c8c821a692
commit
2353bc62cc
@@ -1,44 +1,44 @@
|
||||
---
|
||||
title: Вебхуки
|
||||
description: Receive real-time notifications when events occur in your CRM.
|
||||
description: Получайте уведомления в реальном времени, когда в вашей CRM происходят события.
|
||||
---
|
||||
|
||||
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
||||
|
||||
Webhooks push data to your systems in real-time when events occur in Twenty — no polling required. Use them to keep external systems in sync, trigger automations, or send alerts.
|
||||
Вебхуки отправляют данные в ваши системы в реальном времени при возникновении событий в Twenty — опрос не требуется. Используйте их, чтобы поддерживать синхронизацию с внешними системами, запускать автоматизации или отправлять оповещения.
|
||||
|
||||
## Создать Webhook
|
||||
|
||||
1. Перейдите в **Настройки → API и Вебхуки → Вебхуки**
|
||||
2. Нажмите **+ Создать вебхук**
|
||||
3. Enter your webhook URL (must be publicly accessible)
|
||||
3. Введите URL вашего вебхука (должен быть общедоступным)
|
||||
4. Нажмите **Сохранить**
|
||||
|
||||
The webhook activates immediately and starts sending notifications.
|
||||
Вебхук активируется сразу и начинает отправлять уведомления.
|
||||
|
||||
<VimeoEmbed videoId="928786708" title="Creating a webhook" />
|
||||
<VimeoEmbed videoId="928786708" title="Создание вебхука" />
|
||||
|
||||
### Manage Webhooks
|
||||
### Управление вебхуками
|
||||
|
||||
**Edit**: Click the webhook → Update URL → **Save**
|
||||
**Изменить**: Нажмите на вебхук → Обновите URL → **Сохранить**
|
||||
|
||||
**Delete**: Click the webhook → **Delete** → Confirm
|
||||
**Удалить**: Нажмите на вебхук → **Удалить** → Подтвердить
|
||||
|
||||
## События
|
||||
|
||||
Twenty sends webhooks for these event types:
|
||||
Twenty отправляет вебхуки для следующих типов событий:
|
||||
|
||||
| Событие | Пример |
|
||||
| ------------------ | ---------------------------------------------------------- |
|
||||
| **Record Created** | `person.created`, `company.created`, `note.created` |
|
||||
| **Record Updated** | `person.updated`, `company.updated`, `opportunity.updated` |
|
||||
| **Record Deleted** | `person.deleted`, `company.deleted` |
|
||||
| Событие | Пример |
|
||||
| -------------------- | ---------------------------------------------------------- |
|
||||
| **Запись создана** | `person.created`, `company.created`, `note.created` |
|
||||
| **Запись обновлена** | `person.updated`, `company.updated`, `opportunity.updated` |
|
||||
| **Запись удалена** | `person.deleted`, `company.deleted` |
|
||||
|
||||
All event types are sent to your webhook URL. Event filtering may be added in future releases.
|
||||
Все типы событий отправляются на URL вашего вебхука. Фильтрация событий может быть добавлена в будущих версиях.
|
||||
|
||||
## Payload Format
|
||||
## Формат полезной нагрузки
|
||||
|
||||
Each webhook sends an HTTP POST with a JSON body:
|
||||
Каждый вебхук отправляет HTTP POST с телом JSON:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -55,35 +55,35 @@ Each webhook sends an HTTP POST with a JSON body:
|
||||
}
|
||||
```
|
||||
|
||||
| Поле | Описание |
|
||||
| --------------- | ------------------------------------------------ |
|
||||
| `событие` | What happened (e.g., `person.created`) |
|
||||
| `данные` | The full record that was created/updated/deleted |
|
||||
| `метка времени` | When the event occurred (UTC) |
|
||||
| Поле | Описание |
|
||||
| --------------- | ----------------------------------------------------- |
|
||||
| `событие` | Что произошло (например, `person.created`) |
|
||||
| `данные` | Полная запись, которая была создана/обновлена/удалена |
|
||||
| `метка времени` | Когда произошло событие (UTC) |
|
||||
|
||||
<Note>
|
||||
Respond with a **2xx HTTP status** (200-299) to acknowledge receipt. Non-2xx responses are logged as delivery failures.
|
||||
Ответьте со **статусом HTTP 2xx** (200-299), чтобы подтвердить получение. Ответы вне диапазона 2xx фиксируются как ошибки доставки.
|
||||
</Note>
|
||||
|
||||
## Валидация вебхуков
|
||||
|
||||
Twenty signs each webhook request for security. Validate signatures to ensure requests are authentic.
|
||||
Twenty подписывает каждый запрос вебхука для обеспечения безопасности. Проверяйте подписи, чтобы убедиться в подлинности запросов.
|
||||
|
||||
### Headers
|
||||
### Заголовки
|
||||
|
||||
| Заголовок | Описание |
|
||||
| ---------------------------- | --------------------- |
|
||||
| `X-Twenty-Webhook-Signature` | HMAC SHA256 signature |
|
||||
| `X-Twenty-Webhook-Timestamp` | Request timestamp |
|
||||
| `X-Twenty-Webhook-Signature` | Подпись HMAC SHA256 |
|
||||
| `X-Twenty-Webhook-Timestamp` | Метка времени запроса |
|
||||
|
||||
### Validation Steps
|
||||
### Шаги проверки
|
||||
|
||||
1. Get the timestamp from `X-Twenty-Webhook-Timestamp`
|
||||
2. Create the string: `{timestamp}:{JSON payload}`
|
||||
3. Compute HMAC SHA256 using your webhook secret
|
||||
4. Compare with `X-Twenty-Webhook-Signature`
|
||||
1. Получите метку времени из `X-Twenty-Webhook-Timestamp`
|
||||
2. Создайте строку: `{timestamp}:{JSON payload}`
|
||||
3. Вычислите HMAC SHA256, используя секрет вашего вебхука
|
||||
4. Сравните с `X-Twenty-Webhook-Signature`
|
||||
|
||||
### Example (Node.js)
|
||||
### Пример (Node.js)
|
||||
|
||||
```javascript
|
||||
const crypto = require("crypto");
|
||||
@@ -101,12 +101,12 @@ const expectedSignature = crypto
|
||||
const isValid = expectedSignature === req.headers["x-twenty-webhook-signature"];
|
||||
```
|
||||
|
||||
## Webhooks vs Workflows
|
||||
## Вебхуки vs рабочие процессы
|
||||
|
||||
| Метод | Направление | Use Case |
|
||||
| ---------------------------- | ----------- | ---------------------------------------------------------- |
|
||||
| **Webhooks** | OUT | Automatically notify external systems of any record change |
|
||||
| **Workflow + HTTP Request** | OUT | Send data out with custom logic (filters, transformations) |
|
||||
| **Workflow Webhook Trigger** | IN | Receive data into Twenty from external systems |
|
||||
| Метод | Направление | Сценарий использования |
|
||||
| -------------------------------------- | ----------- | -------------------------------------------------------------------------- |
|
||||
| **Вебхуки** | OUT | Автоматически уведомлять внешние системы о любом изменении записи |
|
||||
| **Рабочий процесс + HTTP-запрос** | OUT | Отправлять данные наружу с настраиваемой логикой (фильтры, преобразования) |
|
||||
| **Триггер вебхука в рабочем процессе** | IN | Получать данные в Twenty из внешних систем |
|
||||
|
||||
For receiving external data, see [Set Up a Webhook Trigger](/l/ru/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger).
|
||||
Для получения внешних данных см. [Настройка триггера вебхука](/l/ru/user-guide/workflows/how-tos/connect-to-other-tools/set-up-a-webhook-trigger).
|
||||
|
||||
Reference in New Issue
Block a user