Интеграция PrimeGate с WhatsApp by Twilio
Важно: предварительные условия
Для подключения и использования любой бизнес-интеграции WhatsApp необходимо иметь зарегистрированную компанию с действительными регистрационными данными и документами. В противном случае WhatsApp не одобрит ваш запрос и не позволит вам интегрировать WhatsApp Business с какой-либо внешней платформой. Если у вас нет зарегистрированной компании, подключить WhatsApp к SuperCharger Primegate не является возможным, к сожалению.
Обратите внимание, что интеграция через Twilio требует приобретения их номера. Номера РФ недоступны для покупки на текущий момент.
Также, при использовании любого номера, интеграция потребует дополнительной оплаты согласно тарифам Twilio.

Данная инструкция состоит из двух больших частей. Во-первых, мы решили собрать здесь блок, связанный с регистрацией в Twilio и подтверждением вашего WhatsApp. Вторая часть посвящена подключению вашего аккаунта в Twilio к PrimeGate.

Регистрация и оформление аккаунта в Twilio для подключения его к Прайм Гейт

  1. Зарегистрируйте аккаунт в Twilio

Если у вас уже есть аккаунт Twilio, переходите к следующему шагу.

Зарегиструйтесь на сайте Twilio и укажите необходимые данные. Данные банковской карты для регистрации не требуются!

Image for post

После этого перейдите в ваш профиль Twilio и приступайте к следующему шагу.

2. Получите одобрение от WhatsApp

Отправьте запрос в WhatsApp на активацию вашего номера Twilio

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

Вам понадобится Facebook Business Manager ID, чтобы отправить запрос на разрешение Twilio отправлять сообщения от вашего имени. Прочитать подробнее можно тут: ссылка.

Прочитать подробнее о профилях WhatsApp Business и песочнице Twilio для WhatsApp можно в документации по ссылке.

Заполните форму, чтобы активировать ваш номер в Twilio

Важно: от того, как вы заполните анкету, будет зависеть, подтвердит вас Twillio или нет и сколько по времени займет интеграция.

Действуйте согласно нашим инструкциям, чтобы исключить ошибки при заполнении анкеты, иначе процесс интеграции затянется:

Image for post
  • Phone Number — Номер телефона. Укажите ваш контактный телефон. Это не обязательно должен быть номер, приобретенный в Twilio. Мы рекомендуем указать номер, который так или иначе относится к вашей компании.
  • Email Address — Адрес email. Укажите существующий адрес электронной почты, который будет также использовать Twilio при необходимости связаться с вами. Рекомендуем использовать email, относящийся к вашей компании.
  • Twilio Account SID — SID аккаунта Twilio. Чтобы найти SID, перейдите в ваш аккаунт Twilio, раздел Settings (Настройки) > General (Общие) и скопируйте данные из поля ACCOUNT SID;
  • Facebook Business Manager ID — ID вашего аккаунта Facebook Business Manager. Его можно найти в вашем аккаунте Facebook Business Manager по ссылке https://business.facebook.com/settings/info?business_id.

Для заполнения оставшихся полей см. скриншот ниже:


Image for post


  • I’ve completed the Business Verification*: укажите статус верификации вашего бизнес-аккаунта на Facebook. Если аккаунт пока не верифицирован, так и укажите. Завершить верификацию можно и позже, н этом шаге важно указать достоверные данные.
  • Company Vertical укажите тип бизнеса, к которому относится ваша компания. Если затрудняетесь с выбором, сверьтесь с этим руководством: ссылка;
  • What is your use case? укажите, для чего вы будете использовать интеграцию: для поддержки клиентов, уведомлений или 2-шаговой верификации (2FA/User Verification).
  • How many messages are you sending per month during the first year? укажите ориентировочное среднее количество сообщений, которое вы планируете отправлять в течение первого месяца интеграции через Twilio.
  • I wish to provision this account with a third a party vendor в этом поле важно выбрать NO (НЕТ), если вы хотите использовать интеграцию Twilio.
  • Assign approval do alternate Account SID (Optional) сообщите SID от другого аккаунта Twilio, если на основном аккаунте будут присутствовать ограничения. Это необязательное поле, которое следует оставлять пустым в большинстве случаев.
  • I understand Twilio can modify my SMS/Voice URL and that approval is only for the brand submitted выберите YES (ДА). Это — подтверждение, что вы поддерживаете соглашение Twilio для активации и использования WhatsApp-номера.

В случае, если все заполнено корректно, Twilio свяжется с вами в течение 5 дней после отправки вами запроса.

3. Приобретите телефонный номер в Twilio

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

Напоминаем, что номера РФ недоступны для покупки на текущий момент.


Примечания:
* После регистрации аккаунта в Twilio, на вашем счете будет активен баланс $15.50 для тестовых целей. Эти средства могут быть использованы исключительно с тестовыми номерами Twilio. В дальнейшем, для интеграции с PrimeGate нужно будет пополнить баланс аккаунта Twilio, после чего тестовый баланс будет аннулирован.
* Покупка номеров некоторых стран потребует загрузки документов, подтверждающих право на использование данного номера, список таких стран можно посмотреть в документации:
ссылка.

4. Активируйте функцию отправки сообщений

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

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

5. Примите запрос от Twilio на отправку сообщений от вашего имени

Внимание! К этому шагу вы можете перейти только если ваш аккаунт уже был одобрен WhatsApp (см. шаг 2 в инструкции).

После того, как вы получили email от Twilio, в котором сообщается, что ваш WhatsApp аккаунт был предварительно одобрен, нужно разрешить Twilio отправку сообщений от вашего имени. Чтобы сделать это, воспользуйтесь документацией: ссылка.

Далее, верифицируйте аккаунт Facebook Business в вашем Business Manager. Сделать это можно пользуясь этой инструкцией: ссылка. Обратите внимание, что этот процесс может занять 7–14 рабочих дней. Настоятельно рекомендуем не допускать ошибок и указывать исключительно достоверную информацию, иначе Facebook отклонит вашу заявку.

В случае успешного прохождения верификации, в течение пяти дней вы получите email с подтверждением от Facebook, а в Business Manager в разделе Company Information статус сменится на “Verified”.

6. Пополните счет аккаунта Twilio

После одобрения аккаунта WhatsApp Business, вы получите письмо от Twilio c предложением повысить уровень вашего аккаунта, чтобы завершить интеграцию. Для этого требуется просто пополнить счет с помощью карты. Это действие также аннулирует остатки тестового баланса с вашего счета Twilio.

Следуйте этому руководству, чтобы повысить уровень аккаунта Twilio: ссылка.

Подключение интеграции Прайм Гейт с WhatsApp by Twilio

Перейдите на страницу интеграции.
Укажите Ваш Twillio ACCOUNT SID
Чтобы найти SID, перейдите в ваш аккаунт Twilio, раздел Settings (Настройки) > General (Общие) и скопируйте данные из поля ACCOUNT SID.

Image for post

Укажите Ваш Twillio AUTH TOKEN
Чтобы найти AUTH TOKEN, перейдите в ваш аккаунт Twilio, раздел Settings (Настройки) > General (Общие) и скопируйте данные из поля AUTH TOKEN. (необходимо будет нажать на него чтобы он показался)

Image for post

И укажите Ваш номер который вы приобрели или перенесли в Twilio


Узнать его можно перейдя в раздел https://www.twilio.com/console/sms/whatsapp/senders и скопировать WHATSAPP NUMBER

Image for post

В этом же разделе , нажав на кнопку Edit Sender, указываем номеру вебхуки:
Webhook: WHEN A MESSAGE COMES IN и Webhook: STATUS CALLBACK URL указываем в соответственные поля в Twilio

Image for post

Активируем, сохраняем и можем перейти в SuperCharger для тестирования.