Integrazione AI

Qlara Platform fornisce documentazione leggibile dalle macchine progettata per gli assistenti AI. Che tu usi ChatGPT, Claude, Gemini, GitHub Copilot, Cursor o qualsiasi altro LLM, puoi fornire i nostri docs API direttamente al tuo strumento e ottenere generazione di codice accurata e contestualizzata.

Come Funziona

Endpoint Documentazione

Seguiamo lo standard llms.txt per fornire documentazione strutturata ottimizzata per il consumo AI:

File	Dimensione	Ideale per
/llms.txt	~3 KB	Domande rapide: "Quali endpoint sono disponibili?", "Come funziona l'autenticazione?"
/llms-full.txt	~55 KB	Generazione codice: "Scrivi una funzione Python per inviare un SMS", "Crea un webhook handler"

:::tip Quando usare quale llms.txt è una panoramica leggera — perfetto per ricerche rapide e quando hai limiti di token. llms-full.txt include tutti i parametri, schemi, esempi e codici errore — usalo quando vuoi che l'AI generi codice production-ready. :::

Guida alla Configurazione

Claude Projects

1. Vai su claude.ai e crea un nuovo Progetto
2. Nella Knowledge del progetto, clicca Aggiungi contenuto → Da URL
3. Incolla: https://lora-api.agiletelecom.com/llms-full.txt
4. Inizia a fare domande sull'API Qlara

:::info Claude Code Se usi Claude Code (CLI), aggiungi l'URL nel file CLAUDE.md del tuo progetto e Claude lo utilizzerà automaticamente durante lo sviluppo. :::

ChatGPT Custom GPTs

1. Vai su ChatGPT → Esplora GPT → Crea
2. Scarica llms-full.txt e caricalo come File di conoscenza
3. Nelle Istruzioni, aggiungi:

   Sei un esperto dell'API Qlara Platform per la messaggistica multi-canale (SMS, RCS, WhatsApp). Usa il file di conoscenza caricato per rispondere accuratamente. Fornisci sempre esempi curl completi con l'URL base corretto.

4. Salva e usa il tuo GPT personalizzato

GitHub Copilot / Cursor

1. Scarica llms-full.txt
2. Posizionalo nella root del tuo progetto e rinominalo in qlara-api-docs.md
3. L'AI lo utilizzerà automaticamente durante il completamento del codice e nella chat

# Setup rapido
curl -s "https://lora-api.agiletelecom.com/llms-full.txt" > qlara-api-docs.md

Qualsiasi LLM via API

Scarica la documentazione e includila nel tuo system prompt:

import requests

# Scarica documentazione API Qlara
docs = requests.get("https://lora-api.agiletelecom.com/llms-full.txt").text

# Usa con qualsiasi LLM (OpenAI, Anthropic, Google, ecc.)
messages = [
    {"role": "system", "content": f"Sei un esperto dell'API Qlara. Riferimento:\n{docs}"},
    {"role": "user", "content": "Scrivi una funzione Python per inviare un SMS"}
]

Cosa Può Costruire il Tuo AI

Una volta che il tuo assistente AI ha la documentazione Qlara, può aiutarti con task di integrazione reali:

Prompt di esempio

Categoria	Prompt di esempio	Cosa ottieni
Messaggistica	"Scrivi una funzione Python che invia un SMS con tracking della consegna"	Funzione completa con gestione errori e setup webhook
Campagne	"Crea uno script Node.js per importare 10.000 contatti da CSV e inviare una campagna"	Workflow end-to-end con parsing CSV, creazione contatti e gestione campagna
Webhook	"Costruisci un webhook handler Express.js per le notifiche di consegna"	Server con gestione eventi DELIVERY, READ e INBOUND
Template	"Genera un template WhatsApp con link tracciati e bottoni"	Creazione template + flusso approvazione Meta + esempio invio
Multi-canale	"Scrivi un servizio Go con fallback WhatsApp → RCS → SMS"	Servizio con configurazione catena di fallback e tracking stato
Debugging	"La mia API restituisce 401 — cosa c'è che non va?"	Troubleshooting autenticazione con formato header specifico

Copertura API

I file di documentazione coprono tutte le 6 API Qlara e 42+ endpoint:

API	Endpoint	Cosa è documentato
Qlara Platform	42 endpoint	Contatti, liste, campagne, webhook, esportazioni, inbox, media, abbonamento
SMS Universal	1 endpoint	SMS moderno con placeholder, schedulazione, simulazione
SMS Legacy	2 endpoint	Invio batch, verifica credito
RCS Send	1 endpoint	Card ricche, caroselli, suggerimenti, fallback
RCS Templates	5 endpoint	CRUD per template TEXT, CARD, CAROUSEL
WhatsApp	8 endpoint	Invio, template, numeri di telefono, download media

Per il Riferimento API interattivo con "Try it", vedi il Riferimento API.

Mantieni Aggiornato il Tuo AI

I file llms.txt vengono aggiornati ad ogni release. Ecco come restare aggiornati:

Strumento	Come aggiornare
Claude Projects	Riaggiungi l'URL — Claude scarica automaticamente l'ultima versione
ChatGPT	Riscarica e ricarica llms-full.txt
Copilot / Cursor	Esegui: curl -s "https://lora-api.agiletelecom.com/llms-full.txt" > qlara-api-docs.md
Integrazione custom	Scarica l'URL all'avvio o a intervalli regolari

Controlla il Changelog per gli ultimi aggiornamenti API.

Risorse

Risorsa	Link
llms.txt (panoramica)	/llms.txt
llms-full.txt (completo)	/llms-full.txt
Riferimento API	Qlara Platform
Collezioni Postman	Download
Casi d'Uso	30 scenari end-to-end
Changelog	Ultimi aggiornamenti