Installation & configuration

Installer l'application

Allez sur l'application de service de messagerie simple ClickSend 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 service de messagerie simple.
Saisissez votre nom d'utilisateur ClickSend et votre clé API (trouvée ici).
Cliquez sur Se connecter à ClickSend.
Une fois connecté, votre historique de service de messagerie simple sera renseigné.

Envois de service de messagerie simple depuis Zendesk

Il existe trois façons d'envoyer des service de messagerie simple dans Zendesk :

1. Barre supérieure (service de messagerie simple 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èle au sein des conversations.

3. Barre de navigation (Messages en masse)

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

Recevoir des emails de service de messagerie simple 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.

Service de messagerie simple automatisé via Webhook + Déclencheurs

Utilisez les déclencheurs Zendesk pour envoyer un service de messagerie simple automatiquement lorsque l'on vient de mettre à jour 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}}, l'état du service 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 service de messagerie simple ?

Oui, l'état du service des service de messagerie simple 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. Pas de support avec les balises Alpha ou votre propre numéro.

Puis-je utiliser un identifiant 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 service de messagerie simple 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. Contacter 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