La sezione Risorse per sviluppatori fornisce strumenti per migliorare il tuo Bitrix24.
In questo articolo scoprirai come:
- configurare l'accesso alla creazione delle integrazioni,
- creare un webhook,
- creare un'app locale,
- visualizzare tutti i tuoi webhook e le tue app,
- visualizzare le statistiche delle richieste per webhook e app.
Piani e prezzi di Bitrix24
Configurare l'accesso alla creazione delle integrazioni
Per impostazione predefinita, solo l'amministratore di Bitrix24 può creare app per tutti gli utenti. Tutti gli utenti possono invece creare webhook in entrata e app personali. L'amministratore di Bitrix24 può modificare queste impostazioni.
Come configurare il connettore Vibecode
1. Fai clic sull'icona delle impostazioni a destra del nome o del logo del tuo Bitrix24.
2. Vai a Impostazioni (⚙️).
3–4. Nella scheda Sicurezza, espandi il blocco Bitrix24 Integrations.
5–6. Fai clic su + Aggiungi in ogni campo per selezionare i dipendenti che potranno creare:
- webhook in entrata,
- app per tutti,
- app personali.
7. Salva le modifiche.
Crea webhook
Nella scheda Casi d'uso comuni, troverai esempi di scenari popolari per la creazione di webhook. Crea un chatbot per informare i dipendenti o aggiungi uno script di vendita al modulo di chiamata. Se non trovi quello che ti serve, puoi creare il tuo webhook. Tieni presente che qualsiasi utente può creare un webhook.
Seleziona il caso d'uso appropriato e completa la configurazione.
Webhook da collegare all'API REST. In questo campo viene generato automaticamente il codice segreto del webhook. È disponibile esclusivamente per il creatore del webhook. Se l'amministratore di Bitrix24 modifica un webhook di un altro utente, il codice segreto verrà reimpostato e l'amministratore diventerà il proprietario di questo webhook.
Webhook. Inizio rapido
Generatore di richieste REST. Utilizza il generatore di richieste per selezionare i metodi e i parametri necessari e perfezionare degli strumenti. Puoi leggere le descrizioni del metodo e dei parametri e scaricare un esempio in PHP.
Descrizione dei metodi dell'API REST
URL. Questo campo include automaticamente l'URL generato dai metodi e parametri configurati. Usalo per eseguire una richiesta nei sistemi esterni.
L'URL è composto da diversi parametri::
********.bitrix24.it: l'indirizzo del tuo account di Bitrix24./rest: mostra che l'operazione del webhook viene eseguita tramite REST./1: è l'ID dell'utente che ha creato il webhook./vam**********xrk: è il codice segreto. Con questo codice puoi visualizzare, modificare ed eliminare i dati in Bitrix24./crm.lead.update: è il metodo chiamato API REST..json: quando si creano nuovi webhook, questo parametro viene utilizzato in un formato predefinito.?ID=42: questi parametri sono necessari per i metodi specifici. I parametri vengono visualizzati dopo il punto interrogativo e sono separati dal carattere &.
Esempio di esecuzione del metodo di aggiornamento
Vediamo un esempio di utilizzo dei metodi di aggiornamento crm.***.update. Per questi metodi CRM, escludendo i processi smart, esiste una regola generale: prima si passa dall'ID e poi da una matrice con valori modificabili nei campi.
Ecco un esempio su come eseguire il metodo di aggiornamento nella barra degli indirizzi del browser:
crm.***.update.json?id=1&fields[TITLE]=Entidad%20de%20prueba&fields[ASSIGNED_BY_ID]=1&fields[UF_CRM_1234567890]=TEST
Scopri come creare delle richieste API REST da eseguire nella barra degli indirizzi del browser:
[método].json?[se passa una matrice, specifica il campo in questo modo:]fields[[campo]]
I parametri possono differire tra vari metodi, quindi verifica prima la descrizione di ogni metodo.
Per verificare la tua richiesta, fai clic su Esegui e consulta il risultato.
Assegna autorizzazioni. Decidi quali strumenti di Bitrix24 saranno disponibili nel tuo webhook. Ad esempio, il caso d'uso di Importazione clienti sarà disponibile solo per il CRM.
Applicazione locale
Le app locali sono quelle che crei per il tuo Bitrix24. Vai nella scheda Casi d'uso comuni > Altro > Applicazione locale.
Applicazione locale. Inizio rapido
Visualizza applicazioni e webhook creati
Apri la scheda Integrazioni. Qui puoi vedere:
- i nomi dei webhook e delle applicazioni configurati,
- gli eventi associati a loro,
- gli strumenti a cui hai accesso,
- l'utente che li ha creati.
Per visualizzare solo le informazioni rilevanti nell'elenco dei webhook, fai clic su Impostazioni (⚙️) e seleziona i campi. Per modificare o eliminare un webhook o un'applicazione, fai clic sul Menu (≡).
Statistiche di applicazioni e webhook
Apri la scheda Statistiche per visualizzare il numero di richieste per ciascun webhook e applicazione. Questo strumento ti aiuterà a controllare il carico delle richieste REST in Bitrix24.
Valutare il carico REST all’interno di Bitrix24
Per visualizzare le statistiche sulle app e sui webhook specifici, utilizza il filtro. Il periodo massimo per visualizzare le statistiche è di 14 giorni.
Per visualizzare solo i dettagli necessari nelle statistiche, fai clic su Impostazioni (⚙️)e seleziona i campi.
Riepilogo
- Nella sezione Risorse per sviluppatori trovi gli strumenti per ampliare le funzionalità di Bitrix24 tramite webhook e API REST.
- Per creare i webhook, puoi utilizzare gli scenari pronti all'uso. Se non trovi lo scenario adatto, crea autonomamente un webhook.
- Per impostazione predefinita, solo l'amministratore di Bitrix24 può creare app per tutti gli utenti. Tutti gli utenti possono invece creare webhook in entrata e app personali. L'amministratore può modificare queste impostazioni nella sezione Sicurezza delle impostazioni di Bitrix24.
- Il connettore Vibecode gestisce anche le autorizzazioni per la creazione di app e webhook. Se l'opzione Permission source — Vibecode server è attiva, vengono applicate le autorizzazioni configurate in Alaio Vibecode.
- Puoi trovare tutti i webhook e le app creati nella scheda Integrazioni.
- Puoi consultare le statistiche delle richieste effettuate tramite webhook e app nella scheda Statistiche.
