Loading...

Описание API

API WAMM.chat позволяет Вам взаимодействовать со своим аккаунтом WhatsApp напрямую из своей CRM, сайта, 1С или другой системы

API доступен на любом из платных тарифов - от 1700 рублей в месяц, а во время тестового периода - бесплатен!
Попробуйте WhatsApp API бесплатно!

API (программный интерфейс приложения) позволяет выполнять некоторые функции программы не нажимая кнопки, не вводя тексты, а отправляя специальные запросы к программе и получать на них ответы. Используя API можно делать автоматические рассылки сообщений из других программ, получать тексты и статусы сообщений, добавлять и обновлять контакты.

Далее описаны имеющиеся функции. Персональный токен (код) для подключения к API указан в разделе Настройки, доступный пользователям с ролью Администратор


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

Используйте GET-запрос, где номер телефона в международном формате (79001234567 и тп, но может содержать пробелы, скобки, тире и др) и текст в кодировке UTF-8 (может включать ссылки, смайлы). Для переноса текста на новую строку используйте в сообщении символы - %0A

При отправке по API нескольких сообщений, они выстраиваются в очередь отправки с интервалом от 5 до 12 сек (в случайном порядке) между сообщениями. Для тестовых аккаунтов есть ограничение - не более 30 отправленных сообщений по API в день.

Запрос GET: https://wamm.chat/api2/msg_to/токен/?phone=номер-телефона&text=текст-сообщения

Ответ при успехе: JSON: {"err":0,"msg_id":1хххххх}, где msg_id - номер сообщения

Ответ при ошибке: JSON: {"err":"phone fail"}
Варианты ошибок:

  • token fail – ошибка в токене
  • acc not authorized – подключение к WhatsApp не авторизовано
  • phone fail – ошибка в номере телефона
  • no WhatsApp on the number – нет WhatsApp с таким номером
  • phone not checked for WhatsApp, please retry – не проверен номер на наличие WhatsApp
  • text fail – пустой текст
  • text fail, more 1500 – текст слишком большой, превышает 1500 символов


👉 Получение статуса сообщения

Запрос GET: https://wamm.chat/api2/msg_state/токен/?msg_id=номер-сообщения

Ответ при успехе: JSON: {"err":0,"msg_data":{"msg_id":"1хххххх","phone":"79ххххххх","state":"viewed"}}

Ответ при ошибке: JSON: {"err":"msg_id fail"}
Варианты ошибок:

  • token fail – ошибка в токене
  • acc not authorized – подключение к WhatsApp не авторизовано
  • msg_id fail – ошибка в номере
  • msg not be – не найден номер сообщения


👉 Проверить наличие WhatsApp по номеру телефона

Запрос GET: https://wamm.chat/api2/check_phone/токен/?phone=номер-телефона

Ответ при успехе: JSON: {"err":0,"result":"exists"}
Варианты ответов:

  • exists – есть WhatsApp на номере
  • none – нет WhatsApp на номере

Ответ при ошибке: JSON: {"err":"fail execution", "result":"error"}
Варианты ошибок:

  • token fail – ошибка в токене
  • acc not authorized – подключение к WhatsApp не авторизовано
  • fail execution – ошибка проверки, стоит повторить


👉 Отправка файлов / картинок / документов

Используйте GET-запрос, где номер телефона в международном формате (79001234567 и тп, но может содержать пробелы, скобки, тире и др) и URL - публичная ссылка к файлу (доступная из Интернета, вида: https://wamm.chat/i/images/wamm-chat-logo.png).

При отправке по API нескольких сообщений, они выстраиваются в очередь отправки с интервалом от 5 до 12 сек (в случайном порядке) между сообщениями. Для тестовых аккаунтов есть ограничение - не более 30 отправленных сообщений по API в день.

Запрос GET: https://wamm.chat/api2/file_to/токен/?phone=номер-телефона&url=ссылка-на-файл

Ответ при успехе: JSON: {"err":0,"msg_id":1хххххх}, где msg_id - номер сообщения

Ответ при ошибке: JSON: {"err":"phone fail"}
Варианты ошибок:

  • token fail – ошибка в токене
  • acc not authorized – подключение к WhatsApp не авторизовано
  • phone fail – ошибка в номере телефона
  • no WhatsApp on the number – нет WhatsApp с таким номером
  • phone not checked for WhatsApp, please retry – не проверен номер на наличие WhatsApp
  • url fail – пустая ссылка или в ней отсутствует http / https


👉 Получение статуса сообщения

Запрос GET: https://wamm.chat/api2/msg_state/токен/?msg_id=номер-сообщения

Ответ при успехе: JSON: {"err":0,"msg_data":{"msg_id":"1хххххх","phone":"79ххххххх","state":"viewed"}}

Ответ при ошибке: JSON: {"err":"msg_id fail"}
Варианты ошибок:

  • token fail – ошибка в токене
  • acc not authorized – подключение к WhatsApp не авторизовано
  • msg_id fail – ошибка в номере
  • msg not be – не найден номер сообщения


👉 Получение сообщений

Этой функцией можно получить до 100 последних исходящих и входящих текстовых сообщений

Запрос GET: https://wamm.chat/api2/msg_get_last/токен/?col=кол-во(1-100)

В запросе также можно указать необязательный GET-параметр from_me=0 или from_me=1, который позволит вывести не все последние сообщения, а лишь отправленные (1) или полученные (0)

Ответ при успехе: JSON: {"err":0,"msg_data":[{"msg_id":"1xxxxxx","from_me":"1","phone":"79xxxxxxxxx","chat_name":"Олег Иванов","tip_msg":"textMessage","msg_text":"текст сообщения","msg_link":"URL","date_ins":"2021-01-24 19:52:00","date_upd":"2021-01-24 19:52:22","state":"delivered"},…….. }]}
Описание переменных:

  • msg_id - номер сообщения
  • from_me - входящее (0) или исходящее (1) сообщение
  • phone - номер телефона
  • chat_name - имя контакта
  • tip_msg - тип сообщения: текст – textMessage, file_link – файл/картинка/голосовое и т.п.
  • msg_text - текст сообщения
  • msg_link - ссылка на файл
  • date_ins - дата отправки/получения
  • state - статус сообщения (sending, viewed, received и другие)

Ответ при ошибке: JSON: {"err":"col fail or more 100"}
Варианты ошибок:

  • token fail – ошибка в токене
  • acc not authorized – подключение к WhatsApp не авторизовано
  • col fail or more 100 – ошибка в кол-ве или превышает 100
  • msgs not be – не найдены сообщения


👉 Получение сообщений по номеру телефона

Этой функцией можно получить до 100 последних исходящих и входящих текстовых сообщений по конкретному номеру телефона

Запрос GET: https://wamm.chat/api2/msg_get/токен/?phone=телефон&col=кол-во(1-100)

Ответ при успехе: JSON: {"err":0,"msg_data":[{"msg_id":"1xxxxxx","from_me":"1","phone":"79xxxxxxxxx","chat_name":"Олег Иванов","tip_msg":"textMessage","msg_text":"текст сообщения","msg_link":"URL","date_ins":"2021-01-24 19:52:00","date_upd":"2021-01-24 19:52:22","state":"delivered"},…….. }]}
Описание переменных:

  • msg_id - номер сообщения
  • from_me - входящее (0) или исходящее (1) сообщение
  • phone - номер телефона
  • chat_name - имя контакта
  • tip_msg - тип сообщения: текст – textMessage, file_link – файл/картинка/голосовое и т.п.
  • msg_text - текст сообщения
  • msg_link - ссылка на файл
  • date_ins - дата отправки/получения
  • state - статус сообщения (sending, viewed, received и другие)

Ответ при ошибке: JSON: {"err":"col fail or more 100"}
Варианты ошибок:

  • token fail – ошибка в токене
  • acc not authorized – подключение к WhatsApp не авторизовано
  • col fail or more 100 – ошибка в кол-ве или превышает 100
  • msgs not be – не найдены сообщения
  • phone fail – ошибка в номере телефона


👉 Добавление и обновление контактов

Этот запрос добавляет контакт в WAMM.chat или обновляет имя, если существует.

Запрос GET: https://wamm.chat/api2/contact_to/токен/?phone=номер-телефона&name=имя контакта

Запрос GET: https://wamm.chat/api2/contact_to/токен/?phone=номер-телефона&name=имя контакта&info=Заметка, примечание к контакту&email=e-mail&web=URL

Где, параметры info, email, web - необязательные, их можно не отправлять в запросе

Ответ при успехе: JSON: {"err":0,"result":"insert"} или JSON: {"err":0,"result":"update"}

Ответ при ошибке: JSON: {"err":"phone fail"}
Варианты ошибок:

  • token fail – ошибка в токене
  • acc not authorized – подключение к WhatsApp не авторизовано
  • phone fail – ошибка в номере телефона
  • no WhatsApp on the number – нет WhatsApp с таким номером
  • phone not checked for WhatsApp, please retry – не проверен номер на наличие WhatsApp
  • name fail – не указано имя
  • name fail, more 250 – имя слишком большое, превышает 250 символов
  • web fail, more 150 – URL слишком большое, превышает 150 символов
  • email fail, more 150 – email слишком большое, превышает 150 символов


👉 Удаление контактов

Этот запрос удаляет контакт в WAMM.chat, при этом в WhatsApp на смартфоне он остаётся.

Запрос GET: https://wamm.chat/api2/contact_delete/токен/?phone=номер-телефона

Ответ при успехе: JSON: {"err":0,"result":"delete"}

Ответ при ошибке: JSON: {"err":"phone fail"}
Варианты ошибок:

  • token fail – ошибка в токене
  • acc not authorized – подключение к WhatsApp не авторизовано
  • phone fail – ошибка в номере телефона
  • phone not found – не найден телефон в контактах


👉 Смайлы

Текст сообщения должен быть в UTF-8 и он позволяет вставить смайлы, как отдельные символы: 🤗💐😂🤩😭 и тд. Если вы используете системы, которые по тем или иным причинам не могут отправить смайлы, то можете использовать спецсимволы, которые будут заменены на смайлы:

Смайл Код
🤗 :sm01:
💐 :sm02:
😂 :sm03:
🤩 :sm04:
😭 :sm05:
😤 :sm06:
🤝 :sm07:
😃 :sm08:
😉 :sm09:
😍 :sm10:
😘 :sm11:
😷 :sm12:
😕 :sm13:
🙏 :sm14:
👉 :sm15:
👍 :sm16:
💐 :sm17:
🔥 :sm18:
🕒 :sm19:
🎁 :sm20:
📺 :sm21:
:sm22:

Как начать использовать

Зарегистрируетесь, сканируете QR-код
и ваш WhatsApp подключен к WAMM.сhat!
На всё не более 5 минут!

01

Регистрация

Укажите свой email и пароль

02

Подключение

Сканируйте QR-код телефоном с WhatsApp

03

Коллеги

Добавьте коллег к аккаунту, указав их email

04

Готово

Принимайте и отправляйте сообщения WhatsApp

Our Achivements

Porttitor dolor donec pulvinar tortor nisi quis dapibus tortor commodo Pellentesque hendrerit pellentesque libero nec sollicitudin.

0

Happy Clients

0

Projects Compleated

0

Files Downloaded

0

Liens Of Code

Присоединяйтесь к WAMM.сhat в соцсетях

Molestias excepturi sint occaecati cupiditate non provident