WhatsApp Business API для последующих сообщений при отсутствии ответа
Сценарий отправляет клиенту персонализированный шаблон WhatsApp, если он не ответил на предыдущее сервисное сообщение вовремя.
Обзор сценария
Сценарий отправляет клиенту персонализированный шаблон WhatsApp, если он не ответил на предыдущее служебное сообщение в установленное время. Сообщение включает имя клиента, тему или контекст изначального запроса и напоминание о том, какой ответ все еще нужен. Статическая кнопка URL открывает портал или страницу ответа.
Пример шаблона
Здравствуйте, {{1}}! Мы отправили вам сообщение о «{{2}}», но пока не получили ответа. {{3}} Пожалуйста, ответьте, когда вам будет удобно — мы готовы помочь.
- {{1}}имя клиента
- {{2}}тема предыдущего сообщения (например, подтверждение встречи, опрос удовлетворенности, запрос документов)
- {{3}}детали напоминания (например, пожалуйста, подтвердите до пятницы, ответьте с предпочтительным временем)
- “Ответить”кнопка — исправлено в шаблоне Meta

Когда это использовать
Используйте этот сценарий, когда клиента попросили подтвердить, загрузить или ответить в WhatsApp, но время прошло без ответа — и процесс не может продолжаться, пока он не выполнит действие. Это подходит для онбординга и напоминаний о формах, сервисов, которые ожидают подтверждения или документов, а также для агентств, которые интегрируют таймеры отсутствия ответа из CRM или BPM в исходящие сообщения WhatsApp.
Как это работает
- Триггер
CRM или Как это работает обнаруживает, что время ожидания без ответа истекло.
event·triggered - Перехват события
Система определяет номер телефона получателя и дополнительные поля.
phone:"+…" - Создать и отправить
Персонализированный шаблон сообщения создается с тремя переменными в теле и статичной кнопкой URL.
POST/sendTemplate - Доставлено
Клиент получает напоминание в WhatsApp.
delivered - Статус отслеживается
Результат доставки записывается в журнал, ошибки обрабатываются по правилам платформы.
status:"read"

Техническая реализация
Предварительные условия
- Ключ API 1MSG · Как получить ключ API
- Аккаунт WhatsApp Business · Как подключить WABA
- Шаблон WhatsApp · Как утвердить шаблон WABA
- Согласие клиента на участие · Как управлять согласием клиентов
Примеры кода
#!/usr/bin/env bash
set -euo pipefail
# === Configuration (replace "___" placeholders) ===
API_BASE_URL="https://api.1msg.io" # production 1MSG API base URL
CHANNEL_ID="___" # channel ID from 1MSG dashboard
API_TOKEN="___" # channel JWT token (Bearer)
TEMPLATE_NAME="___" # approved template name
TEMPLATE_NAMESPACE="___" # template namespace (required — send fails without it)
TEMPLATE_LANGUAGE="___" # template language code, e.g. "en"
# === Test data ===
TEST_PHONE="___" # client phone in international format
TEST_CUSTOMERNAME="___" # {{1}} customer name
TEST_TOPIC="___" # {{2}} topic or subject
TEST_REQUESTDETAIL="___" # {{3}} request detail
PHONE_NORM="$(printf '%s' "$TEST_PHONE" | tr -cd '0-9')"
for pair in "CHANNEL_ID=$CHANNEL_ID" "API_TOKEN=$API_TOKEN" \
"TEMPLATE_NAME=$TEMPLATE_NAME" "TEMPLATE_NAMESPACE=$TEMPLATE_NAMESPACE" \
"TEMPLATE_LANGUAGE=$TEMPLATE_LANGUAGE" "TEST_PHONE=$TEST_PHONE" \
"TEST_CUSTOMERNAME=$TEST_CUSTOMERNAME" \
"TEST_TOPIC=$TEST_TOPIC" \
"TEST_REQUESTDETAIL=$TEST_REQUESTDETAIL"; do
val="${pair#*=}"
if [ -z "$val" ] || [ "$val" = "___" ]; then
echo "Missing configuration value: ${pair%%=*}" >&2
exit 1
fi
done
if [ -z "$PHONE_NORM" ]; then
echo "Error: phone number has no digits after normalization" >&2
exit 1
fi
URL="${API_BASE_URL%/}/${CHANNEL_ID}/sendTemplate"
# params carries body ONLY. Button text is fixed in the Meta template — no button param.
# {{1}} customer name → ${TEST_CUSTOMERNAME}
# {{2}} topic or subject → ${TEST_TOPIC}
# {{3}} request detail → ${TEST_REQUESTDETAIL}
read -r -d '' PAYLOAD <<JSON || true
{
"phone": "${PHONE_NORM}",
"template": "${TEMPLATE_NAME}",
"namespace": "${TEMPLATE_NAMESPACE}",
"language": { "policy": "deterministic", "code": "${TEMPLATE_LANGUAGE}" },
"params": [
{
"type": "body",
"parameters": [
{ "type": "text", "text": "${TEST_CUSTOMERNAME}" },
{ "type": "text", "text": "${TEST_TOPIC}" },
{ "type": "text", "text": "${TEST_REQUESTDETAIL}" }
]
}
]
}
JSON
RESPONSE="$(curl -s -w '\n%{http_code}' -X POST "$URL" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${API_TOKEN}" \
-d "$PAYLOAD")"
HTTP_CODE="$(printf '%s' "$RESPONSE" | tail -n1)"
BODY="$(printf '%s' "$RESPONSE" | sed '$d')"
case "$BODY" in
*'"sent":true'*) ok=1 ;;
*) ok=0 ;;
esac
if [ "$HTTP_CODE" -ge 200 ] && [ "$HTTP_CODE" -lt 300 ] && [ "$ok" -eq 1 ]; then
echo "Message sent to client."
echo "API response: $BODY"
else
echo "Send failed. HTTP status: $HTTP_CODE" >&2
echo "$BODY" >&2
exit 1
fi
Ответ и статус доставки
HTTP 2xx и JSON "sent": true означают, что 1MSG принял сообщение для отправки, но не что оно уже доставлено на телефон клиента. Сохраните idполе (выглядит как wamid.…), чтобы сопоставить уведомления о доставке.
{
"sent": true,
"id": "wamid.HBgLMzgwNjM5...",
"message": "Message accepted for delivery"
}sentПринято для отправки — еще не на устройстве клиента
idСохраните это: уведомления о доставке и
hookInfoпривязаны к этому
Доставка поступает позже, отдельным обратным вызовом. Зарегистрируйте вебхук (POST …/webhook), и 1MSG отправляет обновления статуса на ваш HTTPS-эндпоинт в данных верхнего уровня.hooks[]
{
"hooks": [
{
"id": "gBGGeSaGViBfAgnlzOSHEwK9O6F",
"type": "message",
"status": "sent",
"timestamp": "1654864094",
"recipient_id": "556123122026"
}
]
}statussent,delivered,read— или статус ошибки, если это возможноidСопоставляет обратный вызов с
idвозвращаемым вызовом функции отправкиtimestampСтрока с Unix секундами
If you would rather not receive callbacks, poll GET {base}/{channel}/hookInfo?messageId=<id> instead. In practice delivery often completes within seconds — but the API contract does not guarantee it, so never block a flow waiting on it.
Распространенные ошибки
| Статус | Ответ | Причина |
|---|---|---|
| 200 | Message was not sent: template is not defined | namespace, template or language missing from the request body. |
| 200 | template name (…) does not exist in <language> | The template is approved in a different language than the one requested. |
| 200 | Message was not sent: provide chatId, phone, bsuid, or username | No recipient the channel could resolve. |
| 403 | access denied | The token is wrong, or belongs to a different channel than the URL. |
| 429 | too many requests. please try later | The channel is over its send rate. |

