app2email API Prezzi

Documentazione

Prenotazione di appuntamenti su WhatsApp

Permetta ai clienti di prenotare, spostare e annullare appuntamenti dentro WhatsApp. Le prenotazioni vanno su Google Calendar, Microsoft 365, Apple iCloud o nel calendario di app2email, con conferme e promemoria. Include l'app calendario, una pagina di prenotazione online, i pagamenti e un team del calendario.

Un cliente scrive "book" al suo numero WhatsApp e sceglie un servizio, un giorno e un orario senza uscire dalla chat.

La prenotazione finisce nel suo calendario, il cliente riceve una conferma e prima della visita parte un promemoria.

Cosa vede il cliente

  1. Invia una parola di prenotazione (book, appointment, reserve: le parole le sceglie Lei) oppure tocca "Book now" in un messaggio che le ha inviato.
  2. Si apre un modulo dentro WhatsApp (un WhatsApp Flow): sceglie un servizio, un giorno da un calendario, un orario libero, indica un nome e conferma.
  3. Riceve un messaggio di conferma con i dettagli, un riferimento e, se vuole, un file di calendario per aggiungere l'appuntamento al telefono.
  4. Prima dell'appuntamento riceve un promemoria con i pulsanti Confirm, Reschedule e Cancel. Funziona anche rispondere CANCEL o RESCHEDULE in qualsiasi momento.

Il cliente non deve installare nulla e non c'è alcun link a un altro sito: il modulo è quello di WhatsApp e si apre nella chat.

La configurazione in cinque minuti

  1. Servizi: cosa si può prenotare e quanto dura (una consulenza di 30 minuti, un taglio di capelli di 45 minuti).
  2. Disponibilità: i suoi orari di apertura per giorno della settimana, la griglia degli slot (ogni 15, 30 o 60 minuti), gli intervalli tra un appuntamento e l'altro, quanto preavviso Le serve e con quanto anticipo i clienti possono prenotare. I giorni speciali (chiuso, oppure altri orari) vanno nello stesso posto.
  3. Calendario: colleghi Google Calendar, Microsoft 365 / Outlook.com o Apple iCloud, oppure tenga le prenotazioni nel calendario di app2email. Gli orari occupati nel calendario collegato non vengono mai proposti.
  4. Messaggi: la conferma, i promemoria e il testo di annullamento, con le sue parole, con segnaposto per il servizio, la data e l'ora.
  5. Pubblicazione: il modulo di prenotazione viene caricato su WhatsApp e pubblicato dalla Overview. Si invii una prova, poi attivi Book-and-Pay.

Staff: aggiunga le persone con cui i clienti possono prenotare, ciascuna con i propri orari e, se vuole, il proprio calendario. Il modulo allora chiede "Con chi desidera prenotare?" con "Anyone available" per primo.

Tutto ciò che è in questa pagina si imposta nella pagina Book-and-Pay della dashboard (/dashboard/app/book, che si apre anche da Integrations).

Parole di attivazione

Una parola di attivazione è una parola o una breve frase che avvia qualcosa quando un cliente la invia. Le parole le sceglie nella scheda Trigger.

  • Le parole di prenotazione (all'inizio book, booking, appointment, reserve, reservation, schedule) inviano il modulo di prenotazione.
  • Le parole di annullamento (cancel) chiedono a un cliente con un appuntamento in arrivo "Vuole annullarlo?" con dei pulsanti.
  • Le parole di spostamento (reschedule, change booking) avviano una nuova prenotazione che sostituisce quella in arrivo.
  • Con più moduli, ogni modulo può avere le sue parole nella scheda Flows. Hanno la precedenza sulle parole di prenotazione.

Le parole vengono riconosciute come parole intere. Maiuscole e accenti non contano: "Book", "BOOK" e "book!" sono la stessa cosa, e "bookshelf" non conta.

I messaggi lunghi vengono ignorati

Una parola di attivazione conta solo in un messaggio breve: uno con meno di 10 altre parole. Un messaggio più lungo che contiene per caso "booking" o "cancel" non avvia nulla e viene gestito come qualsiasi altro messaggio.

Può cambiare il numero nella scheda Trigger ("Ignore the words in long messages"), da "solo quando la parola è l'intero messaggio" a "in un messaggio di qualsiasi lunghezza".

Calendari

Con Google Calendar e Microsoft 365 accede una sola volta e sceglie il calendario in cui vengono scritte le prenotazioni e quali calendari devono bloccare gli orari.

Apple iCloud e altri server CalDAV si collegano con una password specifica per app.

Un link di calendario in sola lettura (.ics) può bloccare gli orari mentre le prenotazioni restano nel calendario di app2email.

Se un calendario collegato smette di rispondere, le prenotazioni continuano a funzionare e la dashboard Le dice di ricollegarlo.

La regola delle 24 ore e i promemoria

WhatsApp consente a un'attività di inviare testo libero per 24 ore dopo l'ultimo messaggio del cliente. Le conferme arrivano dentro quella finestra, quindi sono testo suo.

I promemoria di solito partono dopo. Per questo app2email crea sul suo numero un piccolo insieme di template utility approvati nel momento in cui attiva le prenotazioni (Meta li esamina, di solito entro un'ora) e usa il template corrispondente ogni volta che la finestra è chiusa.

I solleciti per una nuova prenotazione ("è passato un po' di tempo") sono messaggi di marketing e vanno solo ai contatti che hanno acconsentito al marketing.

Follow-up e report

Dopo una visita può seguire una nota di assistenza post-visita con i link ai suoi prodotti e una valutazione con un solo tocco.

La scheda Reports mostra le prenotazioni per origine, i mancati arrivi, le valutazioni e quali servizi e membri dello staff sono più richiesti.

L'app calendario

Le sue prenotazioni hanno una propria app su /calendar (www.app2email.com/calendar). È pensata per gli schermi touch: un tablet alla reception o un telefono in tasca. I pulsanti sono grandi e i pannelli scorrono dal basso su uno schermo stretto.

  1. Apra l'app dalla voce "Calendar" nel menu della dashboard, oppure vada su /calendar e acceda. Se ha più attività, passa dall'una all'altra nella barra in alto.
  2. Scelga una vista: Day, Week, Month o List. Scorra a sinistra o a destra per passare al giorno (alla settimana, al mese) successivo o precedente. Tocchi la data per saltare con un selettore del mese. Con lo staff, tocchi un chip dello staff per vedere una sola persona.
  3. Prenoti: tocchi "+ New", oppure tocchi un orario vuoto nella vista giornaliera. Scelga il cliente (cerchi o digiti un numero con il prefisso internazionale), il servizio, il membro dello staff ("Anyone available" è un'opzione) e uno degli orari liberi. Attivi "tell the customer" per inviare la conferma.
  4. Sposti: apra l'appuntamento, tocchi Move e scelga un nuovo orario. L'appuntamento mantiene il suo riferimento. Il cliente viene avvisato se lascia attivo "tell the customer".
  5. Annulli, completato, mancato arrivo: apra l'appuntamento e tocchi il pulsante. Un annullamento chiede un motivo.
  6. Blocchi un orario: tocchi "+ New", poi "Block time". Scelga un membro dello staff o tutti, le ore o interi giorni, e un titolo (pranzo, ferie). L'orario bloccato non viene mai proposto ai clienti.
  7. Note: note interne su un cliente o su un singolo appuntamento. Fissi in alto quelle importanti. Il cliente non le vede mai. Una nota può avere una data "Remind me on"; quel giorno riceve un'e-mail.

Clienti e sondaggi

Customers elenca tutti quelli che hanno prenotato, con visite, mancati arrivi, appuntamenti futuri e passati, note, pacchetti e pagamenti. Da lì può modificare tag e dettagli, inviare un messaggio WhatsApp o un'e-mail, e chiedere all'assistente una bozza o un breve riepilogo di preparazione.

Polls Le permette di proporre da due a dieci orari e lasciare che le persone votino (vedere Tipi di evento).

Il calendario mostra in grigio gli orari occupati di un calendario Google, Microsoft o Apple collegato, così nulla Le viene nascosto. Lo schermo si aggiorna ogni 30 secondi.

Team del calendario

Può invitare persone solo al calendario. Non vedono la sua dashboard, i suoi messaggi né le sue impostazioni.

  1. Apra il calendario, poi il menu, poi Team (solo gli amministratori).
  2. Digiti l'indirizzo e-mail della persona, scelga un ruolo e, facoltativamente, il membro dello staff che questa persona è.
  3. Invii l'invito. La persona riceve un'e-mail con un link, accede o crea un login e arriva nel suo calendario.
  4. Può cambiare un ruolo, inviare di nuovo un invito o rimuovere una persona in qualsiasi momento.

Ruoli

RuoloCosa può fare la persona
AdministratorTutto nel calendario: prenotare, spostare, annullare, bloccare gli orari di chiunque, tutte le note, il team, la condivisione, i pagamenti e i rimborsi, l'eliminazione dei dati dei clienti.
StaffVedere il calendario, prenotare, spostare e annullare, bloccare i propri orari, scrivere note e inviare messaggi ai clienti. Solo il proprio feed di condivisione.
ViewerSolo consultazione. Nessun pulsante che modifichi qualcosa.

Due opzioni per ogni persona

Servono soprattutto per lo staff:

  • Only their own entries: la persona vede e modifica solo gli appuntamenti del proprio membro dello staff (deve scegliere il membro dello staff).
  • Hide customer contact details: i numeri di telefono e gli indirizzi e-mail compaiono come "•••• 4567". Vale anche per ciò che viene inviato all'assistente.

Le persone che hanno già un ruolo nella sua dashboard ricevono automaticamente il ruolo corrispondente nel calendario: owner e admin sono amministratori, member è staff, viewer è viewer.

Pagina di prenotazione online

Oltre al modulo WhatsApp, i clienti possono prenotare su una pagina web per cellulare. Non richiede login né app. La imposti nella pagina Book-and-Pay della dashboard, scheda Online booking.

  1. Attivi la pagina.
  2. Scelga l'indirizzo: www.app2email.com/book/ seguito da un breve nome suo (da 5 a 40 lettere, cifre o trattini). Prema "Check and save". Se il nome è già preso, Le viene detto.
  3. Scriva un titolo e una breve introduzione se vuole cambiare quelli predefiniti.
  4. Copi il link, stampi il codice QR, oppure copi lo snippet di incorporamento per il suo sito (un iframe; aggiunga ?embed=1 per nascondere l'intestazione e imposti i colori con color, bg e text).

Digiti {booking_link} in qualsiasi testo per il cliente e app2email lo sostituisce con un link creato per quel cliente. Lo apre già riconosciuto: nessun numero da digitare e la prenotazione è legata alla sua chat.

Può usarlo nella risposta alla parola di attivazione, nella conferma, nei promemoria, nei messaggi di annullamento e di spostamento, nel follow-up e nel testo "nessun orario libero".

Il link scade dopo il numero di giorni che imposta (7 per impostazione predefinita). I testi inviati come template fuori dalla finestra di 24 ore non possono contenerlo. Se la pagina è disattivata, il tag diventa vuoto.

Cosa invia una parola di attivazione

Ne sceglie una fra tre: il modulo WhatsApp (come prima), un pulsante che apre la pagina online, oppure il modulo con il link alla pagina sotto il suo testo. Se non è ancora pubblicato alcun modulo, viene inviato il link.

Un cliente che app2email non conosce ancora

  1. Il cliente apre il suo indirizzo pubblico, sceglie un servizio, un orario e indica un nome.
  2. L'orario viene tenuto per alcuni minuti (10 per impostazione predefinita; può impostare da 5 a 30).
  3. La pagina mostra un pulsante che apre WhatsApp con un messaggio già pronto, "Confirm booking BK-...". Il cliente lo invia.
  4. La prenotazione viene creata, la pagina mostra "You're booked" e la conferma arriva su WhatsApp, con un pulsante "Pay now" quando il servizio si paga online. Se il tempo scade, l'orario viene rilasciato e il cliente può sceglierne un altro.

Questo dimostra che il cliente è il titolare del numero WhatsApp. Un cliente che arriva da un link personale non ha bisogno di questo passaggio.

Gestione e limiti

Con un link personale il cliente può vedere i suoi appuntamenti in arrivo e annullarli o spostarli (può disattivarlo).

Può impostare un termine ultimo prima dell'inizio entro cui i clienti possono modificare, e un limite di appuntamenti al giorno. Lei, l'API e l'app calendario non siete mai limitati da queste regole.

Feed del calendario (.ics)

Nel calendario, apra Sharing e crei un link feed per Lei o per un membro dello staff. Lo aggiunga a Google Calendar, Apple Calendar o Outlook come abbonamento e i suoi appuntamenti e orari bloccati compariranno lì.

Il feed contiene nomi, servizi e riferimenti, mai i numeri di telefono dei clienti. Può revocare un link feed in qualsiasi momento.

Tipi di evento

  • Uno a uno: un cliente per orario. È l'impostazione predefinita.
  • Gruppo: imposti i "posti" su un servizio (da 1 a 200). Lo stesso orario di inizio resta prenotabile finché tutti i posti non sono occupati. Ogni cliente ha la propria prenotazione, i propri messaggi e il proprio pagamento. La pagina mostra quanti posti restano.
  • Tutti partecipano: scelga da due a dieci membri dello staff. Un orario viene proposto solo quando tutti sono liberi, e l'evento va nel calendario di ciascuno.
  • Round robin: nelle impostazioni dello staff, scelga come "Anyone available" sceglie una persona: la prima libera, oppure quella libera con meno appuntamenti attorno a quell'ora.
  • Sondaggi: nel calendario, apra Polls e tocchi da due a dieci orari liberi. Invii il link. Le persone votano sulla pagina senza login. Quando sceglie un orario, viene creato un appuntamento per il cliente che ha indicato, oppure l'orario viene bloccato. Gli orari non vengono tenuti mentre il voto è in corso.

Incassare pagamenti

Collega il suo account Stripe o PayPal. Il denaro va direttamente dal cliente al suo account.

app2email non trattiene commissioni e non detiene mai il suo denaro. Valgono le commissioni e le ricevute del fornitore di pagamento. Una valuta per numero.

Collegare e impostare i prezzi

  1. Apra Bookings, Payments. La pagina Le dice dove trovare ogni chiave.
  2. Stripe: incolli una chiave segreta o limitata. app2email la controlla e aggiunge il proprio webhook al suo account. PayPal: inserisca il client id e il secret di un'app REST e scelga live o sandbox. Solo il proprietario o un amministratore può collegare o scollegare.
  3. Scelga la valuta e quali metodi i clienti possono usare (uno o entrambi).
  4. Su ogni servizio, imposti il prezzo e se il pagamento è required, optional o none. Aggiunga una caparra per addebitare solo una parte adesso; il resto si paga alla visita.

Come funziona

  • Required, sulla pagina online: tramite un link personale l'orario viene tenuto mentre il cliente paga, e la prenotazione viene creata quando il pagamento è confermato (un pagamento che scade o viene annullato rilascia l'orario). Sul suo indirizzo pubblico il cliente conferma prima l'orario su WhatsApp, come sopra, così Lei sa di chi è la prenotazione. La prenotazione viene poi creata con il pulsante "Pay now" nella conferma WhatsApp, e viene annullata se non è pagata entro 1 giorno e al più tardi 2 ore prima dell'appuntamento (una prenotazione fatta più tardi ha comunque 30 minuti).
  • Modulo WhatsApp e prenotazioni che fa Lei: la prenotazione viene creata e la conferma contiene un link "Pay now". Con "optional" non viene mai annullato nulla. Con "required" può annullare automaticamente le prenotazioni non pagate dopo un numero di minuti che sceglie (0 significa mai).
  • Coupon: un codice, una percentuale o un importo, per alcuni o per tutti i servizi, con un numero massimo di utilizzi e una data di fine.
  • Pacchetti prepagati: per esempio 10 sedute a un unico prezzo, valide per alcuni giorni. I clienti ne acquistano uno sulla pagina online, oppure Lei ne assegna uno al banco. Prenotare con un pacchetto non addebita nulla e consuma una seduta. Un annullamento restituisce la seduta quando annulla Lei o quando il cliente annulla in tempo.
  • Link di pagamento una tantum: nel calendario, richieda un pagamento a un cliente con un importo e una descrizione, inviato su WhatsApp o copiato per inviarlo Lei stesso.
  • Rimborsi: scelga in Payments se un annullamento non rimborsa mai, Le chiede conferma, oppure rimborsa automaticamente per intero. Può anche rimborsare dal calendario, per intero o in parte.

Un pagamento conta come pagato solo quando Stripe o PayPal lo confermano. app2email memorizza l'importo, lo stato e il riferimento del fornitore, mai i dati della carta.

Notifiche

  • E-mail ai clienti: quando la prenotazione ha l'indirizzo e-mail del cliente, la conferma (con un file di calendario), l'annullamento, l'avviso di spostamento, i promemoria e il follow-up arrivano anche per e-mail, oltre che su WhatsApp. Le risposte vanno all'indirizzo che sceglie. Lo attivi in Bookings, Notifications.
  • Regole aggiuntive: fino a 20 regole come "invia una nota sul parcheggio il giorno prima". Ogni regola ha un evento scatenante (prenotato, annullato, spostato, prima dell'inizio, dopo la fine, completato, mancato arrivo, pagato), un ritardo, i servizi a cui si applica, chi lo riceve (il cliente, Lei o il membro dello staff) e il canale (WhatsApp o e-mail).
  • Fuori dalla finestra di 24 ore: una regola su WhatsApp viene inviata come testo libero solo dentro la finestra. Fuori, il messaggio va per e-mail se il cliente ha un indirizzo. Altrimenti viene saltato e il registro lo indica. I promemoria integrati usano comunque template approvati, come descritto sopra.

Personalizzazione grafica

Nella scheda Online booking può caricare un logo (PNG, JPEG o WEBP, fino a 300 KB), scegliere un colore per i pulsanti e uno per lo sfondo, e nascondere la riga "Powered by app2email".

Può anche scrivere una politica di annullamento che compare nel passaggio di riepilogo e insieme all'appuntamento, aggiungere fino a tre pulsanti nella pagina "You're booked" e indirizzare i clienti a una sua pagina pochi secondi dopo la prenotazione.

Eliminare i dati dei clienti

Un amministratore può cancellare i dati di prenotazione di un cliente: nel calendario apra il cliente e scelga "Delete customer data" (digita una conferma). L'API ha la stessa chiamata.

  • Gli appuntamenti futuri vengono annullati senza un messaggio al cliente.
  • Su tutti gli appuntamenti il nome, l'e-mail, le note e il feedback vengono svuotati e il numero del cliente viene sostituito da un codice casuale.
  • Le note, i link, i blocchi e i voti ai sondaggi di quel cliente vengono eliminati. I pagamenti e i pacchetti mantengono l'importo e la data ma perdono il nome e il numero.
  • I report continuano a contare gli appuntamenti resi anonimi.

Questo non elimina il contatto né la conversazione WhatsApp; quelli restano nella pagina Contacts.

Per l'eliminazione automatica, imposti "keep customer details for N days" (da 30 a 3650) nelle impostazioni della privacy. Una volta al giorno, i dati degli appuntamenti terminati da più tempo vengono cancellati nello stesso modo. 0 conserva tutto.

Per sviluppatori e agenti

Tutto ciò che fa la dashboard è nell'API REST sotto /v1/{number}/bookings: elencare e creare prenotazioni, annullarle, leggere gli slot liberi e le impostazioni di prenotazione.

Il suo sistema può ricevere gli eventi webhook booking.created, booking.cancelled e booking.rescheduled. Gli stessi strumenti esistono sul server MCP per gli agenti AI.

Il riferimento API contiene i parametri e gli esempi. Per scopo:

  • Calendario: leggere il calendario unificato di prenotazioni e blocchi; creare, modificare ed eliminare gli orari bloccati.
  • Trovare gli orari: servizi, staff, i prossimi orari liberi, blocchi temporanei su un orario.
  • Modificare le prenotazioni: aggiornare i dettagli, spostare una prenotazione sul posto.
  • Note: leggere e scrivere note su una prenotazione o su un cliente, con promemoria.
  • Link: link di prenotazione personali, elenco, revoca.
  • Clienti: profili, aggiornamento, cancellazione dei dati di prenotazione.
  • Pagamenti: elenco, link di pagamento, rimborsi, segnare una prenotazione come pagata; pacchetti e assegnazioni.
  • Sondaggi: creare, elencare, chiudere, prenotare un orario.
  • Webhook: booking.updated, booking.note.created, calendar.block.created, calendar.block.deleted, booking.paid, booking.refunded, payment.paid, package.purchased, poll.voted, poll.closed, booking.customer.erased. Ogni webhook riceve tutti gli eventi.
  • MCP: strumenti corrispondenti per gli agenti, per esempio get_calendar, find_next_booking_slots, reschedule_booking, add_booking_note, create_booking_link, request_payment.

Le scritture richiedono lo scope bookings:manage. Le chiavi sandbox non possono scrivere, rimborsare né cancellare.

Non ancora disponibile

  • Appuntamenti ricorrenti e lista d'attesa.
  • Prenotazioni che richiedono prima la sua approvazione.
  • Abbonamenti e addebiti ricorrenti.
  • Imposte e fatture (la ricevuta di Stripe o PayPal è la ricevuta).
  • Pagamenti parziali oltre a una caparra e pagamento con carta dentro WhatsApp stesso.
  • E-mail di massa ai clienti (Broadcasts invia WhatsApp di massa).
  • Una prenotazione senza un numero WhatsApp: ogni cliente ne ha bisogno.
  • Trascinamento nel calendario (Move è un pulsante).
  • Lingue diverse dall'inglese nella pagina online.

Tutto ciò che precede si imposta nella pagina Book-and-Pay della dashboard (/dashboard/app/book). Domande: support@app2email.com.

Torna all'inizio