Автоматическая отправка платёжных ссылок в WhatsApp
Чтобы автоматически отправлять платёжные ссылки в WhatsApp, отвечайте на вопросы об оплате фиксированной ссылкой от вашего платёжного провайдера, которая запускается такими словами, как «pay» или «оплатить», либо передавайте сообщение своей системе, которая создаёт ссылку на заказ этого клиента и возвращает её как ответ. Клиент платит на странице провайдера, а ваша система подтверждает оплату в чате, как только платёж проходит.
easyCoexistence подключает номер WhatsApp Business, который вы ведёте в приложении, к Cloud API от Meta через Coexistence и запускает на нём автоматизации: ответ по ключевому слову с вашей ссылкой, собственный ИИ на вашем ключе или вебхук к системе, которая создаёт ссылки на каждый заказ.
Время, за которое ваша система должна создать ссылку и вернуть её в поле reply.
Срок действия по умолчанию для Stripe Checkout Session; его можно задать от 30 минут до 24 часов.
Stripe копирует metadata из Payment Link в создаваемые Checkout Session, поэтому платёж можно связать с чатом.
Шаблоны, в кнопках которых нет переменных, может отправлять шаг Send a template в автоматизации.
Категория Meta для шаблонов, которые запускаются действием или запросом пользователя, без рекламного назначения.
Какими способами WhatsApp может автоматически отправить платёжную ссылку?
Пять схем: от полностью без кода до полностью автоматических. Начните с фиксированной ссылки, если один тариф или оплата в магазине покрывает ваши продажи, и переходите к ссылке на каждый заказ, когда суммы различаются. Во всех схемах сама оплата проходит на странице или в приложении вашего провайдера, поэтому номера карт, банковские переводы и чеки остаются за пределами автоматизации и её журнала запусков:
Как отправить фиксированную ссылку по ключевому слову?
Начните с шаблона Keyword reply в разделе Start from an example. Trigger: Has keyword, Contains, со словами, которыми клиенты пишут, когда хотят оплатить. Step: Reply with text, со ссылкой на отдельной строке, чтобы её можно было нажать или скопировать, и при желании {{first_name}}. Банковские реквизиты или референс перевода работают так же. Contains ищет совпадение внутри слов, поэтому «pay» сработает и на PayPal, и на repay, что обычно полезно, а слово «link» само по себе срабатывает на многие несвязанные сообщения. Автоматизация по ключевому слову отвечает раньше вашего ИИ-ассистента, поэтому ссылка точная и никогда не перефразируется.
Keywords (Contains): pay, payment, pagar, pagamento, pix, pago, link de pago, checkout
Reply with text:
Hi {{first_name}}! You can pay securely here:
https://buy.stripe.com/test_cN25nr0iZ7bUa7meUY
Prefer PIX? Key: payments@bloomcafe.example
Send the receipt here when you are done and we will confirm.Может ли ваш ИИ отправить ссылку, когда клиент готов?
Да, если ссылка есть в поле Instructions. Шаг Reply with AI пишет по Instructions и переписке, поэтому укажите там ссылку, правило, когда её отправлять, и порядок, в котором сначала подтверждается заказ. Модели копируют переданный им URL дословно, а правило в инструкциях запрещает выдумывать цены, поэтому перечислите суммы или укажите, откуда они берутся.
Добавьте две строки безопасности: модель никогда не просит номера карт или пароли, а всё, что касается возвратов или неудачных платежей, передаётся человеку. Проверьте оба пункта через Try it, прежде чем включать автоматизацию, в том числе вопросом на другом языке.
Payments
- When the customer confirms the order and wants to pay, send this link on its own line:
https://buy.stripe.com/test_cN25nr0iZ7bUa7meUY
- Before sending it, repeat the items and the total from the price list above.
- Never ask for card numbers, PINs, passwords or one-time codes. The customer pays on the link.
- Refunds, double charges or failed payments: say someone from our team will reply here shortly.Как ваша система создаёт ссылку для каждого заказа?
Через шаг Call my webhook. Ваш эндпоинт проверяет X-EC-Signature, находит открытый заказ клиента по contact.wa_id или по номеру заказа в message.text, запрашивает у платёжного провайдера ссылку с точной суммой и возвращает её в поле reply. Укажите идентификатор заказа и номер WhatsApp в metadata ссылки, чтобы платёж можно было позже связать с заказом.
Уложитесь в 20 секунд: один запрос к провайдеру обычно занимает секунду-две. Повторно используйте ещё открытую ссылку, если клиент дважды просит оплатить один и тот же заказ. При тестах dry_run равен true: верните пример предложения и ничего не создавайте.
// signed(req) is the X-EC-Signature check from the live-data page, with this automation's secret.
app.post("/whatsapp/pay", express.text({ type: "application/json" }), async (req, res) => {
if (!signed(req)) return res.status(401).end();
const { dry_run, contact } = JSON.parse(req.body);
const order = await openOrderFor(contact.wa_id); // your system: this customer's unpaid order
if (!order) return res.json({ reply: "I could not find an open order for this number. Send the order number and I will check." });
if (dry_run) return res.json({ reply: "Test: the payment link for order " + order.id + " would go here." });
const form = new URLSearchParams({
mode: "payment",
success_url: "https://shop.example/thanks",
"line_items[0][quantity]": "1",
"line_items[0][price_data][currency]": order.currency, // e.g. "usd" or "brl"
"line_items[0][price_data][unit_amount]": String(order.amountCents),
"line_items[0][price_data][product_data][name]": "Order " + order.id,
"metadata[order_id]": order.id,
"metadata[wa_id]": contact.wa_id,
});
const r = await fetch("https://api.stripe.com/v1/checkout/sessions", {
method: "POST",
headers: { Authorization: "Bearer " + process.env.STRIPE_SECRET_KEY },
body: form,
});
const session = await r.json();
if (!session.url) return res.json({ reply: "The payment link is not ready yet. Someone from our team will send it here shortly." });
res.json({ reply: "Order " + order.id + ", total " + order.total + ". Pay here:\n" + session.url + "\nThe link stays open for 24 hours." });
});Как клиент получает подтверждение после оплаты?
Ваша система отправляет его, когда провайдер сообщает об оплате, например по событию checkout.session.completed от Stripe с вашими metadata. Из него берутся номер WhatsApp и идентификатор заказа, после чего сообщение отправляется через Cloud API от Meta, с эндпоинтом отправки и токеном доступа, которые возвращает get_api_credentials. Пока открыто окно обслуживания клиентов (24 часа) после последнего сообщения клиента, подходит обычный текст. Потом Meta принимает только одобренный шаблон. Подтверждение оплаты относится к покупке самого клиента, что подходит категории utility, хотя решение принимает Meta при проверке. Сообщение также появится в ветке чата в приложении, и команда увидит, что заказ оплачен.
// send_endpoint and access_token come from get_api_credentials for this number.
const insideWindow = Date.now() - lastCustomerMessageAt(waId) < 24 * 3600 * 1000;
await fetch(SEND_ENDPOINT, {
method: "POST",
headers: { Authorization: "Bearer " + ACCESS_TOKEN, "Content-Type": "application/json" },
body: JSON.stringify(insideWindow
? { messaging_product: "whatsapp", to: waId, type: "text",
text: { body: "Payment received for order " + orderId + ". Thank you! We will let you know when it ships." } }
: { messaging_product: "whatsapp", to: waId, type: "template",
template: { name: "payment_received", language: { code: "en" },
components: [{ type: "body", parameters: [{ type: "text", text: orderId }] }] } }),
});Может ли шаблон содержать кнопку оплаты?
Да, с фиксированным URL. Шаг Send a template может отправить одобренный шаблон, в кнопках которого нет переменных: кнопку URL на страницу оформления или на фиксированную Payment Link либо быстрые кнопки, например Pay now и Talk to us, нажатия по которым приходят как текст, а автоматизация по ключевому слову может ответить на них ссылкой. Переменные в тексте заполняются по позиции, поэтому сумма или номер заказа идут в {{1}} и {{2}}.
Кнопка URL с переменной, которая понадобилась бы для ссылки на каждый заказ, и кнопки копирования кода пока не заполняются автоматизациями; такие шаблоны отправляет ваша система через Cloud API. Meta списывает плату за шаблонные сообщения поштучно, по категории и стране, с вашего собственного аккаунта WhatsApp Business.
Как настроить
- Create the link at your providerMake a Payment Link or a checkout page for the product, or note your PIX key. Open it once on a phone to check the amount and the page.
- Start a keyword automationIn Automations, click New automation and pick Keyword reply under Start from an example. Choose Contains and enter your payment words, one per line.
- Write the replyIn Reply with text, put a short greeting with {{first_name}} and the link on its own line. Save with the switch Off.
- Test the wordsClick Test and run "how do I pay?", "quero pagar" and an unrelated message with Run test, to see which ones match and what the customer would receive.
- Switch it OnSet the switch to On and save. Write "pay" from another phone and tap the link to check it opens the payment page.
Распространённые ошибки
- Разрешать ИИ собирать данные карт в чате. Добавьте в Instructions строку, которая запрещает номера карт, PIN-коды и коды, и отправляйте ссылку провайдера; сообщения чата хранятся в журналах запусков 30 дней.
- Отправка ссылки на сессию, которая истекает. Stripe Checkout Session живёт 24 часа по умолчанию, поэтому клиент, вернувшийся на следующий день, нажмёт нерабочую ссылку; создавайте новую по запросу.
- Подтверждение оплаты свободным текстом через несколько дней. Спустя 24 часа после последнего сообщения клиента Meta отклоняет свободный текст, поэтому для подтверждений держите одобренный шаблон категории utility.
- Добавление фиксированного ответа после шага вебхука, который возвращает ссылку. Отправляются оба сообщения, и клиент получает ссылку и второе, общее сообщение.
Деньги мы не трогаем: клиенты платят напрямую вашему провайдеру, а Meta выставляет счёт за сообщения на ваш аккаунт без наценки. Цена от US$ 9 до US$ 0,75 за подключённый номер в месяц, с понижением по мере добавления номеров, и бесплатным пробным периодом на 3 дня.
Часто задаваемые вопросы
Обрабатывает ли easyCoexistence платежи?
Нет. Он отправляет текст или шаблон со ссылкой, а оплата проходит между клиентом и вашим провайдером, например Stripe, Mercado Pago или банком. Комиссии, выплаты, возвраты и чеки остаются в панели управления вашего провайдера.
Могут ли клиенты платить, не покидая чат?
Не через автоматизации, которые отправляют текст и шаблоны, поэтому клиент открывает страницу провайдера. Собственные платёжные сообщения Meta внутри чата доступны только в некоторых странах и отправляются системой бизнеса через Cloud API; проверьте документацию Meta по платежам для вашей страны.
Как моя система понимает, к какому чату относится платёж?
Укажите contact.wa_id и идентификатор заказа в metadata ссылки при её создании. Когда провайдер сообщит об оплате, прочитайте их, чтобы обновить заказ и отправить подтверждение на нужный номер.
Можно ли отправить напоминание об оплате тому, кто не писал несколько дней?
Да, как одобренный шаблон, который отправит ваша система или ваш ИИ через send_template, потому что свободный текст отклоняется спустя 24 часа после последнего сообщения клиента. Отправляйте напоминания только тем, кто согласился их получать, и не добавляйте акции в шаблон категории utility.
Читайте дальше
Готовы начать?
Настройте WhatsApp Coexistence за несколько минут, а не месяцев. Приложение продолжит работать на телефоне.
Начать бесплатный пробный периодПроверено по состоянию на