sendFileByUpload

Отправляет файл, который лежит у вашего приложения, одним запросом multipart/form-data. Картинка уходит фото, видео — видео, OGG/Opus в Telegram и WhatsApp — голосовым, остальное — документом.

Параметры

Пример запроса

Расписание в PDF по номеру телефона, с подписью и ключом от дублей:

curl

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/sendFileByUpload/$GRATIO_TOKEN" \
  -F 'chatId=79991234567@c.us' \
  -F 'caption=Расписание на ноябрь' \
  -F 'clientMessageId=schedule-nov-79991234567' \
  -F 'file=@schedule.pdf;type=application/pdf'

Python

import os
import requests

BASE = f"{os.environ['GRATIO_URL']}/waInstance{os.environ['GRATIO_ID']}"
TOKEN = os.environ["GRATIO_TOKEN"]

url = f"{BASE}/sendFileByUpload/{TOKEN}"
fields = {
    "chatId": "79991234567@c.us",
    "caption": "Расписание на ноябрь",
    "clientMessageId": "schedule-nov-79991234567",
}
with open("schedule.pdf", "rb") as f:
    files = {"file": ("schedule.pdf", f, "application/pdf")}
    response = requests.post(url, data=fields, files=files, timeout=120)
print(response.status_code, response.json())

Node.js

import { readFile } from "node:fs/promises";
const { GRATIO_URL, GRATIO_ID, GRATIO_TOKEN } = process.env;
const base = `${GRATIO_URL}/waInstance${GRATIO_ID}`;

const url = `${base}/sendFileByUpload/${GRATIO_TOKEN}`;
const form = new FormData();
form.append("chatId", "79991234567@c.us");
form.append("caption", "Расписание на ноябрь");
form.append("clientMessageId", "schedule-nov-79991234567");
const file = new Blob([await readFile("schedule.pdf")], { type: "application/pdf" });
form.append("file", file, "schedule.pdf");
const response = await fetch(url, { method: "POST", body: form });
console.log(response.status, await response.json());

PHP

<?php
$base = getenv('GRATIO_URL') . '/waInstance' . getenv('GRATIO_ID');
$url = $base . '/sendFileByUpload/' . getenv('GRATIO_TOKEN');
$form = [
    'chatId' => '79991234567@c.us',
    'caption' => 'Расписание на ноябрь',
    'clientMessageId' => 'schedule-nov-79991234567',
    'file' => new CURLFile('schedule.pdf', 'application/pdf', 'schedule.pdf'),
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 120,
]);
$response = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($response);

Пример ответа

Ответ 200 OK:

{
  "idMessage": "117428956522361912",
  "urlFile": "https://api.gratio.net/media/7100000001/8695836/117428956522361912/0/d8f9…"
}

Поля ответа

После отправки приходят outgoingAPIMessageReceived с fileMessageData и статус outgoingMessageStatus sent.

Ещё примеры

Голосовое

Файл OGG/Opus в Telegram и WhatsApp уходит голосовым сообщением с длительностью, как из приложения:

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/sendFileByUpload/$GRATIO_TOKEN" \
  -F 'chatId=79991234567@c.us' \
  -F 'file=@answer.ogg;type=audio/ogg'

Фото с ответом цитатой

Фото в MAX — ответ на вопрос собеседника:

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/sendFileByUpload/$GRATIO_TOKEN" \
  -F 'chatId=8695836' \
  -F 'caption=Вот схема проезда' \
  -F 'quotedMessageId=117428955282341903' \
  -F 'file=@map.jpg;type=image/jpeg'

Ошибки

Общие правила — в статье Ответы и ошибки.

Особенности каналов

Как уходит файл:

• Тип картинки Gratio определяет по содержимому, а не по имени файла.
• MAX. Не принял картинку как фото или видео как видео — файл уходит документом. Перед отправкой Gratio отмечает прочитанными сообщения собеседника, пришедшие до неё.
• WhatsApp. У аудио нет подписи: caption не уйдёт. Цитировать можно сообщения, которые канал видел с момента привязки.
• Почта. Письмо с файлом во вложении, caption — текст письма. Письмо целиком — до 20 МБ, больше — 400 too_large.

Что дальше

• sendFileByUrl — отправить файл по ссылке.
• uploadFile — загрузить файл один раз и отправлять многим.
• Файлы и альбомы — как приходят файлы собеседника.