Chat api что это
Сравнительный анализ Chat API и WhatsApp Business API. Преимущества и недостатки
2021 год медленно, но верно подходит к концу, и мы продолжаем нашу добрую традицию подводить итоги года, разбирать основные нововведения от Facebook и изменения в работе WhatsApp API.
Если Вам интересна краткая выдержка основных отличий WhatsApp Business API и Chat API, то ее Вы сможете найти в таблице в конце статьи. Остальная часть материала посвящена детальному разбору отличий WhatsApp Business API, Chat API и иными доступными WhatsApp API, а также оценке рисков и возможных сложностей при выборе подходящего инструмента для бизнеса.
Немного истории
Изначально WhatsApp, в отличии от других мессенджеров, держал свой API закрытым. То есть у разработчиков не было возможности связать свои программные решения с мессенджером. Например, провести интеграцию WhatsApp с CRM\ERP системами или же автоматизировать общение с клиентами через чат бота. Facebook (компания купила WhatsApp в октябре 2014 года) объяснял это желанием уберечь пользователей от ненужного спама и рассылок, сделать инфопространство мессенджера более защищенным. Кстати, подобный лейтмотив политики Facebook сохранился и до сих пор, многие решения компания обосновывают данными принципами.
Тем не менее, отсутствие открытого доступа к API не останавливало энтузиастов разработчиков по поиску способов оптимизации работы с мессенджером. Создавались самописные шлюзы для интеграций с WhatsApp на основе, как правило, протоколов WhatsApp WEB. Некоторые решения были удачными, некоторые не очень.
Например на Github до сих пор можно найти библиотеки для интеграции с WhatsApp, которые быстро устаревают из-за обновлений мессенджера. Другие решения не забывали про обновления, но защищенность номера от возможного бана была их слабым местом. Часть работы Chat API также строится на работе протоколов WhatsApp WEB, при этом мы всегда особое внимание уделяли безопасности номера, стоит ли говорить, что мы также против спама и нежелательных рассылок.
В 2015 году WhatsApp становится самым популярным мессенджером на планете и на сегодняшний день приложение насчитывает более 2 миллиардов пользователей. Повлиять на ослабление позиции WhatsApp не смогла ни критика основателя Telegram, ни изменение политики конфиденциальности в мае 2021 года. Подозреваем, что WhatsApp уже набрал критическую массу пользователей, что не позволит ему так просто сойти с пьедестала первенства.
В 2017 году Facebook объявил ограниченный доступ к WhatsApp Business API, и только самые крупные мировые бренды имели возможность апробировать долгожданный gateway. Начиная с 2018 года все больше компаний получают возможность подключиться к WhatsApp Business API, и на сегодняшний день сохраняется тенденция упрощения процедуры доступа к WhatsApp Business API, несмотря на специфические особенности работы с решением от Facebook, которые мы разбираем в таблице ниже.
Что насчет нашего решения, то мы разработали Chat API в 2015 году, занимаясь интеграцией WhatsApp с CRM. С тех пор мы прошли долгий путь, завоевывая доверие и расширяя функционал сервиса. На данный момент Chat API объединяет более 10 000 компаний и программистов со всего мира, обрабатывая более миллиарда пользовательских запросов в месяц. В 2020 году Chat API стал партнером провайдера WhatsApp и интегратором WhatsApp Business API.
Что интересного произошло в 2021 году и что ждать от 2022?
Как проходит подключение WhatsApp Business API сегодня?
Facebook предоставляет доступ к WhatsApp Business API через своих партнеров или BSP (Business Solution Provider). Ознакомиться со списком действующих BSP можно вот здесь.
В чем отличие WhatsApp API от WhatsApp Business API?
WhatsApp API, в том числе и Chat API, были разработаны в тот период, когда WhatsApp Business API был недоступен для бизнеса и программистов. WhatsApp API, как правило, основан на протоколах WhatsApp WEB и позволяет автоматизировать и оптимизировать общение с пользователями в WhatsApp. Для работы с WhatsApp API достаточно отсканировать QR код и Вы уже можете приступить к отправке сообщений.
Chat API изначально позиционировал себя как безопасный инструмент для расширения возможностей разработчиков и бизнеса для работы с пользователями в WhatsApp. Мы против спама и некорректных маркетинговых рассылок.
Понятно. Значит, использовать официальный API будет правильней?
С ответом на этот вопрос не стоит торопиться, как и почти во всем. В первую очередь нужно решить, а для чего вам необходим API. У обоих вариантов есть свои преимущества и недостатки.
WhatsApp Business API в первую очередь подкупает своим статусом и безопасностью. Но есть несколько существенных ограничений, из-за которых не все компании смогут работать с WhatsApp Business API. Их мы выделим отдельно:
Цена – абонентская плата за официальный API может достигать от 3 до 60 тысяч рублей в месяц, включая плату за подключение, отправленные шаблонные сообщений и дополнительные услуги. К тому же цену на тарифы диктует сам WhatsApp (в валюте), и с посредникам не всегда удается договориться на более индивидуальный подход. Подробнее о ценах можно почитать на официальном сайте разработчика.
Ограничения по сферам бизнеса. WhatsApp не одобряет партнерство с некоторыми отраслями бизнеса. Например, медицина, алкоголь, ветеринария, часть финансовых консультаций могут получить отказ к доступу к WhatsApp Business API.
Достижение WhatsApp Business API может быть сопряжено с рядом сложностей. Будьте в хорошем смысле готовы, что это энерго- и ресурсо- затратный процесс.
Да, но это не так страшно, как Бан со стороны WhatsApp!
Действительно, бан рабочего номера для бизнеса — это сюжет ночного кошмара. Никто бы не хотел оказаться в такой ситуации. Согласно статистике WhatsApp, мессенджер блокирует около 2 000 000 пользователей в месяц, которые нарушают условия политики WhatsApp.
Но это не значит, что провайдеры WhatsApp API безответственно относятся к своим клиентам. Например, Chat API для безопасности пользователей предоставляет клиентам индивидуальные IP, производит безопасную авторизацию и вводит систему искусственных предохранителей. Конечно, это не поможет, если пользователь будет беспечно относиться к правилам работы с WhatsApp и спамить клиентам. Даже с WhatsApp Business API есть возможность получить бан за нарушение политики WhatsApp. Но если объединить инструменты безопасности Chat API с разумным использованием сервиса, то ваш номер будет в полной безопасности. А если Вам больше интересен статус номера или зеленая галочка, то тогда Вам однозначно стоит подключать WhatsApp Business API.
Разобрав основные моменты, можно перейти непосредственно к самому интересному, а именно к сухой аналитике, и сравнить два способа работы c WhatsApp.
Начнем с преимуществ Chat API
| Chat API | Business API |
|---|---|
| Работает с любым существующим личным или служебным номером | Работает только с новыми номерами. Подключать действующие номера возможно, но это сопряжено с рядом дополнительных процедур |
| Начать работать можно моментально после оформления номера, но важно соблюдать наши рекомендации | Номер должен пройти регистрацию и верификацию. Facebook важно собрать информацию о бизнесе, прежде, чем предоставить доступ к API |
| Доступно для всех категорий клиентов | Только для юридических лиц. С учетом затрат на подключение, то для среднего и крупного бизнеса. |
| Можно отправить любое содержимое (не нарушающее законодательство) | Шаблоны сообщений должны быть предварительно одобрены. Нельзя отправлять аудио файлы |
| Физически неограниченный обмен сообщениями за фиксированную плату (900 рублей в месяц) | Платные исходящие шаблонные сообщения. Ограничение на количество отправленных сообщений в сутки, привязанные к “рейтингу” номера |
| Нет условий и легкая регистрация | Строгое соблюдение правил и комплексный процесс внедрения. При этом сохраняется тенденция к упрощению доступа к WhatsApp Business API |
| Разрешение не требуется, можно написать первым | Первые исходящие сообщения являются платными. Необходимо составить и утвердить шаблоны таких сообщений |
| Приступить к работе можно сразу же | Сейчас возможен моментальный доступ к WhatsApp Business API, но с ограничениями, которые устраняются при подтверждении Вашего бизнеса |
| Можно использовать номера в любом количестве | До 25-ти номеров. Далее требуется индивидуальное соглашение |
| Прямая поддержка Chat API 24 x 7 через электронную почту и чаты | Поддержка 24 x 7 обеспечивается Chat API, часть вопросов возможно решить только с помощью отправки запросов в Facebook, на это может уйти дополнительное время |
| Возможность сделать любую доработку и интеграцию | Невозможность повлиять и добавить функциональности сервису |
| Любое наименование вашего аккаунта | Display name Вашего аккаунта также проверяется и утверждается Facebook |
| Можно работать по всему миру | Есть ряд государств, которые не признаются мировым сообществом, с такими странами невозможно заключить сотрудничество с Facebook |
| Можно работать представителям любой сферы бизнеса (кроме запрещенных законодательством). | Есть ограничения, связанные с политикой Facebook. Нельзя, например, проводить консультации по медицинским вопросам. Политические организации должны проходить отдельное согласование с Facebook |
Преимущества WhatsApp Business API
| Chat API | Business API |
|---|---|
| Возможность бана номера от WhatsApp, если нарушаются наши рекомендации по безопасной работе | Бан в исключительных случаях. В первую очередь падение рейтинга номера или же ограничение в использовании отдельных шаблонных сообщений |
| Зависит от срока использования аккаунта. В начале советуем отправлять не более 5-20 сообщений в минуту | Высокая масштабируемость: по умолчанию 10 сообщений в секунду |
| Зависит от условий вашей телефонной сети | Не зависит от локального соединения телефона |
| Только ручное добавление контактов через телефон | Автоматическая возможность добавлять и удалять контакты |
| Нет возможности получить зеленую галочку | Бизнес аккаунт может получить верифицированный значок Официального бизнес аккаунта (зеленая галочка), для этого необходимо подать заявку в Facebook |
| Зависит от срока использования аккаунта. В начале советуем отправлять не более 5-20 сообщений в минуту | Высокая масштабируемость: по умолчанию 10 сообщений в секунду. С увеличением рейтинга номера будет расти количество отправляемых сообщений в секунду |
| Необходимо держать телефон подключенным к сети и к хорошему соединению с интернетом. | Нет такой необходимости |
На этом у нас все. Команда Chat API желает всем успехов и новых свершений!
Настройка и автоматизация API
Если вы планируете автоматизацию процесса работы с Chat API, настроить автоматическое создание\удаление инстансов, получение и обработку информации, то Вам просто необходим раздел «Настройки API»
Здесь вы сможете найти функции, которые позволят провести необходимую настройку автоматизации или решения по интеграции API с вашим решением.
В первую очередь обратите внимание на Ваш API KEY, это крайне конфиденциальная информация, данный ключ лучше никому не показывать, иначе это может привести к потере управления над вашими инстансами. В отличие от токена, который мы можем изменить, API KEY является неизменным атрибутом.
В настройках API представлены три функции, с помощью которых вы сможете создать, удалить и посмотреть информацию по инстансам.
Первая функция https://us-central1-app-chat-api-com.cloudfunctions.net/newInstance создает новые инстансы. Для этого задействуем параметры, указанные в настройках API.
Uid – это Ваш API KEY
Выглядеть это будет вот так:
Вид ответа от сервера:
Рабочими параметрами являются:
Uid – это Ваш API KEY
Функция принимает следующий вид:
Ответ от сервера будет выглядеть следующим образом :
Uid – это Ваш API KEY
Подробнее ознакомиться с тем, как можно настроить API можно в нашем обучающем видео:
Была ли эта статья полезной?
Ваше мнение будет использовано для улучшения содержания статьи
Документация
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 секунд.
Параметры:
| groupName | Название группы, строка, обязательное. |
| phones | Массив телефонов, начинающийся с кода страны. Свой номер добавлять не надо. Для России и Казахстана это всегда 7, затем 10 цифр. Пример: 79995253422. |
| messageText | Текст сообщения, строка |
Пример запроса:
POST /sendMessage
Отправка сообщения в новый или существующий чат. Сообщение будет добавлено в очередь на отправку и доставлено даже если телефон отключен от интернета или авторизация не пройдена.
Параметры:
| phone | Обязателен если не указан chatId | Номер телефона, начинающийся с кода страны. Для России и Казахстана это всегда 7, затем 10 цифр. Сообщения на номера телефона с 8 не будут доставлены. Пример: 79995253422. |
| chatId | Обязателен если не указан phone | ID чата из списка сообщений. Примеры: 79633123456@c.us для личных сообщений и 79680561234-1479621234@g.us для группы. Используется вместо параметра phone |
| body | Обязателен | Текст сообщения, любая строка включая emoji 🍏 |
Примеры запросов:
Пример ответа:
POST /sendFile
Отправка файла в новый или существующий чат. Сообщение будет добавлено в очередь на отправку и доставлено даже если телефон отключен от интернета или авторизация не пройдена.
Параметры:
| phone | Обязателен если не указан chatId | Смотрите POST /sendMessage |
| chatId | Обязателен если не указан phone | Смотрите POST /sendMessage |
| body | Обязателен | Ссылка на файл, например https://upload.wikimedia.org/wikipedia/ru/3/33/NatureCover2001.jpg Или файл в base64, например data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ. Или файл в поле формы |
| filename | Обязательно | Имя отправляемого файла, например 1.jpg или hello.xlsx |
| caption | Не обязательно | Текст под фотографией |
Примеры запроса:
Пример ответа:
GET /messages
Получить список сообщений. Для получения только новых сообщений передайте параметр lastMessageNumber из последнего запроса.
Файлы из сообщений гарантированно хранятся лишь 10 дней и могут быть удалены. Скачивайте файлы сразу при получении на свой сервер.
Параметры:
| lastMessageNumber | Параметр lastMessageNumber из предыдущего запроса |
| last | Отображает последние 100 сообщений. Если передан этот параметр, то lastMessageNumber игнорируется. |
Пример ответа:
POST /webhook
Устанавливает URL для получения webhook уведомлений о новых сообщениях и о статусах доставки исходящих сообщений (ack).
Параметры:
| webhookUrl | Http или https URL для получения оповещений. Для тестирования рекомендуем использовать requestb.in. |
Пример ответа:
Пример webhook уведомления:
GET /webhook
Возвращает текущий webhook url.
Пример ответа:
POST /settings/ackNotificationsOn
Включить или выключить получение уведомлений о доставке и прочтении отправленных сообщений ack в webhook. Так же работает GET метод по тому же адресу.
Параметры:
Пример ответа:
GET /logout
Выйти из аккаунта и запросить новый QR-код.
Пример ответа:
GET /reboot
Перезагрузить Ваш инстанс WhatsApp.
Пример ответа:
GET /showMessagesQueue
Показать список сообщений, которые стоят в очереди на отправку, но еще не отправлены.
Пример ответа:
GET /clearMessagesQueue
Очистить очередь на отправку сообщений. Этот метод нужен когда вы случайно отправили тысячи сообщений подряд.
Chat api что это
Chat API – это WhatsApp API провайдер, шлюз для работы с сообщениями. Если Вы ищите способ наладить общение с клиентами через WhatsApp, то мы можем помочь Вам в этом. Chat API работает с 2015-года и на данный момент сотрудничает более чем с 3000 программистов и организаций по всему миру, проводя через себя более чем 1 миллиард пользовательских запросов в месяц.
Мы изначально фокусировались на решении задач программистов по интеграции с WhatsApp, поэтому Chat API обладает широким функционалом возможностей с более чем 200-ми методов, которые постоянно обновляются. Таким образом, если Вы хотите связать клиентов в WhatsApp с одной стороны и Ваше решение (будь то CRM система, чат-бот или иная платформа) с другой, то Chat API будет отличным решением.
На сегодняшний день мы также предоставляем конструктор чат-ботов (даже два) и официальный WhatsApp Business API от Facebook. Разбор отличий решения Chat API и WhatsApp Business API описан в этой статье.
Если у Вас малый или средний бизнес, то Вы можете использовать Chat API для налаживания общения с клиентами в WhatsApp, оптимизируя тем самым свои маркетинговые расходы на рассылки сообщений. Автоматизировать общение с клиентами можно через наших встроенных ботов либо же разработать полностью индивидуальный сценарий, используя доступные методы API.
Если Вы предоставляете определенное IT решение, например, CRM систему, бота или иную платформу, то через Chat API Вы сможете легко интегрироваться с WhatsApp. В личном кабинете Вы найдете SDK генератор, который поможет Вам в этом, а также руководства к разработке в базе знаний.
Если Вы представляете крупный бизнес, то Вас может заинтересовать официальный WhatsApp Business API.
Функционал Chat API достаточно широк. В личном кабинете Вы сможете найти инструменты по тестированию функций API, SDK генератор, два конструктора чат-ботов, конвертер в base64, генератор ссылок, а также удобный интерфейс по добавлению, оплате и управлению инстансами.
С помощью документации и мануалов Вы сможете отправлять все типы файлов и сообщений в WhatsApp, автоматически создавать и управлять инстансами, получать хуки и настраивать уведомления на события в мессенджере, создавать группы, работать с категорией «товаров» и многое-многое другое.
Все просто. Пройдите регистрацию, отсканируйте QR код в личном кабинете и можете приступать к отправке сообщений без модераций. Для работы сервиса Вам понадобится смартфон, со стабильным подключением к сети. Также следите, чтобы приложение WhatsApp на телефоне не уходило в фоновой режим.
В этом видео на нашем канале Вы можете посмотреть, как проходит процесс регистрации, а также ознакомиться с функционалом Chat API.
Да, у Chat API их два.
— Menu-bot – он бесплатный и создан для решения простых задач по обработке входящих сообщений. Подробности о нем в нашей статье в базе знаний (с видео).
— Visual bot constructor – более мощный инструмент для решения самых разнообразных и творческих задач по работе с клиентами в WhatsApp. Он оплачивается отдельно от услуг сервиса. Узнать о нем больше можно в пояснительной статье в базе знаний.
Да, обязательно будет обновляться. Chat API работает и поддерживается с декабря 2015 года. Обычно выходит 3-4 обновления в год, влияющих на работу Chat API – в течение 1 рабочего дня мы адаптируем API к изменениям.
Chat API сотрудничает более чем с 3000 программистов и организаций по всему миру, проводя через себя более чем 1 миллиард пользовательских запросов в месяц. Именно поэтому мы в большей степени сосредоточены на предоставлении качественного и стабильного API, а отдельно интеграцией не занимаемся.
Однако наши пользователи отмечают, что интеграция с сервисом проходит быстро и легко. Чтобы интеграция проходила проще, в личном кабинете Вы найдете SDK генератор и руководства к разработке в базе знаний.
Стоимость подключения одного инстанса – 900 рублей в месяц.
Один инстанс – это один номер телефона.
В Вашем личном кабинете Вы можете иметь сколько угодно инстансов, при этом, чем больше инстансов Вы подключаете, тем выгодней становится цена за каждый отдельный. «Лестница» скидок выглядит следующим образом:
Узнать больше о нашей ценовой политике и наших специальных предложениях можно здесь.
Мы работаем с 2015 года и никогда не переставали уделять внимание вопросам стабильности и безопасности. Что мы можем гарантировать со своей стороны:
— уникальный IP для каждого клиента;
— безопасная авторизация через настройки личного кабинета;
— мы используем прокси, а через личный кабинет, Вы можете установить свой собственный прокси сервер;
— uptime сервера;
— служба поддержки 24\7.
Более того, за 6 лет работы с WhatsApp мы научились оперативно обновлять сервис вслед за обновлениями мессенджера, что позволит Вам практически не замечать технических работ.
При этом, если Вы производите с номера массовые рассылки, то даже подобные меры безопасности не смогут защитить Вас от бана. Самый надежный способ обезопасить номер – это соблюдать наши рекомендации по работе с сервисом. Почитать о них можно здесь.
В Chat API нет ограничений на количество отправляемых сообщений. При этом, мы не рекомендуем отправлять более 6000 сообщений в день. Если Вы заинтересованы в большем количестве сообщений, то стоит подключить несколько номеров.
Также стоит иметь в виду, что при массовых рассылках пользователи могут помечать Ваши сообщения как спам, что неизбежно приведет к блокировке номера. Поэтому отправляйте сообщения клиентам, которые ждут их от Вас.
Для этого Вам необходимо настроить Webhook на входящие ACK уведомления. Максимально подробный гид по настройке хуков с примерами представлен в этой статье.
Да. Смотрите раздел “ack” в документации
1) Создайте группу через метод POST /group.
2) Получите chatId через метод GET /messages.
3) Отправьте сообщение в группу через POST /sendMessage
Да, можно.
Важно! Используйте метод /sendFile вместо метода message (sendMessage) в ссылке с токеном. Отправляйте только ссылки https (не стоит отправлять http). Максимальный размер файла 60 mb. Файлы большого размера лучше отправлять с помощью ссылки, а не base64.
Используйте эту инструкцию в базе знаний, чтобы форматировать текст или делать разрыв строки (перенос текста)