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

Защитите автоматизации WhatsApp: ключи, вебхуки и подписи

Защитите автоматизацию WhatsApp в четырёх точках: ключ ИИ, который хранится в зашифрованном виде и используется только для ответов ИИ; вебхук, который вызывает автоматизация и который должен проверить подпись HMAC до того, как доверять запросу; пересылку входящих сообщений, подписанную секретом, который можно сменить; и людей и ассистентов с доступом, которым дан только нужный минимум.

easyCoexistence хранит ваши ключи ИИ в зашифрованном виде и никогда их не показывает, подписывает каждый запрос «Вызвать мой вебхук» и каждое пересланное сообщение заголовком X-EC-Signature секретом, который знаете только вы, и отклоняет адреса вебхуков, которые не являются публичным HTTPS.

AES-256-GCM

Шифрование при хранении для сохранённых ключей ИИ, секретов подписи и токена доступа Meta номера.

Last 4

Сохранённый ключ ИИ потом видно только как «заканчивается на» и четыре последних символа.

192 bits

Случайность в каждом секрете подписи: whsec_ и 24 случайных байта, по одному на автоматизацию и по одному на номер для пересылки.

HTTPS only

URL вебхуков и пересылки должны быть публичными HTTPS; частные и внутренние адреса отклоняются при сохранении и перед каждой отправкой.

5 minutes

Рекомендуемое ограничение возраста значения t в подписи, чтобы отклонять повторно отправленные запросы.

Что нужно защищать в настройке автоматизации WhatsApp?

Пять учётных данных, у каждого своё место и свой способ исправления при утечке. Два из них принадлежат самим автоматизациям: ключ ИИ и секрет подписи вебхука «Вызвать мой вебхук»; секрет пересылки принадлежит номеру; токен доступа и вход вашего ассистента принадлежат аккаунту. Зная, что есть что, вы понимаете, что менять при сбое.

AI keyYour Anthropic, OpenAI or OpenRouter key. Saved under AI keys, encrypted, shown only as its last 4 characters.
Webhook signing secretOne per automation, for Call my webhook. Shown as Signing secret in the editor once the automation is saved.
Forward secretOne per number, for the Forward URL. Shown once; New secret replaces it.
Number access tokenReturned by get_api_credentials for sending through Meta's API. Treat it like a password.
Assistant sign-inThe OAuth session of ChatGPT, Claude or another MCP client. Removed from the client's settings.

Как хранятся и используются ключи ИИ?

Только из панели управления: кнопка «Ключи ИИ» на странице автоматизаций, затем «Тест и сохранение». Ключ сначала проверяется через бесплатную конечную точку провайдера, которая не расходует токены; ключ, который провайдер отклоняет, отбрасывается и не сохраняется. Рабочий ключ шифруется при хранении алгоритмом 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": "..."} отправляется клиенту как написано, поэтому никогда не пропускайте текст клиента без проверки.

A Call my webhook request: headers and body
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, сделанные тогда, настоящие.
  • Вставка ключа ИИ в чат с ассистентом, чтобы сэкономить время. Ни один инструмент его не принимает, и он остаётся в истории чата; используйте ключи ИИ в панели управления.
  • Проверка пересылки секретом «Вызвать мой вебхук» или наоборот. Это разные секреты: один на номер для пересылок, один на автоматизацию для вызовов вебхука.
Настройка с EasyCoexistence

Номер остаётся на официальном 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 к ChatGPT или Claude?Как безопасно подключить номер WhatsApp Business к ChatGPT или Claude: официальный API, вход через OAuth, подтверждения, блокировка инструментов и отзыв доступа.Как сообщения WhatsApp доходят до вашего сервера: напрямую или через управляемый режим, и проверка подписиНапрямую: Meta шлёт вебхуки на ваш сервер. Через сервис: автоматизации отвечают, подписанная копия уходит на Forward URL.Отвечайте клиентам в WhatsApp актуальными данными: цены, остатки и наличие из вашей системыОтвечайте на вопросы в WhatsApp о ценах, остатках и свободных слотах: подписанный вебхук запрашивает вашу систему, и ответ уходит за 20 секунд.Автоматически отправляйте диалоги WhatsApp в CRMЗаписывайте диалоги WhatsApp в CRM с номера из приложения: подписанные события, поиск контакта по телефону или BSUID, дедупликация по id сообщения.Лучшие практики автоматизации WhatsApp: 12 правил12 правил автоматизации WhatsApp из политики Meta и реальных лимитов: тест до запуска, один ответ на сообщение, путь к человеку, окно 24 часа и лимиты ИИ.Проверка эндпоинта вебхука WhatsAppMeta отправляет на ваш эндпоинт GET-проверку до доставки событий. Что приходит, что вернуть и почему неверный ответ не вызывает ошибки.

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

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

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

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