Descrizione
Connettore enterprise per Typeform — la piattaforma di form conversational design-first nata in Barcellona 2012 (2M+ paying customer) preferita da marketer e UX designer per la one-question-at-a-time interaction che produce 40% higher completion rate vs form tradizionali, integrazione massiccia con CRM/marketing automation tool, librerie di template ricchissime per ogni vertical (NPS survey, lead capture, job application, customer feedback, evento registration) — via Responses API + Forms API ufficiali. Cinque operazioni atomiche coprono il ciclo completo: listForms (elenco di tutti i form dell'account/workspace con metadata e analytics aggregate), getForm (definition completa di un form specifico con tutti i field, branching logic, ending screens — utile per pre-validation o introspection dello schema), listResponses (filter compound by completion status partial/completed, range di date submitted_at, hidden fields query), getResponse (fetch puntuale di una singola response by response_id con tutte le answers e metadata calculated), deleteResponses (operazione di cancellazione GDPR-aware con audit trail). Auth via Personal Access Token (formato tfp_xxxxx generato dall'admin Typeform in Settings → Personal tokens → Generate token con scope responses:read|write + forms:read) stored nel vault integration FlowForge. Auto-pagination per listResponses: usa cursor "after" + page_size 1000 max — il nodo automaticamente itera fino a recuperare TUTTE le response che matchano il filtro (con cap default 50000 totali per safety + memory), pattern naturale per sync incrementale del data warehouse. Rate limit Typeform: 4 req/sec per access token sustained, 60 req/min con burst — il nodo gestisce 429 con Retry-After header + backoff exponential automatico. Hidden fields support nativo: i hidden field passati come query string al form URL (es. ?utm_source=google&customer_id=42) sono inclusi nelle response answers — pattern critico per attribuire la response al touchpoint marketing che ha generated il traffic e alla customer entity preesistente nel CRM. Output rich: { forms: [{ id, title, links, settings }], form?, responses: [{ response_id, submitted_at, landed_at, calculated, answers: [{ field, type, value, ref }], hidden, metadata }], total, page_count }. Use case operativi reali della pipeline marketing/HR: lead form Typeform "scopri quale piano fa per te" → CRM HubSpot auto-import + dedup per email + lead scoring based on answers + assignment al sales rep corretto del territorio; NPS survey trimestrale → analytics dashboard real-time con avg per segment (customer tier, regione, vintage) e detect drop trimestre-su-trimestre come signal di churn risk; job application form per HR → Slack notify nel canale #hr-newapps + upload CV allegato su Google Drive + create Trello card "Review {{candidate_name}}" assegnata al recruiter manager; GDPR right-to-erasure workflow customer-driven (customer chiede cancellazione dati personali → workflow trova tutte le response Typeform con email match → deleteResponses → audit log immutable della cancellazione per compliance + email conferma al customer); webinar registration → automatic add a HubSpot list "webinar_attendees" + email confirmation con zoom link.
