Перейти к основному содержимому

Create Contact External

POST 
/api/v1/contact-creation-integration/create-contact

Публичный endpoint для создания контакта(ов) через API интеграцию.

Использование: GET/POST /api/v1/contact-creation-integration/create-contact

Авторизация (приоритет):

  1. Authorization: Bearer <token>
  2. token в JSON body
  3. token в query (legacy, для простых форм)

Поддерживает два режима:

  1. Один контакт: query / JSON object
  2. Массив контактов: JSON array в теле POST

Параметры (для одного контакта):

  • token (обязательно): Токен интеграции из настроек (можно в query или в теле запроса)
  • campaign_id (опционально): ID кампании. Если не указан, используется первая кампания из интеграции
  • name (опционально): Имя контакта (можно в query или в теле запроса). Если не указано, берём из contact_data.name, fio, FIO или famili
  • phone или msisdn (обязательно): Номер телефона контакта (можно в query или в теле запроса). Поддерживаются оба варианта для совместимости
  • contact_data (опционально): Дополнительные поля контакта в JSON-формате
  • timezone (опционально): IANA часовой пояс (Europe/Moscow). Пишется в Contact.timezone, не в contact_data
  • determine_timezone (опционально): true/false — переопределяет настройку интеграции

start_call:

  • только в JSON body (POST), не из query;
  • если не передан — берётся настройка интеграции «Автоматически начинать звонок»;
  • при обновлении существующего контакта звонок НЕ ставится в очередь повторно.

Возвращает JSON с информацией о созданном/обновлённом контакте и call_enqueued.

Request​

Responses​

Successful Response