Этот метод позволяет отправлять текстовые сообщения получателям через доступные каналы связи (WhatsApp, Telegram, MAX, и т.д.). Можно включать в сообщения ссылки, эмодзи и форматирование. Метод удобен для отправки уведомлений, информационных сообщений и непосредственно общения с клиентами.
При отправке автоматически проверяется наличие аккаунта в мессенджере по указаному телефону или ID чата, никнейму, в зависимости от мессенджера.
Пример запроса:
GET https://wamm.chat/api2/msg_to/{token}/?phone={phone}&text={text}
или
GET https://wamm.chat/api2/msg_to/{token}/{phone}/{text}
Параметры запроса
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
token | string | Да | API-токен, полученный в настройках |
phone | string | Да | Номер телефона в международном формате (например, 79001234567). Для Telegram вместо номера можно указывать ID чата или никнейм, для MAX - ID чата |
text | string | Да | Текст сообщения длиной до 4500 символов в кодировке UTF-8, закодированный функцией urlencode. Для переноса текста на новую строку используйте в тексте "%0A" |
delay | integer | Нет | Интервал между сообщениями в секундах. Допустимые значения: 15, 20, 30, 45, 60, 120, 180 |
quote_msg_id | integer | Нет | ID сообщения, на которое отвечаем |
При отправке по API одновременно нескольких сообщений, они выстраиваются в очередь отправки с интервалом в несколько секунд между сообщениями или интервал можно увеличить, явно задав через параметр "delay". Для тестовых аккаунтов есть ограничение - не более 30 отправленных сообщений по API в день.
Ответ при успехе
{"err":0,"msg_id":1234567}
Возможные ошибки
Код ошибки, значение "err" | Описание |
---|---|
token fail | Ошибка в токене |
acc not authorized | Подключение не авторизовано |
phone fail | Ошибка в номере телефона |
no WhatsApp on the number | Нет аккаунта с таким номером для WhatsApp |
no Account on the number | Нет аккаунта с таким номером для других каналов (Telegram, MAX...) |
phone not checked for WhatsApp, please retry | Не проверен номер на наличие (WhatsApp), повторите запрос |
phone not checked, please retry | Не проверен номер на наличие (для других каналов), повторите запрос |
text fail | Пустой текст |
text fail, more 4500 | Текст слишком большой, превышает 4500 символов |
quote_msg_id fail, not found | Не найдено сообщение для ответа |
Примеры использования
curl -X GET "https://wamm.chat/api2/msg_to/YOUR_TOKEN/?phone=79001234567&text=Тестовое%20сообщение"
function sendMessage($token, $phone, $text) {
// Подготавливаем URL запроса
$url = "https://wamm.chat/api2/msg_to/$token/?phone=$phone&text=" . urlencode($text);
// Выполняем запрос
$response = file_get_contents($url);
// Обрабатываем ответ
if ($response !== false) {
// Преобразуем ответ в массив
$json_response = json_decode($response, true);
// Проверяем наличие ошибок
if (isset($json_response['err'])) {
if ($json_response['err'] == 0 && isset($json_response['msg_id'])) {
echo "Сообщение успешно отправлено, ID сообщения: " . $json_response['msg_id'];
} else {
echo "Ошибка: " . $json_response['err'];
}
} else {
echo "Не удалось обработать ответ от сервера";
}
} else {
echo "Не удалось выполнить запрос к серверу";
}
}
// Используем функцию для отправки сообщения
$token = "YOUR_TOKEN";
$phone = "79001234567";
$text = "Тестовое сообщение";
sendMessage($token, $phone, $text);