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 trattative per il team vendite. Ogni mattina alle 9:00 invia al responsabile in chat un riepilogo di ieri: totale delle nuove trattative, top-5 commerciali per fatturato, trattative senza attività e bloccate da più di 7 giorni. Prendi i dati dal CRM, pipeline «Vendite»; importi con la variazione rispetto al giorno precedente. Se non ci sono state nuove trattative — invia un breve «ieri nessuna trattativa». 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.