Conversions API · события из переписки

    CAPI для WhatsApp:
    продажи из чата в рекламу

    Клиент пришёл из объявления и купил в переписке. Meta об этом не знает и продолжает искать тех, кто просто пишет. CAPI возвращает результат диалога обратно в рекламный кабинет.

    • Подключение в кабинете
    • Без разработчика
    • События по ctwa_clid
    ctwa_clidидентификатор клика приходит с первым сообщением
    2 событияпродажа и целевой лид уходят в Meta
    5 минутчерез столько отметка попадает в рекламный кабинет
    Сумма сделкиуходит вместе с продажей, если менеджер её указал

    Как теряются заявки прямо сейчас

    Три ситуации, знакомые почти каждой компании для WhatsApp

    Реклама учится на переписках, а не на деньгах

    Кампании с переходом в WhatsApp оптимизируются по началу диалога. Алгоритм одинаково считает удачей и покупателя, и человека, который спросил цену и пропал.

    Продажа происходит там, где нет пикселя

    Сделка закрывается в переписке или в CRM. Пиксель живёт на сайте, поэтому событие о покупке до Meta не доходит и стоимость заявки считается по кликам.

    Отчёты не сходятся с кассой

    В рекламном кабинете десятки дешёвых обращений, в отчёте отдела продаж три сделки. Сопоставить их вручную получается только по памяти менеджера.

    Как выглядит работа с рекламными обращениями

    Над перепиской видно объявление, из которого пришёл человек, а после сделки менеджер отмечает результат: он и уходит в Meta.

    9:41
    Чаты
    Поиск
    👩🏻
    📌Айгерім Сәрсенова
    14:35
    Рахмет, өте жақсы!
    👨🏻
    📌Нұрсұлтан Әбдіхалық
    14:28
    Қашан жіберемін?2
    👩🏽
    Дана Қасымова
    14:15
    Жақсы, күтемін
    👨🏼
    Алексей Смирнов
    13:45
    Спасибо большое! 🙏
    👨🏻
    Ержан Мұратов
    12:30
    Договорились
    👩🏻
    Мадина Әлиева
    11:20
    Қанша тұрады?1
    👩🏼
    Екатерина Попова
    Вчера
    Хорошо, жду ответа
    👨🏽
    Бауыржан Сейітов
    Вчера
    Рақмет!
    Актуальное
    Звонки
    Инструменты
    3
    Чаты
    Настройки
    Путь события

    Как продажа возвращается в рекламный кабинет

    Пять шагов от клика по объявлению до строки в Events Manager. Первые три происходят сами, четвёртый делает менеджер одним нажатием.

    1. 01

      Клик по объявлению

      Человек нажимает «Написать в WhatsApp». Meta выдаёт идентификатор этого клика и запоминает, какое объявление сработало.

      Meta запоминает объявление
    2. 02

      Первое сообщение

      Идентификатор приходит нам вместе с первым сообщением клиента. Захватить его можно только в этот момент: позже он не восстановится.

      Метка приходит вместе с сообщением
    3. 03

      Переписка и сделка

      Менеджер отвечает в общем чате. Над перепиской видно объявление и кампанию, из которых пришёл человек.

      Объявление видно над перепиской
    4. 04

      Отметка результата

      После разговора менеджер отмечает: продажа, целевой лид, отказ или нет ответа. У продажи можно указать сумму.

      Продажа или целевой лид
    5. 05

      Событие в Meta

      Раз в пять минут накопленные отметки уходят в Meta с идентификатором клика. Алгоритм видит, какое объявление принесло деньги.

      Отметка уходит в рекламный кабинет
    Интерфейс

    Как это выглядит у менеджера

    Ничего нового учить не нужно: работа идёт в том же чате, а настройка занимает один экран в кабинете.

    С рекламы
    Доставка за 2 часа по городуКампания: Лето · Доставка · CTWAID 120210987654321
    Здравствуйте! Сколько стоит доставка до Медеуского района?
    Добрый день! До Медеуского 1 500 ₸, привезём сегодня до 19:00.
    Карточка объявления стоит прямо над перепиской: менеджер сразу понимает, о чём человек прочитал в рекламе.
    Чем закончился разговор
    Сохранить
    Нажмите на любой вариант: справа видно, что при этом уйдёт в Meta. Отметка ставится в два нажатия, у продажи можно указать сумму.
    Продажи в MetaРаботает

    Отправляем в Meta отметки о продажах: реклама начинает искать похожих покупателей.

    • Набор данных1298600768857819
    • ТокенEAAG…9fZB
    Уйдёт: продажа на 185 000 ₸Meta засчитает сделку этому объявлению и начнёт искать похожих покупателей.
    Последняя проверка: сегодня, доступ есть
    Состояние подключения видно в кабинете. Токен показывается замаскированным, а проверка доступа ничего не отправляет в отчёты.

    Как проходит подключение

    Всё удалённо. Если с номером всё в порядке — линия запускается примерно за 15 минут

    2 минуты

    Регистрация и линия

    Заводите кабинет и создаёте линию WhatsApp Business API. Мы сразу видим заявку и подключаемся к вам.

    5 минут

    Форма Meta

    Заполняете данные компании прямо из кабинета: название, номер, имя канала. Подсказываем на каждом поле.

    2 минуты

    Подтверждение номера +7

    Meta присылает код звонком или СМС, вы вводите его в форме. С этого момента номер работает в бизнес-канале.

    5 минут

    Шаблоны и запуск

    Готовим первые шаблоны сообщений, подключаем CRM — и можно писать клиентам. Дальше работаете из чата или из своей системы.

    потом, не мешает работе

    Проверка компании в Meta

    Verification проходит уже после запуска и на переписку не влияет: до неё действует ограничение Meta на число новых диалогов в сутки, после — снимается. Поможем собрать документы.

    Что вы получаете

    01

    Событие привязано к объявлению

    Meta присылает ctwa_clid с первым сообщением клиента, мы храним его рядом с диалогом и отправляем вместе с событием обратно.

    02

    Отметка ставится в чате

    Менеджер отмечает результат обращения: продажа, целевой лид, отказ. Никаких выгрузок и таблиц.

    03

    Продажи и лиды раздельно

    В настройках выбираете, что отправлять: только покупки, только целевые лиды или и то и другое.

    04

    Токен хранится отдельно

    Токен доступа лежит в закрытом хранилище, в кабинете виден только замаскированным. Читает его лишь серверная функция.

    05

    Проверка до первого события

    Кнопка проверки спрашивает Meta, видит ли она набор данных. Проверочное событие уходит с кодом проверки и в отчёты не попадает.

    06

    Результат можно передать из CRM

    Если сделки закрываются в Битрикс24, amoCRM или своей системе, отметку о продаже принимает наш REST API.

    Данные

    Что уходит в Meta, а что остаётся у вас

    В рекламный кабинет попадает только результат разговора. Содержание переписки остаётся в сервисе и никуда не передаётся.

    Уходит в Meta

    • Факт результатаПродажа или целевой лид. Отказ и молчание не отправляются.
    • Когда это случилосьМомент, когда менеджер отметил результат разговора.
    • Сумма сделкиЕсли менеджер её указал. Без суммы событие тоже уходит.
    • Метка объявленияТехническая отметка, по которой Meta узнаёт своё объявление.

    Остаётся у вас

    • ПерепискаСообщения и вся история диалога остаются в сервисе.
    • Контакты клиентаНомер телефона и имя в Meta не передаются.
    • Файлы и фотоВложения из переписки никуда не уходят.
    • Заметки менеджераКомментарии к сделке видны только вашей команде.

    Так работает Conversions API: Meta получает результат, а не содержание разговора.

    Прикидка

    Сколько выручки увидит Meta

    Сейчас рекламный кабинет знает только про клики. После подключения он будет знать вот эту сумму, и алгоритм начнёт искать людей, похожих на тех, кто её принёс.

    Сумма считается по вашим цифрам и никуда не отправляется: это прикидка для понимания масштаба. В Meta уходят только реальные отметки из чата.

    Выручка в отчётах Meta1 800 000 ₸

    Столько рекламный кабинет сможет засчитать как результат кампаний вместо строчки «начатые переписки».

    Подключить CAPI
    Пакеты конверсий

    Сколько стоит отправка событий

    Пакет берётся сверх линии официального WhatsApp и считается по числу событий, которые уходят в Meta за месяц.

    до 1 000событий в месяц
    9 900 ₸/ месяц
    или $21 · €20Подключить
    Чаще берутдо 10 000событий в месяц
    24 900 ₸/ месяц
    или $52 · €49Подключить
    Безлимитсобытий в месяц
    49 900 ₸/ месяц
    или $104 · €99Подключить
    • При оплате за полгода скидка 10%, за год 20%.
    • Лимит мягкий: если событий стало больше, отправка не обрывается. Предложим перейти на старший пакет.
    • Видеть, из какого объявления пришёл клиент, можно и без пакета: это входит в линию официального WhatsApp.

    Сколько это будет стоить в месяц

    Подвиньте ползунки под свой поток сообщений. Считаем по действующим ставкам — тем же, по которым списывается с баланса

    Ваша страна

    Ставки Meta зависят от страны получателей. Цены ниже уже с нашей сервисной комиссией.

    Рассылки и акции1 000 шт.

    Промо, скидки, приглашения — маркетинговые сообщения

    38,34 ₸ за сообщение38 338 ₸
    Уведомления500 шт.

    Статус заказа, запись на приём, напоминание об оплате

    8,39 ₸ за сообщение4 195 ₸
    Ответы в переписке2 000 шт.

    Всё, что менеджер пишет клиенту, пока открыто окно 24 часа

    1,48 ₸ за сообщение2 957 ₸
    Ваш счёт за месяц
    Платформа и линия29 900 ₸
    Сообщения45 490 ₸

    Итого

    75 390 ₸

    Входящие от клиентов и ответы считаются отдельно по факту. Подключение бесплатное, скрытых платежей нет.

    Что входит в тариф

    Подключение бесплатное. Платите за работу линии и за сообщения по тарифам Meta

    Линия WhatsApp Business API

    29 900 ₸ / месяц

    или $68 · €59

    Сообщения тарифицирует Meta: цена зависит от страны получателя и типа переписки. Рекламные дороже, ответы клиенту в течение суток после его обращения — почти бесплатны. Актуальные ставки называем при подключении.

    Оплата — картой Visa или Mastercard, для компаний выставляем счёт.

    Что входит

    • Линия официального WhatsApp Business API
    • Чат для всей команды: браузер и телефон
    • Интеграции с Битрикс24 и amoCRM
    • Рассылки и шаблонные уведомления
    • Открытый REST API и вебхуки
    • Бесплатный виджет для сайта
    • Автоответы: приветствие и нерабочее время
    • Помощь с подключением и шаблонами
    • Расшифровка голосовых сообщений (ИИ)
    • Шаблоны быстрых ответов

    Первые 3 дня бесплатно на любом тарифе — можно проверить на своих клиентах и только потом принимать решение.

    Бесплатных мест для менеджеров: 3. Каждое следующее стоит 3 000 ₸ в месяц.

    При оплате за полгода скидка 10%, за год 20%.

    Что такое CAPI и зачем он бизнесу в WhatsApp

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

    Пиксель остаётся на сайте

    Пиксель считает действия в браузере: просмотр страницы, добавление в корзину, оплату. В переписке браузера нет, поэтому всё, что происходит после клика по объявлению, для пикселя невидимо.

    Ключ к атрибуции: ctwa_clid

    При клике по объявлению Meta выдаёт идентификатор клика и присылает его вместе с первым сообщением клиента. Пока он сохранён рядом с диалогом, событие можно вернуть ровно к тому объявлению, которое привело человека.

    Отправляются два события

    Purchase, когда сделка закрыта, и QualifiedLead, когда обращение целевое и дошло до расчёта. Оба уходят с пометкой business_messaging: Meta понимает, что конверсия случилась в переписке, а не на сайте.

    Алгоритм меняет поведение

    Кампания перестаёт гнаться за дешёвыми диалогами и начинает искать людей, похожих на тех, кто заплатил. Обращений может стать меньше, а выручки больше.

    Данные остаются вашими

    Отправляются событие, время и идентификатор клика. Тексты переписки, файлы и контакты в Meta не уходят.

    Настройка занимает один вечер

    Нужны номер набора данных, номер аккаунта WhatsApp Business и токен системного пользователя. Всё вводится в кабинете, мастер подсказывает, где это взять в Events Manager.

    Кому это нужно в первую очередь

    • Реклама с кнопкой «Написать в WhatsApp» и потоком обращений
    • Интернет-магазины: заказ оформляется в переписке
    • Клиники и салоны: запись подтверждается менеджером
    • Автосалоны и сервисы: сделка длинная, решение принимается в чате
    • Агентства: клиент требует показать выручку, а не стоимость клика
    • Опт и услуги: средний чек разный, и важно, кто именно купил

    Пиксель и CAPI: в чём разница

    Оба инструмента отправляют события в Meta, но живут в разных местах и видят разное

    Что сравниваем
    Пиксель на сайте
    CAPI для WhatsApp
    Где работает
    В браузере на страницах сайта
    На сервере, события уходят напрямую
    От чего зависит
    От браузера, блокировщиков и ограничений Apple
    Ни от чего из этого не зависит
    Продажа в переписке
    Не видит: страницы нет, события нет
    Видит: отметка из чата уходит событием
    Сделка закрыта в CRM
    Не видит
    Принимаем по REST API и отправляем
    Привязка к объявлению
    По cookie и переходу на сайт
    По ctwa_clid из первого сообщения
    Что ломает передачу
    Расширения, режим инкогнито, запрет cookie
    Только неверный токен или чужой набор данных

    Почему события не доходят

    Шесть причин, из-за которых у компаний атрибуция так и не заводится

    Идентификатор клика не сохранён

    Meta присылает ctwa_clid один раз, вместе с первым сообщением. Если система его не записала, привязать продажу к объявлению уже нечем. У нас он сохраняется автоматически, ничего включать не нужно.

    У токена нет прав на набор данных

    Токен выпущен на системного пользователя, но доступ к набору данных ему не выдали. Meta отвечает ошибкой, события копятся впустую. Проверка доступа в кабинете ловит это до первой отправки.

    Перепутаны номера

    Номер набора данных и номер аккаунта WhatsApp Business похожи и оба состоят из цифр. Если их поменять местами, Meta вежливо примет запрос и ничего не засчитает.

    Одна продажа отправлена дважды

    Если событие шлёт и чат-бот, и CRM, статистика раздувается, а алгоритм учится на выдуманных цифрах. Решается просто: источник отметки должен быть один.

    Ожидание, что отправится всё подряд

    В Meta уходят только продажи и целевые лиды. Отказ и недозвон не отправляются: для Business Messaging отрицательных событий у Meta нет, алгоритм учится на удачах.

    Слишком мало событий

    Алгоритму нужно накопить статистику, поэтому по одной продаже в неделю кампания не перестроится. Чем ровнее поток отметок, тем быстрее видно эффект.

    Словарь: что значат эти слова

    Термины, которые встречаются в Events Manager и в документации Meta

    CAPI
    Conversions API, канал отправки событий с сервера в Meta. Работает и для сайта, и для переписки, но настраивается по-разному.
    ctwa_clid
    Click to WhatsApp Click ID, идентификатор клика по объявлению. Приходит с первым сообщением клиента и связывает будущую продажу с конкретным объявлением.
    Набор данных
    Хранилище событий в Meta, к которому привязан ваш аккаунт WhatsApp Business. Его номер вводится при подключении.
    Events Manager
    Раздел Meta, где видно поступающие события, их количество и ошибки. Там же берётся код для проверочных событий.
    QualifiedLead
    Событие о целевом обращении: человек подходит под ваши критерии и дошёл до расчёта, но ещё не заплатил.
    Код проверки
    Одноразовый код из вкладки «Тестирование событий». Событие с ним видно в Events Manager, но в отчёты кампаний оно не попадает.

    Частые вопросы

    Что такое CAPI простыми словами?

    CAPI (Conversions API) это канал, по которому ваш сервер сообщает Meta о результатах: покупке, заявке, целевом обращении. Пиксель делает то же самое из браузера, но в переписке браузера нет, поэтому события отправляются с сервера.

    Чем CAPI отличается от пикселя Meta?

    Пиксель работает на сайте и зависит от браузера, блокировщиков и ограничений Apple. CAPI отправляет события напрямую с сервера, поэтому доходят и те конверсии, которые пиксель не видит: продажи в переписке, оплаты по счёту, сделки, закрытые менеджером.

    Что такое ctwa_clid и зачем он нужен?

    Это идентификатор клика по объявлению с переходом в WhatsApp. Meta присылает его вместе с первым сообщением клиента. Мы сохраняем его рядом с диалогом, и при отправке события Meta понимает, какое именно объявление привело покупателя.

    Что нужно, чтобы подключить CAPI?

    Официальный WhatsApp Business API, номер набора данных из Events Manager, номер аккаунта WhatsApp Business и токен системного пользователя с доступом к набору данных. Всё это вводится в кабинете, в разделе «Продажи в Meta».

    Нужен ли программист?

    Нет. Подключение проходит мастером в кабинете, события отправляет наша серверная часть. Программист понадобится только в одном случае: если отметку о продаже вы хотите передавать из своей CRM через REST API.

    Какие события вы отправляете?

    Purchase для продажи и QualifiedLead для целевого лида. Что именно отправлять, вы выбираете в настройках: можно оставить только продажи.

    Передаются ли Meta тексты переписки?

    Нет. Уходят название события, время и идентификатор клика. Сообщения, файлы и карточки контактов остаются в сервисе.

    Как быстро событие попадает в рекламный кабинет?

    Отметки уходят в Meta раз в пять минут. В Events Manager они появляются почти сразу, а на оптимизацию кампании алгоритму нужно накопить несколько десятков событий.

    Можно ли сначала проверить, не портя статистику?

    Да. Проверка доступа просто спрашивает Meta, видит ли она ваш набор данных. Проверочное событие отправляется с кодом из вкладки «Тестирование событий» и в отчёты кампаний не попадает.

    Сколько стоит подключение CAPI?

    Отдельной платы нет: отправка событий входит в работу линии официального WhatsApp. Оплачиваете линию связи и сообщения по тарифам Meta, как обычно.

    Работает ли CAPI без официального WhatsApp?

    Нет. Идентификатор клика Meta присылает только по официальному каналу WhatsApp Business API. На обычном номере данных о рекламе нет, и связать продажу с объявлением невозможно.

    Что делать, если Meta отклоняет события?

    В кабинете видно последнюю проверку и текст ошибки. Чаще всего дело в токене без прав на набор данных или в перепутанных номерах набора и аккаунта WhatsApp Business: это поправимо в настройках за минуту.

    Подключим CAPI и покажем продажи в рекламном кабинете

    Поможем собрать набор данных, выпустить токен и проверить доступ. Первые 3 дня работы линии бесплатны.