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 рублей в месяц.
Один инстанс – это один номер телефона.
В Вашем личном кабинете Вы можете иметь сколько угодно инстансов, при этом, чем больше инстансов Вы подключаете, тем выгодней становится цена за каждый отдельный. «Лестница» скидок выглядит следующим образом:
— 1-20 инстансов — 900 руб/за инстанс;
— 20-49 инстансов — 750 руб/за инстанс;
— 50-99 инстансов — 600 руб/за инстанс;
— 100-499 инстансов — 450 руб/за инстанс;
— от 500 инстансов — 300 руб/за инстанс;
Узнать больше о нашей ценовой политике и наших специальных предложениях можно здесь.
900 руб/мес — это оплата за подключение к сервису Chat API 1 аккаунта WhatsApp. При использовании более 20 аккаунтов действует специальная цена.
Мы работаем с 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.
Используйте эту инструкцию в базе знаний, чтобы форматировать текст или делать разрыв строки (перенос текста)
Источник
Привязка WhatsApp к Chat-API
Содержание
Введение
Прежде чем приступить к настройке интеграции с WhatsApp, требуется авторизация на сервисе WhatsApp API.
Авторизация на WhatsApp API
Прямая ссылка для входа на сервис: https://app.chat-api.com/login
Для авторизации требуется ввести логин и пароль, можно установить галочку «Запомнить меня». Если учетная запись еще не создана, сначала требуется зарегистрироваться.
Для этого требуется указать e-mail и пароль, подтвердить пароль, поставить галочку «Я прочитал и согласен(а) условия и положения» и подтвердить, что Вы не робот.
После этого станет активной кнопка «Создать учетную запись»
Далее требуется подтвердить e-mail. На указанный адрес электронной почты будет отправлено письмо.
Его требуется открыть и нажать в нем кнопку «Закончите регистрацию».
Произойдет переход на сайт в созданную учетную запись.
В правом верхнем углу отображается аватар пользователя и имя или адрес электронной почты. Можно задать имя аккаунта. Слева находится меню управления:
Внимание! «+ Добавить аккаунт» не нажимать – лишние аккаунты потом будет не удалить.
Но в случае необходимости можно создавать несколько аккаунтов, например, для разных подразделений организации, если оплата по ним будет происходить раздельно (т.к. каждый аккаунт оплачивается отдельно).
Далее требуется отсканировать QR-код. На сайте выходит сообщение:
Для подключения к API вам необходимо отсканировать QR код с устройства, на котором зарегистрирован WhatsApp. Если ваш аккаунт зарегистрирован менее месяца назад, вам необходимо пройти безопасную авторизацию, чтобы уменьшить вероятность блокировки.»
и две кнопки: «Обычная авторизация» и «Безопасная авторизация» (при выборе безопасной авторизации сервис предложит установить расширение для браузера).
Инструкция для сканирования QR-кода отображается в форме gif-инструкции (https://app.chat-api.com/assets/gifs/whatsapp_auth_ru.gif) и дублируется текстом.
В инструкции показано, что следует открыть WhatsApp на телефоне, нажать три точки, нажать «WhatsApp WEB», отсканировать QR-код.
И то же самое написано словами в сообщении:
«Для отправки и приема сообщений Вы должны авторизовать наш сервер как WhatsApp Web.
- Откройте WhatsApp на телефоне
- Нажмите Настройки -> WhatsApp WEB и добавить
- Просканируйте код и подождите 1 минуту
- Держите телефон подключенным к интернету
Код можно сканировать в течение 1 минуты* после загрузки.
Отправка сообщений будет доступна сразу после авторизации.»
*Примечание: по факту меньше минуты, затем код меняется.
Приложение WhastsApp требуется держать открытым во время авторизации. Повторная авторизация нужна только в случае смены устройства или ручного нажатия «Выйти из всех устройств» на телефоне.
Когда авторизация установлена (статус «Авторизован»), отображаются следующие рамки:
Рекомендуется подключить телефон к Wi-Fi, чтобы снизить трафик данных, а также регулярно заряжать батарею.
На сколько дней оплачен аккаунт
3 дня после регистрации сервисом можно пользоваться бесплатно, затем нужно будет платить.
Если аккаунт в статусе «Не оплачен», отображается сообщение: «Ваш аккаунт был остановлен из-за неуплаты. Прямо сейчас вы можете включить этот инстанс, просто продлив подписку.»
В настройках аккаунта должны быть включены все параметры:
- Уведомления о доставке/прочтении
- Уведомления об изменениях в чатах
- Уведомления об изменениях статуса
- Не загружать (примеч.: не отправлять) старые сообщения после авторизации*
*Примечание: «старые сообщения» – это сообщения, дата которых не текущая, т.е. настройка используется, чтобы не отправлялись неактуальные сообщения, когда связь появилась.
Возможные проблемы и способы их устранения
Рекомендуется регулярно (например, раз в неделю) проверять корректность работы механизма отправки сообщений: заходить в Мастер настройки и делать тест подключения по всем каналам.
Как понять, что отправка сообщений через WhatsApp не работает.
Открыть Список Чаты: Сообщения (CRM -> Сообщения -> Сообщения). Установить отбор «Канал доставки равно WhatsApp».
На возможные проблемы указывают статусы нескольких сообщений подряд «Отправка невозможна», «Не отправлено», «Не доставлено» или «Ошибка отправки».
Чтобы проверить корректность работы функционала, требуется зайти в «Мастер настройки» (CRM -> Обработки -> Мастер настройки), выбрать канал доставки WhatsApp, нажать «Тест подключения».
Статус аккаунта Chat API отобразится в формате . Возможные статусы (см. https://chat-api.com/ru/docs.html):
- init – «это начальный статус»
- loading – «загрузка, повторите через 30 секунд»
- got qr code – требуется отсканировать QR-код в приложении WhatsApp. QR-код действителен в течении одной минуты.
- authenticated – «авторизация пройдена успешно»
Статус «loading» говорить о том, что WhatsApp ждет выхода телефона на связь, если он отключен или ушел в спящий режим. WhatsApp может активизировать телефон, инициировать обмен данными.
Если статус аккаунта «got qr code», требуется зайти на сайт и проследовать инструкции, как отсканировать QR-код.
Такая проблема может возникнуть, если случайно перебить учетную запись – зайти с другого компьютера (или если нажать «Выйти из всех устройств» на телефоне, или отвязать свою учетную запись в Chat API от телефона). WhatsApp позволяет интеграцию только одного компьютера с телефоном: если зайти с другого компьютера – на первом отключится.
В программе в этом случае отображается статус «got qr code» и выходит ошибка, сообщения перестают отправляться.
Также причиной того, что отправка через WhatsApp не работает, может быть то, что закончились деньги на балансе аккаунта: на сайте отобразится Статус авторизации «Не оплачен».
Когда аккаунт не работает, на сайте выходит следующее сообщение:
«Топ-3 причины отключения WhatsApp ‘WEB’:
- У Вашего телефона плохое соединение с интернетом или включен режим энергосбережения.
- Вы открыли WhatsApp WEB на другом компьютере.
- Вы только что оплатили аккаунт, который был ранее остановлен за неуплату. В течение 1 часа он снова запустится на нашем сервере и будет работать.»
Также рекомендуется к изучению раздел FAQ (панель управления аккаунтом, раздел «Поддержка»).
Если после устранения возможных проблем статус аккаунта на сайте меняется на «Авторизован», а в программе (при тесте подключения) – authenticated, значит, проблема успешно устранена.
Тогда все сообщения в программе будут в статусах «Прочитано», «Отправлено», «Доставлено».
Настройки отправки сообщений
Должны быть настроены следующие права для автоматической отправки сообщений (см. Мастер настройки системы#Настройка отправки сообщений).
Обработки -> Мастер настройки -> вкладка «Отправка сообщений» -> вкладка «Общие настройки» -> поле «Права» -> кнопки-ссылки «Активность значимых событий» (значение права = «Да») и «Время ожидания реакции клиента на отправленное сообщение, мин» (значение права по умолчанию = 10).
Эти настройки действуют следующим образом: если было отправлено сообщение по WhatsApp, а статус сообщения не сменился на «Прочитано» в течение указанного в настройке времени (10 минут), то отправка автоматически повторяется по другому каналу (Telegram, SMSC).
Порядок отправки по каналам доставки задается в настройках уведомлений по значимым событиям.
Источник