Важно: предварительные условия
Для подключения и использования любой бизнес-интеграции WhatsApp необходимо иметь зарегистрированную компанию с действительными регистрационными данными и документами. В противном случае WhatsApp не одобрит ваш запрос и не позволит вам интегрировать WhatsApp Business с какой-либо внешней платформой. Если у вас нет зарегистрированной компании, подключить WhatsApp к SuperCharger Primegate не является возможным, к сожалению.
Обратите внимание, что интеграция через Twilio требует приобретения их номера. Номера РФ недоступны для покупки на текущий момент.
Также, при использовании любого номера, интеграция потребует дополнительной оплаты согласно тарифам Twilio.
Данная инструкция состоит из двух больших частей. Во-первых, мы решили собрать здесь блок, связанный с регистрацией в Twilio и подтверждением вашего WhatsApp. Вторая часть посвящена подключению вашего аккаунта в Twilio к PrimeGate.
Регистрация и оформление аккаунта в Twilio для подключения его к Прайм Гейт
Если у вас уже есть аккаунт Twilio, переходите к следующему шагу.
Зарегиструйтесь на сайте Twilio и укажите необходимые данные. Данные банковской карты для регистрации не требуются!
После этого перейдите в ваш профиль Twilio и приступайте к следующему шагу.
2. Получите одобрение от WhatsApp
Отправьте запрос в WhatsApp на активацию вашего номера Twilio
Чтобы использовать API для WhatsApp от Twilio, вам потребуется активировать номер Twilio для WhatsApp. Сами Twilio будут использовать эту информацию для подтверждения вашего соглашения с WhatsApp и соблюдения политики конфиденциальности Twilio, а также для помощи вам в интеграции.
Вам понадобится Facebook Business Manager ID, чтобы отправить запрос на разрешение Twilio отправлять сообщения от вашего имени. Прочитать подробнее можно тут: ссылка.
Прочитать подробнее о профилях WhatsApp Business и песочнице Twilio для WhatsApp можно в документации по ссылке.
Заполните форму, чтобы активировать ваш номер в Twilio
Важно: от того, как вы заполните анкету, будет зависеть, подтвердит вас Twillio или нет и сколько по времени займет интеграция.
Действуйте согласно нашим инструкциям, чтобы исключить ошибки при заполнении анкеты, иначе процесс интеграции затянется:
- 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.
Для заполнения оставшихся полей см. скриншот ниже:
- 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.
Укажите Ваш Twillio AUTH TOKEN
Чтобы найти AUTH TOKEN, перейдите в ваш аккаунт Twilio, раздел Settings (Настройки) > General (Общие) и скопируйте данные из поля AUTH TOKEN. (необходимо будет нажать на него чтобы он показался)
И укажите Ваш номер который вы приобрели или перенесли в Twilio
Узнать его можно перейдя в раздел https://www.twilio.com/console/sms/whatsapp/senders и скопировать WHATSAPP NUMBER
В этом же разделе , нажав на кнопку Edit Sender, указываем номеру вебхуки:
Webhook: WHEN A MESSAGE COMES IN и Webhook: STATUS CALLBACK URL указываем в соответственные поля в Twilio
Активируем, сохраняем и можем перейти в SuperCharger для тестирования.
