Installazione & configurazione
Installa l'app
Andare all'app ClickSend SMS sul Marketplace di Zendesk.
Cliccare su Installa, quindi scegliere il proprio account Zendesk.
Cliccare di nuovo su Installa per confermare.
Autenticarsi con ClickSend
In Zendesk, andare al Centro amministrativo > App e integrazioni > ClickSend SMS.
Inserire il proprio username ClickSend e la chiave API (disponibili qui).
Cliccare su Connetti a ClickSend.
Dopo la connessione, la cronologia degli SMS verrà caricata.
Invio di SMS da Zendesk
Ci sono tre modi per inviare SMS all'interno di Zendesk:
1. Barra superiore (SMS rapido – Consigliato)
Accessibile da qualsiasi pagina in Zendesk.
Ideale per messaggi rapidi e personalizzati ai contatti.
2. Barra laterale dei ticket
Da utilizzare quando si lavora su un ticket con un numero di telefono salvato.
Ideale per le risposte del servizio clienti all'interno delle conversazioni.
3. Barra di navigazione (Messaggistica di massa)
Inviare SMS singoli o di massa a gruppi o organizzazioni.
Ottimo per annunci, promozioni o avvisi.
Ricezione di SMS in entrata
Le risposte appaiono in tempo reale sul pannello di controllo di Zendesk.
I messaggi non letti presentano un indicatore a punto rosso.
Nota: Zendesk potrebbe non mostrare le risposte se l'account ClickSend ha più di 10 regole in entrata. Scopri di più sulle Regole in entrata.
Suggerimento: Controllare regolarmente il pannello di controllo per garantire risposte tempestive.
SMS automatici tramite webhook + trigger
Utilizzare i trigger di Zendesk per inviare automaticamente SMS quando si verificano aggiornamenti dei ticket.
Crea un webhook
Andare al Centro amministrativo > App e integrazioni > Webhook.
Cliccare su Crea webhook.
Utilizzare le seguenti impostazioni:
URL endpoint: https://rest.clicksend.com/v3/sms/send
Metodo: POST
Formato: JSON
Autenticazione: Basic Auth (username ClickSend + chiave API)
Aggiungi un trigger
Andare su Trigger > Aggiungi trigger.
Scegliere una categoria (es. Ticket).
Aggiungere un'azione:
Notifica webhook attivo → selezionare il proprio webhook ClickSend.
Aggiungere questo al corpo JSON:
Di base:
{
"messages": [
{
"to": "+61411111111",
"source": "zendesk",
"body": "questo è un messaggio di prova"
}
]
}Esempio dinamico:
{
"messages": [
{
"to": "##{{current_user.phone}}",
"source": "zendesk",
"body": "Ciao ##{{current_user.first_name}}, lo stato di ##{{ticket.brand.name}} è stato modificato in ##{{ticket.status}}."
}
]
}
FAQ
Come mi autentico?
Utilizzare lo username ClickSend e la chiave API (non la password).
Posso tracciare la consegna degli SMS?
Sì, lo stato degli SMS può essere tracciato tramite la Barra superiore, la Barra laterale e la Barra di navigazione.
Posso inviare messaggi di massa?
Sì, utilizzare la Barra di navigazione e selezionare un gruppo o un'organizzazione.
Le risposte funzionano con tutti i tipi di mittente?
Le risposte funzionano con numeri condivisi o dedicati. Non supportato con Alpha Tag o con il proprio numero.
Posso usare un ID mittente Alpha Tag?
Sì, nei paesi supportati. Limite: 11 caratteri, nessuno spazio.
Aggiungere il campo from nel corpo JSON:
{
"messages": [
{
"to": "+61411111111",
"from": "MyCompany",
"body": "questo è un messaggio di prova"
}
]
}
Risoluzione dei problemi
Autenticazione
Assicurarsi di utilizzare lo username ClickSend e la chiave API, non la password.
Gli SMS in entrata non funzionano?
Assicurarsi di disporre di un numero dedicato.
Limitare le regole del webhook a meno di 10.
Credito dell'account
Assicurarsi che l'account ClickSend abbia credito sufficiente. Ricarica qui.
Invio globale
Abilitare l'invio globale per i paesi di destinazione. Contattare il supporto per assistenza.
Formattazione del numero di telefono
Utilizzare il formato internazionale (es. +1XXXXXXXXXX per gli USA).
Campi del messaggio mancanti
Assicurarsi che i campi obbligatori come il numero del destinatario e il corpo del messaggio siano compilati.