Но сделать это напрямую большинству компаний по прежнему не под силу, а только через крупных партнеров Facebook, которые в данном случае выступают в роли посредников.
Одним из таких доступных партнеров является американская компания Twilio. Самое основное их преимущество на мой взгляд, это невысокая стоимость использования WhatsApp Business API.
Я подключил через Twilio официальный бизнес API WhatsApp и сейчас подробно расскажу, как это сделать.
![WhatsApp Messenger](https://habrastorage.org/webt/yd/h1/qu/ydh1qu402oowwjpculg_sw1rp2q.jpeg)
Основным условием Facebook является наличие зарегистрированного юридического лица, например ООО или ИП, на физическое лицо доступ получить не получится.
Итак, начнем двигаться по шагам.
1. Создание аккаунта в Facebook Business Manager
Войдем в свой личный аккаунт в Facebook и создадим аккаунт Business Manager, для чего перейдем по ссылке business.facebook.com/overview и нажмем кнопку «СОЗДАТЬ АККАУНТ», откроется окно для ввода данных компании.
![Создание аккаунта Business Manager в Facebook](https://habrastorage.org/webt/cl/zb/_g/clzb_ghswpf0i234lx7awnqzvnm.png)
Согласно подсказкам над полями, вводим название компании, имя и фамилию, e-mail и нажимаем кнопку «Отправить».
В следующем окне введем информацию о компании и нажмем кнопку «Отправить».
![Добавление информации о компании при создании аккаунта в Facebook Business Manager](https://habrastorage.org/webt/og/c9/0q/ogc90qsjltiovvmc8xrzbzeydt0.png)
После отправки появится сообщение, что аккаунт создан и необходимо подтвердить адрес электронной почты.
![Необходимость подтверждения адреса электронной почты при создании аккаунта в Facebook Business Manager](https://habrastorage.org/webt/md/ig/nm/mdignmtjsis3zd-snqkl6wlworo.png)
Зайдем в почту и нажмем на кнопку «Подтвердить» из письма.
![Подтверждение адреса электронной почты при создании аккаунта в Facebook Business Manager](https://habrastorage.org/webt/iu/_h/dm/iu_hdmpfebjmzdmybbv_tmlxwsk.png)
2. Регистрация аккаунта в Twilio
Зарегистрируем аккаунт в Twilio по ссылке twilio.com/try-twilio. Сделать это совсем не сложно, регистрация бесплатная и не требует данных банковской карты, нужно только ввести имя, фамилию, e-mail и придумать пароль.
![Регистрация аккаунта в Twilio](https://habrastorage.org/webt/07/eo/pf/07eopfazq2vkrvfuppyb1en2xag.png)
Подтверждаем e-mail.
![Подтверждение e-mail при создании аккаунта в Twilio.](https://habrastorage.org/webt/r6/vx/p2/r6vxp2psktsjo1udhymhujfwuze.png)
Подтверждаем номер телефона.
![Подтверждение телефона при создании аккаунта в Twilio](https://habrastorage.org/webt/x3/fe/qp/x3feqpskugm5vqjbbc6rugyajwo.jpeg)
3. Запрос в Twilio на активацию возможности добавления WhatsApp отправителей
Подготовим и отправим запрос в Twilio на активацию возможности добавления WhatsApp отправителей, для чего перейдем в раздел «WhatsApp Senders» по ссылке www.twilio.com/console/sms/whatsapp/senders и нажмем кнопку «Sign Up to Receive Updates».
![Открытие формы запроса на активацию возможности добавления WhatsApp отправителей в Twilio](https://habrastorage.org/webt/ct/gp/qw/ctgpqwgwsdm0mx9lk3drmqvy9iy.png)
Откроется форма запроса на активацию возможности добавления WhatsApp отправителей в Twilio. Заполняем поля формы данными, которые указывались выше, при создании аккаунта в Facebook Business Manager:
First Name — Имя (латиницей);
Last Name — Фамилия (латиницей);
Phone Number — Номер телефона компании (указанный в Facebook Business Manager);
Email Address — Адрес электронной почты компании (указанный в Facebook Business Manager);
Company Name — Название компании (латиницей, указанное в Facebook Business Manager);
Company Website — Веб-сайт компании (указанный в Facebook Business Manager);
Company HQ Country — Страна регистрации компании (указанная в Facebook Business Manager);
Twilio Account SID — Идентификатор аккаунта Twilio скопировать из поля ACCOUNT SID на странице www.twilio.com/console;
![Twilio Account SID](https://habrastorage.org/webt/t-/tr/-q/t-tr-qrgumi-b14fodzjck03rjs.png)
Facebook Business Manager ID — Идентификатор созданного аккаунта в Facebook Business Manager скопировать из поля «Идентификатор Бизнес-менеджера:» на странице business.facebook.com/settings/info (Facebook Business Manager -> Настройки компании -> Информация о компании);
![Facebook Business Manager ID](https://habrastorage.org/webt/qp/yl/fo/qpylfo56xyb4ahmxs6corimkpk0.png)
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»).
![Заполняем поля формы запроса на активацию возможности добавления WhatsApp отправителей в Twilio](https://habrastorage.org/webt/jc/pe/hd/jcpehdemp6wrsyyp_rss1qua5ok.png)
Для отправки запроса, нажимаем кнопку «Request Now». После успешной отправки появится соответствующее уведомление: «Спасибо за Ваш интерес. Мы будем держать Вас в курсе по мере открытия доступа.».
![Уведомление об успешной отправке запроса на активацию возможности добавления WhatsApp отправителей в Twilio](https://habrastorage.org/webt/rq/ks/wz/rqkswznypk9hor2wqwe_atyx8wa.png)
На почту получаем вот такое письмо:
![Письмо от Twilio после отправки запроса на активацию возможности добавления WhatsApp отправителей в Twilio](https://habrastorage.org/webt/lw/i6/r5/lwi6r5z-bvslikfjhz4tkf1obsi.png)
Переводим сообщение на русский:
![Перевод на русский письма от Twilio после отправки запроса на активацию возможности добавления WhatsApp отправителей в Twilio.](https://habrastorage.org/webt/1r/m0/eu/1rm0eu3bz-bay0xj6w55zbrvqas.png)
Теперь ждем 3-4 недели ответ от Twilio, как указано в письме.
Через 4 недели получаем ответ от Twilio, что теперь можно добавить WhatsApp отправителя и продолжить процесс регистрации:
![Ответ от Twilio на запрос по активации возможности добавления WhatsApp отправителей в Twilio](https://habrastorage.org/webt/hv/of/7z/hvof7z1dnhgqcgb3y2dm1mygajc.png)
Переводим сообщение на русский:
![Перевод на русский ответа от Twilio на запрос по активации возможности добавления WhatsApp отправителей в Twilio](https://habrastorage.org/webt/pv/pw/71/pvpw71mfjhvnl3havh77i9tcke4.png)
4. Upgrade аккаунта в Twilio
Для продолжения, обязательно нужно перевести проект Twilio из пробного (Trial) в рабочий (Upgrade), для чего потребуется пополнить баланс. На пробном аккаунте Twilio не получится зарегистрировать WhatsApp отправителя. Минимальная сумма пополнения 20$ (двадцать долларов). Потом эти деньги можно будет тратить на аренду телефонных номеров для WhatsApp отправителей и оплату входящих и исходящих сообщений в WhatsApp. Аренда телефонного номера стоит от 1$ (один доллар) в месяц. Входящие и исходящие сообщения в WhatsApp — 0.005$ (пол цента) за 1 сообщение.
Для апгрейда аккаунта перейдем по ссылке www.twilio.com/console/billing/upgrade.
Заполним латиницей поля в разделе «Add Company Address».
![Пополнение баланса Twilio: Добавление адреса компании](https://habrastorage.org/webt/0c/b3/nz/0cb3nzgth-aretpscaxalfp8q2e.png)
Нажмем кнопку «Validate Address» для подтверждения адреса. В открывшемся окне нажмем кнопку «Use This Address».
![Пополнение баланса Twilio: Валидация адреса компании](https://habrastorage.org/webt/ir/kj/xg/irkjxghd8bpjdg6d9zeib16xf0m.png)
Аналогично, заполним поля в разделе «Add Billing Address» такими же данными.
![Пополнение баланса Twilio: Добавление адреса компании для выставления счетов](https://habrastorage.org/webt/j_/ka/r5/j_kar5hcnep_-4fmo3rbyfssxvu.png)
И так же подтвердим адрес.
![Пополнение баланса Twilio: Валидация адреса компании для выставления счетов](https://habrastorage.org/webt/lu/8b/0g/lu8b0gueac0jdj4d0ja2rntyqay.png)
В разделе «Add Payment Information and Funds» введем данные банковской карты и нажмем кнопку «Upgrade Account» для проведения оплаты.
![Пополнение баланса Twilio: добавление данных о способе оплаты и проведение платежа](https://habrastorage.org/webt/l4/e4/tf/l4e4tfobxq2fhmtnxpf360lz1_4.png)
После успешной оплаты увидим соответствующее уведомление.
![Сообщение об успешной оплате в Twilio](https://habrastorage.org/webt/p0/wl/p8/p0wlp8kxzfesxfwnmd92j_vrxwo.png)
5. Покупка телефонного номера в Twilio для создания WhatsApp отправителя
Российских номеров в Twilio к сожалению нет, но на практике это оказалось не так и важно. Зачастую пользователи даже и не смотрят на номер, когда пишут в WhatsApp.
Для покупки телефонного номера Twilio перейдем по ссылке www.twilio.com/console/phone-numbers/search, выберем страну в поле «COUNTRY», по желанию можно выставить и другие дополнительные параметры поиска, и нажмем кнопку «Search».
![Подбор телефонного номера в Twilio для аренды](https://habrastorage.org/webt/lq/ni/4_/lqni4_jxanb_ry-76smje2sf8xw.png)
![Подбор телефонного номера в Twilio для аренды](https://habrastorage.org/webt/pq/_k/f6/pq_kf6eoqumyczdfrttp4ivlw68.png)
Выберем нужный телефонный номер и нажмем кнопку «Buy».
В следующем окне подтвердим покупку.
![Подтверждение покупки телефонного номера Twilio](https://habrastorage.org/webt/w5/qt/2q/w5qt2q9my5oozhpu67_xmbdye_4.png)
6. Регистрация WhatsApp отправителя в Twilio
Для регистрации WhatsApp отправителя в Twilio перейдем в раздел «WhatsApp Senders» по ссылке www.twilio.com/console/sms/whatsapp/senders и нажмем иконку «плюс».
![Добавление отправителя WhatsApp в Twilio](https://habrastorage.org/webt/g1/eg/kg/g1egkguhgiwrnfqb6g180_bmlms.png)
Пока создадим 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) — Ссылка на логотип компании (можно не указывать). Минимальный размер изображения 640x640 px в форматах PNG или JPG (JPG рекомендуется), фон не должен быть прозрачным.
Check if profile is for a client. I've read the third party guidelines — Эту галочку не ставим.
![Форма регистрации WhatsApp отправителя в Twilio](https://habrastorage.org/webt/zl/9_/bn/zl9_bno64eile4xmudh121zlgji.png)
Для отправки нажмем кнопку «Submit Request», которая станет активной после после заполнения обязательных полей формы.
В списке отправителей появится запись со статусом «Waiting for Approval from WhatsApp», означающая что теперь нужно подождать подтверждения со стороны WhatsApp.
![Статус WhatsApp отправителя Waiting for Approval from WhatsApp в Twilio](https://habrastorage.org/webt/tp/on/8w/tpon8wbyd_ikfsoxmj9nuba_ltc.png)
И получаем письмо от Twilio, что они рассматривают наш запрос, и свяжутся с нами в ближайшее время.
![Письмо от Twilio после отправки формы регистрации WhatsApp отправителя](https://habrastorage.org/webt/kb/ur/ch/kburch6bulojgds2hdmd-ljcvma.png)
Ждем ответа от Twilio.
7. Подтверждение компании в Facebook Business Manager
Примерно через полтора часа получаем от Twilio еще одно письмо, что в Facebook Business Manager необходимо принять запрос от Twilio, чтобы предоставить им разрешение на создание учетной записи WhatsApp Business. Для этого переходим по ссылке business.facebook.com/settings/requests/received_requests (Facebook Business Manager -> Настройки компании -> Запросы -> Полученные) и нажать кнопку «Одобрить».
![Принятие запроса от Twilio в Facebook Business Manager](https://habrastorage.org/webt/pf/j2/yt/pfj2ytniidqawc1eghxrzukulnm.png)
После принятия запроса от Twilio, необходимо подтвердить компанию в Facebook Business Manager. Для этого переходим по ссылке business.facebook.com/settings/security (Facebook Business Manager -> Настройки компании -> Центр безопасности) и в разделе «Подтверждение компании» нажимаем кнопку «Начать подтверждение», которая станет активной после принятия запроса от Twilio.
![Начать подтверждение компании в Facebook Business Manager](https://habrastorage.org/webt/5e/ef/gk/5eefgkulymigkdlg_-ggsm0kqyu.png)
С официальной информацией от Facebook о подтверждении компании можно ознакомиться по ссылке: www.facebook.com/business/help/2058515294227817?id=180505742745347.
На первом шаге подтверждения введем данные нашей компании:
Юридическое название компании — название компании, как в указано в документах на регистрацию компании.
Страна — страна регистрации компании.
Адрес (улица, № дома) — улица и номер дома юридического адреса компании, как в указано в документах на регистрацию компании.
Адрес 2/Населенный пункт — вводим, если имеется.
Город — город юридического адреса компании, как в указано в документах на регистрацию компании.
Штат/провинция/регион — регион юридического адреса компании, как в указано в документах на регистрацию компании.
Почтовый индекс — почтовый индекс юридического адреса компании, как в указано в документах на регистрацию компании.
Номер телефона компании — номер телефона, который принадлежит данному юридическому лицу (должны быть подтверждающие документы: договор, счета на оплату за телефон и т.п.).
Сайт — адрес веб-сайта компании (домен сайта должен совпадать с доменом электронного адреса компании).
![Подтверждение компании в Facebook Business Manager. Шаг 1 - ввод данных компании.](https://habrastorage.org/webt/5z/9e/ox/5z9eoxpclgphh_ozz6ili4n74so.png)
На втором шаге подтверждения компании необходимо подтвердить юридическое название компании.
Для этого нужно загрузить документы из списка:
- Лицензия на ведение коммерческой деятельности (если имеется);
- Свидетельства о регистрации или учредительные договоры (ОГРН или учредительный договор);
- Свидетельство о регистрации налогоплательщика (ИНН).
Я загрузил сканы ОГРН и ИНН компании.
![Подтверждение компании в Facebook Business Manager. Шаг 2 - подтверждение юридического названия компании.](https://habrastorage.org/webt/ui/k4/2u/uik42uxk0dcpy79pfnwetqoz5sg.png)
На третьем шаге подтверждения компании необходимо подтвердить юридический адрес и номер телефона компании.
Для этого нужно загрузить документы из списка:
- Счет за коммунальные услуги, например электроэнергию или телефон;
- Справка из банка, на которой указан адрес;
- Лицензия на ведение коммерческой деятельности с адресом или телефоном компании (если имеется).
Я загрузил сканы: договора на аренду офисного помещения по юридическому адресу, информационного письма об учете в Статрегистре Росстата, счета на оплату за телефонный номер от оператора связи.
![Подтверждение компании в Facebook Business Manager. Шаг 3 - подтверждение юридического адреса и номера телефона компании.](https://habrastorage.org/webt/fa/ik/k-/faikk-jgsm_jpuiiixxbapkaebs.png)
На четвертом шаге необходимо получить и ввести код подтверждения.
Для этого нужно в разделе «Выберите, как с вами связаться» выбрать телефон и нажать кнопку «Позвоните мне». Поле «Мой рабочий электронный адрес» оставляем пустым. Позвонит робот и продиктует цифры, которые нужно ввести в поле ввода кода подтверждения.
Вводим цифры кода подтверждения и нажимаем кнопку «Отправить».
Ждем подтверждения от Facebook, как нам пишут в письме Twilio, это может занять 4-7 рабочих дней.
Мы получили подтверждение компании от Facebook в течении 1-го рабочего дня.
![Письмо от Facebook с уведомлением, что компания успешно подтверждена.](https://habrastorage.org/webt/pr/se/p-/prsep-q_x1z9swo_eigip0d6zbs.png)
![Сообщение в Facebook Business Manager, что компания успешно подтверждена.](https://habrastorage.org/webt/mt/1m/pv/mt1mpvpxbz6prmczgkdlw3_dkak.png)
![Зеленая иконка в Центре безопасности в Facebook Business Manager, что компания подтверждена.](https://habrastorage.org/webt/mr/me/c9/mrmec9n3aqag56hws3hx7-rlebs.png)
![Зеленая галочка в Информации о компании в Facebook Business Manager, что компания подтверждена.](https://habrastorage.org/webt/fk/su/ih/fksuihojwfcseak_4rfq3ysaltc.png)
Ждем завершения регистрации WhatsApp отправителя от Twilio.
8. Завершение регистрации WhatsApp отправителя в Twilio
Через 4 часа получаем письмо от Twilio, что они проверили наш бизнес-профиль в WhatsApp и отправили на рассмотрение отображаемое название нашей компании. Срок выполнения проверки отображаемого имени обычно составляет 24–48 часов.
![Письмо от Twilio, что они проверили наш бизнес-профиль в WhatsApp.](https://habrastorage.org/webt/ma/64/n7/ma64n7vt4jkjua_ms06islwd_yw.png)
Переводим сообщение на русский:
![Перевод на русский письма от Twilio, что они проверили наш бизнес-профиль в WhatsApp.](https://habrastorage.org/webt/em/jz/db/emjzdbo9439ry1euemhfud1omxq.png)
Ждем ответа от Twilio 24-48 часов, как указано в письме.
Примерно через 30 часов получаем письмо от Twilio, что наш профиль отправителя WhatsApp с выбранным номером телефона успешно зарегистрирован.
![Письмо от Twilio, что профиль отправителя WhatsApp с выбранным номером телефона успешно зарегистрирован.](https://habrastorage.org/webt/lw/wc/vu/lwwcvucrxomylfq3kd7_-7p-tjm.png)
Переводим сообщение на русский:
![Перевод на русский письма от Twilio, что профиль отправителя WhatsApp с выбранным номером телефона успешно зарегистрирован.](https://habrastorage.org/webt/82/8y/kf/828ykfvmm4tqczzeyo3_qr9adai.png)
Заходим в аккаунт Twilio, в раздел WhatsApp Senders по ссылке www.twilio.com/console/sms/whatsapp/senders и видим, что у записи сменился статус на «Approved» («Одобрено»).
![WhatsApp отправитель одобрен в Twilio и готов к работе.](https://habrastorage.org/webt/pq/1z/vw/pq1zvw6k0kbsdxzqlseyue4aup4.png)
Итог
На этом подключение официального бизнес API WhatsApp через Twilio успешно завершено. По времени, со всеми ожиданиями, у меня это заняло примерно один месяц. Теперь его можно использовать для интеграции с различными сервисами для коммуникации с пользователями и для создания чат-ботов.
granvi
Жесть. Так не должно быть.
А уж ценник у этих контор… Дешевле смс отправлять.
Пытался в прошлом году через этих, так сказать партнеров зарегистрироваться.
Из 7 контор ответили 2(!).
Тулят свои чат сисиемы, с непонятными функциями ха космические суммы. Без покупки этого чата нет whatsapp api. А все дело в том, что они работают по тем же принципам, как и серый api
AiAppsPro Автор
Я тоже поначалу был возмущен) Но такова реальность. Если бы сам WhatsApp предоставлял возможность подключиться напрямую, то сессионные сообщения и были бы бесплатными. По сути, WhatsApp дает возможность партнерам зарабатывать на предоставлении доступа. Логично, что за бесплатно партнерам это было бы просто не интересно.
"Серый" API я тоже тестил, но это все-таки другая и не очень стабильная история, да и сам WhatsApp, я думаю, не очень одобряет все это.