Разработка формы заявки с интеграцией в CRM

Разработка формы заявки с интеграцией в CRM

Форма заявки на сайте, данные которой автоматически попадают в CRM — стандартная задача для лидогенерирующих сайтов. Менеджер получает уведомление, заявка появляется в воронке, история переписки сохраняется. Без ручного переноса данных.

Популярные CRM и способы интеграции

Интеграция с amoCRM

class AmoCrmService
{
    private string $subdomain;
    private string $accessToken;

    public function createLead(array $formData): int
    {
        $resp = Http::withToken($this->accessToken)
            ->post("https://{$this->subdomain}.amocrm.ru/api/v4/leads", [
                [
                    'name'           => "Заявка с сайта: {$formData['name']}",
                    'status_id'      => config('amocrm.initial_status_id'),
                    'pipeline_id'    => config('amocrm.pipeline_id'),
                    '_embedded' => [
                        'contacts' => [[
                            'name' => $formData['name'],
                            'custom_fields_values' => [
                                ['field_code' => 'EMAIL', 'values' => [['value' => $formData['email']]]],
                                ['field_code' => 'PHONE', 'values' => [['value' => $formData['phone'], 'enum_code' => 'WORK']]],
                            ],
                        ]],
                    ],
                    'custom_fields_values' => [
                        ['field_id' => config('amocrm.source_field_id'), 'values' => [['value' => 'Сайт']]],
                        ['field_id' => config('amocrm.comment_field_id'), 'values' => [['value' => $formData['message']]]],
                    ],
                ]
            ]);

        return $resp->json('_embedded.leads.0.id');
    }
}

OAuth2 токены amoCRM

amoCRM использует OAuth2 с refresh_token. Токены нужно обновлять каждые 24 часа:

class AmoCrmTokenManager
{
    public function getValidToken(): string
    {
        $stored = Cache::get('amocrm_access_token');
        if ($stored) return $stored;

        // Обновляем через refresh_token
        $resp = Http::post("https://{$this->subdomain}.amocrm.ru/oauth2/access_token", [
            'client_id'     => config('amocrm.client_id'),
            'client_secret' => config('amocrm.client_secret'),
            'grant_type'    => 'refresh_token',
            'refresh_token' => decrypt(Setting::get('amocrm_refresh_token')),
            'redirect_uri'  => config('amocrm.redirect_uri'),
        ]);

        $tokens = $resp->json();
        Cache::put('amocrm_access_token', $tokens['access_token'], 82800);  // 23 часа
        Setting::set('amocrm_refresh_token', encrypt($tokens['refresh_token']));

        return $tokens['access_token'];
    }
}

UTM-метки в заявке

Источник трафика фиксируется в куках при первом визите и передаётся с формой:

// Сохраняем UTM при первом визите
const utmParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];
const params    = new URLSearchParams(window.location.search);

utmParams.forEach(param => {
  if (params.has(param)) {
    document.cookie = `${param}=${params.get(param)};path=/;max-age=2592000`;
  }
});

// При отправке формы добавляем UTM
function getUtmData() {
  return Object.fromEntries(
    utmParams.map(p => [p, getCookie(p) || '']).filter(([, v]) => v)
  );
}

Сроки

Форма заявки с интеграцией в одну CRM через API: 3–5 рабочих дней.