Avvio rapido
Avvio rapido

Crea le tue app da zero

Una guida passo passo per chi non ha mai scritto codice.

Spieghi il compito con parole semplici — l'IA crea l'app e la distribuisce da sola su un server protetto.

Cos'è il vibe coding

È un modo di creare programmi spiegando il compito all'IA a parole — invece di scrivere codice a mano. Il programma lo scrive l'IA. Tu dai la direzione, verifichi il risultato e lo rifinisci.

Non serve saper programmare

Il codice lo scrive l'IA. Da parte tua — una spiegazione chiara del compito, come se istruissi un nuovo collega.

Spiega con parole semplici

Cosa deve succedere, per chi, quali dati e cosa conta come risultato. Più sei specifico, meglio è.

L'IA la distribuisce per te

L'IA scrive il codice, crea un server e pubblica l'app. Tu controlli e perfezioni.

Cos'è il vibe coding

Documentazione e assistenza

Due documentazioni diverse: una per imparare da solo, l'altra da consegnare a un modello IA.

Guida per le persone

Guide dettagliate e il riferimento completo dell'API, con esempi per ogni passaggio.

Documentazione per i modelli IA

La documentazione completa dell'API. Dai al modello il suo link — oppure inserisci semplicemente /v1/me nel prompt, e l'IA scoprirà da sola i tuoi diritti e le tue possibilità.

Passo 1. Scegli uno strumento

Un'app si crea con uno strumento di vibe coding — un'IA capace di scrivere file ed eseguire comandi. Una chat normale (ChatGPT web) non basta.

Claude CodeCodex
Strumenti di vibe coding

Claude Code, Codex, Antigravity, Cursor — strumenti per sviluppatori. Ti servirà un account personale e un'installazione. I passaggi seguenti riguardano proprio questa via.

Passo 2. Crea la tua prima app

Una guida dettagliata — seguila punto per punto, passo dopo passo.

  1. 1
    Accedi con il tuo Bitrix24

    Apri la piattaforma e clicca su «Accedi con Bitrix24». Autorizzati (va bene anche un codice QR) e scegli l'account giusto dall'elenco.

  2. 2
    Apri la creazione della chiave

    La chiave è il lasciapassare con cui la tua app lavora con il tuo Bitrix24. Puoi crearla in due modi:

    • Nella dashboard — il pulsante «Crea chiave API».
    • Oppure nella sezione «Chiavi API» (barra laterale a sinistra) — il pulsante «Crea chiave».
  3. 3
    Compila i parametri della chiave

    Nella finestra «Crea chiave API» imposta:

    • Nome della chiave — per riconoscerla in seguito tra le altre.
    • Modalità di accesso — «Solo lettura» o «Lettura e scrittura».
    • Permessi — lascia solo quelli di cui l'app ha bisogno.
    • Validità — «Senza limiti», 30 / 90 / 180 giorni o 1 anno.
    • Se vuoi — «Impostazioni avanzate»: indirizzi IP e limite di richieste al minuto.
  4. 4
    Crea la chiave e copia il prompt

    Clicca su «Crea». La chiave viene mostrata UNA sola volta — clicca subito su «Copia prompt» (il testo pronto ha già la tua chiave) oppure su «Copia chiave».

  5. 5
    Incolla il prompt nell'IA

    Apri Claude Code o Codex, incolla il prompt copiato e aggiungi, con parole semplici, quale app ti serve.

  6. 6
    Lascia che l'IA crei e pubblichi

    L'IA scriverà il codice, creerà un server Black Hole e distribuirà l'app. Se le manca qualche permesso, ti dirà quali aggiungere.

  7. 7
    Apri l'app pronta

    Vai alla sezione «Server Black Hole», trova il tuo server e clicca su «Apri». Se è configurata un'integrazione, l'app apparirà direttamente dentro Bitrix24.

Ecco come appare un prompt
La mia chiave API per la piattaforma Vibecode: vibe_api_xxxxxxxxxxxx

Documentazione: https://vibecode.bitrix24.com/v1/me

Creami un'app [descrivi l'app] e distribuiscila su un server
Chiave API
vibe_api_

Per te stesso e una singola app. Funziona a tuo nome — tutti vedono gli stessi dati. Si crea nella sezione «Chiavi API».

Chiave di autorizzazione
vibe_app_

Quando l'app è usata da un team o va integrata dentro Bitrix24. Ogni dipendente ha i propri permessi. Sezione «Chiavi di autorizzazione».

La chiave viene mostrata una sola volta. Non potrai rivederla — copiala subito. L'hai persa o hai chiuso la finestra per errore? Creane semplicemente una nuova e revoca quella vecchia.

Come spiegare all'IA cosa ti serve per ottenere il risultato perfetto

Tratta l'IA come un nuovo collega: dai contesto, discuti l'idea e verifica quanto fatto. Più spieghi con chiarezza, più il primo risultato si avvicina alla perfezione.

Sii specifico

Cosa fare, per chi, quali dati usare e cosa conta come risultato. «Una dashboard settimanale», non solo «una dashboard».

Discuti prima l'idea

Prima di chiedere il codice, discuti l'idea con l'IA con parole semplici — come un product manager, non come un programmatore. E chiedi al modello di fare domande.

Suddividi e verifica

Non «tutto insieme». A piccoli passi, con un ciclo «prompt → verifica → rifinitura». Correggi in modo puntuale, senza riscrivere tutto il progetto.

Cosa evitare

  • Una richiesta troppo vaga — l'IA va nella direzione sbagliata.
  • Aspettarsi un risultato perfetto dopo un solo prompt — è un processo iterativo.
  • Accettare il codice senza testarlo su dati di prova.
  • Riscrivere tutto il progetto in una volta invece di modifiche puntuali.
  • Inserire dati reali dei clienti nel testo del prompt o negli screenshot.

Com'è fatto un buon prompt

✓Un paragrafo — con tutto ciò di cui l'app ha bisogno

Crea un'app di riepilogo degli affari per il team vendite. Ogni mattina alle 9:00 invia al responsabile in chat un riepilogo di ieri: totale dei nuovi affari, top 5 dei commerciali per fatturato, affari senza incarichi e incarichi bloccati da più di 7 giorni. Prendi i dati dal CRM, pipeline "Vendite"; mostra gli importi con la variazione rispetto al giorno precedente. Se non ci sono stati nuovi affari, invia un breve "ieri nessun nuovo affare". Aggiungi un pulsante "Aggiorna ora". Distribuiscila su un server e mandami il link.

C'è tutto: cos'è l'app, per chi, quando si attiva, quali dati e in che forma, il caso limite e il finale — il deploy. Più il paragrafo è completo, più il risultato si avvicina alla perfezione al primo tentativo.

Dopo il lancio

La tua prima app non è il traguardo. È facile migliorarla, integrarla in Bitrix24 e tornare indietro se una modifica non ha funzionato.

Affina in dialogo

Torna dall'IA, descrivi le modifiche con parole semplici — cambia il codice e ripubblica l'app.

Integra in Bitrix24

Mostra l'app dove serve: nel menu, in una scheda CRM, in un'attività o in una chat — scegli i punti di integrazione.

Torna a una versione

La piattaforma conserva una versione del codice a ogni pubblicazione (sezione «Sorgenti dell'app»). Se una modifica ha rotto qualcosa, puoi ripubblicare una versione precedente.

Cos'altro c'è nel pannello

Quando ti senti a tuo agio con la prima app, il pannello ha molto altro da offrire. Ogni sezione fornisce all'IA codice già pronto tramite il pulsante «Usa».

Dashboard

La schermata principale dopo l'accesso: saldo, richieste di oggi, percentuale di successo e accesso rapido a ogni sezione.

Analitica

Le chiamate della tua app: quante richieste, la percentuale di successo, dove sono gli errori. Compare dopo le prime chiamate reali — è normale che la sezione sia vuota subito dopo il deploy.

Fatturazione

Saldo, ricariche e storico degli addebiti. I server e i potenti modelli IA consumano credit; a saldo zero si fermano.

Bot

Chatbot per il messenger di Bitrix24 — rispondono ai messaggi e reagiscono agli eventi dell'account.

Agenti IA

Un bot IA già pronto che lavora dentro Bitrix24 (sezione «Agenti»). L'accesso viene concesso su richiesta.

Archiviazione

Storage di file per le app — pagamento a consumo, isolato per chiave. Sezione «Storage».

Connect

Collegamento di servizi esterni: la piattaforma rilascia una normale chiave revocabile. Approva solo l'accesso che hai avviato tu stesso.

Backup

Backup dei server: uno snapshot dell'intero disco, ripristino su un nuovo server. Si attivano nelle impostazioni.

Galassia

Hosting denso — più app su un unico server. Per chi scala le proprie soluzioni.

Lavoro di squadra e accessi

Se sei amministratore di un account Bitrix24, puoi configurare chi fa cosa sulla piattaforma.

Chi accede e chi crea

Sono due impostazioni distinte: l'accesso al pannello (login) e il diritto di creare chiavi, server e bot. Si configurano in modo indipendente.

Limiti per utente

Quante chiavi, server e bot può creare un dipendente — lo stabilisce l'amministratore dell'account.

Audit e richieste

Un registro delle azioni (chi, quando, da dove) e la gestione delle richieste di accesso dei dipendenti — nelle sezioni dell'amministratore.

Se «non hai i permessi» per un'azione, probabilmente è stato l'amministratore a impostarlo così. Scrivigli oppure invia una richiesta di accesso direttamente dal pannello.

Sicurezza

Alcune regole semplici proteggono te e i dati dei tuoi clienti. Ecco le tre principali — leggi l'analisi completa nella pagina sulla sicurezza.

Accesso a due fattori

Un solo passaggio blocca il 99% dei tentativi di furto dell'account. Si attiva in un minuto.

Una chiave unica — come la chiave di una cassaforte

Apre tutto ciò a cui hai accesso. Non inserirla nel codice, non inviarla nelle chat.

Modalità pubblica — con consapevolezza

È accesso completo da internet senza login. Non attivarlo se non capisci le conseguenze.

Chiedi all'IA di verificare l'app

Quando l'app è pronta, chiedi all'IA di verificare il codice generato in cerca di vulnerabilità (meglio con «uno sguardo fresco», in una nuova sessione). Dopo il deploy, ripeti il controllo: in produzione possono emergere rischi che non c'erano durante lo sviluppo.

Sicurezza

Questo è solo l'essenziale

La sicurezza è una cosa seria. Prima di lanciarti con dati reali, leggi assolutamente la pagina completa sulla sicurezza: cosa vede un'IA esterna, come funzionano chiavi e server e come verificare il codice con un audit IA indipendente.

Pronto a creare la tua prima app?

Accedi con il tuo Bitrix24 — e descrivi il compito all'IA con parole semplici.