Авторизация через Telegram и интеграция с CRM: полное руководство

<script async src="https://telegram.org/js/telegram-widget.js?22" 
  data-telegram-login="your_bot_username" 
  data-size="large" 
  data-radius="8"
  data-onauth="onTelegramAuth(user)"></script>

<script>
function onTelegramAuth(user) {
    console.log(user);
    // Отправка данных на сервер
    fetch('/api/telegram-auth', {
        method: 'POST',
        headers: {'Content-Type': 'application/json'},
        body: JSON.stringify(user)
    });
}
</script>

// Пример на PHP
function handleTelegramAuth($telegramData) {
    // Проверка подлинности (используя hash)
    if (!verifyTelegramAuth($telegramData)) {
        return false;
    }
    
    // Поиск или создание пользователя
    $user = User::findByTelegramId($telegramData['id']);
    
    if (!$user) {
        $user = User::create([
            'telegram_id' => $telegramData['id'],
            'first_name' => $telegramData['first_name'],
            'last_name' => $telegramData['last_name'] ?? null,
            'username' => $telegramData['username'] ?? null,
            'avatar' => $telegramData['photo_url'] ?? null,
            'registered_via' => 'telegram'
        ]);
    } else {
        // Обновление данных
        $user->update([
            'first_name' => $telegramData['first_name'],
            'username' => $telegramData['username'] ?? $user->username
        ]);
    }
    
    // Создание сессии
    $_SESSION['user_id'] = $user->id;
    
    return $user;
}

Политика конфиденциальности для Telegram Login

Мы получаем от Telegram следующие данные:
Идентификатор пользователя (для создания аккаунта)

Имя и username (для персонализации)

Аватар (опционально, если вы разрешите)


Эти данные используются для:
Входа в систему

Связи вашего Telegram-профиля с аккаунтом

Персонализации интерфейса


Вы можете в любое время:
Запросить копию ваших данных

Удалить ваш аккаунт

Отказаться от синхронизации


Все данные шифруются и защищены согласно стандартам GDPR.

function syncUserToCRM($user) {
    $crmData = [
        'name' => trim($user->first_name . ' ' . ($user->last_name ?? '')),
        'custom_fields' => [
            [
                'id' => 123456, // ID поля "Telegram Username"
                'values' => [['value' => $user->username]]
            ],
            [
                'id' => 123457, // ID поля "Telegram ID"
                'values' => [['value' => $user->telegram_id]]
            ]
        ]
    ];
    
    $response = sendToAmoCRM('POST', '/api/v4/contacts', $crmData);
    
    if ($response->success) {
        // Сохраняем ID контакта в CRM
        $user->crm_contact_id = $response->contact_id;
        $user->save();
    }
}

// Пример создания лида в CRM при регистрации
async function createLeadInCRM(telegramUser, formData) {
    const lead = {
        name: Новый лид: ${telegramUser.first_name},
        price: formData.productPrice,
        contacts: [{
            first_name: telegramUser.first_name,
            last_name: telegramUser.last_name || '',
            custom_fields: [{
                field_id: 123456,
                values: [{
                    value: telegramUser.username || 'Отсутствует'
                }]
            }]
        }]
    };
    
    await fetch('YOUR_CRM_WEBHOOK', {
        method: 'POST',
        body: JSON.stringify(lead)
    });
}

// api/telegram-auth.php
if ($_POST && isset($_POST['id'])) {
    $telegramData = $_POST;
    
    // Проверка подлинности
    $check_string = createCheckString($telegramData);
    if (!hash_equals($telegramData['hash'], hash_hmac('sha256', $check_string, BOT_TOKEN))) {
        http_response_code(401);
        exit;
    }
    
    // Создание/обновление пользователя
    $user = syncTelegramUser($telegramData);
    
    // Отправка в CRM
    if ($user->is_new) {
        syncToCRM($user);
        sendTelegramNotification($user->telegram_id, 
            'Добро пожаловать на Bothost! 🚀');
    }
    
    // Создание сессии
    createSession($user);
    
    echo json_encode(['success' => true]);
}