deleteNotification

Удаляет уведомление из очереди канала по его receiptId. Пока уведомление не удалено, receiveNotification отдаёт его снова, а следующие ждут за ним.

Параметры

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

Удалить уведомление 41:

curl

curl -X DELETE "$GRATIO_URL/waInstance$GRATIO_ID/deleteNotification/$GRATIO_TOKEN/41"

Python

import os
import requests

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

url = f"{BASE}/deleteNotification/{TOKEN}/41"
response = requests.delete(url, 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}/deleteNotification/${GRATIO_TOKEN}/41`;
const response = await fetch(url, { method: "DELETE" });
console.log(response.status, await response.json());

PHP

<?php
$base = getenv('GRATIO_URL') . '/waInstance' . getenv('GRATIO_ID');
$url = $base . '/deleteNotification/' . getenv('GRATIO_TOKEN') . '/41';

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'DELETE',
    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:

{"result": true}

Уведомление уже удалено или его нет — тоже 200 OK:

{"result": false, "reason": "notification not found or already deleted"}

Поля ответа

Когда удалять

• После обработки. Сначала сохраните результат, затем удалите. Упали до удаления — уведомление придёт снова, и вы обработаете его ещё раз. Повтор отсекайте по eventId.
• Если обработать не получается. Ошибка в вашем коде на одном уведомлении — сохраните его у себя для разбора и удалите. Иначе очередь встанет.
• Отравленное, которое не нужно возвращать. receiptId из getDeadNotifications тоже подходит: уведомление уйдёт из списка отравленных.

result: false при повторном удалении — не ошибка: уведомление уже подтверждено.

Ошибки

Что дальше

• receiveNotification — забрать следующее уведомление.
• clearWebhooksQueue — подтвердить все уведомления разом.
• Как получать уведомления — очередь, вебхук и подписки.