Сохраняйте сообщения и контакты WhatsApp в Google Sheets автоматически
Чтобы автоматически сохранять сообщения WhatsApp Business в Google Sheets, отправляйте их подписанными HTTP POST-запросами в инструмент автоматизации, например n8n, Make или Zapier. Его шаг Google Sheets добавляет строку на каждое сообщение: время, направление, номер телефона, имя, текст и message id. Вторая вкладка, привязанная к номеру телефона, хранит одну строку на контакт и обновляется, когда человек пишет снова.
easyCoexistence подключает номер WhatsApp Business, который вы ведёте в приложении, к Cloud API от Meta через Coexistence.
Пересланные доставки повторяются примерно через 1, 5, 30, 120, 360 и 1 440 минут, если ваш URL не отвечает.
Сколько времени пересланный POST ждёт ответа 2xx, прежде чем доставка будет повторена.
Запросы на запись в Google Sheets API: лимит в минуту на пользователя и проект; 300 на проект.
Вывод веб-приложения Apps Script перенаправляется на одноразовый URL по адресу script.googleusercontent.com.
Объект события doPost в Apps Script содержит тело и параметры, но не заголовки HTTP-запроса.
Какой маршрут должен заполнять таблицу?
На номере, сообщения которого проходят через easyCoexistence, есть два маршрута, и они решают разные задачи. Forward URL задаётся один раз для каждого номера и передаёт исходные события Meta независимо от того, отвечает ли автоматизация: сообщения клиентов, ответы, которые ваша команда набирает в приложении WhatsApp Business, и статусы доставки. Это маршрут для полного журнала сообщений. Шаг Call my webhook внутри автоматизации срабатывает только на сообщения, которые эта автоматизация отбирает, и передаёт недавний чат, включая ответ, который автоматизация только что отправила. Он подходит для таблицы лидов, заказов или заявок, с которыми работает одна автоматизация. Оба маршрута подписаны, с разными секретами.
| Forward URL (per number) | Call my webhook step (per automation) | |
|---|---|---|
| Fires on | Any message event on the number, with or without automations | Only messages that automation is picked for |
| Carries | Meta's original value: messages, phone replies, statuses | The message, the contact and up to 10 recent messages |
| Automated replies | Delivery statuses only, without the text | In history, direction out |
| Retries | 7 attempts over about 33 hours | One attempt |
| Signed with | The number's forward secret, shown once | The automation's Signing secret |
| Set in | Number page, Where incoming messages go card | The automation editor, or create_automation |
Какие поля приходят и какие столбцы нужны таблице?
Пересланный POST оборачивает одно изменение Meta: id (доставку), event (имя поля Meta, например messages или smb_message_echoes), received_at, connection (id вашего номера, phone и phone_number_id) и value, точно в том виде, в каком его отправила Meta. В value поле messages содержит то, что написали клиенты, а message_echoes содержит то, что ваша команда набрала на телефоне. Номера телефонов приходят как цифры с кодом страны, без знака плюс; храните этот столбец как обычный текст, чтобы Sheets не превратил его в число. Пользователь с именем пользователя WhatsApp может прийти с ID пользователя в рамках бизнеса рядом с номером или вместо него, поэтому оставьте для него отдельный столбец.
Как построить журнал сообщений в n8n?
Три узла. Узел Webhook с HTTP Method POST, Respond со значением Immediately и Production URL, сохранённый как Forward URL номера. Узел Code, который проверяет X-EC-Signature секретом пересылки и превращает событие в строки, пропуская статусы доставки. Узел Google Sheets с операцией Append or Update Row и Column to match on, равным Message id, чтобы повторная доставка переписывала ту же строку, а не добавляла новую.
Секрет пересылки показывается один раз, при сохранении Forward URL; если он потерян, нажмите New secret и вставьте новый. В n8n Cloud модуль crypto в узлах Code разрешён; самостоятельно развёрнутому n8n нужна переменная NODE_FUNCTION_ALLOW_BUILTIN=crypto.
const crypto = require('crypto');
const SECRET = 'whsec_...'; // the number's forward secret, shown once when you saved the Forward URL
const { headers, body } = $input.first().json;
const sig = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(headers['x-ec-signature'] || '');
if (!sig || Math.abs(Date.now() / 1000 - Number(sig[1])) > 300) throw new Error('Bad or stale signature');
// n8n has parsed the body; it was sent as compact JSON, so JSON.stringify rebuilds the signed bytes.
const mac = crypto.createHmac('sha256', SECRET).update(sig[1] + '.' + JSON.stringify(body)).digest();
if (!crypto.timingSafeEqual(mac, Buffer.from(sig[2], 'hex'))) throw new Error('Bad signature');
const { event, connection, value } = body;
const names = Object.fromEntries((value.contacts || []).map((c) => [c.wa_id, c.profile?.name || '']));
const textOf = (m) => m.text?.body ?? m.button?.text ?? m.interactive?.button_reply?.title
?? m.interactive?.list_reply?.title ?? ('[' + m.type + '] ' + (m[m.type]?.caption || '')).trim();
const row = (m, direction, phone) => ({
time: new Date(Number(m.timestamp) * 1000).toISOString(), direction, phone,
user_id: m.from_user_id || '', name: names[phone] || '', text: textOf(m),
message_id: m.id, number: connection.phone,
});
let rows = [];
if (event === 'messages') rows = (value.messages || []).map((m) => row(m, 'in', m.from || '')); // statuses skipped
if (event === 'smb_message_echoes') rows = (value.message_echoes || []).map((m) => row(m, 'out', m.to || ''));
return rows.map((json) => ({ json }));Как держать одну строку на контакт?
Добавьте второй узел Google Sheets на вкладку Contacts, тоже с Append or Update Row, с сопоставлением по Phone. Сопоставьте номер телефона, имя профиля, ID пользователя, время и текст последнего сообщения. Первое сообщение с номера создаёт его строку; последующие обновляют имя и столбцы последнего контакта, поэтому вкладка одновременно служит списком тех, кто писал и когда. Заметки, которые вы пишете вручную, храните на отдельной вкладке, которую ищут по номеру телефона, чтобы рабочий процесс никогда их не перезаписывал.
Контакты из адресной книги телефона так не приходят. Meta отправляет их вместе с чатами за последние 6 месяцев только на прямой адрес вебхука, сохранённый в течение 24 часов после подключения номера.
Может ли Apps Script получать сообщения напрямую?
Нет, не чисто, поэтому поставьте перед таблицей инструмент автоматизации. Google отдаёт ответ веб-приложения Apps Script через перенаправление на одноразовый URL script.googleusercontent.com, а easyCoexistence перенаправления не выполняет. Ответ 302 считается неудачной доставкой: пересылка повторяется до 7 раз, и каждый повтор снова запускает doPost и записывает ещё одну строку, а шаг Call my webhook завершается ошибкой и отправляет вам письмо. Кроме того, doPost не может читать заголовки запроса, поэтому проверка X-EC-Signature там невозможна.
Apps Script остаётся хорошим решением для обратного направления: отправки утверждённых шаблонов из строк таблицы, о чём с кодом рассказано на странице интеграции с Google Sheets.
Могут ли Make или Zapier заполнять таблицу вместо этого?
Да. В Make запустите сценарий через Webhooks > Custom webhook и добавьте Google Sheets > Add a Row; в Zapier используйте Webhooks by Zapier с Catch Raw Hook, который сохраняет заголовки, а затем Google Sheets > Create Spreadsheet Row. Оба сразу отвечают на POST кодом 2xx, что нужно пересылке в пределах её 10 секунд. Сопоставьте те же поля, что указаны выше, из value.messages, и отфильтруйте события, у которых в value вместо messages стоят statuses.
Относитесь к URL хука как к паролю: любой, кто его знает, может отправлять строки. Если ваш тариф включает шаг с кодом, проверяйте там X-EC-Signature тем же рецептом HMAC, что и в узле n8n.
Как избежать дублей и пропущенных строк?
Дубли появляются из-за повторов. Пересылка, которая не получила 2xx в течение 10 секунд, отправляется снова с тем же заголовком X-EC-Delivery и тем же id в теле; сообщения внутри сохраняют свой wamid, поэтому сопоставление по Message id делает повтор безвредным. На маршруте с шагом webhook тесты из Try it приходят с dry_run true: направьте их на тестовую вкладку или отбросьте.
Пропущенные строки возникают из-за квоты записи Google. Sheets API разрешает 60 запросов на запись в минуту на пользователя и проект, а одни учётные данные n8n соответствуют одному пользователю; всплеск ответов после кампании шаблонов может превысить лимит и получить HTTP 429. Включите Retry On Fail в настройках узла Google Sheets или собирайте сообщения несколько секунд и добавляйте их одним запросом.
Как настроить
- Check the number's modeOn the number's page, the card Where incoming messages go must show Through easyCoexistence. If it shows Straight to your system, choose Through easyCoexistence.
- Build the workflowWebhook node (POST, Respond Immediately), the Code node above, then Google Sheets with Append or Update Row matched on Message id. Activate it and copy the Production URL.
- Save the Forward URLPaste the Production URL into Forward URL (optional) and click Save forward URL. Copy the signing secret shown once into the Code node.
- Send a test messageFrom another phone, write to your number and reply to it from the WhatsApp Business app. Two rows should appear: one in, one out.
Распространённые ошибки
- Проверка пересылки секретом автоматизации (Signing secret) или наоборот. Forward URL подписывается секретом пересылки номера, а Call my webhook собственным секретом автоматизации; выбирайте секрет по заголовку X-EC-Event.
- Добавление строки на каждый POST без ключа. Доставка, повторённая после медленного ответа, записывает одно и то же сообщение дважды; используйте Append or Update Row с сопоставлением по message id.
- Запись статусов доставки как сообщений. Событие messages также несёт статусы sent, delivered и read в value.statuses; у них нет текста, и они создают пустые строки.
- Сохранение URL веб-приложения Apps Script как Forward URL. Его перенаправление считается ошибкой, поэтому каждая из 7 попыток снова запускает doPost и добавляет дублирующую строку.
При включённых автоматизациях Forward URL передаёт исходные события Meta в ваш рабочий процесс, подписанные секретом, известным только вам, и повторяет доставку, когда ваш URL недоступен. Шаг Call my webhook отправляет то, что обработала автоматизация, вместе с её ответом. Оба входят в тариф. От US$ 9 за подключённый номер в месяц, до US$ 0,75 по мере добавления номеров, с первыми 3 днями бесплатно.
Часто задаваемые вопросы
Получает ли таблица сообщения, которые моя команда набирает на телефоне?
Да, через Forward URL. Ответы, набранные в приложении WhatsApp Business, приходят как события smb_message_echoes с номером клиента в поле to. Ответы, отправленные автоматизациями, возвращаются только как статусы доставки, поэтому записывайте их текст через шаг Call my webhook, поставленный после ответа.
Можно ли загрузить в таблицу существующие чаты?
Не на номере, сообщения которого проходят через easyCoexistence. Meta отправляет чаты один на один за последние 6 месяцев только на прямой адрес вебхука, сохранённый в течение 24 часов после подключения, и только один раз для каждого подключения. Номер, подключённый через easyCoexistence, ведёт журнал с момента сохранения Forward URL.
Сохраняет ли easyCoexistence копию сообщений?
Частично. На номере, маршрутизируемом через easyCoexistence с включёнными автоматизациями, текст сообщений хранится в течение выбранного вами срока, 30, 90 или 365 дней (по умолчанию 90), и отображается в Conversations; пересылаемые доставки удерживаются до 7 дней для повторных попыток, а журналы запусков хранятся 30 дней. Таблица остаётся вашей постоянной копией.
Может ли мой ИИ читать таблицу, чтобы отвечать клиентам?
Не из шага Reply with AI, который читает только свои Instructions и чат. ИИ-агент может искать данные через пользовательский HTTP-инструмент, а шаг Call my webhook или Call an API может отправить вопрос в рабочий процесс, который найдёт ответ в таблице и вернёт его как ответ.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на