Подключение WhatsApp Business API через Twilio

Важно: предварительные условия

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



Интеграция позволит вам работать с сообщениями клиентов из WhatsApp в приложении Jivo. Также вы сможете добавить опцию связи по WhatsApp в виджет Jivo на мобильной версии вашего сайта, чтобы посетители могли начать разговор с вами непосредственно из WhatsApp.

В среднем, весь процесс подключения занимает от 15 до 25 дней. В связи с этим мы рекомендуем точно следовать нижеописанным шагам, чтобы избезжать возможных ошибок, которые могут затянуть процесс одобрения заявки и усложнить подключение интеграции.

  1. Зарегистрируйте профессиональный аккаунт в Jivo
  2. Зарегистрируйте аккаунт в Twilio
  3. Получите одобрение от WhatsApp
  4. Приобретите телефонный номер в Twilio
  5. Активируйте функцию отправки сообщений
  6. Примите запрос от Twilio на отправку сообщений от вашего имени
  7. Пополните счет аккаунта Twilio
  8. Подключите Twilio к Jivo
  9. Протестируйте интеграцию и создайте Шаблонные сообщения

FAQ

Шаги для подлючения

Рассмотрим подробно шаги для подключения нтеграции через сервис Twilio.

  1. Зарегистрируйте профессиональный аккаунт в Jivo

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

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

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

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

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

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

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

Вам понадобится **Business Manager ID, чтобы отправить запрос на разрешение Twilio отправлять сообщения от вашего имени. Прочитать подробнее можно тут: **[ссылка](https://www.twilio.com/docs/whatsapp/api#***-business-manager-account)\*\.

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

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

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

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

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

  • I've completed the Business Verification:* укажите статус верификации вашего бизнес-аккаунта на ___. Если аккаунт пока не верифицирован, так и укажите. ЗАвершить верификацию можно и позже, н этом шаге важно указать достоверные данные.
  • 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 дней после отправки вами запроса.

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

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

Примечания:

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

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

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

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

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

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

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

Далее, верифицируйте аккаунт ***Business в вашем Business Manager. Сделать это можно пользуясь этой инструкцией: [ссылка](https://www.twilio.com/docs/whatsapp/tutorial/connect-number-business-profile#step-4-verify-your-***-business-manager-account). Обратите внимание, что этот процесс может заняь 7-14 рабочих дней. Настоятельно рекомендуем не допускать ошибок и указывать исключительно достоверную иннформацию, иначе ___ отклонит вашу заявку.

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

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

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

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

8. Подключите Twilio к Jivo

Добавьте канал связи WhatsApp Business в Jivo

Финальный шаг подключения - добавить WhatsApp Business в вашем аккаунте Jivo. Для этого вам понадобятся 3 параметра: Twilio SID, Twilio AuthToken и ваш одобренный номер WhatsApp Business.

Чтобы добавить канал связи, перейдите в приложение Jivo > раздел Управление > кнопка Добавить канал > WhatsApp:

Нажмите на "Подключить аккаунт к Jivo" в колонке Twilio:

Заполните поля данными вашего аккаунта Twilio:

  • Название канала: - название канал, которое будет видно в списке подключенных каналов (подойдет любое название).
  • Номер телефона WhatsApp Business API аккаунта: - ваш одобренный номер WhatsApp Business от Twilio. (нажимте здесь, чтобы посмотреть номер);
  • SID аккаунта Twilio - скопируйте из личного кабинета Twilio, раздел Settings (Настройки) > General (Общие). Ваш SID расположен в поле "ACCOUNT SID";

  • Авторизационный токен Twilio - скопируйте из личного кабинета Twilio, раздел Settings (Настройки) > General (Общие). Ваш токен расположен в поле "AUTH TOKEN";

  • Назначить всех операторов на этот канал - если отметка проставлена, все операторы аккаунта будут назначены на канал и смогут работать с сообщениями из WhatsApp; если убрать отметку, только владелец аккаунта будет назначен на канал (изменить это можно в дальнейшем в списке подключенных каналов).

Добавьте Jivo Webhook URL в Twilio

  • После подключения канала, вы увидите его в списке подключенных каналов в приложении Jivo -> Управление -> Каналы связи;
  • Перейдите в настройки канала WhatsApp и скопируйте Webhook URL, сгенерированный Jivo, примерно такого вида:
https://joint.jivosite.com/xxxxxxxxxxxxxxx/xxxxxxxxxxx
  • После этого перейдите в ваш аккаунт Twilio, откройте настройки отправки сообщений (Develop > Messaging > Senders > WhatsApp senders > Edit sender) и вставьте скопированный URL в поле "Webhook URL for incoming messages", затем сохраните изменения.

Настройка готова! Время протестировать интеграцию.

9. Протестируйте интеграцию и создайте Шаблонные сообщения

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

Интеграция с WhatsApp Business предполагает 2 типа сообщений для отправки: Шаблонные сообщения и Сеансовые сообщения. Сеансовые сообщения - те, которые оператор отправляет в ответ на запрос клиента в течение 24 часов со времени последнего сообщения от клиента. По истечении этого времени, отправить можно будет только Шаблонные сообщения. Шаблонные сообщения - стандартные сообщения, могут быть отправлены вне 24-часового периода. Такие сообщения могут включать в себя напоминания клиенту, информацию о статусе заказа или доставке и т.д.

*В Jivo не поддерживаются кнопки и изображения в шаблонных сообщениях.

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

Добавление Шаблонных сообщений в Jivo

Когда вы создали шаблонные сообщения в аккаунте Twilio, вам нужно добавить их в Jivo.
Важно! Сообщения в Jivo должны быть идентичны добавленным в Twilio.

Откройте приложение Jivo и перейдите в любой чат, либо откройте один из архивных (Диалоги -> Все - кнопка Начать чат):

Нажмите на иконку \.. снизу поля ввода текста и в окне добавления быстрых фраз выберите "Добавить фразу":

Скопируйте фразу из аккаунта Twilio и вставьте ее в Jivo в неизменном виде, пропишите ярлык, который поможет вам ее быстро отыскать в дальнейшем, по желанию установите сочетание клавиш для моментальной отправки фразы и нажмите на "Добавить фразу".

Отправка Шаблонных сообщений в Jivo

После подключения интеграции с WhatsApp во чате появится еще оин тип поля ввода: WhatsApp. Переключившись на него, вы сможете отправить исходящее Шаблонное сообщение клиенту (при условии, что в информации о клиенте указан номер телефона). Если у вас подключено несколько номеров WhatsApp, выберите, с какого номера будет отправлено сообщение:

Отправить возможно только шаблонное сообщение, заготовленное в акаунте Twilio. Выберите сообщение из шаблонных (список фраз открвается по значку \.. внизу поля ввода). Сообщение подставится в поле ввода текста, и вы смможете заменить плейсхолдеры из шаблона на нужную информацию, актуальную для клиента.

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

Подключив интеграцию с WhatsApp по этой инструкции, вы будете готовы вести переписку с клиентами через WhatsApp Business напрямую через приложение Jivo.

Надеемся, эта статья была полезна, и желаем вам продуктивного дня!

FAQ:


У меня нет зарегистрированной компании. Могу ли я использовать интеграцию с WhatsApp?

К сожалению, нет. Эта функция доступна только для зарегистрированных компаний, это является требованием ___.

Я индивидуальный предприниматель. Могу ли я использовать интеграцию с WhatsApp?

Если у вас есть зарегистрированная компания, вы можете подключить эту интеграцию. Возможно, есть некоторые нюансы, но команда поддержки Twilio может помочь вам с любыми трудностями, которые могут возникнуть.

Я выполнил все требования, но моя компания или бизнес-аккаунт WhatsApp не были одобрены ___. Что делать?

Если ваша компания является зарегистрированной, и вы предоставили достоверную информацию в анкете-заявлении ___ Business, то этого не должно произойти. В любом случае, наша техподдржка и команда поддержки Twilio будут готовы помочь вам, если возникнут трудности.

Просим убедиться, что тип вашего бизнеса соответствует критериям ___ для использования WhatsApp Business API: ссылка.

Можно ли отключить интеграцию, если я хочу вернуться к обычному использованию WhatsApp?

Важно: НЕТ. После активации бизнес-API WhatsApp на вашем номере вы больше не сможете использовать его в обычном приложении WhatsApp, только через API (интеграция). Это - условие со стороны ___.

Является ли Jivo официальным каналом ___ / WhatsApp?

Мы работаем в прямом партнерстве с ___, а также с официальными провайдерами WhatsApp Business API со всего мира.

Как я могу получить значок подтвержденной организации в WhatsApp?

WhatsApp не сообщает четких деталей получения значка подтвержденной организации на своей платформе. В настоящее время нет точных данные по этому процессу. Более подробная информация об этом здесь: ссылка.

Есть ли дополнительные расходы на использование интеграции WhatsApp в Jivo?

Да, сообщения WhatsApp оплачиваются отдельно, независимо от лицензии Jivo.

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

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

Нужно ли мне покупать новый номер, или я могу использовать свой существующий номер?

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

Могу ли я перенести свой одобренный номер WhatsApp в Twilio?

В некоторых случаях можно перенести уже подтвержденный номер WhatsApp в Twilio.

Если вы зарегистрировались в WhatsApp с помощью стандартного приложения WhatsApp или приложения WhatsApp Business для малого бизнеса, возможно использовать тот же номер и в Twilio. Мы рекомендуем обратиться за помощью в службу поддержки Twilio.

Однако если вы зарегистрировались в WhatsApp с помощью бизнес-API WhatsApp через другого официального провайдера интеграции (не Twilio), такой номер вы не сможете перенести. Это связано с текущими ограничениями на передачу номеров и параметров между существующими бизнес-счетами

Также, к сожалению, на текущий момент не все страны поддерживают возможность перенноса номера. Чтобы проверить, можно ли перенести ваш текущий номер в Twilio, пожалуйста, свяжитесь с отделом продаж Twilio ссылка.

Можно ли протестировать интеграцию с WhatsApp перед использованием?

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

В чем отличие Шаблонных сообщений от Сессионных сообщений?

Сессионные сообщения отправляются операторами в ответ на сообщение клиента, в течение 24 часов с момента оправки им последнего сообщения. Таким образом, у вас есть 24 часа, чтобы ответить клиенту. По истечении этого времени, отправлять можно будет только Шаблонные сообщения.

Шаблонные сообщения - это заготовки сообщений, которые можно отправлять клиенту в любой момент времени. Template Messages are standard models of messages that can be sent via WhatsApp outside the 24-hour window. Такие сообщения могут включать в себя напоминания клиенту, информацию о статусе заказа или доставке и т.д. Пожалуйста, ознакомьесь с более подробной информацией о Шаблонных сообщениях и том, как их создать в аккаунте Twilio, в документации: ссылка.

Как работает правило 24-часового ответа клиентам? Как отправлять сообщения клиентам через API по истечении 24 часов?

Это правило обусловлено политикой WhatsApp. Она ограничивает возможность отвечать на сообщения, полученные более 24 часов назад через внешние приложения. Если вы хотите продолжить разговор по истечении этого периода, следует отправить сообщение из списка заранее утвержденных шаблонов или подождать, пока ваш клиент снова свяжется с вами.

Статьи по теме
Есть вопросы?
Спросите техподдержку в чате на сайте, мы всегда рады помочь.
Работаем 24 часа 7 дней в неделю.