API Cronologia messaggi

Ottieni l'elenco dei messaggi del tuo spazio di lavoro in un intervallo di date, con lo stato di ciascuno. Usala per riconciliare ciò che è stato inviato, creare report o trovare i messaggi non riusciti da reinviare.

La cronologia comprende tutti i messaggi dello spazio di lavoro della tua chiave API, che siano stati inviati tramite l'API, la dashboard o una campagna. I risultati arrivano 200 per pagina, dal più vecchio. Gli stessi dati sono disponibili nella pagina Report.

Esempio rapido#

curl -X POST https://wbiztool.com/api/v1/report/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "start_date": "01-09-2026",
    "end_date": "08-09-2026",
    "page": 1
  }'

import requests

page = 1
history = []

while True:
    response = requests.post(
        "https://wbiztool.com/api/v1/report/",
        json={
            "client_id": 12345,
            "api_key": "YOUR_API_KEY",
            "start_date": "01-09-2026",
            "end_date": "08-09-2026",
            "page": page,  # must be a JSON number, not a string
        },
        timeout=60,
    )
    result = response.json()  # read the body even when the HTTP code is 400

    if result.get("message") != "Success" or "total" not in result:
        print("Failed:", result.get("message", "no message in response"))
        break

    history.extend(result["history"])
    if page * 200 >= result["total"]:
        break
    page += 1

failed = [m for m in history if m["message_status"] == "Failed"]
print(len(history), "messages,", len(failed), "failed")

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const history = [];
let page = 1;

while (true) {
  const response = await fetch("https://wbiztool.com/api/v1/report/", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      client_id: 12345,
      api_key: "YOUR_API_KEY",
      start_date: "01-09-2026",
      end_date: "08-09-2026",
      page, // must be a JSON number, not a string
    }),
  });
  const result = await response.json(); // read the body even when the HTTP code is 400

  if (result.message !== "Success" || !("total" in result)) {
    console.error("Failed:", result.message ?? "no message in response");
    break;
  }

  history.push(...result.history);
  if (page * 200 >= result.total) break;
  page += 1;
}

const failed = history.filter((m) => m.message_status === "Failed");
console.log(`${history.length} messages, ${failed.length} failed`);

<?php
$history = [];
$page = 1;

do {
    $ch = curl_init('https://wbiztool.com/api/v1/report/');
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
        CURLOPT_POSTFIELDS     => json_encode([
            'client_id'  => 12345,
            'api_key'    => 'YOUR_API_KEY',
            'start_date' => '01-09-2026',
            'end_date'   => '08-09-2026',
            'page'       => $page, // an integer, so json_encode sends a number
        ]),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 60,
    ]);
    $result = json_decode(curl_exec($ch), true);
    curl_close($ch);

    if (($result['message'] ?? '') !== 'Success' || !isset($result['total'])) {
        echo 'Failed: ' . ($result['message'] ?? 'no message in response');
        break;
    }

    $history = array_merge($history, $result['history']);
    $page++;
} while (($page - 1) * 200 < $result['total']);

echo count($history) . ' messages';

Sostituisci 12345 e YOUR_API_KEY con i tuoi valori. Consulta Autenticazione per sapere dove trovarli.

Parametri della richiesta#

Intervallo di date#

Le date vengono interpretate come la mezzanotte all'inizio di quel giorno nell'ora standard indiana (IST, UTC+5:30), e i messaggi vengono selezionati in base a quando sono stati creati (messi in coda o pianificati), non a quando sono stati inviati. L'intervallo va da start_date 00:00 fino a end_date 00:00, quindi:

• "start_date": "01-09-2026", "end_date": "08-09-2026" restituisce i messaggi dall'1 al 7 settembre. L'8 settembre non è incluso.
• Per ottenere un solo giorno, imposta end_date sul giorno successivo: "start_date": "15-09-2026", "end_date": "16-09-2026".
• Se le due date coincidono, non ottieni alcun messaggio.

Paginazione#

Ogni risposta contiene total, il numero di messaggi dell'intero intervallo, e fino a 200 di questi in history. Richiedi page 2, 3 e così via finché page × 200 non è almeno pari a total.

Risposta#

Una richiesta riuscita restituisce HTTP 200:

{
  "message": "Success",
  "status": 0,
  "total": 3,
  "history": [
    { "id": 9817263, "msg_type": "Text", "contact": "919876543210", "message_status": "Sent" },
    { "id": 9817264, "msg_type": "File", "contact": "919812345670", "message_status": "Failed" },
    { "id": 9817265, "msg_type": "Image", "contact": "Sales Team Mumbai", "message_status": "Pending" }
  ]
}

Valori di stato dei messaggi#

Al momento le spunte di consegna e di lettura non vengono registrate, quindi i messaggi inviati risultano sempre Sent. Delivered e Read sono valori riservati; se dovessero comparire, considerali come Sent.

Errori#

Gli errori restituiscono HTTP 200 con status impostato su 0, salvo dove indicato:

{ "message": "Error", "status": 0, "history": [] }

Suggerimenti#

• Recupera la cronologia a piccoli intervalli: un giorno o una settimana alla volta mantengono basso il numero di pagine.
• Trova i messaggi non riusciti: filtra history per Failed, poi chiama Stato del messaggio con ogni id per vedere perché non è riuscito. Prima di riprovare, controlla l'error: Sending was interrupted and may have been delivered… significa che il destinatario potrebbe avere già il messaggio.
• I messaggi vecchi vengono eliminati: i messaggi che hanno raggiunto uno stato finale e non sono cambiati per circa 90 giorni possono essere eliminati e non comparire più qui, così come i messaggi ancora in coda 90 giorni dopo la creazione o la pianificazione, su un numero disconnesso o eliminato.
• Monitoraggio in tempo reale: per reagire quando i messaggi vengono inviati, passa un webhook quando invii il messaggio invece di interrogare periodicamente questo endpoint.