Descrizione
Connettore enterprise per Calendly — la piattaforma SaaS di booking di appuntamenti più diffusa per sales team B2B, consulenti, coach, recruiter, customer success (10M+ utenti, 100k+ paying customer business) che permette di pubblicare un pubblico booking link "trova uno slot libero con me" eliminando le 5-6 email back-and-forth di scheduling — via REST API v2 ufficiale. Cinque operazioni atomiche gestiscono l'intero lifecycle del booking: listScheduledEvents (recupera elenco di appuntamenti scheduled con filtri compound by user URI/organization URI/status active|cancelled/range di date min_start_time-max_start_time per dashboard analytics e sync incrementale), getEvent (fetch puntuale di un singolo event by URI univoco con metadata complete come location/duration/calendar_event_provider/invitee_questions_and_answers), listInvitees (gli invitee dell'evento — solitamente 1 per 1-to-1 meeting ma può essere N per group events), getInvitee (dettagli singolo invitee con email + nome + phone + answers ai prompt custom configurati dal Calendly admin nel form di booking), cancelEvent (cancellazione lato server con motivazione opzionale che notifica entrambe le parti via Calendly nativ). Auth via Personal Access Token formato eyJxxx (JWT generato da Calendly nell'admin dashboard Settings → Integrations → API & Webhooks → Personal Access Token, scope organization-wide o user-only), stored nel vault integration FlowForge accessibile via integrationLabel. Multi-account supportato per agenzie che gestiscono Calendly di N consulenti. Rate limit Calendly: 1000 req/h sustained per token (~16 RPS sustained, 30/sec burst), header X-RateLimit-Remaining trackato dal nodo per warning preventivo. Pagination automatica su listScheduledEvents (cursor-based "next_page_token") con cap default 500 events per workflow per evitare flood. Output: { events: [{ uri, name, start_time, end_time, status, location, invitees_counter, event_memberships }], invitees: [{ uri, email, name, phone?, status (active|canceled), questions_and_answers: [...], cancellation? }], event?, invitee?, cancelled? (boolean per cancelEvent operation) }. API docs ufficiali: developer.calendly.com/api-docs (v2 stable). Use case: sync new booking via webhook Calendly subscription → CRM lead automatic in HubSpot/Salesforce/Odoo con properties popolate dalle questions custom del form (es. "company_size", "budget_range", "main_challenge") e LeadSource=Calendly; reminder workflow 24h pre-meeting che parte da trigger_cron check daily + listScheduledEvents filter su tomorrow + email reminder personalizzato + WhatsApp message opzionale con link Zoom incluso; no-show detection per ricalibrare il forecasting (event passato + invitee status active non transitato a confirmed via webhook canceled = candidate no-show, marca contact in CRM per analytics conversion rate); aggregate weekly bookings nel sales dashboard del manager team commerciale con breakdown per consulente e source; trigger di onboarding workflow al primo meeting closed-won → invio kit benvenuto + creazione progetto in Asana + Slack channel dedicato al cliente.
