TEC.DELIVERY
enesilru

Руководство по настройке WhatsApp-уведомлений для клиентов Tec.Delivery через Twilio

Официальная интеграция WhatsApp Business API через Twilio

Данное руководство объясняет, как подключить WhatsApp-уведомления в Tec.Delivery с использованием Twilio и официальной платформы WhatsApp Business.

Tec.Delivery предоставляет техническую интеграцию внутри платформы. Клиент несет ответственность за создание и настройку аккаунта Meta Business, аккаунта Twilio, WhatsApp Sender и утвержденных шаблонов WhatsApp.

Необходимые данные для Tec.Delivery

Перед настройкой WhatsApp-уведомлений в Tec.Delivery подготовьте следующие данные Twilio:

Пример ContentSid

HX28c6fb3250aadd68f200dd056bd2ee56

Часть 1

Настройка Meta / Facebook Business

Шаг 1. Создание аккаунта Meta Business

Перейдите на сайт business.facebook.com.

Создайте новый аккаунт Meta Business или войдите в существующий.

Шаг 2. Заполнение информации о компании

В Meta Business Manager заполните профиль компании:

  • Юридическое название компании
  • Адрес компании
  • Веб-сайт компании
  • Рабочий адрес электронной почты
  • Рабочий номер телефона
  • Страна
  • Отрасль деятельности

Шаг 3. Подготовка документов для верификации бизнеса

Meta может запросить документы для подтверждения компании:

  • Свидетельство о регистрации компании
  • Лицензия на ведение деятельности
  • Документ о налоговой регистрации
  • Счет за коммунальные услуги или банковская выписка с адресом компании
  • Подтверждение владения сайтом или доменом

Шаг 4. Запуск процедуры верификации бизнеса

Business Settings → Security Center → Business Verification

Запустите процесс верификации и следуйте инструкциям Meta.

Шаг 5. Включение двухфакторной аутентификации

Business Settings → Security Center → Two-Factor Authentication

Включите двухфакторную аутентификацию для администраторов бизнеса.

Часть 2

Настройка аккаунта Twilio

Шаг 1. Создание аккаунта Twilio

Перейдите на сайт twilio.com.

Создайте новый аккаунт Twilio или войдите в существующий.

Шаг 2. Активация платного аккаунта Twilio

Billing → Upgrade

Добавьте платежные данные и способ оплаты для использования в рабочем режиме.

Шаг 3. Получение Account SID и Auth Token

Откройте главную панель Twilio Console Dashboard и скопируйте:

  • Account SID
  • Auth Token
Auth Token является конфиденциальным. Не публикуйте его и не передавайте через незащищенные каналы связи.
Часть 3

Регистрация WhatsApp Sender в Twilio

Шаг 1. Откройте раздел WhatsApp Senders

Messaging → Senders → WhatsApp Senders

Шаг 2. Запустите WhatsApp Self Sign-up

Начните процесс подключения WhatsApp и свяжите ваш аккаунт Meta Business.

Шаг 3. Выберите или создайте WhatsApp Business Account

Во время настройки выберите или создайте:

  • Meta Business Portfolio
  • WhatsApp Business Account (WABA)
  • Профиль WhatsApp Business

Шаг 4. Заполните профиль WhatsApp Business

  • Отображаемое имя
  • Категория бизнеса
  • Описание
  • Веб-сайт
  • Рабочий адрес электронной почты
  • Логотип (если требуется)

Шаг 5. Зарегистрируйте отдельный номер телефона

Номер телефона должен:

  • Принимать SMS или голосовые звонки во время подтверждения
  • Не использоваться активно в обычном WhatsApp или WhatsApp Business на телефоне
  • Быть выделен исключительно для использования с WhatsApp Business API

Шаг 6. Дождитесь одобрения

После одобрения скопируйте номер WhatsApp Sender из Twilio.

Пример номера WhatsApp Sender

+14155238886

Часть 4

Создание шаблонов WhatsApp в Twilio

Шаг 1. Откройте Content Template Builder

Messaging → Content Template Builder

Шаг 2. Создайте шаблон для уведомлений о статусе заказа

Пример шаблона

Статус вашего заказа №{{1}} был изменен. Новый статус: {{2}} Спасибо за ваш заказ.

Шаг 3. Добавьте переменные шаблона

Используйте нумерованные заполнители: {{1}}, {{2}}, {{3}}.

Шаг 4. Отправьте шаблон на модерацию WhatsApp

Шаблон должен соответствовать требованиям WhatsApp и Twilio.

Шаг 5. Скопируйте ContentSid шаблона

Пример ContentSid

HX28c6fb3250aadd68f200dd056bd2ee56

Часть 5

Настройка в Tec.Delivery

Шаг 1. Добавьте аккаунт Twilio / WhatsApp

Twilio Account Statuses & Path → Twilio/WA Account → + Add
Поле Значение
Name Любое внутреннее название аккаунта
Account SID Account SID из Twilio
Token Auth Token из Twilio
Sender Номер WhatsApp Sender, например +14155238886

Нажмите Save.

Шаг 2. Настройте WhatsApp-уведомление для статуса заказа

Twilio Status Statuses & Path → Order Status → [Статус] → WhatsApp via Twilio

Включите:

Send notification to WhatsApp via Twilio

Шаг 3. Укажите Template SID

Введите утвержденный ContentSid из Twilio.

Шаг 4. Настройте переменные

Переменная Описание
user_name Имя клиента
user_phone Номер телефона клиента
order_id Номер заказа
order_security_code Код подтверждения заказа
order_status Текущий статус заказа
order_left_time Оставшееся расчетное время доставки в минутах
Пример сопоставления переменных

Шаблон Twilio: Статус вашего заказа №{{1}} был изменен. Новый статус: {{2}} Переменные Tec.Delivery: 1 → order_id 2 → order_status

Нажмите Save.

Тестирование

  1. Создайте тестовый заказ.
  2. Используйте номер клиента, который может получать сообщения WhatsApp.
  3. Измените статус заказа в Tec.Delivery.
  4. Убедитесь, что уведомление WhatsApp было доставлено.
  5. Проверьте журналы Twilio, если сообщение не доставлено.
Twilio Console → Monitor → Logs → Messaging

Важные примечания

Итоговый чек-лист