Продукты WhatsApp · Связанные устройства · API

Отправляйте сообщения WhatsApp из собственного ПО

WASMS — это SMS-сервис, работающий через WhatsApp. Это не панель, а API: ваша CRM, платформа электронной коммерции или система управления кампаниями отправляет HTTP-запрос, после чего сообщение поступает на телефон клиента с номера WhatsApp, закреплённого за вашей организацией. Можно отправлять текст, изображения, видео, документы, аудио, местоположение и карточки контактов; статус проверяется через тот же API.

Линия представляет собой номер, подключённый по QR-коду. Документы и одобрение Meta не требуются; при этом нет ни значка верификации, ни гарантий официального API. Мы прямо указываем здесь оба обстоятельства.

Для кого

Задачи, в которых отправку запускает ПО

Для всех случаев, когда человек не открывает панель и не пишет сообщение вручную, а уведомление должно отправляться в момент наступления события в системе.

Уведомления об операциях и подтверждение

В электронной коммерции, финансах и логистике уведомления о заказах, доставке, записях и подтверждении отправляются из существующей системы в WhatsApp одним запросом.

Отправка документов

Файлы, такие как счета, квитанции и договоры, отправляются непосредственно клиенту вместе с именем файла. Для клиента всё это является частью одного диалога.

Информирование по спискам получателей, давших согласие

Клиентам из списков, давшим согласие, отправляются информационные сообщения с текстом, изображением или документом. Ниже мы также отдельно указываем, что массовые и нежелательные рассылки подвергают номер риску.

Типы контента

Что можно отправлять?

Шесть типов контента опубликованы; список кнопок также опубликован. Опрос и сообщение с кнопкой являются экспериментальными; перед использованием в рабочей среде необходимо получить подтверждение от Tecmony.

Текст

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

Изображения и видео

Изображения для кампаний, презентации продуктов, короткие видеоролики.

Документ

Счета, квитанции, договоры и аналогичные файлы — вместе с именем файла.

Аудио

Голосовые уведомления и напоминания.

Карточка контакта

Контактные данные соответствующего оператора или подразделения.

Местоположение

Координаты филиала, магазина или места встречи.

Как это работает

Сообщение проходит четыре этапа

Третий этап — ваш номер; WASMS использует его как сервис.

Ваша системаВаша CRM, платформа электронной коммерции или система управления кампаниями отправляет POST-запрос.
WASMS APIТокен проверяется; в зависимости от типа сообщения вызывается соответствующая конечная точка и возвращается message_id.
Линия WhatsApp, закреплённая за вашей организациейВаш подключённый по QR-коду и подтверждённый номер передаёт сообщение.
Ваш клиентВ WhatsApp отображается, что сообщение отправлено с номера вашей компании. Статус проверяется через тот же API по message_id.

Экраны

Так сообщение выглядит на телефоне клиента

На стороне клиента

Одна линия — три разные задачи

Уведомление о доставке, счёт и код подтверждения отправляются с одного номера через единую интеграцию. Если клиент ответит, диалог продолжится на той же линии; если вы хотите, чтобы ответы обрабатывала команда, этот же номер можно также подключить к WADesk.

Уведомление: заказ, доставка, запись на приём
Документ: счёт, квитанция, договор
Проверка: одноразовый код

API

Всё необходимое для интеграции

В приведённых ниже примерах замените YOUR_API_TOKEN, YOUR_PHONE_ID и YOUR_PIN значениями, переданными вам Tecmony. Ответы используют единый конверт с полями status, code и data.

1. Аутентификация: получение токена

Вы получаете токен с помощью предоставленных вам phone_id и PIN. Этот токен передаётся в заголовке token во всех последующих вызовах; если заголовок отсутствует, его значение неверно или срок действия токена истёк, запрос отклоняется и необходимо получить новый токен.

curl -X GET \
  "https://wasms.tecmony.cloud/api/v1/whatsapp/token?phone_id=YOUR_PHONE_ID&pin=YOUR_PIN"

Ответ:

{
  "status": true,
  "code": 200,
  "data": {
    "phone_id": "9085XXXXXXXX",
    "token": "YOUR_API_TOKEN"
  }
}

2. Отправка текстового сообщения

curl -X POST \
  "https://wasms.tecmony.cloud/api/v1/whatsapp/message/text" \
  -H "token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "905XXXXXXXXX",
    "message": "Siparişiniz kargoya verildi."
  }'

3. Отправка документа

curl -X POST \
  "https://wasms.tecmony.cloud/api/v1/whatsapp/message/document" \
  -H "token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "905XXXXXXXXX",
    "filename": "fatura-2026-04187.pdf",
    "content": "https://ornek.com/fatura.pdf"
  }'

Список конечных точек

Метод	Конечная точка	Поля тела запроса	Статус
GET	`/api/v1/whatsapp/token`	Параметры запроса: `phone_id`, `pin`	Опубликован
POST	`/api/v1/whatsapp/message/text`	`phone_number`, `message`	Опубликован
POST	`/api/v1/whatsapp/message/image`	`phone_number`, `content`	Опубликован
POST	`/api/v1/whatsapp/message/video`	`phone_number`, `content`	Опубликован
POST	`/api/v1/whatsapp/message/document`	`phone_number`, `filename`, `content`	Опубликован
POST	`/api/v1/whatsapp/message/audio`	`phone_number`, `content`	Опубликован
POST	`/api/v1/whatsapp/message/location`	`phone_number`, `lat`, `lon`, `title`	Опубликован
POST	`/api/v1/whatsapp/message/contact`	`phone_number`, `contact_name`, `contact_number`	Опубликован
POST	`/api/v1/whatsapp/message/button/list`	`phone_number`, `title`, `description`, `button_text`, `rows_title`, `rows[]`	Опубликован
POST	`/api/v1/whatsapp/message/poll`	`phone_number`, `poll_title`, `poll_options[]`	Экспериментальный
POST	`/api/v1/whatsapp/message/button`	`phone_number`, `media_file`, `media_message`, параметры кнопок	Экспериментальный
GET	`/api/v1/whatsapp/message/{message_id}`	Запрос статуса отправленного сообщения	Опубликован

Все конечные точки находятся по адресу https://wasms.tecmony.cloud/api/v1/. Экспериментальные: перед использованием в рабочей среде необходимо получить подтверждение от Tecmony.

Ошибки

200: запрос выполнен; поле status возвращает true и предоставляется message_id.
400 “Must be connected”: сеанс WhatsApp для линии был прерван. Необходимо повторно отсканировать QR-код с телефона владельца номера; после этого запросы снова будут выполняться в обычном режиме.
Ошибка токена: заголовок token отсутствует, его значение неверно или срок действия токена истёк. Получите токен заново через конечную точку токена.
502: чаще всего это блокировка доступа со стороны сети вашей организации. Повторите тот же запрос через другое интернет-соединение; убедитесь, что сервис работает, отправив запрос на адрес https://wasms.tecmony.cloud/: при нормальной работе возвращается ответ 200.

Чтобы получить полный список кодов ошибок, правила проверки отдельных полей и коллекцию Postman, обратитесь в службу поддержки Tecmony.

Настройка

Четыре шага от предоставления номера до первого запроса

Учётная запись не создаётся до подтверждения номера; договор на оказание услуг также подписывается до этого этапа.

Предоставление номераВы сообщаете Tecmony номер, который будете использовать для отправки сообщений. Номер должен принимать звонки или SMS из-за границы; некоторые операторы блокируют такой трафик.
ПодтверждениеНаша команда направляет на номер звонок или SMS; вы сообщаете нам код подтверждения.
Создание учётной записиПосле подтверждения номера вам предоставляются данные phone_id и PIN; линия подключается с помощью QR-кода.
ИнтеграцияПолучив сеанс через конечную точку токена, вы вызываете конечные точки сообщений. Пример коллекции Postman можно получить у нашей службы поддержки.

Ограничения

Что не делает WASMS и что вам следует знать

Ограничения, обусловленные способом подключения через «Связанные устройства». Об этом было написано и на нашем прежнем сайте; здесь это тоже указано.

Это не официальный WhatsApp Business API. Клиент видит только номер и его профиль; значок подтверждённой компании не предоставляется. Если нужны значок и официальный отчёт о доставке, рассмотрите WaSend.
WhatsApp может ограничить или заблокировать номер. Пункт 7 нашего договора об оказании услуг: в продукте, работающем посредством подключения устройства к аккаунту WhatsApp, WhatsApp может ограничить номер в соответствии со своими правилами; клиент выбирает услугу, осознавая этот риск. Массовая и нежелательная рассылка заметно повышает риск.
При разрыве подключения запросы возвращают “Must be connected”. Если сессия на телефоне завершается, отправка приостанавливается до повторного сканирования QR-кода. Обрабатывайте эту ошибку в процессе отправки и формируйте уведомление.
Можно использовать только мобильный номер. Стационарный или виртуальный номер для этого способа не подходит; номер должен быть привязан к WhatsApp на телефоне.
Опрос и сообщение с кнопкой являются экспериментальными. Перед использованием в рабочей среде необходимо получить подтверждение от Tecmony; они не входят в рамки договора.
Система не собирает согласия. Чтобы первым отправить сообщение человеку, необходимо заранее получить от него согласие, в котором указано название вашей компании; получение согласия и его соответствие законодательству входят в обязанности клиента.
Это не канал для передачи чувствительных данных. Номер платёжной карты, данные финансового счёта и идентификационный номер не должны передаваться по этому каналу; их также нельзя запрашивать у клиентов.

Часто задаваемые вопросы

Что спрашивают перед интеграцией

Если вашего вопроса здесь нет, напишите нам. Если вам больше подходит другой вариант: WADesk — для командной обработки входящих сообщений, WaSend — для массовых кампаний с утверждёнными шаблонами, WAGEM — для архива только для чтения. Сравнение приведено на странице «Продукты WhatsApp».

Чем WASMS отличается от сервиса SMS?

WASMS — это работающая через WhatsApp версия традиционного сервиса SMS. Ваше приложение, CRM или система кампаний подключается к API; отличие заключается в том, что сообщение отправляется не по SMS, а с линии WhatsApp, закреплённой за вашей организацией, и помимо текста вы можете отправлять изображения, видео, документы, аудио, карточки контактов и местоположение.

Чем WASMS отличается от WaSend?

Инфраструктурой. WASMS работает через номер, подключённый с помощью QR-кода: документы и одобрение Meta не требуются, но значок подтверждённой компании не предоставляется, а WhatsApp может заблокировать номер. WaSend работает через официальный WhatsApp Business API: требуется подтверждение компании и утверждение шаблонов, взимается плата Meta за разговоры, а взамен предоставляются подтверждённый профиль и официальный отчёт о доставке.

Какие типы сообщений опубликованы, а какие являются экспериментальными?

Конечные точки для текста, изображений, видео, документов, аудио, местоположения, карточек контактов и списка кнопок опубликованы. Опрос и сообщение с кнопкой являются экспериментальными; если вы планируете использовать их в рабочей среде, сначала согласуйте это с Tecmony.

Как долго действует токен?

Токен получают с помощью phone_id и PIN и передают в заголовке token во всех последующих вызовах. Если заголовок отсутствует, его значение неверно или срок действия токена истёк, запрос отклоняется; в этом случае вы получаете токен заново через конечную точку токена.

Что делать, если запрос возвращает 502?

Обычно это связано с ограничением доступа в сети вашей организации. Повторите тот же запрос через другое интернет-соединение. Работоспособность сервиса также можно проверить запросом к wasms.tecmony.cloud; при нормальной работе возвращается код 200.

Что означает ошибка “Must be connected”?

Это означает, что сеанс WhatsApp на телефоне, связанном с линией, прерван. Владелец номера открывает в WhatsApp на телефоне раздел «Связанные устройства» и сканирует новый QR-код; после восстановления подключения запросы снова обрабатываются в обычном режиме. Это обусловлено самой природой способа подключения через «Связанные устройства».

Можно ли проверить статус отправленного сообщения?

Да. Конечная точка GET /api/v1/whatsapp/message/{message_id} возвращает статус отправленного сообщения. Ответы используют общую оболочку с полями status, code и data.

Нужно ли согласие клиента для отправки сообщения?

Да. WASMS работает в соответствии с правилами WhatsApp LLC: чтобы первым отправить сообщение человеку, необходимо заранее получить от него согласие, в котором прямо указано название вашей компании. Способ получения согласия и его соответствие законодательству входят в обязанности клиента.

Выполните первый вызов уже сегодня

Сообщите свой номер; после проверки вы сможете отправить первое сообщение в течение нескольких минут, используя phone_id и PIN.

Запросить демо

Или свяжитесь с нами напрямую: +90 (216) 912 00 79[email protected]