Sviluppatori

Webhooks

Ricevi una callback HTTP con JSON in chiaro appena un articolo è pronto e ogni volta che cambia stato.

Eventi

Due eventi, ciascuno attivato in una fase precisa della pipeline delle campagne.

article.readyAl termine della scrittura

Inviato quando un articolo è stato scritto e supera la revisione automatica: il segnale per pubblicarlo.

article.status_changedAl cambio di stato

Inviato quando lo stato di un articolo cambia in TrafficWins, ad esempio quando lo pubblichi o lo archivi.

Payload

Ogni evento invia questo corpo JSON tramite POST. Entrambi gli eventi hanno la stessa struttura.

{
  "event": "article.ready",
  "orgId": "org_8c2f1a…",
  "timestamp": "2026-06-15T12:34:56.000Z",
  "article": {
    "id": "art_3b9a7d…",
    "campaignId": "cmp_71d4e0…",
    "title": "How to Choose a Standing Desk",
    "slug": "how-to-choose-a-standing-desk",
    "status": "draft",
    "description": "A practical buyer's guide to height, stability, and budget.",
    "content": "<h1>How to Choose a Standing Desk</h1><p>…</p>",
    "keywords": ["standing desk", "ergonomics"],
    "wordCount": 1840,
    "reviewScore": 92,
    "reviewVerdict": "pass",
    "heroImageUrl": "https://cdn.trafficwins.com/articles/3b9a/hero.png",
    "heroImageAlt": "A height-adjustable standing desk in a bright office",
    "updatedAt": "2026-06-15T12:34:55.000Z"
  }
}

Intestazioni richiesta

TrafficWins invia JSON in chiaro via HTTPS con queste intestazioni.

POST /your-endpoint  HTTP/1.1
Content-Type: application/json
User-Agent: TrafficWins-Webhooks/1.0

Configuralo

Aggiungi l’URL del tuo endpoint in TrafficWins, nelle impostazioni di pubblicazione del sito. Invieremo ogni evento come JSON in chiaro.

Apri TrafficWins

Inizia con un solo sito

Indicalo al tuo sito. Leggi le prime bozze domani.

Crea un account, collega un sito e lascia che TrafficWins ricerchi, pianifichi, scriva e revisioni la tua prima campagna — senza carta di credito, senza chiavi API.

Inizia la prova gratuita

Prova di 3 giorni · 5 crediti articolo · disdici quando vuoi