API Chatbot IA
Crea le tue integrazioni di chatbot IA con la nostra API REST. Invia messaggi e ricevi risposte IA intelligenti per qualsiasi piattaforma, applicazione o soluzione su misura.
Costruisci qualsiasi cosa con l'IA
La nostra API REST ti permette di integrare le funzioni di chatbot IA in qualsiasi applicazione
curl -X POST https://asyntai.com/api/v1/chat/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "Quali sono i vostri orari?"}'
API REST semplice
Un unico endpoint per inviare messaggi e ricevere risposte IA. Usa cURL, Python, JavaScript o qualsiasi linguaggio in grado di fare richieste HTTP. Nessun SDK complesso.
{
"success": true,
"response": "Siamo aperti dal lunedì al venerdì,
dalle 9 alle 18. Come posso aiutarla?",
"session_id": "abc123"
}
Risposte intelligenti
L'IA conosce a fondo la tua attività. Si basa sul tuo sito, sui tuoi documenti e sulle tue istruzioni per dare risposte precise e adatte a ogni domanda.
{
"message": "Qual era la mia ultima domanda?",
"session_id": "user_12345"
}
# L'IA ricorda la conversazione
Memoria della conversazione
Usa gli identificatori di sessione per mantenere il contesto. L'IA ricorda i messaggi precedenti e risponde in modo coerente su più scambi.
Pensata per gli sviluppatori
Tutto ciò che serve per integrare le funzioni di chatbot IA nelle tue applicazioni
Design RESTful
Un'API REST chiara e intuitiva che segue le buone pratiche. Facile da capire, da integrare e da mantenere.
Autenticazione semplice
Autenticazione sicura con chiave API. Metti la chiave nell'intestazione e puoi iniziare a fare richieste.
Tempi di risposta rapidi
Ottimizzata per la velocità. Risposte IA in millisecondi, non in secondi.
Gestione delle sessioni
Tracciamento delle conversazioni integrato con identificatori di sessione. Mantieni il contesto su più messaggi senza sforzo.
Multilingue
L'IA riconosce la lingua dell'utente e risponde in quella lingua. Servi un pubblico internazionale senza lavoro extra.
Sicura e affidabile
Cifratura HTTPS, limite di frequenza e 99,9 % di disponibilità. La tua integrazione è sicura e sempre raggiungibile.
Come funziona
Inizia con l'API Chatbot IA in tre semplici passi
Registrati e ottieni la chiave API
Crea il tuo account e genera la chiave API dalla dashboard. La tua IA userà automaticamente i contenuti del tuo sito.
Invia la prima richiesta
Invia una richiesta POST con il tuo messaggio al nostro endpoint di chat. L'IA la elabora e restituisce una risposta intelligente.
Integra ovunque
Usa l'API nella tua app mobile, sul tuo sito, negli strumenti interni o su qualsiasi piattaforma su misura. Le possibilità sono aperte.
Casi d'uso
L'API Chatbot IA è versatile e può alimentare il supporto IA su qualsiasi piattaforma o applicazione tu immagini.
- ✓ App mobili (iOS, Android, React Native)
- ✓ Applicazioni web su misura
- ✓ Strumenti di supporto interni
- ✓ Assistenti vocali e sistemi IVR
- ✓ Bot Slack, bot Discord e altro
import requests
response = requests.post(
"https://asyntai.com/api/v1/chat/",
headers={"Authorization": "Bearer API_KEY"},
json={"message": "Ciao!"}
)
print(response.json()["response"])
Perché scegliere la nostra API
Crea integrazioni di chatbot IA potenti con il minimo sforzo
Rilascia prima
Risparmia mesi di sviluppo IA. Integra la nostra API e avrai funzioni di chatbot intelligente nella tua app già oggi.
Sempre aggiornata
Aggiorna le conoscenze della tua IA quando vuoi dalla dashboard. Non servono modifiche all'API quando la tua attività cambia.
Conveniente
Paghi solo ciò che usi. Nessun costo di infrastruttura, nessun costo di addestramento IA, nessun onere di manutenzione.
Domande frequenti
Tutto quello che c'è da sapere sull'API Chatbot IA
La tua prima richiesta
Un solo POST restituisce una risposta IA basata sulla tua base di conoscenza. Nessun SDK da installare.
curl -X POST https://asyntai.com/api/v1/chat/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "Spedite in Italia?"}'
# 200 OK
{
"success": true,
"response": "Sì, spediamo in Italia in 3-5 giorni.",
"session_id": "api_1042_87"
}
Prima della prima chiamata, aggiungi contenuti alla tua base di conoscenza. L'API risponde partendo dalla tua documentazione, dai tuoi prezzi e dalle tue condizioni. Con una base vuota le risposte restano generiche.
Autenticazione
Ogni richiesta porta la chiave API in un'intestazione. Sono accettate due forme di intestazione, con lo stesso comportamento. Scegline una. Genera la chiave in Impostazioni → API.
Solo intestazioni. La chiave non viene mai letta dalla stringa di query. Una chiave in un URL finisce nei log del server, nei log del proxy, nella cronologia del browser e nelle intestazioni Referer. Per questo il metodo non è supportato.
# Opzione A - token bearer
Authorization: Bearer YOUR_API_KEY
# Opzione B - intestazione dedicata
X-API-Key: YOUR_API_KEY
L'endpoint di chat
POST https://asyntai.com/api/v1/chat/
Corpo della richiesta
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
message | string | obbligatorio | Il messaggio dell'utente. Un valore vuoto restituisce un errore 400. |
session_id | string | facoltativo | Il tuo identificatore per una conversazione. Rinvia lo stesso valore per mantenere il contesto. Se lo ometti, l'account usa un'unica sessione condivisa. |
website_id | integer | facoltativo | Quale dei tuoi agenti deve rispondere. Se lo ometti, viene usato il sito principale, altrimenti il primo dell'account. |
Corpo della risposta
| Campo | Tipo | Descrizione |
|---|---|---|
success | boolean | true quando l'IA ha prodotto una risposta. |
response | string | Il testo della risposta. |
session_id | string | La sessione con cui è stato registrato questo messaggio. Rinviala alla chiamata successiva. |
Memoria della conversazione
Passa un session_id stabile e gli ultimi 10 messaggi di quella conversazione vengono forniti come contesto, così una domanda di seguito come "e quanto costa?" viene capita. Usa un session_id diverso per ogni utente finale. Se lo ometti, tutte le chiamate dell'account condividono un solo filo, cosa quasi mai desiderabile in produzione.
// prima chiamata
{ "message": "Spedite in Italia?", "session_id": "user-8842" }
// seconda chiamata - stesso session_id, quindi "quello" viene capito
{ "message": "Quanto costa?", "session_id": "user-8842" }
Esempi di integrazione
Copia, incolla, sostituisci la chiave.
const res = await fetch('https://asyntai.com/api/v1/chat/', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'Spedite in Italia?',
session_id: 'user-8842'
})
});
const data = await res.json();
if (!data.success) throw new Error(data.error);
console.log(data.response);
// Non esporre mai la chiave API nel codice del browser. Chiama questo dal
// tuo server o da una funzione edge e inoltra il risultato.
import requests
resp = requests.post(
"https://asyntai.com/api/v1/chat/",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"message": "Spedite in Italia?",
"session_id": "user-8842",
},
timeout=30,
)
data = resp.json()
if not data["success"]:
raise RuntimeError(data["error"])
print(data["response"])
$ch = curl_init('https://asyntai.com/api/v1/chat/');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'message' => 'Spedite in Italia?',
'session_id' => 'user-8842',
]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
if (empty($data['success'])) {
throw new Exception($data['error']);
}
echo $data['response'];
const ASYNTAI_KEY = process.env.ASYNTAI_API_KEY;
export async function ask(message, sessionId) {
const res = await fetch('https://asyntai.com/api/v1/chat/', {
method: 'POST',
headers: {
'X-API-Key': ASYNTAI_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({ message, session_id: sessionId })
});
if (res.status === 429) throw new Error('Limite mensile di messaggi raggiunto');
const data = await res.json();
if (!data.success) throw new Error(data.error);
return data.response;
}
curl -X POST https://asyntai.com/api/v1/chat/ \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"message": "Spedite in Italia?",
"session_id": "user-8842"
}'
Risposte di errore
Ogni errore restituisce {"success": false, "error": "..."} con uno di questi codici di stato.
| Status | Significato | Cosa fare |
|---|---|---|
400 | Corpo JSON non valido, message mancante, oppure un website_id che non appartiene al tuo account. | Correggi i dati inviati. Il testo di error indica il problema. |
401 | Chiave API assente, o la chiave non corrisponde a nessun account. | Controlla il nome dell'intestazione e se la chiave è stata rigenerata. |
403 | L'account usa il piano Free. L'accesso all'API richiede Starter, Standard o Pro. | Cambia piano. |
429 | Limite mensile di messaggi raggiunto. Il corpo contiene anche "limit_reached": true. | Rallenta e cambia piano, oppure attendi il periodo di fatturazione successivo. |
503 | Il servizio IA non è riuscito a rispondere a questa richiesta. | Riprova dopo un'attesa. L'errore è temporaneo. |
Controlla success, non solo il codice di stato. Gestisci il 429 in modo esplicito se invii molte richieste, altrimenti un limite raggiunto sembra un guasto qualsiasi ai tuoi utenti.
Riferimento completo degli endpoint
URL di base https://asyntai.com/api/v1/. Tutti gli endpoint usano la stessa autenticazione.
Chat
| Metodo | Percorso | Scopo |
|---|---|---|
| POST | /chat/ | Invia un messaggio e ricevi una risposta IA. |
Siti e agenti
| Metodo | Percorso | Scopo |
|---|---|---|
| GETPOST | /websites/ | Elenca i tuoi agenti, oppure creane uno e avvia la scansione. |
| GET | /websites/{id}/ | Dettagli di un agente. |
| GETPATCH | /websites/{id}/settings/ | Leggi o modifica le impostazioni del widget. |
| GETPUT | /websites/{id}/instructions/ | Leggi o sostituisci le istruzioni dell'IA. |
Base di conoscenza
| Metodo | Percorso | Scopo |
|---|---|---|
| GET | /knowledge/ | Elenca tutto ciò su cui l'IA può basarsi. |
| POST | /knowledge/text/ | Aggiungi testo semplice. |
| POST | /knowledge/url/ | Aggiungi una pagina tramite URL. |
| POST | /knowledge/spreadsheet/ | Aggiungi un foglio di calcolo. |
| GETDELETE | /knowledge/{context_id}/ | Leggi o rimuovi un elemento. |
| POSTPUT | /knowledge/{context_id}/tags/ | Gestisci le etichette di un elemento. |
Conversazioni e dati
| Metodo | Percorso | Scopo |
|---|---|---|
| GET | /conversations/ | Conversazioni passate. |
| GET | /sessions/ | Sessioni con il numero di messaggi. |
| GET | /leads/ | Contatti raccolti dal chatbot. |
| GET | /account/ | Piano, utilizzo e limiti. |
Webhooks
| Metodo | Percorso | Scopo |
|---|---|---|
| GETPOST | /webhooks/ | Elenca o registra un webhook. |
| DELETE | /webhooks/{webhook_id}/ | Rimuovi un webhook. |
Requisiti e limiti
| Voce | Dettaglio |
|---|---|
| Piano | L'accesso all'API richiede un piano a pagamento: Starter, Standard o Pro. Gli account Free ricevono un errore 403. |
| Quota di messaggi | I messaggi dell'API rientrano nella stessa quota mensile delle conversazioni del widget. Controlla il valore attuale con GET /api/v1/account/. |
| Profondità della cronologia | Vengono forniti come contesto fino a 10 messaggi precedenti per session_id. |
| Trasporto | Solo HTTPS. Corpi di richiesta e risposta in JSON. |
| Rotazione della chiave | Rigenera la chiave in Impostazioni → API. La chiave precedente smette subito di funzionare. |
Pronto a costruire con l'IA?
Crea un account gratuito e prova il chatbot nella dashboard. Poi scegli un piano a pagamento per ottenere la chiave API.