Автоматически отправляйте диалоги WhatsApp в CRM
Чтобы автоматически отправлять диалоги WhatsApp в CRM, настройте доставку входящих сообщений в виде подписанных вебхуков на ваш бэкенд или в инструмент автоматизации, найдите контакт по номеру телефона или создайте его, а сообщение запишите как запись на этом контакте. Используйте id сообщения WhatsApp в качестве уникального ключа записи, чтобы повторная доставка обновляла ту же запись, а не создавала вторую.
easyCoexistence подключает номер WhatsApp Business, который вы ведёте в приложении, к Cloud API от Meta через Coexistence.
Заголовок пересылаемого POST-запроса с идентификатором доставки, одинаковым при каждой повторной отправке этой доставки.
Срок 7 попыток пересылки: примерно через 1, 5, 30, 120, 360 и 1 440 минут.
Шаг «Call my webhook» вызывает ваш URL один раз; тайм-аут или ошибка прерывают запуск и отправляют вам письмо.
Идентификатор пользователя в рамках бизнеса, например US.13491208655302741918, передаётся в полях user_id и from_user_id вместе с номером телефона или вместо него.
Как долго журнал запусков автоматизации хранит сообщение-триггер, ответ и каждый шаг.
Какие события должны попадать в CRM?
Диалог на номере Coexistence складывается из трёх видов сообщений, а доставляют их два маршрута. «Forward URL», который задаётся для каждого номера, отправляет то, что пишут клиенты, и то, что ваша команда набирает в приложении WhatsApp Business, в виде исходных событий Meta. Они повторно отправляются, пока CRM не ответит. Ответы, отправленные автоматизациями, попадают к Meta через API, который сообщает о них только статусами доставки без текста. Чтобы записать их содержимое, завершите автоматизацию шагом «Call my webhook»: в его истории есть ответ, который только что отправил запуск. Один эндпоинт может принимать оба вида. По заголовку X-EC-Event значение automation.step означает шаг, а для пересылок там стоит имя поля Meta.
Как сопоставить отправителя WhatsApp с контактом в CRM?
По номеру телефона, приведённому к единому виду. WhatsApp передаёт цифры с кодом страны и без знака плюс, например 5511987654321, в messages[].from в пересылках и в contact.wa_id в шаге вебхука. В записях CRM, которые вносят люди, номер записан как +55 11 98765-4321 или (11) 98765-4321, поэтому заведите отдельное свойство только с цифрами и ищите по нему. Если совпадений нет, создайте контакт с именем профиля WhatsApp и номером.
Сохраняйте также BSUID. Пользователь с именем пользователя WhatsApp, который 30 дней не писал вашему номеру, может прийти только с BSUID в from_user_id и contacts[].user_id. Пересылки передают его, а шаг вебхука передаёт номер телефона.
Что должна содержать каждая запись в CRM?
Контакт с идентификаторами и по одной записи на каждое сообщение с направлением, текстом, временем и уникальным ключом. Схема ниже показывает, где находится каждое значение на обоих маршрутах. Время сообщений в пересылках передаётся как Unix-секунды от Meta, а шаг вебхука отправляет даты в формате ISO. Медиа в пересылках приходят как тип и id, а в шаге вебхука как заглушки вроде [image] с подписью. Поэтому записывайте короткую метку, а не пытайтесь сохранить файл.
| Forwarded event (value is Meta's) | Call my webhook step | |
|---|---|---|
| Contact phone | messages[].from | contact.wa_id |
| Contact name | contacts[].profile.name | contact.name |
| BSUID | contacts[].user_id, messages[].from_user_id | Not sent |
| Activity text | text.body, or the media type | message.text and history[].text |
| Direction | messages = in, smb_message_echoes = out | history[].direction: in, out or echo |
| Time | timestamp, Unix seconds | message.at and history[].at, ISO 8601 |
| Unique key | messages[].id (wamid) | message.id; run_id for history entries |
Как избежать дублей при повторной отправке?
Отвечайте быстро, а затем задавайте ключ всему. Пересылка, на которую не пришёл ответ 2xx за 10 секунд, повторяется с тем же X-EC-Delivery, до 7 попыток. Поэтому вызов CRM, который длится 12 секунд, выполнится дважды, если запись не обновляется через upsert по wamid. Сначала отвечайте 200, а работу с CRM выполняйте в очереди или фоновом задании.
Шаг вебхука не повторяется, а повторные доставки Meta отфильтровываются до запуска автоматизации, поэтому он вызывает вас не более одного раза на сообщение. Записи истории не содержат id сообщения, поэтому автоматические ответы ключуйте по run_id и порядковому номеру. Тестовые вызовы из «Try it» приходят с dry_run true и тестовым контактом 15550000000. Пропускайте их, чтобы тестовые запуски не создавали записи в CRM.
Как выглядит приёмник на Node.js?
Один маршрут Express принимает оба вида событий. Он читает сырое тело запроса, выбирает секрет по заголовку X-EC-Event, проверяет X-EC-Signature, сразу отвечает 200 и передаёт работу фоновой функции. Объект crm означает клиент API вашей CRM: upsert контакта по номеру телефона только из цифр и upsert записи по её уникальному ключу. Та же схема работает в рабочем процессе n8n: узел Code проверяет подпись, а после него идут узлы вашей CRM.
import express from "express";
import crypto from "node:crypto";
const FORWARD_SECRET = process.env.EC_FORWARD_SECRET; // the number's, shown once with the Forward URL
const STEP_SECRET = process.env.EC_STEP_SECRET; // the automation's Signing secret
function signed(req, secret) {
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
const mac = crypto.createHmac("sha256", secret).update(m[1] + "." + req.body).digest();
return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}
const app = express();
app.post("/whatsapp/crm", express.text({ type: "application/json" }), (req, res) => {
const kind = req.get("X-EC-Event"); // automation.step, or Meta's field name for a forward
if (!signed(req, kind === "automation.step" ? STEP_SECRET : FORWARD_SECRET)) return res.status(401).end();
res.json({}); // no reply field: nothing is sent to the customer
handle(kind, JSON.parse(req.body)).catch(console.error);
});
async function handle(kind, body) {
if (kind === "messages") {
for (const m of body.value.messages ?? []) { // statuses are skipped
const c = (body.value.contacts ?? []).find((x) => x.wa_id === m.from);
const contact = await crm.upsertContact({ phone: m.from, bsuid: m.from_user_id, name: c?.profile?.name });
await crm.upsertActivity({ key: m.id, contact, direction: "in", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "smb_message_echoes") {
for (const m of body.value.message_echoes ?? []) {
const contact = await crm.upsertContact({ phone: m.to, bsuid: m.to_user_id });
await crm.upsertActivity({ key: m.id, contact, direction: "out", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "automation.step" && !body.dry_run) {
const contact = await crm.upsertContact({ phone: body.contact.wa_id, name: body.contact.name });
const sentAfter = body.history.filter((h) => h.direction === "out" && h.at >= body.message.at);
for (const [i, h] of sentAfter.entries()) {
await crm.upsertActivity({ key: body.run_id + ":" + i, contact, direction: "out", text: h.text, at: new Date(h.at) });
}
}
}
app.listen(3000);Может ли CRM обновлять лид по тому, что узнал ИИ?
Да, в вашем рабочем процессе. Чат, который приходит с шагом «Call my webhook», содержит вопросы, которые задал ваш ИИ, и ответы клиента. Поэтому узел модели в n8n или вызов в вашем бэкенде могут извлечь потребность, бюджет, сроки или местоположение, записать их в поля лида и перевести его на другой этап. Не возвращайте ответ: клиент уже получил сообщение ИИ. Когда рабочий процесс решает, что лид стоит звонка, он может создать задачу для менеджера по продажам или отправить оповещение команде. Или поручите извлечение easyCoexistence: шаг «agent or an AI saves details» записывает потребность, бюджет и сроки в поля контакта, а шаг «Call an API» может отправить их в вашу CRM с токенами вида {{contact.budget}} в теле запроса. На странице квалификации лидов есть инструкция по интервью и полезная нагрузка для такой настройки.
Как настроить
- Send the number's messages through easyCoexistenceOn the number's page, the Where incoming messages go card must be set to Through easyCoexistence; choose it if it shows Straight to your system.
- Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
- Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
- Log automated repliesIn each automation that replies, add Call my webhook as the last step with the same URL, save, and copy that automation's Signing secret.
- Check one real conversationWrite to the number from another phone, let the automation answer, reply from the app, and confirm three activities on the contact: in, automated out and phone out.
Распространённые ошибки
- Поиск в CRM по полю телефона со свободным текстом. Формат WhatsApp из одних цифр редко совпадает с тем, что человек ввёл вручную, и каждый промах создаёт дубль контакта. Ищите по нормализованному свойству только из цифр.
- Вызов CRM до ответа на пересылку. CRM, которая отвечает дольше 10 секунд, заставляет easyCoexistence повторять отправку, а без upsert по wamid запись сохраняется дважды.
- Логирование только пересылок с ожиданием автоответов. Отправки через API возвращаются как статусы без текста. Шаг «Call my webhook» после ответа передаёт его слова.
- Тесты доходят до CRM. «Try it» действительно вызывает ваш URL с dry_run true и тестовым контактом 15550000000. Отбрасывайте такие события до любого upsert.
Его «Forward URL» передаёт сообщения клиентов и ответы по телефону в CRM как исходные события Meta, подписанные для каждого номера и повторяемые около 33 часов, если CRM недоступна. Шаг «Call my webhook» добавляет автоматические ответы. Пересылки и автоматизации входят в тариф: от US$ 9 до US$ 0,75 за номер в месяц, с понижением по мере добавления номеров, и бесплатный пробный период на первые 3 дня.
Часто задаваемые вопросы
С какими CRM это работает?
С любой CRM, у которой есть API: через собственный бэкенд или через инструмент автоматизации, например n8n, Make или Zapier, у которого для неё есть узлы. У HubSpot есть объект Communications с типом канала WhatsApp, созданный для записи таких сообщений. На странице HubSpot показан вызов.
Может ли ваша команда отвечать клиентам из CRM?
Только если CRM отправляет через Cloud API от Meta, с эндпоинтом отправки номера и токеном из get_api_credentials: свободный текст в течение 24 часов после последнего сообщения клиента, а после этого одобренный шаблон. Такие сообщения также появляются в ветке чата в приложении на телефоне.
Можно ли загрузить прошлые переписки в CRM?
Только через импорт истории от Meta. Он отправляет до 6 месяцев личных чатов один на один на прямой адрес вебхука, сохранённый в течение 24 часов после подключения, один раз на подключение. Номер, настроенный на режим «Through easyCoexistence», ведёт записи с момента запуска пересылки.
Что easyCoexistence хранит по ходу дела?
Пересылаемые изменения ставятся в очередь для повторных попыток и удаляются через 7 дней. На номере, который работает через easyCoexistence, текст сообщений также хранится для Conversations и контекста для ИИ в течение выбранного вами срока: 30, 90 или 365 дней, а журналы запусков хранятся 30 дней. Постоянная запись остаётся в CRM.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на