Questa guida presuppone che tu abbia già installato il connettore. In caso contrario, consulta prima la Guida all’installazione.

Apertura della schermata di configurazione

Dal Gateway of Tally, seleziona SurveyAnalytica Connector. La schermata di configurazione è composta da due sezioni: Global Settings in alto e una tabella Transaction Types in basso.

Passaggio 1 — Scegli il tuo ambiente

Nella parte superiore della schermata, usa il menu a tendina Environment per selezionare:

• Test — invia i dati all’ambiente di staging di SurveyAnalytica. Usa questa opzione durante la configurazione e i test.
• Production — invia i dati al tuo account SurveyAnalytica live. Passa a questa opzione una volta completati i test.

Passaggio 2 — Ottieni l’URL del Webhook e l’API Key da SurveyAnalytica

1. In SurveyAnalytica, apri il workflow che deve ricevere i dati di Tally.
2. Fai clic sul passaggio Trigger e assicurati che il tipo di trigger sia impostato su Webhook.
3. Prendi nota del valore KEY — questa è la tua API Key per il connettore.
4. Prendi nota del Workflow ID — è l’identificatore univoco mostrato nell’URL del webhook dopo /webhook/.

Passaggio 3 — Configura i tipi di transazione

La tabella Transaction Types elenca tutti i tipi di voucher e i record master disponibili nella tua azienda Tally, inclusi eventuali tipi personalizzati aggiunti da altri moduli TDL.

Per ogni tipo di transazione che desideri sincronizzare:

1. Imposta Enable su Yes.
2. Inserisci il Workflow ID di SurveyAnalytica (la parte dopo /webhook/ nel tuo URL del webhook).
3. Inserisci l’API Key (il valore KEY dal pannello del trigger).
4. Scegli un Auth Type:
   • API Key — scelta standard per la maggior parte dei workflow.
   • Basic Auth — usa nome utente e password separati da due punti nel campo API Key.
   • OAuth 2.0 — inserisci le tue credenziali client OAuth; il connettore recupera e rinnova i token automaticamente.
   • HMAC-SHA256 — genera una firma della richiesta per una maggiore sicurezza.
5. Scegli una Trigger Mode:
   • Realtime — invia i dati immediatamente ogni volta che viene salvato un voucher di questo tipo.
   • Batch — raccoglie i voucher e li invia insieme a intervalli prestabiliti (5, 15, 30 o 60 minuti). Usa questa opzione per ridurre il traffico di rete per i tipi di transazione ad alto volume.
   • Scheduled — esegue una sincronizzazione completa su base giornaliera, settimanale o mensile all’orario specificato. Adatto per i report di fine giornata.
   • One-time — usa il pulsante manuale Sync Now nel menu del connettore per esportazioni occasionali.

Puoi configurare Workflow ID, Auth Type e Trigger Mode diversi per ciascun tipo di transazione in modo indipendente.

Passaggio 4 — Salva la configurazione

Premi Ctrl+A oppure fai clic su Save Config. Le tue impostazioni vengono salvate all’interno di Tally e restano valide dopo i riavvii.

Passaggio 5 — Testa la connessione

1. Dal menu Gateway of Tally → SurveyAnalytica Connector, seleziona Test Connection.
2. Il connettore invia un ping di prova a ciascun workflow abilitato e mostra un messaggio di successo o di errore per ogni tipo di transazione.
3. In SurveyAnalytica, vai al trigger del workflow e fai clic su Check Status per confermare che il payload di test sia stato ricevuto.

Invio di un voucher di prova

Salva un voucher qualsiasi di un tipo abilitato in Tally (ad esempio, crea un Sales Voucher di prova). Se la modalità del trigger è Realtime, i dati compaiono nel tuo workflow SurveyAnalytica entro pochi secondi. Puoi visualizzarli nel pannello Check Status del workflow, nel pannello del trigger.

Risoluzione dei problemi

I dati non arrivano in SurveyAnalytica

• Verifica che il workflow sia nello stato Active in SurveyAnalytica.
• Verifica che il Workflow ID e l’API Key siano stati inseriti correttamente — copiali e incollali invece di digitarli.
• Conferma che l’ambiente corretto (Test o Production) sia selezionato nel connettore.
• Se utilizzi la modalità Batch, attendi che l’intervallo trascorra, oppure passa temporaneamente a Realtime per verificare che la connessione funzioni.

Il menu SurveyAnalytica Connector non è presente nel Gateway of Tally

• Conferma che il file TDL sia elencato e abilitato in F12 → TDL & Add-On.
• Controlla eventuali errori di caricamento TDL tramite Help → TDL & Add-On.
• Assicurati che la tua versione di Tally Prime sia la 7.0 o successiva.

Test Connection mostra un errore

• Verifica che il tuo PC Tally abbia accesso a internet e possa raggiungere integration.surveyanalytica.com (Production) o l’URL di test.
• Se la tua azienda utilizza un proxy o un firewall, chiedi al tuo team IT di consentire il traffico HTTPS in uscita verso quei domini.