Per iniziare
Widget (da incorporare nel tuo sito)
Metti un widget white-label di chat, immagini, voce, musica o video sul tuo sito con un solo tag script, vincolato ai tuoi domini e limitato dai tetti di spesa.
I widget aggiungono al tuo sito un'interfaccia AI white-label con un solo tag script: chat, immagini, voce, musica o video, basata su qualsiasi modello del catalogo. I visitatori non hanno bisogno di una chiave API. Le richieste vengono addebitate al tuo saldo in USD al normale prezzo del modello.
Creare un widget
- Apri Widget e scegli Nuovo widget (oppure progettane uno prima, senza account, nella pagina dei widget).
- Scegli un tipo e un modello, poi imposta titolo, colori, tema, raggio degli angoli, testi e posizione. I widget di chat accettano anche istruzioni private e un limite alla lunghezza delle risposte.
- L'anteprima esegue davvero le impostazioni non ancora salvate, così puoi provare un modello o delle istruzioni prima di salvare. Le richieste dell'anteprima vengono addebitate al tuo saldo.
- Salva, poi copia il codice di incorporamento.
Codice di incorporamento
<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>
Inserisci il tag dentro <body> nel punto in cui deve comparire il widget. Opzioni:
| Attributo | Effetto |
|---|---|
data-widget | Obbligatorio. L'id del widget dalla dashboard. |
data-target | Selettore CSS di un elemento in cui renderizzare, ad esempio #support. Senza di esso il widget viene renderizzato subito prima del tag script. |
data-height | Altezza di un widget inline, ad esempio 520px. Predefiniti: 480px per la chat, 420px per gli altri tipi. |
Il widget viene renderizzato in uno Shadow DOM isolato, quindi gli stili della tua pagina non vi penetrano e il widget non modifica la tua pagina. Con la posizione Pulsante flottante si apre invece da un pulsante nell'angolo in basso.
Siti consentiti
Un widget risponde solo alle richieste provenienti dai siti che elenchi in Impostazioni, Siti dei widget. Un dominio per riga; un dominio copre anche i suoi sottodomini (example.com copre www.example.com). Aggiungi una porta per consentire solo quella porta, ad esempio localhost:3000 per i test in locale. L'anteprima della dashboard funziona sempre.
Una pagina su qualsiasi altro sito riceve 403 site_not_allowed e il widget non viene renderizzato (la console del browser mostra una riga che ne spiega il motivo).
Il controllo usa l'header Origin del browser. I browser non possono modificarlo, ma gli strumenti esterni a un browser sì, quindi considera l'elenco dei siti una restrizione, non un segreto. Sono i controlli di spesa qui sotto a limitare il costo.
Controlli di spesa
Poiché un widget è pubblico, il suo costo è limitato da tetti che solo tu puoi modificare:
| Controllo | Dove | Effetto |
|---|---|---|
| Limite di spesa giornaliero per questo widget | Editor del widget | Quando il widget ha speso questa cifra oggi (UTC), si ferma fino al giorno dopo: 429 widget_daily_limit. |
| Limite di spesa giornaliero per tutti i widget | Impostazioni, Controlli dei widget | Un unico tetto su tutti i widget dell'account. |
| Richieste per visitatore al giorno | Impostazioni, Controlli dei widget | Conteggiate per IP del visitatore, per ogni widget. Predefinito 100: 429 visitor_daily_limit. |
| Richieste per visitatore al minuto | Fisso | 10 al minuto per visitatore: 429 rate_limited. |
| Frequenza del widget | Il tuo piano | Tutti i visitatori di un widget condividono insieme le richieste al minuto del tuo piano. |
Il tuo saldo è il limite finale: a $0 ogni widget restituisce 402 insufficient_balance finché non aggiungi fondi.
Stato e avvisi
L'elenco dei widget mostra quando ciascun widget è stato usato l'ultima volta, la spesa e le richieste di oggi e l'ultimo errore quando un widget fallisce per un motivo che puoi correggere: saldo esaurito, un modello rimosso, un limite di spesa raggiunto o un sito mancante nell'elenco. Con Inviami un'email quando un widget fallisce attivo (Impostazioni, Controlli dei widget) ricevi al massimo un'email per widget al giorno.
Utilizzo mostra le richieste dei widget con il nome del widget e il sito da cui provengono; raggruppa per Per widget o Per sito per confrontarli.
Cosa vedono i visitatori
- Le risposte della chat arrivano in streaming e supportano una formattazione di base (paragrafi, elenchi, grassetto, corsivo, codice e link). La conversazione resta mentre il visitatore si sposta tra le pagine nella stessa scheda.
- Un pulsante Stop interrompe una risposta lunga; dopo un errore un link Riprova rinvia il messaggio.
- Immagini, audio e video sono accompagnati da un link Scarica. Il video viene generato come job in background e compare quando è pronto, di solito entro pochi minuti.
- I visitatori non vedono mai le tue istruzioni, il tuo saldo o l'errore grezzo del modello. Vedono il tuo messaggio di errore (o uno predefinito neutro) e la causa ti viene mostrata nella dashboard.
- I testi che lasci vuoti usano i valori predefiniti nella lingua del tuo account.