Удаляет истории аккаунта канала — из активных, «Публикаций» и архива.
| Запрос | POST /waInstance{idInstance}/deleteStory/{apiTokenInstance} |
| Тело | JSON |
| Каналы | Telegram |
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
storyIds |
array или string | да | id своих историй — массивом или через запятую. Одну можно передать в storyId |
Пример запроса
Удалить две истории:
curl
curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/deleteStory/$GRATIO_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"storyIds": ["2", "3"]}'
Python
import os
import requests
BASE = f"{os.environ['GRATIO_URL']}/waInstance{os.environ['GRATIO_ID']}"
TOKEN = os.environ["GRATIO_TOKEN"]
url = f"{BASE}/deleteStory/{TOKEN}"
payload = {"storyIds": ["2", "3"]}
response = requests.post(url, json=payload, timeout=60)
print(response.status_code, response.json())
Node.js
const { GRATIO_URL, GRATIO_ID, GRATIO_TOKEN } = process.env;
const base = `${GRATIO_URL}/waInstance${GRATIO_ID}`;
const url = `${base}/deleteStory/${GRATIO_TOKEN}`;
const payload = { storyIds: ["2", "3"] };
const response = await fetch(url, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(payload),
});
console.log(response.status, await response.json());
PHP
<?php
$base = getenv('GRATIO_URL') . '/waInstance' . getenv('GRATIO_ID');
$url = $base . '/deleteStory/' . getenv('GRATIO_TOKEN');
$payload = ['storyIds' => ['2', '3']];
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 60,
]);
$response = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($response);
Пример ответа
Ответ 200 OK:
{"deleteStory": true}
Telegram отказал — тоже 200, с false и причиной в reason:
{"deleteStory": false, "reason": "bad_message: Неверный id: в Telegram это число"}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
deleteStory |
boolean | true — истории удалены |
reason |
string | только при false: код и текст причины |
Ещё примеры
Одну историю
curl -X POST "$GRATIO_URL/waInstance$GRATIO_ID/deleteStory/$GRATIO_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"storyId": "2"}'
Ошибки
| Код | code |
Когда | Что делать |
|---|---|---|---|
400 |
validation |
нет ни storyIds, ни storyId |
добавить поле |
400 |
not_authorized |
канал не на связи | проверить getStateInstance |
501 |
not_supported |
MAX, WhatsApp или почта | — |
Что дальше
- getStories — свои истории и их id.
- sendStory — опубликовать новую.
- Истории Telegram — правила.
