Как узнать api whatsapp

Как сделать API на любое Android приложение. На примере WhatsApp

Анализ ситуации.

Казалось, требуется всего лишь отправлять и принимать сообщения. А столько подводных камней…

1. Официальный API

Официального API в релизе тогда ещё не было. Но Facebook успел прислать ссылку на форму, для подключения официального API, находящегося в тестировании.

2. Сторонний сервис. Подключение через WhatsApp WEB

Рассматривал вариант «серого» способа, использование неофициального сервиса, который отправляет сообщения через WEB интерфейс, подключается сканированием QR кода.

Но это зависимость от чужого API, в любой момент может всё отвалиться, да и передавать чужому сервису номера клиентов не хотелось. А ещё писать под чужой авторский API, да ещё который придётся переписывать, при переезде на другой сервис, тоже такое себе удовольствие.

Ну и ещё требуется держать телефон включенным (хотя некоторые сервисы за доп плату решали эту проблему 🙂

3. Ручной режим

Посадить человека, пускай копипастит сообщения клиентам. Шутки шутками, а из этой идеи родилось решение!

Решение

Отправка сообщения

Есть такая программка для автоматизации действий под Android, называется Tasker, одна из первых подобных программ. Но я в ней не разобрался с первого раза… Поискал аналоги, наткнулся на программу Automagic. В ней события, действия и ветвления рисуются как блок схема.

И вот в ней я то и придумал решение, root права нам не нужны. Получилось методом научного тыка нарисовать скрипт отправки сообщения, далее буду называть поток, так именуется каждый отдельный нарисованный алгоритм в данной программе. А теперь разберём его работу:

Приём сообщений

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

Плюсы, минусы, доработка и планы

Основную функцию отправки сообщения алгоритм выполняет отлично. Так как не используется WEB интерфейс, схватить баню от мессенджера тут меньше рисков, как мне кажется. Арендовал слабенький виртуальный сервер, установил туда Android и перенёс всё.

На отправку одного сообщения новому контакту уходит

5 сек. Для проверки доставки и прочтения сообщения, разработал отдельный поток, но он в черновом варианте и иногда не срабатывает. Поэтому о нём позже.

В данный момент не реализована функция приёма медиа сообщений (фото, аудио, вложения), но это можно выгружать из WhatsApp, используя кнопку поделиться сообщением в будущем.

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

Ещё хочу делать скриншоты аватарок и отправлять их на сервер, для прикрепления миниатюры к контакту в CRM системе.

Ну и вообще самое интересное: Данный способ обёртывания в API подойдёт почти для любого приложения под Android 🙂

Всё изначально разрабатывал и запускал на Android 9, xiaomi mi 9 se, root прав нет.

UPD:
Пример на Python3.8 в качестве бекенда доступен на GitHub, доработан алгоритм ловли уведомлений и код отправки из комментариев от ivan909020

Источник

Есть ли API у WhatsApp?

Всё что вам нужно знать об этом на сегодняшний день

В последние несколько лет было очевидно, что многие разработчики активно ищут API WhatsApp. API необходим многим: и тем кто занимается созданием чатботов и компаниям, которые хотят сделать интеграцию ERP/CRM, да и просто автоматизировать бизнес-процессы с помощью самого популярного мессенджера. К сожалению, у WhatsApp нет официального API для разработчиков, потому что они хотят сохранить платформу от хаоса, который может появится от большого количества спама. Компания представила WhatsApp Business API, а также корпоративную версию для крупных компаний с возможностью отправки сообщений, связанных с транзакциями (например авиабилеты, заказы и подтверждения и т. д.). Получить доступ к этому business api обычному человеку очень сложно. И нужно отметить, что возможности системы очень ограничены и совсем не в пользу «бизнеса».

Есть множество репозиториев Github с библиотеками по всему Интернету, но ни один из них не предоставляет каких-либо стабильных и долгосрочных решений. Более того, большинство репозиториев не обновлялось очень долгое время, а значит эти библиотеки уже не актуальны.

Наша команда разработчиков попробовали найти решение этой проблемы. Главное условие было добиться стабильности и удобства для обычных программистов. После продолжительной работы (которая не оканчивается до сих пор!) мы добились кое каких результатов. Наш API работает с 2015 года, на основе протокола WhatsApp WEB и исключает бан как при использовании библиотек от mgp25 и подобных. При этом мы постоянно обновляем наши системы, адаптируем API под изменения. Используя этот API, вы можете создавать чатботов всего за пару часов или сделать любую интеграцию на PHP, JavaScript, 1С, Python, Java, C# или даже VBA.

Обратите внимание, что наше API независимое и неофициальное и у нас нет никакой официальной связи с Whatsapp / Facebook. Мы пытаемся решить болезненную проблему для разработчиков с полного согласия пользователей WhatsApp, которые заинтересованы в использовании их WhatsApp в качестве роботов. Мы не одобряем спам. Мы не советуем делать массовые рассылки. Ваш аккаунт может быть забанен анти-спам системой, если несколько пользователей пожалуются на вас или у вас будет большое число неотвеченных исходящих сообщений. Отправляйте только сообщения, которые ожидают получатели!

Не стесняйтесь обратиться и поделиться своим опытом или задать любые вопросы.

Источник

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

Как известно, WhatsApp не так давно начал предоставлять доступ к своему официальному бизнес API, который так необходим для создания чат-ботов для этого мессенджера «белыми» методами.

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

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

Я подключил через Twilio официальный бизнес API WhatsApp и сейчас подробно расскажу, как это сделать.

Основным условием Facebook является наличие зарегистрированного юридического лица, например ООО или ИП, на физическое лицо доступ получить не получится.

Итак, начнем двигаться по шагам.

1. Создание аккаунта в Facebook Business Manager

Войдем в свой личный аккаунт в Facebook и создадим аккаунт Business Manager, для чего перейдем по ссылке business.facebook.com/overview и нажмем кнопку «СОЗДАТЬ АККАУНТ», откроется окно для ввода данных компании.

Согласно подсказкам над полями, вводим название компании, имя и фамилию, e-mail и нажимаем кнопку «Отправить».

В следующем окне введем информацию о компании и нажмем кнопку «Отправить».

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

Зайдем в почту и нажмем на кнопку «Подтвердить» из письма.

2. Регистрация аккаунта в Twilio

Зарегистрируем аккаунт в Twilio по ссылке twilio.com/try-twilio. Сделать это совсем не сложно, регистрация бесплатная и не требует данных банковской карты, нужно только ввести имя, фамилию, e-mail и придумать пароль.

Подтверждаем номер телефона.

3. Запрос в Twilio на активацию возможности добавления WhatsApp отправителей

Подготовим и отправим запрос в Twilio на активацию возможности добавления WhatsApp отправителей, для чего перейдем в раздел «WhatsApp Senders» по ссылке www.twilio.com/console/sms/whatsapp/senders и нажмем кнопку «Sign Up to Receive Updates».

Откроется форма запроса на активацию возможности добавления 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;

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 сообщение.

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

Нажмем кнопку «Validate Address» для подтверждения адреса. В открывшемся окне нажмем кнопку «Use This Address».

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

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

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

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

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

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

Для покупки телефонного номера Twilio перейдем по ссылке 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Источник

Прямая активная ссылка на Ватсап (WhatsApp) — всё, что нужно знать

Всем привет, сегодня учимся делать полезную и бесплатную «фичу» для Вотсапа, так называемую «кнопку связи в один клик» с уводом в мессенджер.
Работает моментально с переадресацией пользователя в чат с вашим номером по клику на неё.

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

Кстати, можно не использовать прямой линк сразу, а сначала провести пользователя по «мини-лэндингу таплинку». Подобрал 50 примеров реализации этой технологии в соседней статье

Юзер кликает, переадресуется и сразу может начать предметный диалог.

Наиболее часто я вижу, как схема применяется для быстрой связи через Instagram
и для точек входа в чат-боты, Вотсап-лэндинги.

Как сделать ссылку на WhatsApp в Инстаграм

Связка работает только для мобильного трафика, что идеально в Instagram.

Используйте простую конструкцию:
https://api.whatsapp.com/send?phone=.

Вместо вопросов вставьте ваш номер телефона в международном стандарте, начиная с 7 для России, 380 для Украины (без плюсов).

Правильные варианты:
https://api.whatsapp.com/send?phone=7**********
api.whatsapp.com/send?phone=7**********

Все остальные вариации работать не будут.

Чуть не забыл, будет действовать только с теми у кого уже установлен Вацап (благо таких сейчас солидное большинство).

Инструкция по размещению в профиле Инстаграм

Активная вотсап ссылка с сообщением

При переходе по этой разновидности, покажет в окне диалога автозаполненное сообщение, которое можно сразу отправить.

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

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

Простой пример.

Кликаем и в окне диалога видим

Подсказка: если привязываете нечто чат-ботное или автовороночное к глобальной кодовой фразе, позаботьтесь о том, чтобы люди высылали именно её.

Как сделать

Знакомую нам конструкцию с номером телефона, дополняем меткой &text= и после каждого слова вписываем %20

https://api.whatsapp.com/send?phone=7**********&text=Хочу%20получить%20скидку%20

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

Есть сложность.
Мне не до конца понятен механизм, что прописывать, когда надо написать два предложения или добавить EMOJI.

Поэтому, при потребности я использую конструктор для быстрых ссылок — whatsapp-link-constructor (переход на сторонний сайт)
Он бесплатный.

Буду рад вашим мыслям и решениям на эту тему в конце материала.

Факты

Для услуг и некрупных проектов — решение находка.

Источник

Документация

REST API позволяет принимать и отправлять сообщения через аккаунт WhatsApp. Зарегистрировать аккаунт WhatsApp API

Параметры в GET запросах передавайте через query string. Параметры в POST запросах — через JSON-encoded тело запроса. Токен авторизации всегда передается в query string (?token=xxxxxx).

К каждому запросу необходимо прибавить токен в GET параметре token.

API WhatsApp работает на основе протокола WhatsApp WEB и исключает бан как при использовании библиотек от mgp25 и подобных. Несмотря на это, Ваш аккаунт может быть забанен анти-спам системой WhatsApp после нескольких нажатий кнопки «в спам».

GET /status

Получить статус аккаунта и QR код для авторизации. Повторная авторизация нужна только в случае смены устройства или ручного нажатия «Выйти из всех устройств» на телефоне. Держите приложение WhastsApp открытым во время авторизации.

Пример ответа:

GET /qr_code

Прямая ссылка на QR-код в виде изображения, а не base64.

POST /group

Создание группы и отправка сообщения в созданную группу. Если хост iPhone, то наличие всех в списке контактов обязательно.

Группа будет добавлена в очередь на отправку и рано или поздно создана, даже если телефон отключен от интернета или авторизация не пройдена.

Обновление от 2 октября 2018: параметр chatId будет заполнен, если удалось создать группу на вашем телефоне в течении 20 секунд.

Параметры:

Пример запроса:

POST /sendMessage

Отправка сообщения в новый или существующий чат. Сообщение будет добавлено в очередь на отправку и доставлено даже если телефон отключен от интернета или авторизация не пройдена.

Параметры:

Примеры запросов:

Пример ответа:

POST /sendFile

Отправка файла в новый или существующий чат. Сообщение будет добавлено в очередь на отправку и доставлено даже если телефон отключен от интернета или авторизация не пройдена.

Параметры:

Примеры запроса:

Пример ответа:

GET /messages

Получить список сообщений. Для получения только новых сообщений передайте параметр lastMessageNumber из последнего запроса.

Файлы из сообщений гарантированно хранятся лишь 10 дней и могут быть удалены. Скачивайте файлы сразу при получении на свой сервер.

Параметры:

Пример ответа:

POST /webhook

Устанавливает URL для получения webhook уведомлений о новых сообщениях и о статусах доставки исходящих сообщений (ack).

Параметры:

Пример ответа:

Пример webhook уведомления:

GET /webhook

Возвращает текущий webhook url.

Пример ответа:

POST /settings/ackNotificationsOn

Включить или выключить получение уведомлений о доставке и прочтении отправленных сообщений ack в webhook. Так же работает GET метод по тому же адресу.

Параметры:

Пример ответа:

GET /logout

Выйти из аккаунта и запросить новый QR-код.

Пример ответа:

GET /reboot

Перезагрузить Ваш инстанс WhatsApp.

Пример ответа:

GET /showMessagesQueue

Показать список сообщений, которые стоят в очереди на отправку, но еще не отправлены.

Пример ответа:

GET /clearMessagesQueue

Очистить очередь на отправку сообщений. Этот метод нужен когда вы случайно отправили тысячи сообщений подряд.

Источник