Whatsapp интеграция с asterisk

Обновлено: 19.09.2024

Так или иначе все мы работаем с Вотсаппом. Что касается корпоративного сегмента, то в компаниях часто используют личные номера или покупают Вотсапп-бизнес API.

Отношения и коммуникации важны в любом бизнесе. Клиентам удобно, когда менеджер пишет им напрямую в мессенджер. Нужно сделать так, чтобы менеджер мог удобно и быстро написать новому контакту в Вотсаппе. К тому же, отделы продаж часто пытаются следить за тем, что менеджеры пишут клиенту в мессенджерах. И в случае с Вотсаппом сделать это сложно. Посмотрим, какие есть варианты на примере.

Обычно, чтобы написать новому контакту в Вотсапп нужно:

  1. Добавить новый контакт на телефон
  2. Подождать, пока Вотсапп обновит телефонную книгу
  3. Перезагрузить Вотсапп Веб, чтобы увидеть новый контакт в списке
Дефолтный метод добавления нового контакта в Вотсаппе

Получается, что каждый раз, когда менеджер захочет написать клиенту, ему нужно открывать Вотсапп на телефоне или ПК и искать его в переписке. И отдельно от этого менять его данные в CRM

Это все долго и неудобно. Хочется, чтобы диалог с клиентом сразу был внутри CRM-системы. В таком случае нужен Business API.

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

Для тех, кому официальный WhatsApp Business API не по карману, на рынке есть решения работающие через эмуляцию приложения WhatsApp на обычных личных и бизнес-аккаунтах. Это сервисы:

  • Chat2Desk
  • Pact
  • Wazzap и тд.

Подключение WhatsApp у них стоит в среднем 2-3 тысячи рублей в месяц за один номер.

Плюсы — экономия. Минусы — высокие риски блокировки, потому что с точки зрения Facebook создание бизнес-решений через эмуляцию запрещено. И все такие решения формально «вне закона».

У Вотсаппа есть возможность создавать ссылку на любой контакт. Можно сделать скрипт, который автоматически создает такую ссылку под любой номер в вашей CRM.

Мы сделали свой виджет, который помогает написать новому контакту по нажатию одной кнопки. Работает это так:

Берем любой номер телефона из карточки контакта → корректируем маску номера → проверяем, есть ли Вотсапп на этом номере → создаем ссылку на номер.

При этом, можно даже не записывать этот контакт в адресную книгу, а при каждой новой переписке просто переходить по ссылке. И даже не нужно переключаться на мобилку — все на десктопе.

Ничего нового и волшебного, просто логичный и удобный функционал

Мы собрали архив с нашим виджетом, его можно скачать и установить. Инструкция по установке есть на нашем сайте. Он бесплатный, так как:

  • Он уже был разработан на клиентском проекте и работу программистов уже оплатили
  • На рынке уже есть аналогичные виджеты, и «нечего выпендриваться»

Пишите в комментариях, как вы решаете вопрос коммуникации с клиентами в мессенджерах. Если попробуете виджет, то пишите, стали ли ваши менеджеры довольнее после такой фичи или нет.

Жду когда все дружно поймут какое Г… этот ватсап и выключат его. В последнее время тенденция явно ускоряется, но ждать еще долго (

Плюсую, но вот когда ты продаешь без этого прям сложно)

проверяем, есть ли Вотсапп на этом номере → создаем ссылку на номер.

Аркадий, но вы ведь не проверяете, есть ли WA на номере, а сразу создаете ссылку.

Что касается проверки, верно подмечено, допущена оговорка в тексте)
А по поводу данных, смотрите, все предельно просто:
- При обращении в поддержку нам требуется идентифицировать пользователя;
- А информация о тарифе полезна для своевременного уведомления о его окончании =)

Спасибо за статью, как раз искали вариант подключения

Сколько раз в вашей практике было, чтобы у клиента блокировали номер в вотсапе из-за того что он пользовался чат2деском или вотсапом?
P. S. Если он, конечно, массовых рассылок бесплатно сделать через них не пытался

Если мы говорим о масштабах 2-3 пользователя, то почти не было. Однако в проектах где 20+ сотрудников занимаются активными продажами, это происходит регулярно🤷🏽‍♂️

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

Chat2Desk
Pact
Wazzap

Есть - 4 магазина женской одежды, рынок только локальный (3 города).
Нужно:

база клиентов ведется в 1с УНФ, т.е. по сути автоматическую интеграцию я не жду, просто выгружать все необходимые данные будет в экселе.

Все описанные действия в статье необходимо выполнять от имени суперпользователя (root). Установка и настройка производилась на предустановленной системе CentOS 6.8 + Asterisk 13 + FreePBX 13.

WARNING библиотека Yowsup 2 стабильно работает с Python 2.7 и Python 3.

Инструкция:

1. Выполним подключение по SSH к серверу IP АТС Asterisk для выполнения дальнейшей настройки. В зависимости от используемой системы(Windows, Linux, MacOS), подключение по SSH можно выполнить с использованием различного дополнительного программного обеспечения(Putty), либо системного терминала.


Подключение по SSH через Putty


Авторизация на сервере Внимание, при авторизации на сервере, пароль в консоли не отображается.


SSH консоль подключения

2. Выполним проверку активности Selinux, в случае если активен, то выполним отключение:


Отключение Selinux

3. В консоли управления для подключения репозиториев выполним ряд команд вида:


Подключение репозиториев

4. Выполним установку ряда пакетов необходимых для работы с библиотекой Yowsup. Для этого в консоли выполним ряд команд вида:


Установка пакетов Python Обновление системы управления пакетами pip


Установка компилятора GCC(GNU Compiler Collection)


Установка Python-axolotl Установка Python-six версии 1.10

6. После успешной установки всего необходимого ряда зависимостей, перейдем к установке непосредственно библиотеки Yowsup для работы с WhatsApp, для этого выполним в консоли ряд команд вида:


Скачивание библиотеки Yowsup из репозитория

Для корректной работы библиотеки необходимо получить текущую версию официального WhastApp клиента и ClassesDex


Уточнение актуальной версии клиента WhatsApp и получение значения ClassesDex

На момент написание данной статьи официальная версия клиента 2.18.379, а ClassesDex имел значение JfoS1T2x3koJVaLtqWRpAA== . Данные параметры необходимы для редактирования следующих файлов:

Для сохранения внесенных изменений в редакторе Nano используем сочетаний клавиш Ctrl+O (сохранить изменения) и Ctrl+X(выйти из редактора

где ключевыми параметрами для изменения являются:
_MD5_CLASSES — полученное ранее значение ClassesDex
_VERSION — текущая актуальная версия клиента WhatsApp


Редактирование env_android.py Для сохранения внесенных изменений в редакторе Nano используем сочетаний клавиш Ctrl+O (сохранить изменения) и Ctrl+X(выйти из редактора

где ключевыми параметрами для изменения являются:
DEFAULT – клиентская платформа которая будет использоваться по умолчанию(android или s40)


Редактирование env.py

7. Выполнив редактирование всех необходимых конфигурационных файлов приступим к сборке и установке библиотеки Yowsup


Сборка библиотеки Yowsup


Установка библиотеки Yowsup Успешное завершение установки

Выполним подтверждение регистрации клиентского приложения:

где ключевыми параметрами для изменения являются:
register – код подтверждения регистрации полученный по SMS
phone – номер телефона на который регистрируется клиентское приложение
cc – код страны(Россия — 7)

Использование одного и того же номера телефона используемого для регистрации, на нескольких устройствах невозможна.


Подтверждение регистрации клиентского приложения WhatsApp

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


Первичная авторизация и генерация ключа доступа Из CLI консоли «Yowsup Cli client» можно выйти сочетанием клавишь «Ctrl+Z» Для сохранения внесенных изменений в редакторе Nano используем сочетаний клавиш Ctrl+O (сохранить изменения) и Ctrl+X(выйти из редактора

И добавим в самый конец файла две строки вида:


Разрешение выполнения yowsup-cli от имени asterisk с правами root Для сохранения внесенных изменений в редакторе Nano используем сочетаний клавиш Ctrl+O (сохранить изменения) и Ctrl+X(выйти из редактора

И добавим контекст вида:

Редактирование диалплана Asterisk для информирования о пропущенных вызовах в очереди на WhatsApp

Траблшутинг:


Ошибка «old_version»

Данная ошибка сообщает о не корректно прописанных двух параметрах «_MD5_CLASSES» и «_VERSION» в файле «yowsup/env/env_android.py». Для решения данной проблемы еще раз стоит убедится в корректно прописанных параметрах, получение которых описано в п.6 данной статьи посредством скрипта dexMD5.py.


Ошибка «Disconnected: Connection Closed»

Данная ошибка сообщает о невозможности выполнения действий от имени платформы Android, для решения данной проблемы необходимо убедиться в наличии использования ключа «-E s40» в команде первичного входа:

Вы можете посмотреть вебинар по подключению бота к WhatsApp:

Как подключить чат-бота к WhatsApp?

Чтобы подключить бота Aimylogic к каналу WhatsApp Business API, вам необходим официальный WhatsApp-аккаунт вашей компании.

Если вы решите сэкономить и обойтись сторонними сервисами и неофициальным API, то, скорее всего, вы столкнетесь с трудностями: во-первых, WhatsApp может заблокировать такой "серый" номер, а во-вторых вы не сможете подключить бота Aimylogic.

Есть несколько способов подключить чат-бота к мессенджеру WhatsApp:

Подключение через i-Digital

Для получения официального API вы можете обратиться к нашим партнерам i-Digital. Они проконсультируют вас по процессу подключения и стоимости.

Чтобы связаться с i-Digital:

Если вы хотите использовать подключение к WhatsApp через i-Digital вместе с бизнес-системами для обработки обращений клиентов, например Jivo, обратитесь к менеджерам i-Digital для получения консультации по подключению к WhatsApp на стороне выбранной вами системе.

Что делать дальше?

Поздравляем! Теперь вы можете подключить чат-бота Aimylogic к аккаунту WhatsApp Business API. Для этого перейдите в настройки каналов вашего бота в Aimylogic. Нажмите на кнопку WhatsApp Business API, чтобы создать новый канал.

Задайте название канала во всплывающем окне и нажмите Подключить. При необходимости вы сможете изменить название канала позже.

whatsapp 1

Теперь в списке каналов текущего бота появится канал WhatsApp Business API. Нажмите на надпись Получить webhook под названием канала, чтобы скопировать вебхук в буфер обмена, и отправьте его менеджеру i-Digital, к которому вы обращались для получения официального API.

После того, как специалист i-Digital обработает ваш запрос, чат-бот заработает в вашем аккаунте WhatsApp Business API.

Отправка рассылок

WhatsApp Business API позволяет осуществлять маркетинговые рассылки, однако с рядом ограничений.

WhatsApp допускает только релевантные к интересам и предыдущим заказам клиента рассылки.

Кроме того, рассылки доступны не во всех странах.

Пример шаблона обычной кнопки

Текст каждой кнопки должен быть не более 20 символов.

Пример шаблона inline-кнопки со ссылкой

Название кнопки может быть не более 20 символов.

URL-адрес указывается полностью, вместе со статичной частью.

Пример шаблона inline-кнопки для звонка

Название кнопки может быть не более 20 символов.

Номер телефона указывается в международном формате.

Подключение через Vonage

Один из вариантов подключения бота Aimylogic к WhatsApp Business API — подключение через Vonage (ранее Nexmo).

После того как вы создали и протестировали сценарий своего бота, вы можете подключить его к WhatsApp Business API. Перейдите в настройки Каналов вашего бота и выберите WhatsApp Business API в разделе Мессенджеры, соцсети и API.

whatsapp 2

Во всплывающем окне выберите поставщика услуг Vonage. Для авторизации вам понадобятся Ключ API и API Secret. Вы можете найти их в вашем личном кабинете Vonage:

whatsapp 3

Как добавлять кнопки

В сценарии при общении с клиентами в WhatsApp можно добавлять два вида кнопок.

Inline-кнопки отображаются под репликами бота. Inline-кнопка может содержать в себе URL-адрес, на который клиент будет перенаправлен при нажатии кнопки, и/или номер телефона, на который клиенту будет предложено позвонить.

При использовании кнопок есть ряд ограничений:

Подключение через Jivo

Вы можете подключить WhatsApp к Jivo.

Чтобы получить информацию по интеграции WhatsApp с Jivo, обращайтесь в техподдержку Jivo.

Подключать WhatsApp в этом случае нужно только на стороне Jivo.

Подключение через Битрикс24

Вы можете подключить WhatsApp к Битрикс24. Для этой интеграции используется Twillio.

О том, как подключить WhatsApp к Открытым Линиям, есть отдельная инструкция на сайте Битрикс24.

Подключать WhatsApp в этом случае нужно только на стороне Битрикс24.

Официально и без бана! Пишите клиентам в WhatsApp из чата и мобильного приложения Битрикс24. Создавать лиды, информировать клиентов и управлять сделками — теперь это просто и с WhatsApp.

С приложением вы сможете:

Приложение работает на базе платформы TextBack.

Чтобы работать с приложением:

  1. Зарегистрируйтесь на TextBack.
  2. Подключите WhatsApp Business API аккаунт. Условия подключения. Срок подключения — от 5 дней.

Приложение использует официальное WhatsApp Business API. Перед использованием ознакомьтесь с политикой WhatsApp Business.

Приложение находится на этапе бета-тестирования и бесплатно для пользователей. Разработчик оставляет за собой право ввести плату за использование приложения после завершения этапа тестирования.

Версия 4
Были исправлены ошибки

Реализована возможность передавать теги для чатов из TextBack в Битрикс24. Когда пользователь назначает тег чата, он появляется в таймлайне связанного объекта чата в виде комментария. Теги также будут фиксироваться в пользовательском поле “Теги”, которое создаётся при установке приложения.

Версия 1
Официальный API. Без риска блокировок. От 5 дней на подключение номера!

Мы осуществляем поддержку модуля с помощью чата в Открытых линиях. Вы можете связаться с нами двумя способами:

1. В чате внутри вашего Битрикс24 (ссылка откроет чат в вашем Битрикс24).

Первый способ наиболее удобен: ответ и историю переписки вы всегда найдете в мессенджере вашего Битрикс24. Однако, чтобы ссылка работала в коробочной версии, у вас должны быть установлены и настроены необходимые модули, а портал должен иметь связь с внешним миром. Если по какой-то причине у вас первый способ не работает, воспользуйтесь вторым.

Обратите внимание: мы не оказываем техническую поддержку продукта по телефону и электронной почте.

Мы действительно неравнодушны к вашей обратной связи и делаем всё, чтобы ни один вопрос не потерялся. Напишите нам :)

1. Установите приложение в Битрикс24.

2. Заведите аккаунт в TextBack и подключите номер WhatsApp.

3. Зайдите в Контакт-центр Битрикс24 и откройте WhatsApp от TextBack. Выберите или создайте Открытую линию. Нажмите Подключить.

4. В открывшемся окне введите API токен TextBack, который можно получить в разделе Интеграция -> Интеграция по API личного кабинета TextBack. Сохраните настройки.

Читайте также: