Защитите автоматизации WhatsApp: ключи, вебхуки и подписи
Защитите автоматизацию WhatsApp в четырёх точках: ключ ИИ, который хранится в зашифрованном виде и используется только для ответов ИИ; вебхук, который вызывает автоматизация и который должен проверить подпись HMAC до того, как доверять запросу; пересылку входящих сообщений, подписанную секретом, который можно сменить; и людей и ассистентов с доступом, которым дан только нужный минимум.
easyCoexistence хранит ваши ключи ИИ в зашифрованном виде и никогда их не показывает, подписывает каждый запрос «Вызвать мой вебхук» и каждое пересланное сообщение заголовком X-EC-Signature секретом, который знаете только вы, и отклоняет адреса вебхуков, которые не являются публичным HTTPS.
Шифрование при хранении для сохранённых ключей ИИ, секретов подписи и токена доступа Meta номера.
Сохранённый ключ ИИ потом видно только как «заканчивается на» и четыре последних символа.
Случайность в каждом секрете подписи: whsec_ и 24 случайных байта, по одному на автоматизацию и по одному на номер для пересылки.
URL вебхуков и пересылки должны быть публичными HTTPS; частные и внутренние адреса отклоняются при сохранении и перед каждой отправкой.
Рекомендуемое ограничение возраста значения t в подписи, чтобы отклонять повторно отправленные запросы.
Что нужно защищать в настройке автоматизации WhatsApp?
Пять учётных данных, у каждого своё место и свой способ исправления при утечке. Два из них принадлежат самим автоматизациям: ключ ИИ и секрет подписи вебхука «Вызвать мой вебхук»; секрет пересылки принадлежит номеру; токен доступа и вход вашего ассистента принадлежат аккаунту. Зная, что есть что, вы понимаете, что менять при сбое.
Как хранятся и используются ключи ИИ?
Только из панели управления: кнопка «Ключи ИИ» на странице автоматизаций, затем «Тест и сохранение». Ключ сначала проверяется через бесплатную конечную точку провайдера, которая не расходует токены; ключ, который провайдер отклоняет, отбрасывается и не сохраняется. Рабочий ключ шифруется при хранении алгоритмом AES-256-GCM, расшифровывается только для вызова этого провайдера в ваших шагах ИИ и агентах, а также для озвучивания голосовых сообщений на ключе OpenAI или OpenRouter, а потом показывается только как «заканчивается на 1234». Ни один инструмент MCP не принимает и не возвращает ключ, поэтому он никогда не проходит через чат с вашим ассистентом.
В аккаунте один ключ на провайдера, и сохранение нового заменяет старый. Создайте отдельный ключ для автоматизаций у провайдера, с лимитом расходов, если провайдер его предлагает, чтобы его можно было отозвать, не сломав другие приложения. Если провайдер когда-либо его отклонит, автоматизации с этим ключом покажут статус «Приостановлена», и вы получите одно письмо; сохранение рабочего ключа перезапустит их самостоятельно.
Как проверить, что запрос «Вызвать мой вебхук» подлинный?
Проверяйте подпись раньше всего остального. Каждый запрос несёт X-EC-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">, подписанный секретом подписи этой автоматизации, который вы копируете из шага в редакторе после сохранения. Пересчитайте HMAC по необработанным байтам, сравните за постоянное время и отклоняйте t, которое отличается от ваших часов больше чем на 5 минут. Тело запроса тоже даёт две важные вещи. dry_run равно true, когда запрос пришёл из пробного запуска, поэтому пропускайте необратимые действия, например создание заказа. А run_id уникален для каждого запуска, поэтому сохраняйте уже обработанные и отклоняйте повторно отправленный запрос. Отвечайте в течение 20 секунд; {"reply": "..."} отправляется клиенту как написано, поэтому никогда не пропускайте текст клиента без проверки.
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
"run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
"channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
"history": [
{ "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
{ "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
]
}
// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }Как работают секреты пересылки и как их менять?
Номер в режиме «Through easyCoexistence» может пересылать входящие сообщения в вашу систему. При первом сохранении URL пересылки создаётся секрет, который показывается один раз под надписью «Секрет подписи, показывается один раз. Скопируйте его сейчас:»; он подписывает каждый переданный POST по той же схеме X-EC-Signature. Новый секрет на странице номера или set_inbound_mode с rotate_secret, равным true, создаёт замену, которая тоже показывается один раз, и с этого момента подписывается всё, включая повторные отправки более старых доставок. Можно также ввести собственный секрет длиной не менее 24 символов: он сохраняется и больше не показывается. Остановка пересылки удаляет секрет, поэтому при следующем сохранении URL начнётся новый.
Меняйте секрет после ухода сотрудника с доступом, после попадания секрета в репозиторий, тикет или лог и при смене хостинга. Секрет «Вызвать мой вебхук» принадлежит автоматизации, и его видит только владелец аккаунта. Если в редакторе под триггером «Your system calls a URL» есть кнопка «New secret», она заменяет секрет, и старый сразу перестаёт работать; в автоматизации без этой кнопки создайте автоматизацию заново, укажите получателю новый секрет, а затем удалите старую автоматизацию.
На какие адреса могут обращаться автоматизации?
Только на публичные адреса HTTPS. URL «Вызвать мой вебхук» или URL пересылки, который начинается с http://, указывает на localhost, в частную сеть, на имя .internal или .local либо на адрес метаданных облака, отклоняется при сохранении и проверяется снова после DNS перед каждым запросом, поэтому публичное имя позже нельзя направить во внутреннюю сеть. Перенаправления не выполняются: ответ 301 или 302 проваливает шаг, поэтому сохраняйте итоговый адрес.
Не храните секреты в самом URL. list_automations возвращает шаги каждой автоматизации, включая URL вебхука, любому ассистенту, подключённому к вашему аккаунту, поэтому токен в строке запроса там читается. Лучше доказывайте подлинность подписью.
Как свести доступ к минимуму?
Давайте каждому человеку и каждому инструменту только тот доступ, который нужен для их задачи, и убирайте то, что больше не используется. Сторона коннектора, с входом, подтверждениями и заблокированными инструментами, описана на странице о безопасном подключении WhatsApp к ИИ; со стороны автоматизаций важнее всего эти привычки:
- Запрашивайте
get_api_credentialsтолько в приватном чате: токен доступа номера тогда остаётся в истории этого чата. - Предпочитайте «Вызвать мой вебхук» или URL пересылки передаче токена сторонней программе.
- Удаляйте выведенные из использования автоматизации; это также отзывает их секреты подписи.
- Помните, что журналы запусков хранят сообщения клиентов и ответы 30 дней, а Conversations хранят чаты в течение вашего срока хранения (30, 90 или 365 дней); всё это видно в панели управления и через подключённого ассистента.
- Для номера с режимом «Straight to your system» добавьте в путь URL обратного вызова длинный случайный секрет, так как подпись Meta там проверить нельзя.
Распространённые ошибки
- Проверка подписи по JSON, который фреймворк пересериализовал. Многие парсеры меняют пробелы, экранирование или порядок ключей; вычисляйте HMAC по необработанным байтам запроса везде, где стек их открывает.
- Побочные эффекты при тестовых вызовах. Пробный запуск вызывает ваш вебхук с dry_run, равным true; заказ, возврат или запись в CRM, сделанные тогда, настоящие.
- Вставка ключа ИИ в чат с ассистентом, чтобы сэкономить время. Ни один инструмент его не принимает, и он остаётся в истории чата; используйте ключи ИИ в панели управления.
- Проверка пересылки секретом «Вызвать мой вебхук» или наоборот. Это разные секреты: один на номер для пересылок, один на автоматизацию для вызовов вебхука.
Номер остаётся на официальном Cloud API Meta через Coexistence, под мониторингом 24/7. От US$ 9 до US$ 0,75 за номер в месяц, со снижением по мере добавления номеров, первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли персонал или поддержка easyCoexistence увидеть мой ключ ИИ?
Ключ никогда не отображается после сохранения: ни в панели управления, ни в результатах MCP, ни в фактах, которые читает ассистент поддержки. Его расшифровывает только система в момент, когда она вызывает вашего провайдера для ответа ИИ.
Кто может читать журналы запусков автоматизаций?
Любой, кто вошёл в ваш аккаунт easyCoexistence, включая приглашённых вами людей, на вкладке «Запуски», и любой ассистент, подключённый к аккаунту, через list_automation_runs и get_automation_run. Журналы содержат сообщение клиента и ответ и удаляются через 30 дней.
Как безопасно удалить ключ ИИ?
Сначала выключите автоматизации, которые его используют, и всех агентов, которые работают на нём, затем выберите «Удалить» в разделе «Ключи ИИ» и отзовите ключ у провайдера. Удаление, пока автоматизации его ещё используют, приостанавливает их при следующем ответе ИИ и отправляет вам письмо.
Отправляет ли «Попробовать» данные клиента на мой вебхук?
Он отправляет только образец текста, который вы ввели, с dry_run, равным true, и пустой историей. Реальные запуски отправляют входящее сообщение и последние сообщения чата, до 10, поэтому считайте свой эндпоинт обрабатывающим данные клиентов.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на