Sì, puoi gestire servizi, orari e prenotazioni tramite API usando il modulo Appuntamenti di Papo. L'API REST ti permette di elencare servizi, professionisti e pazienti, consultare l'agenda e creare nuove prenotazioni in modo programmatico, integrando tutto il flusso delle prenotazioni con il tuo sito, applicazione o sistema esterno.
Il modulo Appuntamenti di Papo è progettato per essere il centro di controllo della tua agenda. Organizza quattro pilastri: i servizi che offri (con nome, durata e prezzo), i professionisti che li erogano, la disponibilità degli orari di ciascuno e le prenotazioni effettuate. Con l'API, puoi automatizzare queste operazioni senza accedere manualmente al pannello, mantenendo un'integrazione fluida tra Papo e i tuoi altri strumenti.
Riepilogo delle operazioni di Appuntamenti tramite API
| Operazione | Cosa fa | Quando usarla |
|---|---|---|
| Elenca servizi | Restituisce i servizi prenotabili registrati, con durata e prezzo. | Sincronizzare il catalogo dei servizi con il tuo sito o applicazione, così il cliente vede le opzioni in tempo reale. |
| Elenca professionisti | Restituisce l'elenco degli operatori o membri del team che erogano i servizi. | Mostrare i professionisti disponibili e le loro specialità in un'interfaccia di prenotazione esterna. |
| Elenca pazienti | Restituisce i pazienti registrati, con nome, telefono e ID. | Verificare se un cliente esiste già nel CRM prima di creare una nuova prenotazione o collegarlo a un record esistente. |
| Elenca prenotazioni | Restituisce le prenotazioni con filtro per stato (es.: confermato, in attesa). | Verificare le prenotazioni, integrarle con sistemi di report o controllare l'occupazione dell'agenda prima di offrire nuovi orari. |
| Prenota un appuntamento | Crea una prenotazione reale nell'agenda di un professionista, per un servizio e un paziente specifici. | Consentire ai clienti di prenotare direttamente dal tuo sito o applicazione, oppure automatizzare la creazione di prenotazioni da sistemi esterni. |
Come funziona l'autenticazione dell'API
Tutte le operazioni di scrittura negli Appuntamenti richiedono la chiave segreta del tuo account Papo, inviata come token Bearer nell'header di autorizzazione. La chiave pubblica dell'account è opzionale, ma, se inviata, deve corrispondere allo stesso account della chiave segreta.
L'URL di base dell'API è https://app.papo.global/api/v1. Le chiavi vengono generate nell'area sviluppatore del pannello Papo. La chiave segreta viene mostrata una sola volta alla creazione; conservala in un luogo sicuro e revocala immediatamente se sospetti una fuga di dati.
Come usarla nella pratica
- Accedi all'area sviluppatore/API nel pannello Papo e genera una chiave segreta. Copia anche la chiave pubblica dell'account.
- In ogni richiesta, autenticati con la chiave segreta come token Bearer. Se vuoi rafforzare la validazione, invia la chiave pubblica nell'header indicato nella documentazione.
- Per creare l'interfaccia di prenotazione, elenca prima i servizi e i professionisti disponibili. Così puoi popolare dinamicamente le opzioni sul tuo sito o app con i dati reali del tuo account Papo.
- Per creare una prenotazione, chiama l'endpoint di creazione dell'appuntamento, inviando nel payload JSON gli identificatori del servizio, del professionista, del paziente e la data/ora desiderata. L'API convaliderà la disponibilità nell'agenda configurata nel modulo Appuntamenti e creerà l'impegno.
- Consulta la documentazione ufficiale su
https://papo.global/pt/docsper ottenere i percorsi esatti, i parametri obbligatori e esempi di codice. Tutte le risposte sono in formato JSON.
L'API consente anche di elencare le prenotazioni esistenti con filtro per stato. È utile per costruire pannelli di monitoraggio, inviare promemoria automatici o integrare lo stato delle prenotazioni con altri sistemi.
A chi è indicata questa integrazione
- Cliniche, studi medici e saloni di bellezza che desiderano offrire la prenotazione online sul proprio sito, con disponibilità in tempo reale.
- Piattaforme SaaS e marketplace che devono collegare l'agenda dei fornitori di servizi a un sistema di prenotazione esterno.
- Rivenditori white label che creano soluzioni personalizzate per i clienti finali e vogliono esporre il modulo Appuntamenti tramite API.
- Aziende con flussi automatizzati che avviano la creazione di prenotazioni a partire da eventi in CRM, ERP o strumenti di automazione.
Domande frequenti
Devo avere il modulo Appuntamenti configurato per usare l'API?
Sì. È necessario che i servizi, i professionisti e le loro disponibilità siano già registrati nel modulo Appuntamenti di Papo affinché l'API possa elencarli e convalidare le prenotazioni.
L'API permette di creare un nuovo servizio o professionista?
Le funzionalità dell'API si concentrano sull'elencare servizi e professionisti esistenti e sul prenotare appuntamenti. Per creare o modificare servizi e professionisti, usa il pannello Papo.
Come fa l'API a sapere se un orario è libero?
Quando invii una richiesta per prenotare un appuntamento, l'API di Papo consulta la disponibilità configurata per il professionista e il servizio scelto in quel giorno e orario. Se c'è un conflitto, la prenotazione non verrà creata e l'API restituirà un errore.
Posso usare l'API per prenotare un appuntamento a nome di un paziente che non è ancora nel CRM?
Puoi prima usare l'API Contatti di Papo per creare il paziente (con nome, e-mail e/o telefono) e poi usare l'ID restituito per creare la prenotazione. Consulta la documentazione per l'endpoint di creazione dei contatti.
L'IA di Papo può prenotare automaticamente tramite API?
L'Intelligenza Artificiale di Papo, come Super Chat, prenota direttamente dalla conversazione su WhatsApp, consultando l'agenda del modulo Appuntamenti. L'API è il canale per integrazioni programmatiche esterne, come un sistema di prenotazione online.
Dove vedo il formato esatto del payload per prenotare?
Nella documentazione ufficiale dell'API, su https://papo.global/pt/docs. Lì trovi i dettagli di autenticazione, parametri, risposte ed esempi di codice per le funzionalità di Appuntamenti.
Leggi anche
- Come usare l'API di Papo per creare e aggiornare contatti in massa
- Come usare l'API di Papo per creare e gestire etichette (tag)
Inizia a integrare la tua agenda tramite API →
Registrati su Papo e accedi all'API REST per automatizzare le tue prenotazioni fin dal primo utente.