Struttura del payload

interface WebhookPayload {
  event_id: string; // ID univoco dell'evento webhook (ID della risposta)
  event_type: "form_response"; // Sempre "form_response" per le risposte alle survey
  form_response: FormResponse; // I dati principali della risposta
}

interface FormResponse {
  form_id: string; // ID della survey
  token: string; // Token/ID della risposta
  submitted_at: string; // Timestamp ISO 8601 UTC quando la risposta è stata inviata
  landed_at: string; // Timestamp ISO 8601 UTC quando l'utente ha iniziato la survey
  calculated?: {
    score?: number; // Punteggio calcolato
    [k: string]: unknown; // Campi calcolati aggiuntivi
  } | null;
  variables?: Variable[]; // Variabili del form provenienti dai parametri URL
  hidden?: Record<string, string>; // Campi nascosti (se presenti)
  definition: FormDefinition; // Definizione della struttura della survey
  answers: Answer[]; // Risposte dell'utente
  ending?: EndingRef; // Schermata finale mostrata all'utente
}

interface FormDefinition {
  id: string; // ID della survey (uguale a form_id)
  title: string; // Titolo della survey
  fields: FieldDefinition[]; // Domande/campi della survey
  endings?: EndingDefinition[]; // Possibili schermate finali
}

interface FieldDefinition {
  id: string; // ID univoco del campo
  title: string; // Testo della domanda
  type: FieldType; // Tipo di domanda (vedi sotto)
  ref?: string; // Identificatore di riferimento opzionale
  allow_multiple_selections?: boolean; // Per domande a scelta multipla
  allow_other_choice?: boolean; // Se l'opzione "Altro" è disponibile
  choices?: ChoiceDefinition[]; // Scelte disponibili (per domande a scelta)
  properties?: Record<string, unknown>; // Proprietà aggiuntive del campo
}

type FieldType =
  | "short_text"
  | "long_text"
  | "email"
  | "number"
  | "picture_choice"
  | "single_choice"
  | "multiple_choice"
  | "yes_no"
  | "opinion_scale"
  | "rating"
  | "swipe"
  | "single_choice";

interface ChoiceDefinition {
  id: string; // ID della scelta
  label: string; // Testo/etichetta della scelta
  ref?: string; // Riferimento opzionale
}

interface Variable {
  key: string; // Nome della variabile
  type: "text" | "number"; // Tipo della variabile
  text?: string; // Valore testuale (se il tipo è "text")
  number?: number; // Valore numerico (se il tipo è "number")
}

// Risposta Testuale
interface TextAnswer {
  type: "text";
  text: string;
  field: { id: string; type: FieldType; ref?: string };
}

// Risposta Booleana
interface BooleanAnswer {
  type: "boolean";
  boolean: boolean;
  field: FieldReference;
}

// Risposta Numerica
interface NumberAnswer {
  type: "number";
  number: number;
  field: FieldReference;
}

// Risposta a Scelta Singola
interface SingleChoiceAnswer {
  type: "choice";
  choice: {
    id?: string;
    label?: string;
    ref?: string;
    other?: string; // Testo personalizzato se è stato scelto "Altro"
  };
  field: FieldReference;
}

// Risposta a Scelte Multiple
interface MultipleChoicesAnswer {
  type: "choices";
  choices: {
    ids?: string[];
    labels?: string[];
    refs?: string[];
    other?: string;
  };
  field: FieldReference;
}