---
title: Получение обратных вызовов при 2FA
description: Обратные вызовы при 2FA — URL для получения статусов и результатов верификации
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.mydialogi.ru/llms.txt). Append `.md` to any page URL for its markdown version.

> **Коротко:** при настройке интеграции можно указать URL, на который платформа будет отправлять результаты верификации и статусы доставки.

## Кому подходит

- Роль: Разработчик
- Уровень: Опытный

## Что это

Обратный вызов (webhook) — это POST-запрос от платформы на ваш URL. Платформа отправляет данные автоматически при событиях.

## Где указать URL

В настройках 2FA-интеграции:

1. Откройте карточку интеграции.
2. Найдите поле **URL, для отправки результата верификации**.
3. Введите URL вашего сервера.
4. Сохраните.

## Что приходит на URL

Формат данных — JSON. Поля:

| Поле | Что содержит |
|---|---|
| requestId | ID запроса |
| number | Номер телефона |
| status | Статус |
| timestamp | Время события |
| billable | Списывается ли плата |

## Возможные статусы

| Статус | Что означает |
|---|---|
| SENT | Сообщение отправлено |
| DELIVERED | Сообщение доставлено |
| VERIFIED | Код успешно проверен |
| FAILED | Ошибка |

## Как обрабатывать

1. **Принимайте POST-запросы** на ваш URL.
2. **Отвечайте 200 OK** как можно быстрее.
3. **Обрабатывайте данные асинхронно** — не блокируйте ответ.
4. **Логируйте все вызовы** — для диагностики.
5. **Используйте requestId** как ключ для связи с отправленным кодом.

## Что делать с данными

- **Обновить статус пользователя** в вашей системе.
- **Отправить уведомление** ответственному сотруднику.
- **Сохранить в лог** для аудита.
- **Обновить метрики** в аналитике.

## Безопасность

1. **Используйте HTTPS** — обязательно.
2. **Проверяйте источник** — можно ограничить по IP.
3. **Валидируйте данные** — не доверяйте слепо.
4. **Не возвращайте чувствительные данные** в ответе.

## Частые проблемы

### Вебхук не приходит

**Причина:** URL недоступен извне или firewall блокирует.

**Решение:** проверьте доступность URL — ваш сервер должен отвечать `200 OK`. Если firewall блокирует — разрешите IP платформы.

[Контакты поддержки →](https://iba-platform.jamdesk.app/06-reference/03-troubleshooting/ts-support-contacts)

### Вебхук дублируется

**Причина:** retry-логика платформы.

**Решение:** используйте `requestId` как ключ — обрабатывайте каждое событие один раз.

[Как редактировать 2FA-интеграцию →](https://iba-platform.jamdesk.app/02-otp/01-turnkey/otp-103-edit-2fa)

### Обработка медленная

**Причина:** тяжёлые операции в обработке вебхука.

**Решение:** отвечайте `200 OK` сразу — обрабатывайте данные асинхронно.

[Вебхуки →](https://iba-platform.jamdesk.app/06-reference/01-api/api-webhooks)

## Пример обработки

1. Пришёл POST с полями `requestId`, `number`, `status: VERIFIED`.
2. Ваш сервер отвечает `200 OK`.
3. Асинхронно: обновляете статус пользователя в базе.
4. Логируете событие.

## См. также

<Columns cols={2}>
  <Card title="API 2FA Service" icon="code" href="/02-otp/01-turnkey/otp-104-2fa-api">
    Обзор API 2FA — методы и эндпоинты
  </Card>
  <Card title="Принцип работы 2FA: на стороне платформы" icon="server" href="/02-otp/01-turnkey/otp-106-platform-side">
    Curl-примеры отправки и проверки кода
  </Card>
  <Card title="Проверка 2FA-запроса" icon="circle-check" href="/02-otp/01-turnkey/otp-109-check-request">
    Статус запроса по requestId
  </Card>
  <Card title="Как настроить 2FA-интеграцию" icon="shield-halved" href="/02-otp/01-turnkey/otp-102-setup-2fa">
    Создание интеграции в разделе 2FA Service
  </Card>
  <Card title="Вебхуки" icon="webhook" href="/06-reference/01-api/api-webhooks">
    Все типы вебхуков платформы
  </Card>
  <Card title="Как создать API-ключ" icon="key" href="/06-reference/01-api/api-keys">
    Создание и управление ключами
  </Card>
</Columns>

## Нужна помощь?

- **OTP-коды:** support@otpcod.ru