Отправка сообщений
Этот метод позволяет отправлять текстовые сообщения получателям через доступные каналы связи (WhatsApp, Telegram, и т.д.). Можно включать в сообщения ссылки, эмодзи и форматирование. Метод удобен для отправки уведомлений, информационных сообщений и общения с клиентами.
GET /api2/msg_to/{token}/?phone={phone}&text={text} Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| token | string | Да | API-токен, полученный в настройках |
| phone | string | Да | Номер телефона в международном формате (например, 79001234567) или ID чата для Telegram |
| text | string | Да | Текст сообщения в кодировке UTF-8, закодированный функцией urlencode. Для переноса текста используйте %0A |
| delay | integer | Нет | Интервал между сообщениями в секундах. Допустимые значения: 20, 30, 60 |
| quote_msg_id | integer | Нет | ID сообщения, на которое отвечаем |
При отправке по API нескольких сообщений, они выстраиваются в очередь отправки с интервалом от 3 до 6 сек между сообщениями. Для тестовых аккаунтов есть ограничение - не более 30 отправленных сообщений по API в день.
Ответ при успехе
{"err":0,"msg_id":1234567}Возможные ошибки
| Код ошибки | Описание |
|---|---|
| token fail | Ошибка в токене |
| acc not authorized | Подключение не авторизовано |
| phone fail | Ошибка в номере телефона |
| no WhatsApp on the number | Нет аккаунта с таким номером для WhatsApp |
| no Account on the number | Нет аккаунта с таким номером для других каналов (Telegram...) |
| 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);