Как мы подключили официальный бизнес API WhatsApp через Twilio

I’ve completed Facebook Business Verification — ставим «No», если в Facebook Business Manager -> Настройки компании -> Информация о компании -> Статус подтверждения компании -> указано «Не подтверждена» или «Yes», если «Подтверждена»;

Company Vertical — выбираем из списка направление деятельности компании;

What is your use case? — выбираем из списка, для чего будет использоваться WhatsApp: Notifications (Оповещения), Customer Support (Поддержка клиентов), 2FA or User Verification (Двухфакторная аутентификация или верификация пользователей);

Which regions are you sending messages to? — В какие регионы будут отправляться сообщения (выбираем из списка Global);

How many messages are you sending per month during the first year? — Сколько сообщений будет отправляться в месяц в течение первого года (выбираем из списка нужный диапазон);

I wish to provision this account with a third party vendor — Будет ли предоставляться эта учетная запись стороннему поставщику (выбираем «No»);

Assign approval to alternate Account SID (Optional) — Назначить утверждение альтернативному SID учетной записи (необязательно) (ничего не вводим, оставляем поле пустым);

I understand Twilio can modify my SMS/Voice URL and that approval is only for the brand submitted. — Я понимаю, что Twilio может изменять мой URL-адрес SMS / голосового сообщения, и это одобрение предназначено только для отправленного бренда (соглашаемся и выбираем «Yes»).

Для отправки запроса, нажимаем кнопку «Request Now». После успешной отправки появится соответствующее уведомление: «Спасибо за Ваш интерес. Мы будем держать Вас в курсе по мере открытия доступа».

На почту получаем вот такое письмо:

Переводим сообщение на русский:

Теперь ждем 3-4 недели ответ от Twilio, как указано в письме.

Через 4 недели получаем ответ от Twilio, что теперь можно добавить WhatsApp отправителя и продолжить процесс регистрации:

Переводим сообщение на русский:

4. Upgrade аккаунта в Twilio

Для продолжения, обязательно нужно перевести проект Twilio из пробного (Trial) в рабочий (Upgrade), для чего потребуется пополнить баланс. На пробном аккаунте Twilio не получится зарегистрировать WhatsApp отправителя.

Минимальная сумма пополнения 20$ (двадцать долларов). Потом эти деньги можно будет тратить на аренду телефонных номеров для WhatsApp отправителей и оплату входящих и исходящих сообщений в WhatsApp. Аренда телефонного номера стоит от 1$ (один доллар) в месяц. Входящие и исходящие сообщения в WhatsApp — 0.005$ (пол цента) за 1 сообщение.

Для апгрейда аккаунта перейдем по ссылке https://www.twilio.com/console/billing/upgrade.

Заполним латиницей поля в разделе «Add Company Address».

Аналогично, заполним поля в разделе «Add Billing Address» такими же данными.

И так же подтвердим адрес.

В разделе «Add Payment Information and Funds» введем данные банковской карты и нажмем кнопку «Upgrade Account» для проведения оплаты.

После успешной оплаты увидим соответствующее уведомление.

5. Покупка телефонного номера в Twilio для создания WhatsApp отправителя

Российских номеров в Twilio к сожалению нет, но на практике это оказалось не так и важно. Зачастую пользователи даже и не смотрят на номер, когда пишут в WhatsApp.

Для покупки телефонного номера Twilio перейдем по ссылке https://www.twilio.com/console/phone-numbers/search, выберем страну в поле «COUNTRY», по желанию можно выставить и другие дополнительные параметры поиска, и нажмем кнопку «Search».

Выберем нужный телефонный номер и нажмем кнопку «Buy».

В следующем окне подтвердим покупку.

6. Регистрация WhatsApp отправителя в Twilio

Для регистрации WhatsApp отправителя в Twilio перейдем в раздел «WhatsApp Senders» по ссылке www.twilio.com/console/sms/whatsapp/senders и нажмем иконку «плюс».

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

Заполним открывшуюся форму:

Select a Number (Required) — Выберем номер телефона, который мы купили в Twilio выше.

Business Display Name (Required) — Отображаемое имя, которое должно соотносится с вашей компанией в соответствии с требованиями Facebook. Можно указать просто название компании, которое мы вводили при регистрации аккаунта в Facebook Business Manager.

Company Address (Optional) — Адрес компании (можно не указывать).

Company Email (Optional) — Электронный адрес компании (можно не указывать).

Website (Optional) — Веб-сайт компании (можно не указывать).

Link to Logo (Optional) — Ссылка на логотип компании (можно не указывать). Минимальный размер изображения 640×640 px в форматах PNG или JPG (JPG рекомендуется), фон не должен быть прозрачным.

Check if profile is for a client. I’ve read the third party guidelines — Эту галочку не ставим.

Для отправки нажмем кнопку «Submit Request», которая станет активной после после заполнения обязательных полей формы.

В списке отправителей появится запись со статусом «Waiting for Approval from WhatsApp», означающая что теперь нужно подождать подтверждения со стороны WhatsApp.

И получаем письмо от Twilio, что они рассматривают наш запрос, и свяжутся с нами в ближайшее время.

Ждем ответа от Twilio.

7. Подтверждение компании в Facebook Business Manager

Примерно через полтора часа получаем от Twilio еще одно письмо, что в Facebook Business Manager необходимо принять запрос от Twilio, чтобы предоставить им разрешение на создание учетной записи WhatsApp Business.

Для этого переходим по ссылке https://business.facebook.com/settings/requests/received_requests (Facebook Business Manager -> Настройки компании -> Запросы -> Полученные) и нажимаем кнопку «Одобрить».

После принятия запроса от Twilio, необходимо подтвердить компанию в Facebook Business Manager. Для этого переходим по ссылке https://business.facebook.com/settings/security (Facebook Business Manager -> Настройки компании -> Центр безопасности) и в разделе «Подтверждение компании» нажимаем кнопку «Начать подтверждение», которая станет активной после принятия запроса от Twilio.

С официальной информацией от Facebook о подтверждении компании можно ознакомиться по ссылке: https://www.facebook.com/business/help/2058515294227817?id=180505742745347.

На первом шаге подтверждения введем данные нашей компании:

Юридическое название компании — название компании, как в указано в документах на регистрацию компании.

Страна — страна регистрации компании.

Адрес (улица, № дома) — улица и номер дома юридического адреса компании, как в указано в документах на регистрацию компании.

Адрес 2/Населенный пункт — вводим, если имеется.

Город — город юридического адреса компании, как в указано в документах на регистрацию компании.

Штат/провинция/регион — регион юридического адреса компании, как в указано в документах на регистрацию компании.

Почтовый индекс — почтовый индекс юридического адреса компании, как в указано в документах на регистрацию компании.

Номер телефона компании — номер телефона, который принадлежит данному юридическому лицу (должны быть подтверждающие документы: договор, счета на оплату за телефон и т.п.).

Сайт — адрес веб-сайта компании (домен сайта должен совпадать с доменом электронного адреса компании).

На втором шаге подтверждения компании необходимо подтвердить юридическое название компании.

Для этого нужно загрузить документы из списка:

1. Лицензия на ведение коммерческой деятельности (если имеется);
2. Свидетельства о регистрации или учредительные договоры (ОГРН или учредительный договор);
3. Свидетельство о регистрации налогоплательщика (ИНН).

Мы загрузили сканы ОГРН и ИНН компании.

На третьем шаге подтверждения компании необходимо подтвердить юридический адрес и номер телефона компании.

Для этого нужно загрузить документы из списка:

1. Счет за коммунальные услуги, например электроэнергию или телефон;
2. Справка из банка, на которой указан адрес;
3. Лицензия на ведение коммерческой деятельности с адресом или телефоном компании (если имеется).

Мы загрузили сканы: договора на аренду офисного помещения по юридическому адресу, информационного письма об учете в Статрегистре Росстата, счета на оплату за телефонный номер от оператора связи.

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

Для этого нужно в разделе «Выберите, как с вами связаться» выбрать телефон и нажать кнопку «Позвоните мне». Поле «Мой рабочий электронный адрес» оставляем пустым.

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

Вводим цифры кода подтверждения и нажимаем кнопку «Отправить».

Ждем подтверждения от Facebook, как нам пишут в письме Twilio, это может занять 4-7 рабочих дней.

Мы получили подтверждение компании от Facebook в течении 1-го рабочего дня.

Ждем завершения регистрации WhatsApp отправителя от Twilio.

8. Завершение регистрации WhatsApp отправителя в Twilio

Через 4 часа получаем письмо от Twilio, что они проверили наш бизнес-профиль в WhatsApp и отправили на рассмотрение отображаемое название нашей компании. Срок выполнения проверки отображаемого имени обычно составляет 24–48 часов.

Переводим сообщение на русский:

Ждем ответа от Twilio 24-48 часов, как указано в письме.

Примерно через 30 часов получаем письмо от Twilio, что наш профиль отправителя WhatsApp с выбранным номером телефона успешно зарегистрирован.

Заходим в аккаунт Twilio, в раздел WhatsApp Senders по ссылке https://www.twilio.com/console/sms/whatsapp/senders и видим, что у записи сменился статус на «Approved» («Одобрено»).

Итог

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

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

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

Оригинал публикации на нашем сайте: https://aiapps.pro