Axenties
ДОКУМЕНТАЦИЯ

Интеграция Webhook для лидов

Собирайте заявки с вашего сайта и отправляйте их напрямую в CRM Axenties одним API-запросом. Без SDK - достаточно простого HTTP POST.

Как это работает

Шаг 1

Создайте Webhook

В панели управления Axenties перейдите в Настройки и создайте новый webhook. Вы можете указать воронку, этап воронки и менеджера по умолчанию.

Шаг 2

Получите URL

После создания вы получите уникальный URL webhook в формате:

POST https://crm.axenties.com/api/public/webhooks/{your-token}
Шаг 3

Отправляйте лиды

Отправьте POST-запрос с JSON-телом из формы вашего сайта на URL webhook. Лид мгновенно появится в CRM.

API Endpoint

POST/api/public/webhooks/{token}
Content-Type: application/json

Тело запроса

ПолеТипСтатусОписание
namestringобязательноеПолное имя клиента
phonestringобязательноеНомер телефона (цифры, опционально +)
emailstringопциональноАдрес электронной почты (опционально)
commentstringопциональноДополнительное сообщение или заметка (опционально)

Ответ

При успешном запросе API возвращает:

webhook.responseExamples
// Success (new lead):
{
  "success": true,
  "message": "Спасибо! Ваша заявка принята. Мы свяжемся с вами."
}

// Success (duplicate - lead already exists for this phone):
{
  "success": true,
  "message": "Ваша заявка уже зарегистрирована. Мы свяжемся с вами."
}

// Error (invalid/expired token):
// HTTP 400
{
  "status": 400,
  "error": "Bad Request",
  "message": "Invalid webhook token"
}

// Error (missing required fields):
// HTTP 400
{
  "status": 400,
  "error": "Bad Request",
  "message": "Validation failed",
  "fieldErrors": { "phone": "Phone number is required" }
}

Примеры кода

JavaScript (fetch)
fetch("https://crm.axenties.com/api/public/webhooks/{your-token}", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "John Smith",
    phone: "+71234567890",
    email: "[email protected]",
    comment: "Interested in pricing"
  })
})
.then(res => res.json())
.then(data => console.log(data));
cURL
curl -X POST "https://crm.axenties.com/api/public/webhooks/{your-token}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "phone": "+71234567890",
    "email": "[email protected]",
    "comment": "Interested in pricing"
  }'
HTML Форма
<form id="leadForm">
  <input name="name" placeholder="Name" required />
  <input name="phone" placeholder="Phone" required />
  <input name="email" placeholder="Email" />
  <textarea name="comment" placeholder="Comment"></textarea>
  <button type="submit">Submit</button>
</form>

<script>
document.getElementById("leadForm")
  .addEventListener("submit", async (e) => {
    e.preventDefault();
    const form = new FormData(e.target);
    const res = await fetch(
      "https://crm.axenties.com/api/public/webhooks/{your-token}",
      {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify(Object.fromEntries(form))
      }
    );
    const data = await res.json();
    alert(data.message);
  });
</script>

Что происходит дальше

  1. 1

    В CRM создаётся новый контакт и карточка клиента (или находится существующий по номеру телефона).

  2. 2

    Создаётся сделка в указанной воронке и на указанном этапе.

  3. 3

    Назначенный менеджер (если указан) и все Владельцы / Руководители отдела продаж получают мгновенное уведомление.

  4. 4

    Менеджер может начать переписку в WhatsApp или связаться с лидом напрямую из CRM.

Безопасность и управление токеном

Каждый webhook имеет уникальный токен. Вы можете перегенерировать токен в любой момент - старый URL сразу перестаёт работать. Храните токен в секрете и никогда не используйте его в клиентском коде.