В этой статье вы узнаете как создать необходимый аккаунт в Twilio, как к аккаунту Twilio присоединить бизнес-номер WhatsApp, который вы будете использовать для общения с клиентами и как подключить WhatsApp номер к RemOnline.

Twilio - это платформа с коммуникационными API, которая позволяет разработчикам и компаниям легко интегрировать средства связи, такие как телефония, SMS, чаты и видео, в свои приложения и веб-сайт. С помощью Twilio можно отправлять текстовые сообщения, совершать телефонные звонки, настраивать автоматические ответы и многое другое. Нам Twilio поможет интегрировать WhatsApp в RemOnline.

Что нужно для начала?

Важно: на данный момент покупка украинского номера невозможна в Twilio, поэтому если вы находитесь в Украине и хотите использовать украинский номер, вы можете использовать только собственный номер, а не номер Twilio. Если вы находитесь в другой стране, вы можете приобрести и использовать номер телефона с кодом этой страны, если такие номера доступны.

Если вы используете собственный номер, он должен принимать SMS или звонки (если номер может принимать только телефонные звонки, этот номер не может использовать Интерактивное Голосовое Меню (IVR)).

После того как вы получили платную версию Twilio, вам нужно зарегистрировать отправителя WhatsApp, который дает возможность отправлять и получать сообщения WhatsApp от имени вашего бренда через API Twilio. Перед запуском, возможно, придется пройти проверку Meta Business Verification, установленную Meta (владельцем WhatsApp), прежде чем подключать отправителей WhatsApp.

Чтобы создать отправителя WhatsApp:

1. Войдите в консоль Twilio.

2. Перейдите в раздел Messaging > Senders > WhatsApp senders.

3. Ознакомьтесь с информацией на этой странице и нажмите Get Started.

4. Ознакомьтесь с Условиями использования WhatsApp и отметьте чекбокс, если вы с ними согласны. Затем нажмите Confirm.

5. Далее выберите номер телефона, который вы хотите подключить к Business API WhatsApp. Вы можете использовать номер Twilio или собственный WhatsApp номер телефона. Нажмите Continue

На этом шаге откроется окошко со ссылкой на Facebook. Не закрывайте это окошко и не переходите на другую страницу в консоли Twilio. Оно понадобится вам для дальнейших шагов в этой инструкции.

1. Войдите в Facebook, если вы этого еще не сделали, или нажмите Continue as [ваше имя], если вы уже зарегистрированы.

2. После входа вы увидите следующие шаги процесса подключения вашего номера к WhatsApp. Нажмите Get started.

3. После этого Facebook попросит вас разрешить Twilio управлять вашей учетной записью WhatsApp Business Account. Нажмите Continue.

4. На следующем экране выберите из списка Meta Business Account для вашей компании. Если у вас его еще нет, вы можете создать новый, выбрав опцию Create a Business Account.

5. Далее вы сможете выбрать WhatsApp Business Account (WABA) или создать новый.

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

Важно: Если у вас уже есть утвержденный бизнес-номер WhatsApp, который вы используете в другом сервисе, выполните шаги, описанные в этой статье.

6. На следующем экране вам нужно будет ввести следующую информацию:

WhatsApp Business Account Name - используется только для внутренних целей и не является доступным для пользователей. Если вы выбрали WABA на предыдущем экране, вы не сможете изменить название здесь.

WhatsApp Business Profile Display Name - это то, что будут видеть ваши клиенты. Оно должно соответствовать требованиям, установленным WhatsApp.

Category - выберите категорию, которая лучше всего описывает ваш бизнес. Пользователи будут видеть ее, когда будут просматривать ваш профиль.

Business Description - Краткое описание вашей компании, и чем вы занимаетесь. Оно также отображается пользователям при просмотре вашего профиля в приложении WhatsApp.

Website - это ссылка на ваш веб-сайт, которая также отображается пользователям при просмотре вашего профиля в приложении WhatsApp. После регистрации отправителя WhatsApp у вас будет возможность добавить еще один веб-сайт, если вы этого захотите.

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

Однако, возможно, у вас есть торговая марка, которую вы хотите использовать в качестве названия для отображения в вашем WhatsApp Business Account, но она отличается от названия вашей компании. В таком случае должна быть четкая связь между вашей компанией и брендом. Эта связь между брендом и вашим бизнесом должна быть отражена на вашем веб-сайте и в самом имени пользователя.

Например, если ваша компания - Johnny Mobile, а ваш бренд - PizzaApp, мы рекомендуем использовать дисплейное имя «PizzaApp by Johnny Mobile». Эта ассоциация должна быть опубликована на вашем вебсайте, чтобы WhatsApp мог ее проверить. Это означает, что где-то на веб-сайте должна быть видимая связь между двумя названиями. Если вы хотите сохранить название «PizzaApp», это, как правило, требует обращения к WhatsApp и может продлить процесс регистрации.

Для получения дополнительной информации вы можете перейти к правилам отображения имен в WhatsApp.

1. Если вы используете номер Twilio с возможностью отправки SMS, скопируйте свой номер Twilio и перейдите в окно Twilio Console, которое вы оставили открытым на шаге 1.

2. Вставьте номер во всплывающее окно Facebook. Оставьте выбранным метод проверки SMS-сообщения и нажмите Send code.

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

Не продолжайте, если вы получили предупреждение о переносе вашего номера. Вместо этого, пожалуйста, откройте тикет в службу поддержки и укажите, что вам нужно перенести номер из Meta или предыдущей компании, с которой вы работали (Business Solutions Provider).

3. После этого код подтверждения появится в консоли Twilio под пунктом Verification code. Нажмите Copy и вставьте его в окошко Facebook.

4. Нажмите OK на следующем экране, чтобы закрыть всплывающее окно.

Поздравляем! Ваш WhatsApp Business Account теперь привязан к вашей учетной записи Twilio. После этого Twilio начнет процесс регистрации вашего номера в WhatsApp. Этот процесс может занять до 2 минут.

После успешной регистрации ваш номер будет отображен. Вы можете нажать Edit sender, чтобы воспользоваться службой обмена сообщениями и обновить остальную часть вашего профиля WhatsApp Business, включая фотографию профиля.

Если вы еще не прошли верификацию Meta business verification, ваш доступ к WhatsApp сначала будет ограничен. Если вы уже прошли бизнес-верификацию, вы будете иметь полный доступ к WhatsApp.

Чтобы подключить дополнительные номера, вам нужно повторить этот процесс, убедившись, что вы выбрали одну и ту же учетную запись Meta Business Manager и WhatsApp Business Account. Учетные записи Meta Business Manager и WhatsApp Business Account, которые в настоящее время привязаны к вашей учетной записи Twilio, отображаются в консоли Twilio Console.

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

Чтобы создать Messaging Service, перейдите в раздел Messaging > Services и нажмите Create Messaging Service.

Шаг 1. Заполните следующие поля:

Messaging Service friendly name - придумайте название своему Messaging Service (например Order Chats)

Select what you want to use Messaging for - выберите функцию, которая лучше всего подходит для ваших чатов.

Нажмите Create Messaging Service.

Шаг 2. Нажмите Add senders, выберите WhatsApp Number и выберите номер для которого вы хотите включить Messenger Service. На этом же шаге вы можете дополнительно настроить выбранный номер.

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

Area Code Geomatch - отправляя сообщения в США и Канаду, используйте местные телефонные номера с кодом города, который совпадает или накладывается на номер телефона получателя.

Эти функции включены по умолчанию. Чтобы их отключить - нажмите на ползунок.

Также вы можете добавить еще номера, если не выбрали несколько номеров на предыдущем шаге, нажав на кнопку Add Senders или удалить уже добавленный номер, нажав Remove напротив него.

Отметьте те номера, которые вы хотите использовать, и нажмите Step 3. Set up integration.

Шаг 3. На этом шаге нужно настроить вебхуки для автоматизации процессов и для синхронизации данных между вашими учетными записями в Twilio и RemOnline.

Выберите опцию Use webhooks, и вставьте необходимые ссылки в следующие поля:

https://web.remonline.app/chat-service/v1/webhook/twilio/whatsapp

https://web.remonline.app/chat-service/v1/webhook/twilio/whatsapp/status

Возле полей Request URL и Fallback URL должна стоять опция HTTP Post.

В поле Validity period мы рекомендуем оставить то значение, которое там стоит по умолчанию - 14400. Это количество секунд, в течение которых сообщения, отправленные с вашего почтового сервиса, будут оставаться на платформе Twilio. Если время, необходимое для отправки сообщения, превышает Validity period, Twilio отклоняет сообщение и отправляет запрос на ваш Callback URL, чтобы сообщить вам об ошибке.

Чтобы продолжить, нажмите Step 4: Add compliance info.

Шаг 4. Добавьте информацию о соблюдении требований. Это можно сделать с помощью регистрации для A2P 10DLC (10-значного кода) в США.

Это система в США, которая позволяет бизнесу отправлять сообщения из приложения человеку (A2P) с помощью 10-значных телефонных номеров (10DLC). Регистрация для A2P сообщений улучшит качество доставки и уменьшит фильтрацию.

Чтобы завершить создание Messaging Service, нажмите Complete Messaging Service Setup.

Важным шагом в настройке аккаунта Twilio является настройка базовой аутентификации HTTP в своем аккаунте Twilio для того, чтобы получение медиафайлов работало корректно.

Для этого перейдите в раздел Messaging > Settings > General > HTTP Basic Authentication for media access, выберите опцию Disabled и нажмите Save внизу страницы для сохранения изменений.

Готово! Последним шагом является подключение к RemOnline, после чего вы сможете использовать WhatsApp для общения с вашими клиентами.

1. На дашборде Twilio перейдите в раздел Account Info. Здесь вы найдете Account SID и Auth Token, которые вам нужны для подключения к чатам RemOnline. Скопируйте эти данные.

2. Затем перейдите в раздел Messaging > Services и найдите Messaging Service, которую вы создали. Скопируйте его Sid.

3. В RemOnline перейдите в раздел Настройки > Чаты и нажмите + Канал. Выберите ресурс WhatsApp by Twilio.

4. Заполните все поля:

Название канала - придумайте название своему WhatsApp каналу, который использовать для общения с клиентами.

Account SID - вставьте код Account SID скопированный с вашего Twilio аккаунта.

Важно: если канал с идентичным Account SID уже подключен другой компанией, система не позволяет подключить новый канал с тем же кодом в RemOnline. Чтобы это исправить, необходимо удалить уже имеющуюся интеграцию в другой компании, и тогда добавить канал с этим Account SID в RemOnline.

Auth Token - здесь вставьте код Auth Token, скопированный из вашего Twilio аккаунта.

Номер телефона - впишите тот номер телефона, который вы зарегистрировали в Twilio и будете использовать для общения с клиентами.

Messaging Service Sid - здесь нужно вставить код Messaging Service Sid скопированный со страницы Messaging Service.

5. Настройте Доступ к каналу:

Все - доступ к настройке Чата будут иметь все сотрудники компании при условии, что такой доступ разрешен им системой;

Избранные - доступ к настройке Чата будут иметь только избранные сотрудники при условии, что такой доступ разрешен им системой;

Владелец - доступ к настройкам будет иметь только Владелец компании.

Чтобы поменять настройки доступа сотрудников к Чату и настроек Чата, нужно перейти в Настройки > Сотрудники > Роли и отредактировать необходимые настройки.

6. Нажмите Создать.

Готово! Теперь вы можете общаться с клиентами с помощью WhatsApp непосредственно в RemOnline. Больше информации о том, как пользоваться шаблонами WhatsApp в RemOnline можно найти здесь.

Стоимость использования WhatsApp рассчитывается на основе тарифа за чат от Meta и тарифа за сообщение от Twilio.

Первые 1000 чатов в месяц - бесплатные, при условии, что они происходят в течение первых 24 часов после получения сообщения от пользователя. Любые чаты, инициированные вами после этого периода, являются платными.

Например, $0.015 за каждый разговор, и $0.005 за каждое сообщение с американского номера.

Таким образом, общая стоимость использования WhatsApp включает как плату за чат от Meta, так и плату за каждое отдельное сообщение от Twilio. Узнать более подробную информацию о ценах и рассчитать стоимость использования WhatsApp от Twilio можно здесь.