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

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

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

Подключить Сколько это стоит

Подключение в кабинете
Без разработчика
События по ctwa_clid

ctwa_clidидентификатор клика приходит с первым сообщением

2 событияпродажа и целевой лид уходят в Meta

5 минутчерез столько отметка попадает в рекламный кабинет

Сумма сделкиуходит вместе с продажей, если менеджер её указал

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

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

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

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

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

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

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

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

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

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

Путь события

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

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

01
Клик по объявлению
Человек нажимает «Написать в WhatsApp». Meta выдаёт идентификатор этого клика и запоминает, какое объявление сработало.
Meta запоминает объявление
02
Первое сообщение
Идентификатор приходит нам вместе с первым сообщением клиента. Захватить его можно только в этот момент: позже он не восстановится.
Метка приходит вместе с сообщением
03
Переписка и сделка
Менеджер отвечает в общем чате. Над перепиской видно объявление и кампанию, из которых пришёл человек.
Объявление видно над перепиской
04
Отметка результата
После разговора менеджер отмечает: продажа, целевой лид, отказ или нет ответа. У продажи можно указать сумму.
Продажа или целевой лид
05
Событие в Meta
Раз в пять минут накопленные отметки уходят в Meta с идентификатором клика. Алгоритм видит, какое объявление принесло деньги.
Отметка уходит в рекламный кабинет

Интерфейс

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

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

С рекламы

Доставка за 2 часа по городуКампания: Лето · Доставка · CTWAID 120210987654321

Здравствуйте! Сколько стоит доставка до Медеуского района?

Добрый день! До Медеуского 1 500 ₸, привезём сегодня до 19:00.

Карточка объявления стоит прямо над перепиской: менеджер сразу понимает, о чём человек прочитал в рекламе.

Чем закончился разговор

Сумма продажи, ₸185 000

Сохранить

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

Продажи в MetaРаботает

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

Набор данных1298600768857819
ТокенEAAG…9fZB

Уйдёт: продажа на 185 000 ₸Meta засчитает сделку этому объявлению и начнёт искать похожих покупателей.

Последняя проверка: сегодня, доступ есть

Состояние подключения видно в кабинете. Токен показывается замаскированным, а проверка доступа ничего не отправляет в отчёты.

Как подключить CAPI для WhatsApp?

Настройка идёт в кабинете, в разделе «Продажи в Meta». Нужны три значения из Events Manager и бизнес-менеджера Meta, программист не нужен.

15 минут

Официальная линия WhatsApp

Если линии ещё нет, создаёте её в кабинете. ctwa_clid Meta присылает только по официальному каналу.

в Events Manager

Набор данных

Находите номер набора данных, к которому привязан ваш аккаунт WhatsApp Business, и номер самого аккаунта.

в бизнес-менеджере

Токен системного пользователя

Выпускаете токен и выдаёте системному пользователю доступ к набору данных. Без этого Meta отклонит события.

один экран

Ввод и проверка доступа

Вводите три значения и нажимаете проверку. Проверочное событие с кодом из «Тестирования событий» в отчёты не попадёт.

раз в 5 минут

Отметки менеджеров

Менеджер отмечает продажу или целевой лид, и событие уходит в Meta вместе с идентификатором клика.

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

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

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

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

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

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

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

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

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

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

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

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

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

Данные

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

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

Уходит в Meta

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

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

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

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

Прикидка

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

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

Сделок из рекламы в месяц30Средний чек60 000 ₸

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

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

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

Подключить CAPI

Цена CAPI

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

Одна подписка на весь CAPI: продажи по рекламе в WhatsApp и лид-формы Facebook и Instagram из amoCRM и Битрикс24. Без лимита событий, первые 7 дней бесплатно.

Безлимитсобытий в месяц

25 900 ₸/ месяц

или $54 · €49Подключить

При оплате за полгода скидка 10%, за год 20%.
Видеть, из какого объявления пришёл клиент, можно и без пакета: это входит в линию официального WhatsApp.

Сколько стоит переписка с теми, кто пришёл из рекламы?

Посчитайте сообщения людям, нажавшим «Написать в WhatsApp»: ответы в течение суток после сообщения клиента обходятся дешевле всего.

Ваша страна

Ставки Meta зависят от страны получателей. Ниже итоговые цены за одно сообщение.

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

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

40,98 ₸ за сообщение40 980 ₸

Уведомления500 шт.

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

13,61 ₸ за сообщение6 803 ₸

Ответы в переписке2 000 шт.

Всё, что менеджер пишет клиенту, пока открыто окно 24 часа. Первые 1 000 в месяц на номер по сниженной цене

первые 1 000: 1,47 ₸, дальше 13,61 ₸15 073 ₸

Ваш счёт за месяц

Платформа и линия29 900 ₸

Сообщения62 856 ₸

Итого

92 756 ₸

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

Сколько стоит линия, на которой работает CAPI?

CAPI работает только на линии официального WhatsApp. Ниже её цена и то, что входит в тариф.

Линия WhatsApp Business API

29 900 ₸ / месяц

или $68 · €61

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

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

Что входит

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

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

Бесплатных мест для менеджеров: 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

Не видит

amoCRM сама по этапу сделки, другие 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?

CAPI оплачивается отдельной подпиской, лимита на число событий нет. Пакеты и цены показаны в блоке «Цена CAPI» выше, первые 7 дней без оплаты. Сама линия официального WhatsApp оплачивается по своему тарифу.

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

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

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

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

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

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

Начать бесплатно Задать вопрос

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