Panoramica

SurveyAnalytica ti consente di collegare il tuo numero di telefono da Telnyx o Twilio per inviare e ricevere SMS nell’ambito delle tue campagne e dei tuoi workflow. Una volta collegato, le risposte dei contatti arrivano direttamente nella tua vista conversazioni.

Prima di iniziare

• Un numero di telefono acquistato da Telnyx o Twilio.
• Le credenziali API per quel numero (vedi il Passo 2 qui sotto).
• Un workspace all’interno di SurveyAnalytica a cui assegnare il numero.

Passo 1: Acquista un numero di telefono

Se non hai ancora un numero, acquistane uno dal provider scelto:

• Telnyx — Cerca e acquista numeri nel portale Telnyx
• Twilio — Cerca e acquista numeri nella console Twilio

Prendi nota del numero completo in formato internazionale, ad esempio +14155551234.

Passo 2: Ottieni le tue credenziali API

Telnyx

1. Accedi al portale Telnyx.
2. Vai su Auth > API Keys.
3. Clicca su Create API Key (oppure copia una chiave esistente che inizia con KEY...).
4. Copia la chiave completa — la incollerai nel campo API Key in SurveyAnalytica.

Twilio

1. Accedi alla console Twilio.
2. Nella dashboard principale, individua il tuo Account SID e Auth Token.
3. Combinali nel formato AccountSID:AuthToken (separati da due punti, senza spazi).
4. Incolla questo valore combinato nel campo API Key in SurveyAnalytica.

Passo 3: Collega il numero in SurveyAnalytica

1. Vai su Account > Domains & Numbers e apri la scheda SMS.
2. Compila il modulo di connessione:

Campo	Cosa inserire
Provider	Seleziona Telnyx o Twilio in base al tuo numero.
Phone Number (E.164)	Il tuo numero in formato internazionale, ad es. +14155551234. Deve iniziare con + seguito dal prefisso internazionale.
API Key	La tua chiave API Telnyx (KEY...), oppure il tuo AccountSID:AuthToken Twilio.
Display Name (opzionale)	Un’etichetta descrittiva, ad es. Support Line. Se lasciato vuoto, viene impostato di default sul numero di telefono.

3. Clicca su Connect. Se le credenziali non sono corrette apparirà un messaggio di errore — verifica la chiave API e riprova.

Passo 4: Assegna il numero a un workspace

Ogni numero collegato può essere assegnato a un solo workspace. Una volta che il numero appare nell’elenco:

1. Usa il menu a tendina Assign to workspace sulla scheda del numero.
2. Clicca su Save.

Il numero è ora disponibile quando componi campagne SMS o conversazioni in quel workspace.

Stato del webhook

Ogni scheda numero mostra un badge Webhook Active o Webhook Not Configured che si aggiorna automaticamente.

• Webhook Active — le risposte in entrata e gli aggiornamenti di consegna vengono ricevuti correttamente.
• Webhook Not Configured — SurveyAnalytica non è riuscita a registrare il gestore dei messaggi in entrata presso il provider. Verifica che la chiave API sia ancora valida, quindi prova a rimuovere e riaggiungere il numero.

Rimuovere un numero

Clicca su Delete sulla scheda del numero per scollegarlo. Il numero rimane nel tuo account Telnyx o Twilio ma smetterà di ricevere messaggi in entrata in SurveyAnalytica.

Risoluzione dei problemi

Sintomo	Cosa verificare
Errore “Failed to connect number”	Verifica che la chiave API sia corretta e non sia scaduta. Per Twilio, conferma che il formato sia AccountSID:AuthToken senza spazi extra.
Numero di telefono rifiutato	Assicurati che il numero sia in formato E.164: inizia con +, prefisso internazionale, poi il numero — senza spazi o trattini.
Webhook Not Configured dopo la connessione	Attendi un momento affinché il badge si aggiorni. Se rimane arancione, rimuovi e ricollega il numero con una nuova chiave API.
I messaggi in entrata non appaiono	Conferma che il numero sia assegnato al workspace corretto e che il badge del webhook mostri Active.