7x24hrs Cosa ti serve
- Un sito configurato da noi, con un piano a pagamento (Base, Standard, Élite o Enterprise). Se non l'hai ancora fatto, registrati con la tua e-mail e inserisci l'indirizzo del tuo sito.
- Una chiave API: nella dashboard apri App di chat e API, dai un nome alla chiave (ad esempio “AstrBot”) e premi Crea chiave API. Copiala subito: viene mostrata solo quella volta.
- AstrBot (o un altro strumento) in funzione e collegato alla tua app di chat. La documentazione di AstrBot spiega come installarlo e collegare Discord, Telegram, Slack, WeChat o QQ.
Questi sono i tre valori che ogni strumento ti chiede:
API Base URL: https://7x24hrs.com/v1
API Key: sk-7x24-…
Model: 7x24hrs-assistantConfigurazione in AstrBot
- Apri la dashboard di AstrBot e vai su Providers. Nella scheda Chat Completion, premi + Add accanto a Provider Sources.
- In New model provider, scegli OpenAI Compatible.
- Assegna un ID facile da riconoscere, come
7x24hrs. Incolla la tua chiave in API Key e imposta API Base URL suhttps://7x24hrs.com/v1. - Premi Save And Fetch Models. In Available Models, premi + accanto a
7x24hrs-assistant. Nella finestra che si apre, lascia selezionato solo Text in Model capabilities (deseleziona Image, Audio e Tool use: l'assistente risponde con il testo) e premi Save. - Rendilo il modello usato dal tuo bot: in Config, sceglilo come modello di chat predefinito (oppure sceglilo per una sola conversazione con il selettore del modello in Chat).
- Fai una domanda nella pagina Chat di AstrBot o nell'app di chat collegata. La risposta arriva dai dati del tuo sito.
Lascia vuoti la persona e il prompt di sistema di AstrBot, o tienili brevi: il tuo assistente segue le regole e il personaggio impostati nella dashboard di 7x24hrs e non prende istruzioni dal prompt di sistema dell'app di chat.
Dify, LobeChat e altri strumenti
Qualsiasi strumento con un provider “compatibile con OpenAI” o “OpenAI personalizzato” funziona allo stesso modo: Base URL https://7x24hrs.com/v1, la tua chiave API e il modello 7x24hrs-assistant.
- Dify: in Settings → Model Provider, aggiungi OpenAI-API-compatible, inserisci il nome del modello, la tua chiave e la Base URL come endpoint dell'API, poi usa il modello nella tua app.
- LobeChat: nelle impostazioni, alla voce dei modelli linguistici, attiva il provider OpenAI, inserisci la tua chiave e imposta come indirizzo proxy dell'API la Base URL, poi aggiungi
7x24hrs-assistantall'elenco dei modelli. - Il tuo codice: chiama l'API con qualsiasi libreria client OpenAI, impostando la base URL e la chiave.
Per provare l'API da un terminale:
curl https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "user": "visitor-42",
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Con "stream": true la risposta arriva come server-sent events, come con OpenAI:
curl -N https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "stream": true,
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'Come funzionano le risposte nelle app di chat
| Pulsante della chat sul tuo sito | App di chat tramite l'API | |
|---|---|---|
| Risponde in base a | Dati del tuo sito, risposte standard e personaggio | Gli stessi |
| Quando non è sicuro | Lo dice e passa il visitatore a te | Lo dice e indica nella risposta il tuo indirizzo di contatto |
| Ricevi la notifica | Via e-mail, Slack, Discord o Telegram | Allo stesso modo, con la dicitura “tramite API / AstrBot” |
| Rispondere tu al visitatore | Dalla tua app di chat o dalla dashboard | Non è possibile da qui: rispondi via e-mail |
| Conversazioni conteggiate | Una per visitatore e conversazione | Allo stesso modo, dalla stessa quota mensile |
Quali piani includono le app di chat?
Tutti i piani a pagamento: Base a $19 al mese per 90 conversazioni, Standard a $59 per 275, Élite a $199 per 1.000 e Enterprise a $1,099 per 6.000. Le conversazioni tramite l'API rientrano nella stessa quota mensile del pulsante della chat. Il piano gratuito non include le app di chat: le chiavi create con questo piano restano in pausa finché non scegli un piano a pagamento. Vedi i prezzi.
Che cosa conta come conversazione?
Un visitatore che chatta, a prescindere da quante domande faccia, esattamente come con il pulsante della chat. Gli strumenti che inviano un campo user con ogni richiesta ci permettono di distinguere i visitatori; altrimenti una conversazione viene riconosciuta dal suo primo messaggio.
Un prompt di sistema in AstrBot può cambiare ciò che dice l'assistente?
No. I prompt di sistema inviati dall'app di chat non vengono seguiti. L'assistente rispetta le tue regole: risponde solo in base ai dati del tuo sito, dice quando non sa una cosa e non promette nulla che il tuo sito non dica. Il suo personaggio è quello che hai impostato nella dashboard.
Sono supportati immagini, messaggi vocali o chiamate a strumenti?
Non ancora. Si risponde al testo; immagini e altri allegati vengono esclusi dal messaggio, e un messaggio senza testo riceve un errore chiaro. Le definizioni di strumenti inviate dal client vengono ignorate.
E se una chiave finisce in mani sbagliate?
Revocala in App di chat e API: smette subito di funzionare. Poi creane una nuova e incollala nel tuo strumento. Le chiavi sono conservate solo come impronta, quindi nemmeno noi possiamo mostrartene una di nuovo.