Автоматическая отправка сообщений WhatsApp из ваших систем
Чтобы отправлять сообщения WhatsApp автоматически из собственных систем, вызовите Cloud API Meta: отправьте POST-запрос на эндпоинт /messages номера с токеном доступа. Сообщение человеку, который не писал за последние 24 часа, должно быть одобренным шаблоном. Свободный текст работает только в течение 24 часов после последнего сообщения клиента. Ответы на входящие сообщения можно автоматизировать отдельно.
easyCoexistence подключает номер WhatsApp Business, который вы уже используете, к Cloud API Meta через Coexistence и выдаёт его учётные данные в панели управления или через get_api_credentials.
Сообщения, которые не являются шаблонами, доставляются только в течение 24 часов после последнего сообщения клиента; после этого доставляются только шаблоны.
Фиксированная пропускная способность Cloud API для номера, который одновременно используется в приложении WhatsApp Business и через API.
Сообщения, отправленные и полученные через Cloud API, отображаются в приложении WhatsApp Business на номере Coexistence.
Уникальные люди, которым новый Business Portfolio может написать вне окна обслуживания клиентов за скользящие 24 часа.
Эндпоинт отправки, который easyCoexistence выдаёт для номера: базовый адрес Graph API, затем phone number ID и /messages.
Какие сообщения ваши системы могут отправлять самостоятельно?
Два типа, и то, сколько времени прошло с последнего сообщения клиента, определяет, какой из них примет Meta. Система, которая отправляет подтверждение заказа, напоминание о записи или чек об оплате человеку, который сегодня не писал, требует одобренного шаблона. Система, которая отвечает на вопрос, заданный час назад, может отправить обычный текст. Meta выставляет счёт за платные сообщения самому бизнесу в его собственном WhatsApp Business Account, за каждое сообщение, по категории и стране, без наценки от easyCoexistence.
| Approved template | Free-form message | |
|---|---|---|
| When it is allowed | Any time, to a person who opted in | Within 24 hours of the customer's last message |
| Review | Meta reviews it first, usually in minutes, up to about 24 hours | None |
| Typical use | Order shipped, appointment tomorrow, payment received | Answering a question, sending a link they asked for |
| Content | Fixed text with variables filled per person | Any text, media or interactive message |
Где взять учётные данные для отправки?
На странице номера в панели управления easyCoexistence или через вашего ИИ. В блоке «Put this number to work» карточка «Plug in your own system» показывает базовый адрес API, эндпоинт отправки, WABA ID и phone number ID, а также кнопку «Reveal access token» для токена доступа и кнопку «Show curl example» для готового запроса. Относитесь к токену как к паролю: любой, у кого он есть, может писать сообщения от имени вашего бизнеса. Если карточка сообщает, что токен не выдан, нажмите «Reconnect to issue a token» с компьютера; переподключение только добавляет токен. Спросите ChatGPT или Claude «мои учётные данные API для номера», и они вызовут get_api_credentials, который вернёт те же значения.
curl -X POST "https://graph.facebook.com/<VERSION>/<PHONE_NUMBER_ID>/messages" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "template",
"template": {
"name": "order_shipped",
"language": { "code": "en_US" },
"components": [{
"type": "body",
"parameters": [
{ "type": "text", "text": "Ana" },
{ "type": "text", "text": "#1042" }
]
}]
}
}'Может ли ваш ИИ отправить сообщение вместо кода?
Да, для сообщений, которые вы решили отправить сейчас. С коннектором easyCoexistence в ChatGPT или Claude просьба «отправь шаблон order_shipped на номер 5511999998888 с Ana и #1042» превращается в один вызов send_template, а просьба «ответь Ana, что торт готов» становится send_message, который работает только в течение 24 часов после её последнего сообщения. Каждый вызов отправляет сообщение одному человеку, и ChatGPT может попросить подтвердить действие перед запуском инструмента, который что-то записывает. Это подходит для разовых отправок и проверок. Задача, которая должна работать сама по себе, например на каждый новый заказ, не выполняется внутри ассистента: ваша система или рабочий процесс в n8n может вызывать Cloud API напрямую или отправлять POST с номером человека на webhook-автоматизацию на номере, которая отправляет одобренный шаблон с подставленными в переменные данными заказа.
Какие события обычно запускают автоматическое сообщение WhatsApp?
Что-то, что уже происходит в вашем бизнес-софте, превращённое в одну отправку шаблона. Схема одинаковая: событие запускает вебхук или рабочий процесс, рабочий процесс заполняет переменные шаблона из записи и отправляет сообщение на эндпоинт отправки. Такие шаблоны обычно относятся к категории UTILITY, пока в них нет предложения:
- Заказ оплачен или отправлен в вашем магазине: подтверждение или данные для отслеживания с номером заказа.
- Запись создана или назначена на завтра в вашем сервисе записи: дата, время и адрес.
- Платёж получен или просрочен в вашей биллинговой системе: сумма и ссылка.
- Форма отправлена на вашем сайте с отмеченным согласием на WhatsApp: первое сообщение, которое это подтверждает.
Что происходит, когда клиент отвечает на автоматическое сообщение?
Ответ попадает в приложение WhatsApp Business, как любое другое сообщение, и открывает 24-часовое окно, в котором можно отправить любой текст в ответ. На номере в режиме «Through easyCoexistence» ответ может также запустить автоматизацию: ответ по ключевому слову на частые вопросы, меню с кнопками, AI agent или шаг «Reply with AI» с вашим собственным ключом, или «Call my webhook», чтобы передать сообщение вашей системе. Добавьте Forward URL, чтобы получать исходные сообщения и статусы доставки в своей системе, подписанные ключом для каждого номера. В режиме «Straight to your system» Meta доставляет всё на ваш эндпоинт, а автоматизации отключаются. Ваша команда может ответить с телефона в любой момент, а сообщения, которые отправила ваша система, появятся в том же чате.
Какие ограничения действуют на сообщения, которые отправляют ваши системы?
Ограничения Meta, и они действуют у любого провайдера. Закладывайте их в систему заранее, а не узнавайте о них из вебхука со статусом ошибки:
- Пропускная способность: номер Coexistence отправляет до 20 сообщений в секунду.
- Лимит сообщений: количество уникальных людей, которым отправлено сообщение вне окна за скользящие 24 часа, задаётся для каждого Business Portfolio; новые портфели начинают с 250.
- Способ оплаты: без него в WhatsApp Business Account Meta принимает шаблоны, а затем отбрасывает их; easyCoexistence пришлёт вам письмо, когда это произойдёт.
- Качество: блокировки и жалобы снижают рейтинг качества номера, а низкий рейтинг ведёт к тому, что Meta ограничивает аккаунт.
Как настроить
- Connect the numberConnect your WhatsApp Business number to easyCoexistence through Meta's Coexistence flow; the app keeps working on the phone.
- Get a template approvedAsk your AI to create a UTILITY template such as order_shipped with create_template, or make it in WhatsApp Manager, and wait until its status is APPROVED.
- Copy the credentialsOpen the number in the dashboard, go to "Plug in your own system", copy the Send endpoint and click "Reveal access token".
- Send from your systemHave your store, CRM or n8n workflow POST the template to the Send endpoint when the event happens, with the variables filled from the record.
- Receive replies and statusesUnder "Where incoming messages go", choose "Through easyCoexistence" with a Forward URL, or "Straight to your system" with your endpoint as the destination, so replies and delivery statuses reach your system.
Распространённые ошибки
- Отправка свободного текста человеку, который последний раз писал два дня назад. Meta отклоняет его с ошибкой 131047; отправьте вместо этого одобренный шаблон, а после ответа клиента переходите на текст.
- Размещение токена доступа на веб-странице, в сборке приложения или в общей таблице. Любой, кто его увидит, может отправлять сообщения от имени вашего бизнеса; храните токен на сервере.
- Принимать ID сообщения из ответа API за доставленное. Meta принимает отправку, а затем она может завершиться ошибкой, поэтому следите за вебхуком статусов на failed и его кодом ошибки.
- Повторять неудачные отправки в тугом цикле. Ограничение на одного пользователя или ошибка об остановке маркетинговых сообщений не снимаются за секунды, а повторы только добавляют ошибки.
Ваши системы отправляют шаблоны и ответы с этого номера, а приложение остаётся на телефоне. Автоматизации отвечают на то, что пишут клиенты, а каждый номер находится под круглосуточным мониторингом, с письмом, когда Meta перестаёт доставлять ваши шаблоны. От US$ 9 до US$ 0,75 за подключённый номер в месяц, с понижением по мере добавления номеров, и 3 дня бесплатного пробного периода.
Часто задаваемые вопросы
Будут ли сообщения, которые отправляет моя система, видны в моём приложении WhatsApp Business?
Да. На номере Coexistence Meta отображает сообщения между Cloud API и приложением, поэтому шаблон, который отправила ваша система, появится в чате с этим клиентом на вашем телефоне, и его ответ тоже придёт туда. Диалог можно продолжить из приложения.
Может ли моя система автоматически отправлять изображения или PDF?
Да, через тот же эндпоинт: медиасообщение в течение 24 часов после последнего сообщения клиента или шаблон, в заголовке которого есть изображение или документ, в любое время. Шаг автоматизации «Send a picture or file» также отправляет одно из ваших изображений или PDF в те же 24 часа, а AI agent может отправлять их сам.
Отправляю ли я через API easyCoexistence или через Meta?
Через Meta. Ваша система обращается к Graph API напрямую, используя собственный токен доступа номера, поэтому easyCoexistence не передаёт и не хранит отправляемые вами сообщения и не добавляет наценку к тому, что Meta выставляет за них.
Может ли бескодовый инструмент или таблица отправлять сообщения WhatsApp?
Да, если он умеет делать HTTP POST: так могут n8n, Make, Zapier и Google Sheets с Apps Script. Укажите эндпоинт отправки, передайте токен доступа в заголовке Authorization и отправляйте одобренный шаблон, по одному получателю в каждом запросе.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на