> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Примеры Webhook для создания контакта

> Обработка событий создания контакта.

<Note>Полный каталог на основе схемы см. в разделе [все примеры](/ru/api-reference/guides/examples/webhook-examples/webhook-payload-examples).</Note>

## Что это такое

Обработка событий создания контакта.

## Перед началом работы

* Создайте общедоступную конечную точку HTTPS в вашем приложении.
* Настройте конечную точку Webhook в YCloud для необходимых типов событий.
* Обеспечьте безопасное хранение секрета подписи конечной точки.
* Сделайте обработку событий идемпотентной.

## Принцип работы

YCloud отправляет HTTP-запрос `POST` при возникновении события. Проверьте подпись, надежно сохраните событие, верните ответ `2xx` и обрабатывайте длительные задачи асинхронно.

## Запрос

Ниже представлены сценарии запросов, доставляемых на ваш Webhook URL. Используйте `id` события как идентификатор доставки, а `type` — для маршрутизации полезной нагрузки.

## Ответ

Верните статус `2xx` после успешного принятия события.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

<Note>Сведения о настройке конечной точки, проверке подписи и логике повторных попыток см. в разделе [Настройка Webhook](/ru/api-reference/guides/api-fundamentals/configure-webhooks).</Note>

Происходит при создании нового контакта. Полезная нагрузка Webhook содержит полную информацию о созданном контакте.

## Пример события создания контакта

### Запрос

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "id": "evt_2345678901",
  "type": "contact.created",
  "apiVersion": "v2",
  "createTime": "2024-01-01T12:00:00.000Z",
  "contactCreated": {
    "id": "1824266594102064128",
    "nickName": "John Doe",
    "realName": "John Smith",
    "phoneNumber": "+16315551111",
    "countryCode": "US",
    "countryName": "United States",
    "email": "john.doe@example.com",
    "sourceType": "api",
    "sourceId": "import_batch_123",
    "sourceUrl": "https://example.com/signup",
    "lastSeen": "2024-01-01T11:59:00.000Z",
    "lastConnectedNumber": "+16315552222",
    "ownerEmail": "owner@example.com",
    "tags": [
      "premium",
      "newsletter"
    ],
    "createTime": "2024-01-01T12:00:00.000Z",
    "updateTime": "2024-01-01T12:00:00.000Z",
    "blocked": false,
    "customAttributes": {
      "company": "YCloud Inc",
      "age": 25
    }
  }
}
```

### Ответ

Подтвердите получение после надежного сохранения события.

```http theme={"theme":{"light":"github-light","dark":"github-dark"}}
HTTP/1.1 200 OK
```

<br />

### Пояснение

* **Полная информация о контакте**: объект `contactCreated` содержит все доступные сведения о контакте на момент его создания.
* **Пользовательские атрибуты**: поле `customAttributes` содержит любые пользовательские данные, связанные с контактом.
* **Теги**: массив `tags` содержит любые теги, присвоенные контакту во время создания.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.