Отправка файлов
Данный метод позволяет отправить файл получателю через указанный канал связи. Файл должен быть доступен по публичной ссылке в интернете. Метод удобен для отправки документов, изображений, видео и других типов файлов клиентам без необходимости загружать их непосредственно на сервер WAMM.chat.
GET /api2/file_to/{token}/?phone={phone}&url={url}
Параметры запроса
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
token | string | Да | API-токен, полученный в настройках |
phone | string | Да | Номер телефона в международном формате (например, 79001234567) или ID чата для Telegram |
url | string | Да | Публичная ссылка на файл (доступная из Интернета) |
quote_msg_id | integer | Нет | ID сообщения, на которое отвечаем |
Ответ при успехе
{"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 | Не проверен номер на наличие аккаунта |
url fail | Пустая ссылка или в ней отсутствует http / https |
quote_msg_id fail, not found | Не найдено сообщение для ответа |
Примеры использования
curl -X GET "https://wamm.chat/api2/file_to/YOUR_TOKEN/?phone=79001234567&url=https://example.com/files/document.pdf"
function sendFile($token, $phone, $fileUrl) {
// Подготавливаем URL запроса
$url = "https://wamm.chat/api2/file_to/$token/?phone=$phone&url=" . urlencode($fileUrl);
// Выполняем запрос
$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";
$fileUrl = "https://example.com/files/document.pdf";
sendFile($token, $phone, $fileUrl);