sendStory

Публикует историю от имени аккаунта канала. Gratio сам истории не выкладывает — только по этому вызову. Аудитория по умолчанию — контакты.

Параметры

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

Фото дня открытых дверей для контактов на сутки:

curl

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/sendStory/$GRATIO_TOKEN" \
  -F 'caption=День открытых дверей в субботу, 11:00' \
  -F 'audience=contacts' \
  -F 'periodHours=24' \
  -F 'clientMessageId=story-open-day' \
  -F 'file=@open-day.jpg;type=image/jpeg'

Python

import os
import requests

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

url = f"{BASE}/sendStory/{TOKEN}"
fields = {
    "caption": "День открытых дверей в субботу, 11:00",
    "audience": "contacts",
    "periodHours": "24",
    "clientMessageId": "story-open-day",
}
with open("open-day.jpg", "rb") as f:
    files = {"file": ("open-day.jpg", f, "image/jpeg")}
    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}/sendStory/${GRATIO_TOKEN}`;
const form = new FormData();
form.append("caption", "День открытых дверей в субботу, 11:00");
form.append("audience", "contacts");
form.append("periodHours", "24");
form.append("clientMessageId", "story-open-day");
const file = new Blob([await readFile("open-day.jpg")], { type: "image/jpeg" });
form.append("file", file, "open-day.jpg");
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 . '/sendStory/' . getenv('GRATIO_TOKEN');
$form = [
    'caption' => 'День открытых дверей в субботу, 11:00',
    'audience' => 'contacts',
    'periodHours' => '24',
    'clientMessageId' => 'story-open-day',
    'file' => new CURLFile('open-day.jpg', 'image/jpeg', 'open-day.jpg'),
];

$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 — опубликованная история:

{
  "storyId": "2",
  "chatId": "8600000001",
  "date": 1791823658,
  "expiresAt": 1791910058,
  "caption": "День открытых дверей в субботу, 11:00",
  "media": "photo",
  "pinned": false,
  "isSelf": true,
  "urlFile": "https://api.gratio.net/media/7100000001/8600000001/story-2/0/9b2e…",
  "audience": "contacts",
  "views": 0,
  "reactions": 0
}

Поля ответа

Остальные поля — в статье Истории Telegram.

Ещё примеры

Видео по ссылке — выбранным

Тело — JSON. История видна только Марии и Олегу:

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/sendStory/$GRATIO_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "urlFile": "https://example.ru/files/robot-demo.mp4",
    "caption": "Робот проходит лабиринт",
    "audience": "selected",
    "allowChatIds": [
      "8617393401",
      "8600000002"
    ],
    "clientMessageId": "story-robot-demo"
  }'

Сразу в профиль

curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/sendStory/$GRATIO_TOKEN" \
  -F 'caption=Расписание на осень' \
  -F 'pinToProfile=true' \
  -F 'file=@schedule.png;type=image/png'

Ошибки

Что дальше

• getStoryViews — кто посмотрел.
• pinStory — оставить историю в профиле.
• Истории Telegram — правила, аудитория и лимиты.