ВойтиНачать бесплатный пробный период
Meta Tech Provider

Автоматически отправляйте диалоги WhatsApp в CRM

Чтобы автоматически отправлять диалоги WhatsApp в CRM, настройте доставку входящих сообщений в виде подписанных вебхуков на ваш бэкенд или в инструмент автоматизации, найдите контакт по номеру телефона или создайте его, а сообщение запишите как запись на этом контакте. Используйте id сообщения WhatsApp в качестве уникального ключа записи, чтобы повторная доставка обновляла ту же запись, а не создавала вторую.

easyCoexistence подключает номер WhatsApp Business, который вы ведёте в приложении, к Cloud API от Meta через Coexistence.

X-EC-Delivery

Заголовок пересылаемого POST-запроса с идентификатором доставки, одинаковым при каждой повторной отправке этой доставки.

About 33 hours

Срок 7 попыток пересылки: примерно через 1, 5, 30, 120, 360 и 1 440 минут.

1 attempt

Шаг «Call my webhook» вызывает ваш URL один раз; тайм-аут или ошибка прерывают запуск и отправляют вам письмо.

BSUID

Идентификатор пользователя в рамках бизнеса, например US.13491208655302741918, передаётся в полях user_id и from_user_id вместе с номером телефона или вместо него.

30 days

Как долго журнал запусков автоматизации хранит сообщение-триггер, ответ и каждый шаг.

Какие события должны попадать в CRM?

Диалог на номере Coexistence складывается из трёх видов сообщений, а доставляют их два маршрута. «Forward URL», который задаётся для каждого номера, отправляет то, что пишут клиенты, и то, что ваша команда набирает в приложении WhatsApp Business, в виде исходных событий Meta. Они повторно отправляются, пока CRM не ответит. Ответы, отправленные автоматизациями, попадают к Meta через API, который сообщает о них только статусами доставки без текста. Чтобы записать их содержимое, завершите автоматизацию шагом «Call my webhook»: в его истории есть ответ, который только что отправил запуск. Один эндпоинт может принимать оба вида. По заголовку X-EC-Event значение automation.step означает шаг, а для пересылок там стоит имя поля Meta.

Customer messagesForward URL, event messages, in value.messages
Replies typed on the phoneForward URL, event smb_message_echoes, in value.message_echoes
Automated repliesCall my webhook as the last step: history entries with direction out
Lead detailsSaved by an agent or an AI saves details step, or extracted by your workflow from the chat; see lead qualification

Как сопоставить отправителя 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 phonemessages[].fromcontact.wa_id
Contact namecontacts[].profile.namecontact.name
BSUIDcontacts[].user_id, messages[].from_user_idNot sent
Activity texttext.body, or the media typemessage.text and history[].text
Directionmessages = in, smb_message_echoes = outhistory[].direction: in, out or echo
Timetimestamp, Unix secondsmessage.at and history[].at, ISO 8601
Unique keymessages[].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.

Express receiver: forwards and Call my webhook steps into a 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}} в теле запроса. На странице квалификации лидов есть инструкция по интервью и полезная нагрузка для такой настройки.

Как настроить

  1. 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.
  2. Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
  3. Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
  4. 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.
  5. 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.
Настройка с EasyCoexistence

Его «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 в Google Sheets автоматическиЗаписывайте сообщения и контакты WhatsApp в Google Sheets с номера, который ведёте в приложении: подписанная пересылка или шаг вебхука в n8n, Make или Zapier.Уведомляйте команду, когда чату WhatsApp нужен человекОповещайте команду в Slack или по почте, когда клиент WhatsApp просит человека или ИИ передаёт чат. Автоматизация отступит, когда кто-то ответит.Запись сообщений WhatsApp в HubSpot с номера CoexistenceЗаписывайте сообщения номера Coexistence в хронологию контакта HubSpot через Communications API, n8n или Make. Команда продолжает отвечать с телефона.Квалификация лидов в WhatsApp с AIКвалифицируйте лиды WhatsApp своим AI: он задаёт первые вопросы, отправляет чат в CRM или n8n, а человек берёт горячие лиды на себя.Имена пользователей WhatsApp и BSUID: что меняется в вебхуках Cloud APIКак имена пользователей WhatsApp меняют вебхуки Cloud API: BSUID в user_id, когда пропадают wa_id и from, ответ по recipient и изменения Coexistence.Как сообщения WhatsApp доходят до вашего сервера: напрямую или через управляемый режим, и проверка подписиНапрямую: Meta шлёт вебхуки на ваш сервер. Через сервис: автоматизации отвечают, подписанная копия уходит на Forward URL.

Готовы начать?

Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.

Начать бесплатный пробный период

Проверено по состоянию на