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.

Ottieni la chiave API Vedi i prezzi

Costruisci qualsiasi cosa con l'IA

La nostra API REST ti permette di integrare le funzioni di chatbot IA in qualsiasi applicazione

# Invia un messaggio all'IA
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.

# Risposta dell'IA
{
  "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.

# Conversazione con contesto
{
  "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.

Pronto a sviluppare con l'API Chatbot IA?

Prova il chatbot gratis con 100 messaggi. L'accesso all'API richiede un piano a pagamento.

Ottieni la tua chiave API

Come funziona

Inizia con l'API Chatbot IA in tre semplici passi

1

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.

2

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.

3

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.

Vedi la documentazione dell'API

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
# Esempio in Python
import requests

response = requests.post(
  "https://asyntai.com/api/v1/chat/",
  headers={"Authorization": "Bearer API_KEY"},
  json={"message": "Ciao!"}
)

print(response.json()["response"])

Prezzi semplici e chiari

Il piano Free include 100 messaggi di prova nella dashboard. L'accesso all'API parte da Starter.

Free
$0
per sempre
100 messaggi
Inizia
Starter
$39
al mese
2.500 messaggi
Inizia
Pro
$449
al mese
50.000 messaggi
Inizia

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.

Inizia oggi stesso

L'accesso all'API richiede Starter, Standard o Pro. Crea prima un account gratuito per provare il chatbot.

Ottieni la tua chiave API

Domande frequenti

Tutto quello che c'è da sapere sull'API Chatbot IA

Come inizio a usare l'API?
Clicca qui per ottenere la tua chiave API. Crea un account, indica l'URL del tuo sito così che l'IA conosca la tua attività, poi genera la chiave API. Quindi invia la prima richiesta con cURL, Python, JavaScript o qualsiasi client HTTP.
Quali linguaggi di programmazione sono supportati?
Qualsiasi linguaggio in grado di fare richieste HTTP funziona con la nostra API. Sono compresi Python, JavaScript, PHP, Ruby, Java, C#, Go, Swift, Kotlin e molti altri. Nella documentazione trovi esempi di codice.
Come funziona il contesto della conversazione?
Includi il parametro session_id nelle richieste. L'IA ricorderà tutti i messaggi precedenti di quella sessione e risponderà tenendo conto del contesto. Usa un identificatore unico per ogni utente o conversazione.
Come fa l'IA a conoscere la mia attività?
Puoi dare conoscenze all'IA indicando l'URL del tuo sito, che analizziamo automaticamente, caricando documenti PDF o di testo, aggiungendo istruzioni tue o fornendo coppie di domanda e risposta. Tutto avviene dalla dashboard, senza modificare l'API.
Quali sono i limiti di frequenza?
I limiti dipendono dal tuo piano. L'API è pensata per applicazioni di chat in tempo reale. Se ti servono limiti più alti, scrivici.
L'API è sicura?
Sì. Tutte le richieste usano cifratura HTTPS. Tieni segreta la chiave API e non esporla mai nel codice lato client. Consigliamo di chiamare l'API dal tuo server.
Riferimento per sviluppatori

La tua prima richiesta

Un solo POST restituisce una risposta IA basata sulla tua base di conoscenza. Nessun SDK da installare.

POST /api/v1/chat/curl
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.

Due forme accettatehttp
# 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

CampoTipoObbligatorioDescrizione
messagestringobbligatorioIl messaggio dell'utente. Un valore vuoto restituisce un errore 400.
session_idstringfacoltativoIl tuo identificatore per una conversazione. Rinvia lo stesso valore per mantenere il contesto. Se lo ometti, l'account usa un'unica sessione condivisa.
website_idintegerfacoltativoQuale dei tuoi agenti deve rispondere. Se lo ometti, viene usato il sito principale, altrimenti il primo dell'account.

Corpo della risposta

CampoTipoDescrizione
successbooleantrue quando l'IA ha prodotto una risposta.
responsestringIl testo della risposta.
session_idstringLa 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.

Mantenere il contesto su due chiamatejson
// 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.

fetch lato serverjavascript
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.
Python 3python
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"])
PHP 8php
$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'];
Node.js 18+javascript
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;
}
Shellcurl
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.

StatusSignificatoCosa fare
400Corpo 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.
401Chiave API assente, o la chiave non corrisponde a nessun account.Controlla il nome dell'intestazione e se la chiave è stata rigenerata.
403L'account usa il piano Free. L'accesso all'API richiede Starter, Standard o Pro.Cambia piano.
429Limite mensile di messaggi raggiunto. Il corpo contiene anche "limit_reached": true.Rallenta e cambia piano, oppure attendi il periodo di fatturazione successivo.
503Il 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

MetodoPercorsoScopo
POST/chat/Invia un messaggio e ricevi una risposta IA.

Siti e agenti

MetodoPercorsoScopo
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

MetodoPercorsoScopo
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

MetodoPercorsoScopo
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

MetodoPercorsoScopo
GETPOST/webhooks/Elenca o registra un webhook.
DELETE/webhooks/{webhook_id}/Rimuovi un webhook.

Requisiti e limiti

VoceDettaglio
PianoL'accesso all'API richiede un piano a pagamento: Starter, Standard o Pro. Gli account Free ricevono un errore 403.
Quota di messaggiI messaggi dell'API rientrano nella stessa quota mensile delle conversazioni del widget. Controlla il valore attuale con GET /api/v1/account/.
Profondità della cronologiaVengono forniti come contesto fino a 10 messaggi precedenti per session_id.
TrasportoSolo HTTPS. Corpi di richiesta e risposta in JSON.
Rotazione della chiaveRigenera 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.

Ottieni la chiave API - richiede un piano a pagamento