Call Me

Услуга Call Me предназначена для подтверждения действий пользователя с помощью телефонного звонка.

После ввода номера телефона на сайте или в мобильном приложении пользователю отображается выделенный номер Call Me, на который необходимо совершить звонок.

После фиксации вызова сервис отправляет HTTP webhook на сервер клиента.

Сценарий работы

1. Пользователь вводит номер телефона;
2. Система отображает выделенный номер Call Me для подтверждения действия;
3. Пользователь совершает звонок;
4. Сервис фиксирует входящий вызов; Клиентский сервер получает webhook с информацией о звонке.

Настройка webhook

Параметр	Описание
URL	Публичный HTTP/HTTPS адрес для получения webhook
HTTP Method	POST
Content-Type	application/json
Timeout	3 секунды
Retry policy	Повторная отправка при ответе, отличном от 2xx

Формат webhook

Пример запроса:

POST https://your-domain.com/webhooks/callme
Content-Type: application/json

Тело запроса:

{
  "callId": "550e8400-e29b-41d4-a716-446655440000",
  "callDate": "2026-05-20T16:30:45+03:00",
  "callerNumber": "79991234567",
  "routingKey": "88005553535"
}

Поле	Тип	Описание
callId	string	Уникальный идентификатор вызова
callDate	string	Дата и время события в формате ISO 8601
callerNumber	string	Номер пользователя
routingKey	string	Номер Call Me, на который был совершен звонок

Подтверждение получения webhook

Сервис считает webhook успешно доставленным при получении HTTP-статуса 2xx.

Код ответа	Повторная отправка
2xx	Нет
Любой другой	Да

Пример обработки webhook (Node.js)

app.post('/webhooks/callme', (req, res) => {
  const {
    callId,
    callDate,
    callerNumber,
    routingKey
  } = req.body;

  console.log(
    `Call ${callId}: ${callerNumber} -> ${routingKey}`
  );

  res.status(200).end();
});

API Specification (OpenAPI)

Техническое описание webhook и API доступно в формате OpenAPI.

Скачать OpenAPI