Installation & configuration

Installer l'application

Allez sur l'application ClickSend SMS sur le Zendesk Marketplace.
Cliquez sur Installer, puis choisissez votre compte Zendesk.
Cliquez à nouveau sur Installer pour confirmer.

S'authentifier avec ClickSend

Dans Zendesk, allez dans Centre d'administration > Applications et intégrations > ClickSend SMS.
Saisissez votre nom d'utilisateur ClickSend et votre clé API (trouvée ici).
Cliquez sur Se connecter à ClickSend.
Une fois connecté, votre historique de SMS sera renseigné.

Envoi de SMS depuis Zendesk

Il existe trois façons d'envoyer des SMS dans Zendesk :

1. Barre supérieure (SMS rapide – Recommandé)

Accessible depuis n'importe quelle page dans Zendesk.
Idéal pour les messages rapides et personnalisés aux contacts.

2. Barre latérale de ticket

À utiliser lorsque vous travaillez sur un ticket avec un numéro de téléphone sauvegardé.
Idéal pour les réponses du service client au sein des conversations.

3. Barre de navigation (Messagerie en masse)

Envoyer un SMS individuel ou des SMS en masse à des groupes ou des organisations.
Parfait pour les annonces, les promotions ou les alertes.

Réception de SMS entrants

Les réponses apparaissent en temps réel sur votre tableau de bord Zendesk.
Les messages non lus affichent un indicateur de point rouge.
Remarque : Zendesk peut ne pas afficher les réponses si votre compte ClickSend comporte plus de 10 règles entrantes. En savoir plus à propos des règles entrantes.

Astuce : Vérifiez régulièrement votre tableau de bord pour garantir des réponses rapides.

SMS automatisés via Webhook + Déclencheurs

Utilisez les déclencheurs Zendesk pour envoyer des SMS automatiquement lors de la mise à jour d'un ticket.

Créer un Webhook

Allez dans Centre d'administration > Applications et intégrations > Webhooks.
Cliquez sur Créer un webhook.
Utilisez les paramètres suivants :
1. URL du point de terminaison : https://rest.clicksend.com/v3/sms/send
2. Méthode : POST
3. Format : JSON
4. Authentification : Basic Auth (nom d'utilisateur ClickSend + clé API)

Ajouter un déclencheur

Allez dans Déclencheurs > Ajouter un déclencheur.
Choisissez une catégorie (ex. : Tickets).
Ajoutez une action :
- Notifier le webhook actif → sélectionnez votre webhook ClickSend.
Ajoutez ceci au corps JSON :

De base :

{
  "messages": [
    {
      "to": "+61411111111",
      "source": "zendesk",
      "body": "ceci est un message de test"
    }
  ]
}

Exemple dynamique :

{
  "messages": [
    {
      "to": "{{current_user.phone}}",
      "source": "zendesk",
      "body": "Bonjour {{current_user.first_name}}, le statut de {{ticket.brand.name}} a été changé en {{ticket.status}}."
    }
  ]
}

FAQ

Comment m'authentifier ?

Utilisez votre nom d'utilisateur ClickSend et votre clé API (pas votre mot de passe).

Puis-je suivre la livraison des SMS ?

Oui, le statut des SMS peut être suivi via la barre supérieure, la barre latérale et la barre de navigation.

Puis-je envoyer des messages en masse ?

Oui, utilisez la barre de navigation et sélectionnez un groupe ou une organisation.

Les réponses fonctionnent-elles avec tous les types d'expéditeurs ?

Les réponses fonctionnent avec les numéros partagés ou dédiés. Non pris en charge avec les balises alpha ou votre propre numéro.

Puis-je utiliser un ID d'expéditeur de balise alpha ?

Oui, dans les pays pris en charge. Limite : 11 caractères, sans espaces.

Ajoutez le champ from dans votre corps JSON :

{
  "messages": [
    {
      "to": "+61411111111",
      "from": "MyCompany",
      "body": "ceci est un message de test"
    }
  ]
}

Résolution de problèmes

Authentification
- Assurez-vous d'utiliser votre nom d'utilisateur ClickSend et votre clé API, pas votre mot de passe.
Les SMS entrants ne fonctionnent pas ?
- Assurez-vous d'avoir un numéro dédié.
- Limitez les règles de webhooks à moins de 10.
Crédit du compte
- Assurez-vous que votre compte ClickSend a suffisamment de crédit. Rechargez ici.
Envois mondiaux
- Activez les envois mondiaux pour vos pays cibles. Contactez le support pour obtenir de l'aide.
Formatage du numéro de téléphone
- Utilisez le format international (par exemple, +1XXXXXXXXXX pour les États-Unis).
Champs de message manquants
- Assurez-vous que les champs requis comme le numéro du destinataire et le corps du message sont remplis.

Guide d'intégration : Zendesk