WhatsApp CAPI Setup

Настройка Conversions API (CAPI) для отправки событий в Meta при WhatsApp взаимодействиях. Отвечает на "Настрой CAPI", "Подключи конверсии", "Настрой пиксель для вотсапа".

---

Предварительные требования

• WhatsApp подключён (проверь openclaw channels status)
• Facebook Pixel ID (из Events Manager)
• Access Token с разрешением ads_management (системный токен или pixel-specific)

---

Workflow

Шаг 1: Проверить текущие настройки

SELECT * FROM capi_settings WHERE is_active = true;

Если настройки уже есть — покажи и спроси нужно ли обновить.

Шаг 2: Запросить данные у пользователя

1. Pixel ID — например 123456789012345
2. Access Token — системный токен или из Events Manager
3. Event names (по умолчанию):
   • L1: LeadSubmitted (первый интерес, порог сообщений)
   • L2: CompleteRegistration (квалифицированный лид)
   • L3: Purchase (записался/купил)
4. L1 Threshold — минимум входящих сообщений для отправки L1 (по умолчанию 3)

Шаг 3: Сохранить настройки

-- Деактивировать старые настройки если есть
UPDATE capi_settings SET is_active = false WHERE is_active = true;

-- Создать новые
INSERT INTO capi_settings (
  channel, pixel_id, access_token,
  l1_event_name, l2_event_name, l3_event_name,
  l1_threshold, is_active
) VALUES (
  'whatsapp', '{pixel_id}', '{access_token}',
  '{l1_event}', '{l2_event}', '{l3_event}',
  {threshold}, true
);

Шаг 4: Тестовая отправка

send-capi.sh 1 77001234567

Проверь ответ:

• Успех: events_received: 1 — CAPI работает
• Ошибка: покажи пользователю сообщение об ошибке

Шаг 5: Проверить лог

SELECT event_name, event_level, status, error_text, sent_at
FROM capi_events_log ORDER BY sent_at DESC LIMIT 5;

---

AI Квалификация (опционально)

Для L2/L3 можно задать описания для AI-квалификации:

UPDATE capi_settings SET
  ai_l2_description = '{описание квалифицированного лида}',
  ai_l3_description = '{описание записавшегося клиента}'
WHERE is_active = true;

Примеры:

• L2: "Клиент задал конкретные вопросы о цене, услуге или записи"
• L3: "Клиент назвал дату/время или подтвердил запись"

---

Формат ответа

⚡ *CAPI настроен*

📊 Pixel: {pixel_id}
📤 L1: {l1_event} (порог: {threshold} сообщений)
📤 L2: {l2_event} (квалификация AI)
📤 L3: {l3_event} (запись/покупка)

✅ Тест: событие отправлено успешно

Теперь при WhatsApp диалогах CAPI события будут отправляться автоматически:
- L1 после {threshold} входящих сообщений
- L2 когда AI определит заинтересованность
- L3 когда клиент запишется/купит