+
Integrazione · Webhook
Pubblica su qualsiasi sito con un webhook
Nessun connettore nativo per il tuo stack? Howseen invia ogni articolo come un'unica richiesta JSON firmata all'URL che scegli.
Di Raphaël Aubry, fondatore di Howseen AI · Aggiornato il Panoramica
Cosa fa l'integrazione webhook
Ogni volta che un articolo viene pubblicato, Howseen lo invia come POST JSON al tuo URL, così qualsiasi CMS, framework o strumento di automazione può riceverlo.
L'articolo risponde a una domanda del cliente in cui l'AI nomina un concorrente (vedi pilota automatico dei contenuti). Il tuo endpoint decide cosa farne: creare una pagina, aprire una pull request, o passarlo a uno strumento di automazione.
Perché pubblicare? Nel nostro studio su 5.331 risposte AI, ChatGPT non ha mai citato YouTube in 1.164 risposte, affidandosi a siti web: siti di brand, documentazione e pagine di esperti. Una pagina chiara sul tuo sito è ciò che ChatGPT può citare.
Payload
Cosa invia Howseen
Un corpo JSON per articolo con titolo, slug, meta, autore, HTML, Markdown e l'orario di pubblicazione.
{
"title": "...",
"slug": "...",
"meta": "...",
"author": "...",
"html": "...",
"markdown": "...",
"publishedAt": "2026-10-10T09:00:00.000Z"
}- Content-Type: application/json.
- Qualsiasi risposta non 2xx conta come un errore e viene mostrata in Howseen.
Sicurezza
Verifica che la richiesta provenga da Howseen
Aggiungi un segreto di firma quando ti colleghi, e ogni richiesta porta un header X-Howseen-Signature: un HMAC-SHA256 del corpo esatto.
Il tuo endpoint ricalcola l'HMAC del corpo grezzo con lo stesso segreto e lo confronta con il valore dell'header (sha256=<hex>). HMAC è un hash standard con chiave (RFC 2104, HMAC: Keyed-Hashing for Message Authentication). L'URL deve essere pubblico (http o https); gli indirizzi privati vengono rifiutati.
Pubblicare è solo metà del lavoro: AI Overviews e AI Mode possono mostrare solo pagine che Google ha indicizzato (Google Search Central, AI features and your website), e quando appare un riepilogo AI, gli utenti Google cliccano su meno link (Pew Research Center, luglio 2025). Essere la pagina citata nella risposta conta più che essere decimi in classifica.
“I sistemi di classificazione automatizzati di Google sono progettati per dare priorità a informazioni utili e affidabili, create per le persone, e non a contenuti creati per manipolare le classifiche dei motori di ricerca.”
Quale domanda dovresti pubblicare per prima?
La prova gratuita di 3 giorni mostra ogni domanda di acquisto in cui l'AI nomina un concorrente. Annulla in 1 clic.
Piani
Articoli per ogni piano
Il webhook funziona su ogni piano, Starter, Pro e Business, con la quota di articoli del tuo piano e la prova di 3 giorni inclusa.
Articoli ogni 30 giorni
Da 4 a 30
Starter 4, Pro 15 per brand, Business 30
Firma
HMAC-SHA256
opzionale, consigliato
Formato
JSON
HTML + Markdown
Preferisci recuperare i dati? Usa il feed JSON per Next.js e siti headless. Quote nella pagina prezzi.
Domande, risposte
Quali strumenti possono ricevere il webhook?+
Qualsiasi cosa accetti un POST HTTPS con un corpo JSON: la tua API, una funzione serverless, o uno strumento di automazione.
La richiesta è firmata?+
Sì, se imposti un segreto di firma quando ti colleghi. L'header X-Howseen-Signature contiene sha256= seguito dall'HMAC-SHA256 del corpo grezzo.
Ricevo Markdown o HTML?+
Entrambi, nella stessa richiesta: usa quello che il tuo sito si aspetta.
Cosa succede se il mio endpoint non risponde?+
La pubblicazione fallisce, l'errore viene mostrato in Howseen, e puoi riprovare. Una firma o credenziali rifiutate (401/403) interrompono i tentativi automatici finché non ti riconnetti.
Invia la risposta che l'AI sta cercando al tuo sito
Attiva una prova gratuita di 3 giorni per trovare le domande che stai perdendo, poi lascia che Howseen la scriva e la invii al tuo stack.
