Учебник по бизнес-обмену сообщениями RCS — QR-код для чата за 4 шага

Почему бизнес-сообщениям RCS нужна умная ссылка, а не очередная форма

Поскольку службы Rich Communication Services быстро заменяют традиционные SMS-сообщения, у Vonage есть все возможности, необходимые для начала интеграции ваших приложений с RCS. Однако помимо этого существует дополнительная функциональность для определенных сценариев использования.

Глубокие ссылки (deep links) позволяют создавать ссылку и связанный с ней QR-код с помощью API Vonage Channel Manager. Когда эти глубокие ссылки сканируются устройством конечного пользователя, они устраняют необходимость инициировать сеанс WhatsApp или обмена сообщениями с определенным номером. Вместо этого QR-код открывает приложение обмена сообщениями на устройстве для начала нового разговора.

В Vonage мы постоянно используем эту функциональность внутри компании: от обслуживания клиентов до запуска новых бесед на выезде во время конференций и торговых выставок. Нет RCS? Мы о вас позаботились: система может автоматически переключиться на традиционные SMS.

Узнайте, как использовать эту функциональность в этом учебном пособии, используя PHP Symfony CLI и Vonage Channel Manager.

Что такое бизнес-сообщения RCS на самом деле (и почему Vonage создала для них быстрый путь)

Бизнес-сообщения RCS (RBM) фактически являются заменой маркетинга по SMS по умолчанию. SMS-маркетинг традиционно используется вместе с A2P 10DLC (Application to Person 10 Digit Long Code) в США, но RCS устраняет возможные трудности, которые может принести эта интеграция (помимо возможности использования RBM во всех других регионах, где она поддерживается за пределами США).

С помощью RCS сообщения теперь могут включать подсказки с предлагаемыми ответами, изображениями и видео, которые доступны в Vonage Messages API (а также возможность использовать тот же API для Viber, Facebook Messenger, WhatsApp, MMS, SMS и новых каналов Email).

В этом учебном пособии умная ссылка будет создана с использованием PHP Symfony CLI, библиотеки chillerlan/php-qrcode и API Vonage Channel Manager: затем вы сможете отсканировать ее с помощью своего устройства, чтобы протестировать ее и проверить конфигурацию резервного переключения на SMS. RBM будет настроен с использованием тестового агента-отправителя для тестирования. Мы также настроим веб-хуки, чтобы наше приложение могло читать ответы и принимать подтверждения о прочтении.

Что RBM добавляет поверх RCS (и почему отправитель должен быть верифицирован)

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

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

RBM была создана Google, и верификация означает, что источником сообщения RCS с использованием RBM является настоящее название компании и настоящий логотип компании. Таким образом, использование Vonage для генерации сообщений RCS с использованием верифицированной учетной записи RBM означает открытие верифицированного чата бренда; ровно противоположное упомянутому ранее сценарию. Vonage может управлять вашим агентом RBM за вас, избавляя от необходимости регистрироваться в Google при интеграции с вашим приложением.

Бизнес-кейс: одна умная ссылка, один QR-код и проблема выставок, которую он решает

QR-коды, очевидно, являются очень удобным и простым способом наладить взаимодействие и беседы в поездках. Однако до того, как RCS стала основным элементом, QR-код должен был куда-то вести, и раньше это была бы какая-то форма для заполнения. Скорее всего, она будет шаблонной, а также несет в себе риск сбоя обслуживания на стороне сервера.

Что произойдет, если ссылка сломается, служба, которую вы используете для размещения этой формы, отключится и т. д.

Что, если вы случайно распечатаете не тот QR-код для не того мероприятия?

Нашим решением было интеграция глубоких ссылок в API Vonage. Вы можете иметь разные «персоны» RCS для разных мероприятий, например, индивидуальный брендинг для каждого мероприятия или вертикального рынка. Обычная форма для заполнения прекращает беседу сразу же, как только пользователь уходит от стенда. Когда QR-код автоматически запускает фирменный разговор прямо на его телефоне, устраняются все препятствия, а мы получаем возможность продемонстрировать возможности нашей собственной технологии. Благодаря резервному переключению на SMS учтены все сценарии без необходимости написания логики на стороне клиента: одна ссылка, несколько решенных проблем.

Как работает резервное копирование на самом деле: проверка поддержки RCS и страховочная сеть SMS

Клиентское устройство при сканировании проверяет, доступен ли RCS в текущем регионе; если нет, Channel Manager Vonage может отправить SMS через Vonage Messages API. Возможны три результата:

· RCS отображается с полным брендингом

· RCS отображается, но в уменьшенном базовом формате

· SMS получено с настроенного номера на стороне Vonage

При настройке резервного копирования рекомендуется убедиться, что текст SMS совпадает с текстом RCS, а не выглядит как сообщение об ошибке.

Предварительные требования

· PHP 8.4+

· Composer

· Учетная запись Vonage с доступом к Channel Manager

· Активированный агент RBM в панели управления Vonage

У Vonage уже есть руководства по настройке RCS для вашей учетной записи. Имейте в виду, что использование конструктора агентов RCS для настройки вашего агента может занять некоторое время, чтобы оправдать ожидания, но после завершения вы можете добавить свое собственное устройство для тестирования в разрешенные номера вместо необходимости полной сборки рабочего уровня.

API Channel Manager также должен быть включен в вашей учетной записи, так как он использует возможности RCS; вам нужно будет связаться с Vonage, чтобы активировать API.

Резервный номер SMS также должен быть номером, зарегистрированным в вашей панели управления Vonage. Вы можете узнать, как настроить API управления номерами, в нашем руководстве. Регистрация резервного номера SMS предотвратит автоматическое помечание сообщений как спам.

Шаг 1: Установка Symfony CLI и написание кода генератора ссылок

Создайте новую папку проекта, перейдите в нее в терминале и создайте новый проект Composer.

На данный момент вы можете использовать все предлагаемые настройки по умолчанию; нас не беспокоит настройка этого как крупного приложения. Нам необходимы две важные библиотеки: Symfony CLI и наш генератор QR-кодов.

Интерфейсу командной строки потребуется определенная структура, поэтому напишите следующие файлы:

Оба эти файла теперь требуют базового кода-заглушки. Исполняемый файл находится в каталоге /bin, и вы, возможно, заметили, что он не содержит расширения .php. Тем не менее, он работает в php. Откройте его в вашей IDE/редакторе кода и добавьте следующее:

Вам также нужно будет убедиться, что вы сделали исполняемый файл bin.

Теперь нам нужно написать код LinkCommand. Откройте LinkCommand и заполните его:

Вы заметите, что теперь вам нужно заполнить некоторые переменные среды. Добавьте свои API Key и Secret от Vonage из панели управления Vonage, зарегистрированное имя сообщения RCS, а также ваш резервный номер для SMS в полезную нагрузку JSON.

Шаг 2: Установка генератора QR-кодов и написание кода

Вместо того чтобы увязать в маршрутизации, наши требования должны быть максимально простыми. Нам нужна точка входа index.php, обслуживаемая встроенным веб-сервером PHP, которая принимает строку запроса deep_link и возвращает изображение QR-кода.

Создайте index.php и добавьте следующее:

Теперь, когда все соединено, вы можете создать ссылку, выполнив команду, взяв вывод и передав его в ваш файл index.php.

Теперь запустите браузер:

HTTP GET https://localhost:8000

Если все настроено правильно, у вас теперь есть QR-код, который можно брать с собой в дорогу!

Вы увидели результат, и я тоже!

Углубляемся: мир, управляемый данными

Причина, по которой создавать такие чаты так полезно, заключается в одном слове: данные.

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

В нашем случае, например, отслеживание данных может дать представление о пути потенциального лида от сканирования QR-кода до полной регистрации аккаунта. Или наоборот — сколько таких путей заканчивается отказом. Вы также можете увидеть, сколько пользователей переходят на резервный канал SMS, что дает представление о востребованности возможностей RCS-сообщений на конечных устройствах или со стороны операторов.

Потребление таких данных вебхуков и возможность их записи — это также идеальный сценарий использования для Event Sourcing (событийного моделирования), о чем я уже писал ранее на примере Laravel в PHP. Вы используете проекторы для «воспроизведения» событий в их последовательном порядке, так что да — вы снова получаете представление о том, насколько успешно работают ваши глубокие ссылки.

Часто задаваемые вопросы о глубоких ссылках для деловых сообщений RCS

Q1. Что такое деловые сообщения RCS?

Деловые сообщения RCS — это фирменное мультимедийное обновление для SMS. Они работают через Vonage Messages API и канал RCS, позволяя проверенному бизнесу отправлять сообщения с логотипом, отчетами о прочтении и интерактивными кнопками вместо простого текста. Если устройство или оператор получателя не поддерживают RCS, сообщение автоматически заменяется на обычное SMS.

Q2. Что такое RBM и чем это отличается от RCS?

RCS — это базовый протокол обмена сообщениями. RBM (Rich Business Messaging) — это надстройка в виде верифицированного отправителя, которая позволяет бизнесу отображать логотип, баннер и подтвержденное название компании вместо анонимного номера. Канал RCS в Vonage Messages API работает на собственных серверах RBM от Google, поэтому клиенты Vonage получают значок верификации без необходимости регистрировать отдельного RBM-агента.

Q3. Что происходит, если телефон получателя не поддерживает деловые сообщения RCS?

API диспетчера каналов Vonage (Channel Manager API) проверяет поддержку RCS до или во время отправки. Если устройство, оператор или настройки пользователя не поддерживают RCS, сообщение автоматически заменяется обычным SMS с назначенного вами резервного номера. Получатель все равно получает реальное сообщение, но без брендирования и мультимедиа.

Q4. Как создать интеллектуальную ссылку (смарт-ссылку) SMS to RCS с помощью Vonage Channel Manager API?

Вы отправляете запрос к Channel Manager API, указывая своего RBM-агента, получателя или пул номеров, шаблон RCS-сообщения и текст резервного SMS. API возвращает одну HTTPS смарт-ссылку. Открытие этой ссылки на телефоне с поддержкой RCS и RBM запускает брендированный чат; открытие в любом другом месте или сбой отправки вызывает резервное SMS.

Q5. Могу ли я превратить смарт-ссылку Channel Manager в QR-код?

Да. Получив URL смарт-ссылки, сгенерируйте из него QR-код на стороне сервера с помощью стандартной библиотеки, например, пакета qrcode для Node.js или chillerlan/qrcode для PHP. Распечатайте его с достаточным размером модулей и достаточным полем (quiet zone) для предполагаемого расстояния сканирования, например, на баннере выставки или упаковке продукта.

Q6. Работают ли деловые сообщения RCS на iPhone?

Да, начиная с iOS 18 в 2024 году, Apple добавила нативную поддержку RCS в приложение «Сообщения» (Apple Support, «Использование RCS-сообщений на вашем iPhone», 2024, https://support.apple.com/en-us/104972). До этого владельцы iPhone, переходившие по смарт-ссылке Channel Manager, всегда получали резервное SMS, так как в iOS не было RCS-клиента.

Q7. Чем деловые сообщения RCS отличаются от общего сравнения RCS и SMS?

Сравнение RCS и SMS — это общее сопоставление протоколов: поддержка медиа, отчеты о прочтении и гарантии доставки. Деловые сообщения RCS — это конкретный коммерческий уровень, построенный поверх них: программа верифицированных отправителей, шаблоны и вызовы Channel Manager API, которые этот туториал использует для фактической отправки и управления такими сообщениями на уровне аккаунта.

Подтверждение внедрения: статистика RCS

Не верьте нам (или мне!) на слово: давайте взглянем на некоторую статистику использования RBM.

Охват платформы

· Google развернул возможности RBM поверх RCS Messaging в 2018 году.

· Apple наконец завершила кросс-платформенную поддержку RCS, добавив ее в iOS в версии 18 в 2024 году.

Внедрение на уровне предприятий

· Предприятия, объединяющие несколько каналов обмена сообщениями у одного CPaaS-провайдера, сообщают о снижении затрат на интеграцию в диапазоне от 15% до 30%, поскольку один аккаунт, один вебхук и один договор на выставление счетов заменяют несколько контрактов с вендорами для каждого отдельного канала. (Источник: Gartner, 2024, https://www.gartner.com/en/infrastructure-and-it-operations-leaders/topics/cloud-strategy)

· Исследования клиентского опыта компании Forrester показывают, что добавление богатых интерактивных сообщений поверх базы обычных SMS обеспечивает измеримый прирост вовлеченности как в программах B2B, так и B2C-коммуникаций, с зарегистрированным ростом удержания клиентов в диапазоне от 20% до 40% для хорошо таргетированных кампаний. (Источник: Forrester, 2024, https://www.forrester.com/blogs/category/customer-experience/)

Происхождение стандартов

· RCS построен на архитектуре IP Multimedia Subsystem, стандартизированной 3GPP для операторских сетей. Это то же IMS-ядро, которое уже передает голосовой трафик VoLTE, поэтому операторам не потребовалась новая радиоинфраструктура для его поддержки. (Источник: 3GPP, 2024, https://www.3gpp.org/)

· Консорциум Всемирной паутины (W3C) и IETF совместно поддерживают спецификацию WebRTC 1.0, которая лежит в основе многих паттернов медиа реального времени, используемых на платформе Vonage Communications Platform. Спецификация достигла статуса Рекомендации в январе 2021 года. (Источник: W3C, 2021, https://www.w3.org/TR/webrtc/)

Контекст роста рынка

· Juniper Research отслеживает RCS и интерактивные сообщения в рамках своей практики рыночной аналитики Messaging and CPaaS, отмечая этот сегмент как один из наиболее быстро растущих в сфере программного обеспечения для корпоративных коммуникаций до конца десятилетия. (Источник: Juniper Research, 2026, https://www.juniperresearch.com/research/)

· IDC включает RCS и деловые сообщения в свой более широкий обзор мирового рынка CPaaS — одну из категорий, отслеживаемых IDC по мере того, как расходы на корпоративные коммуникации продолжают смещаться от простых SMS к более богатым верифицированным каналам. (Источник: IDC, 2024, https://www.idc.com/)

Один инструмент для множества инсайтов

QR-код из смарт-ссылки и канал RCS, лежащий в основе реализации RBM, являются нативными для вашего аккаунта Vonage благодаря использованию Messages API. Это тот же набор API, который вы, возможно, уже используете. Учитывая это, вам не нужно привлекать внешних RCS-вендоров, управлять дополнительными учетными данными и — если у вас уже есть реализация для обработки вебхуков — создавать дополнительный код и инфраструктуру для мониторинга отчетов об использовании.

Масштабируйте так, как вам удобно: мы в Vonage и так уже обрабатываем более триллиона API-событий, так что метрики вашей конференции для воронок продаж находятся в надежных руках.