Versions Compared

Version Old Version 4 New Version Current
Changes made by

Anastasia Lipskaya (Unlicensed)

Veronika Sidorovich

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Создание тестового канала WhatsApp с провайдером Twilio

...

Готовы подключиться к каналу WhatsApp? Для начала вам понадобится учетная запись Twilio.

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

Если у вас уже есть платная учетная запись Twilio, вы можете пропустить эти инструкции и перейти к разделу "Как добавить канал WhatsApp в Creatio с использованием обновленной учетной записи Twilio".

📘 Инструкции:

Как создать тестовую учетную запись Twilio

  1. Перейдите на https://www.twilio.com/try-twilio , заполнив

  2. Заполните все обязательные поля

...

После успешной верификации откроется страница, на которой в окне “Choose what you prefer” Следует выбрать третий вариант “I just need my Account SID and Auth Token”

...

2. Переходим к настройке. Для начала на главной странице (My first Twilio account) во вкладке “Develop” нужно скопировать и сохранить себе данные из полей Account SID и Auth Token. Это потребуется для подключения канала в Creatio.

...

3. Далее, на вкладке “Develop” следует нажать “Explore Products” и закрепить раздел “Messaging”

...

4. Переходим к настройке тестового канала WhatsApp в Creatio.

  • Перейдите в дизайнер системы.

  • Откройте раздел [ Настройка чатов ].

  • В области [ Каналы ] нажмите “+”. В появившемся меню выберите “WhatsApp”.

  • В открывшейся мини-карточке заполните параметры канала:

...

[ Название канала ] — на ваше усмотрение.

[ Номер телефона ] — номер вашей тестовой учетной записи в Twilio. Его можно взять из Messaging — > Settings — > WhatsApp Sandbox Settings.

Номер телефона в поле вносить без префикса “whatsapp:“ и знака “+“ !

...

[ Twilio AccountSid ] — SID тестовой учетной записи Twilio, который указан в поле [ ACCOUNT SID ] Twilio Console, из пункта 2.

[ Twilio AuthToken] — токен, сгенерированный Twilio для тестовой учетной записи. Указан в поле [ AUTH TOKEN ] Twilio Console, из пункта 2.

[ Вес ] - укажите вес будущего канала, например 1.

Из поля [ Webhook ] скопируйте сгенерированный адрес (он понадобится для добавления в Twilio на следующем шаге).

Из поля [ Status Webhook ] скопируйте сгенерированный адрес (он понадобится для добавления в Twilio на следующем шаге).

5. Настройте “песочницу” (“sandbox”) в Twilio:

Вкладка “Develop” —> Messaging —> Try it out —> Send a WhatsApp message —> Sandox settings

В поле “When a message comes in” вставить Webhook, скопированный из Creatio, Method - POST;
В поле “Status callback URL” вставить Status Webhook, скопированный из Creatio, Method - POST;
Нажать на кнопку “Save”.

...

Отправьте кодовое слово, сформированное Twilio, через WhatsApp с вашего номера на номер вашей тестовой учетной записи. Если сообщение будет доставлено успешно, вы получите уведомление в Twilio. В результате ваш номер будет добавлен в Sandbox Participants.

...

6. Вернитесь к настройке канала в Creatio, нажмите кнопку “Добавить”, к созданному каналу привяжите оператора.

    ...

    1. Подтвердите свой адрес электронной почты и номер телефона

    ...

    1. Заполните поля, как показано на скриншоте:

    ...

    1. Нажмите Get started with Twilio

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

    Как добавить канал WhatsApp в Creatio с использованием тестовой учетной записи Twilio

    1. Войдите в Creatio под пользователем с лицензией Beesender Chat Master.

    2. Перейдите в дизайнер системы и откройте раздел Конфигурация чатов Beesender.

    3. На вкладке Каналы нажмите "+" и выберите WhatsApp.

    ...

    1. Введите имя для канала (например, WhatsApp) в поле Имя канала.

    2. Скопируйте Webhook из поля Webhook.

    3. Перейдите в свою учетную запись Twilio и войдите в систему.

    4. На левой панели страницы Twilio нажмите на Messaging, затем выберите Try it out и нажмите на Send a WhatsApp message.

    5. На вкладке Sandbox settings вставьте Webhook из Creatio в поле When a message comes in.

    6. Нажмите Save.

    7. Скопируйте Status Webhook в последнем поле.

    8. Вставьте Status Webhook из Creatio в поле Status callback URL.

    9. Нажмите Save.

    10. Скопируйте значение My Twilio phone number со страницы Twilio и вставьте его в поле Номер телефона в Creatio в формате: "14155238886".

    ...

    1. Нажмите на My first Twilio account. На вкладке Account Info вы увидите два поля:

    • Account SID

    • Auth Token

    ...

    1. Скопируйте значение Account SID с этой страницы и вставьте его в поле Twilio AccountSid в Creatio.

    2. Скопируйте значение Auth Token со страницы Twilio и вставьте его в поле Twilio AuthToken в Creatio.

    3. Введите вес чата.

    4. Нажмите Добавить.

    Скопируйте код, сгенерированный Twilio через WhatsApp, с вашего номера на номер вашей тестовой учетной записи. Если сообщение будет доставлено успешно, вы получите уведомление в Twilio. В результате ваш номер будет добавлен в Sandbox Participants.

    Tip

    Вот и все! Вы успешно добавили канал WhatsApp в Creatio с использованием тестовой учетной записи Twilio.

    Как добавить канал WhatsApp в Creatio с использованием обновленной учетной записи Twilio

    Настройка обновленной учетной записи Twilio аналогична настройке тестовой учетной записи, с некоторыми небольшими отличиями.

    Следуйте простым шагам, и вы будете готовы к работе в кратчайшие сроки! Кроме того, мы выделили отличия, на которые вам нужно обратить внимание, чтобы легко пройти процесс настройки.

    1. Войдите в Creatio под пользователем с лицензией Beesender Chat Master.

    2. Перейдите в дизайнер системы и откройте раздел Конфигурация чатов Beesender.

    3. На вкладке Каналы нажмите "+" и выберите WhatsApp.

    ...

    1. Введите имя для канала (например, WhatsApp) в поле Название канала.

    2. Скопируйте Webhook в последнем поле.

    3. Перейдите в свою учетную запись Twilio и войдите в систему.

    4. На левой панели страницы Twilio нажмите на Messaging, затем выберите Senders и нажмите на WhatsApp Senders.

    ...

    1. В разделе WhatsApp Senders найдите таблицу с вашим номером WhatsApp, скопируйте значение номера телефона со страницы Twilio и вставьте его в поле Номер телефона в Creatio в формате: "3700000000".

    2. Нажмите на ваш номер WhatsApp.

    3. В окне конфигурации конечной точки вставьте Webhook из Creatio в поле Webhook URL for incoming messages.

    4. Прокрутите вниз и нажмите Update WhatsApp Sender.

    ...

    1. Нажмите на My first Twilio account. На вкладке "Account Info" вы увидите поля:

    • Account SID

    • Auth Token

    ...

    1. Скопируйте значение Account SID с этой страницы и вставьте его в поле Twilio AccountSid в Creatio.

    2. Скопируйте значение Auth Token со страницы Twilio и вставьте его в поле Twilio AuthToken в Creatio.

    3. Введите вес чата.

    4. Нажмите Добавить.

    Tip

    Вот и все! Вы успешно добавили канал WhatsApp в Creatio с использованием обновленной учетной записи Twilio.

    Как зарегистрировать HSM-сообщения для WhatsApp в Twilio

    Чтобы зарегистрировать HSM-сообщения (Highly Structured Messages) для WhatsApp в Twilio, следуйте этим шагам:

    1. Войдите в свою учетную запись Twilio и перейдите на страницу Senders.

    2. Перейдите на страницу Content Template Builder.

    3. Нажмите Create new.

    4. Заполните следующие поля:

    • Template name (Имя шаблона)

    • Message language (Язык сообщения) – выберите язык из списка

    • Select Content Type (Выберите тип контента) - Текст

    ...

    1. Нажмите "Create"

    2. Заполните поле "Body"

    Info

    Если вы хотите включить параметры в шаблон, просто напишите их в поле "Body" (Шаг 6) в формате {{1}}, {{2}} и так далее. Например, вы можете написать: "Привет, {{1}}. Позвони мне, пожалуйста, по этому номеру {{2}}". Позже агент сможет заменить {{1}} и {{2}} на свои собственные значения.

    1. Нажмите "Save and submit for WhatsApp approval" (Сохранить и отправить на утверждение в WhatsApp).

    ...

    1. В окне "Submit for WhatsApp review" (Отправить на проверку в WhatsApp) выберите "Marketing" .

    2. Нажмите "Submit".

    ...

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

    Info

    После того как вы зарегистрировали шаблон в Twilio, необходимо перейти в Creatio и добавить шаблоны туда.

    Как зарегистрировать HSM-сообщения для WhatsApp в Creatio

    1. Перейдите в Studio рабочего места и откройте раздел "Lookups" или перейдите в раздел "Lookups" из шестеренки дизайнера системы ⚙️

    2. Нажмите "Add lookup" и выберите "Template Whatsapp". Установите имя справочника, например, "WhatsApp templates"

    Info

    Примечание. Пропустите шаги 1-2, если справочник уже был добавлен ранее.

    1. Откройте содержимое добавленного справочника и нажмите "Add".

    2. Укажите имя шаблона, например, Greeting

    3. В поле "Description" предоставьте точное текстовое сообщение, соответствующее шаблону, зарегистрированному в Twilio. Этот текст автоматически заполнит поле ввода "Text" (Текст), когда этот конкретный шаблон будет выбран из панели коммуникаций. В конце текста обязательно добавьте [#HSM#]SID. Замените SID на значение Content Template SID из карточки вашего утвержденного шаблона.

    ...

    1. В поле "SID" также введите ваш Content Template SID из шаблона.

    В результате на стороне Creatio ваш шаблон будет выглядеть примерно так:

    ...

    Info

    После отправки шаблона клиент не увидит [#HSM#]SID.

    Tip

    Шаблон ответа добавлен. После обновления страницы шаблон будет доступен для выбора в панели коммуникаций агента после обновления страницы.

    ...

    Как добавить интерактивное сообщение WhatsApp

    Чтобы создать интерактивное меню сообщения для WhatsApp в Twilio, следуйте этим шагам:

    Создание сервиса обмена сообщениями

    1. Войдите в свою учетную запись Twilio и перейдите на страницу Services

    2. Перейдите на страницу "Messaging Services".

    3. Нажмите "Create Messaging Service".

    4. Заполните следующие поля:

    • Messaging Service friendly name (Имя сервиса обмена сообщениями)

    • Select what you want to use Messaging for (Выберите, для чего вы хотите использовать обмен сообщениями)

    ...

    1. Нажмите "Create Messaging Service" (Создать сервис обмена сообщениями):

    a) Нажмите "Add Senders" (Добавить отправителей), и в окне "Add Senders" заполните поле "Sender Type" (Тип отправителя) значением "WhatsApp Number"

    b) Нажмите "Continue"

    ...

    c) Активируйте флажок рядом с требуемым номером

    d) Нажмите "Add WhatsApp Number"

    ...

    1. Нажмите "Step 3: Set up integration" (Шаг 3: Настройка интеграции):

    a) Активируйте флажок "Send a webhook" в разделе "Integration"

    b) Заполните поле "Request URL" значением из карточки добавления канала WhatsApp в CRM (из поля Webhook).

    c) Заполните поле "Callback URL" значением из карточки добавления канала WhatsApp в CRM (из поля Status Webhook).

    ...

    1. Нажмите "Step 4: Add compliance info"

    2. Нажмите "Complete Messaging Service Setup" (Завершить настройку сервиса обмена сообщениями).

    3. Добавьте канал в CRM (прочитайте: 'Как добавить канал WhatsApp в Creatio с использованием обновленной учетной записи Twilio').

    Интерактивное сообщение

    Чтобы гарантировать, что кнопки в вашем чат-боте отображаются как интерактивное меню, вам нужно сделать следующее:

    1. В элементе "Beesender: Ask a question" (Beesender: Задать вопрос) бизнес-процесса чат-бота заполните поле "Message" (Сообщение) следующим образом: [*MENU*]What would you like to do today?[Main menu]. Текст "Что бы вы хотели сделать сегодня" и "Главное меню" можно заменить на любой текст по вашему выбору.

    2. Заполните поля "Button"

    ...

    В результате интерактивное меню в вашем канале будет выглядеть следующим образом:

    Image AddedImage Added
    Info

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

    2. Она не поддерживается в настольной версии WhatsApp.

    3. Если текст кнопки меню не указан (в квадратных скобках), текст по умолчанию будет "Select Menu option".

    4. Может быть всего от 1 до 10 пунктов меню. Максимальная длина текста пункта меню составляет 24 символа; если она превышает этот лимит, произойдет ошибка доставки.

    5. Максимальная длина текста кнопки меню составляет 20 символов.

    Устранение неполадок

    Сообщения агентов не доходят до WhatsApp в Beesender

    Если сообщения агентов не доходят до WhatsApp, а вы получаете сообщения от клиентов после подключения канала, скорее всего, был указан неверный номер телефона при добавлении канала WhatsApp.

    Чтобы решить эту проблему, перейдите в "Конфигурацию чатов Beesender", удалите канал WhatsApp и добавьте его снова.

    Убедитесь, что номер телефона указан в формате {номер}.

    Также убедитесь, что whatsapp написано правильно и что в номере телефона есть двоеточие, знак плюса и нет пробелов.

    Если вы добавили канал с использованием "Messaging Services", но сообщения не поступают в систему, попробуйте перейти в настройки вашего сервиса, перейти на вкладку "Sender Pool" и удалить и снова добавить ваш номер WhatsApp.

    ...