· 5 min · TextMeFlow Team

Notifications WhatsApp pour les tickets Freshdesk via webhook

Freshdesk informe un client par e-mail que son ticket est résolu. La plupart des gens n'ouvrent cet e-mail que des heures plus tard, si tant est qu'ils l'ouvrent, et rouvrent alors le ticket en répondant « des nouvelles ? » parce qu'ils n'ont jamais vu la résolution. WhatsApp est lu en quelques minutes. Freshdesk n'a pas de canal de notification WhatsApp natif, mais ses règles d'automatisation peuvent appeler un webhook, et ce webhook peut appeler directement l'API de messages de TextMeFlow : pas d'application de marketplace, pas d'abonnement à un middleware.

Étape 1 : créez la règle d'automatisation dans Freshdesk

Dans Freshdesk, allez dans Admin → Workflows → Automations → Ticket Updates et créez une nouvelle règle. Définissez la condition sur la transition pour laquelle vous voulez réellement un message, généralement « le statut passe à Resolved » ou « le statut passe à Open ET le statut précédent était Pending » (c'est-à-dire que la réponse est désormais attendue de votre côté, et non du client). Évitez de déclencher sur « toute mise à jour du ticket » : Freshdesk émet cet événement aussi pour les notes internes, les changements de tags et la réaffectation d'agent, et vous ne voulez pas d'un message WhatsApp pour chacun d'eux.

Ajoutez à la règle une action « Trigger Webhook » :

  • Type de requête : POST
  • URL de rappel : votre récepteur, par ex. https://yourapp.example.com/freshdesk-hook
  • Encodage : JSON
  • Authentification : Freshdesk permet d'ajouter un en-tête personnalisé ; utilisez-le pour transporter un secret partagé, car le corps du webhook n'a pas de signature intégrée

Étape 2 : façonnez le payload avec des placeholders

L'éditeur de corps de webhook de Freshdesk prend en charge les placeholders de ticket. Limitez le payload à ce dont votre récepteur a besoin :

{
  "ticket_id": "{{ticket.id}}",
  "status": "{{ticket.status}}",
  "subject": "{{ticket.subject}}",
  "requester_phone": "{{ticket.requester.mobile}}"
}

Freshdesk enregistre les numéros de téléphone des contacts sous mobile ou phone, selon le champ que le demandeur a rempli : vérifiez les deux dans votre récepteur, car beaucoup de contacts n'en ont qu'un des deux renseigné.

Étape 3 : recevez le webhook et envoyez le message WhatsApp

from flask import Flask, request
import os, requests

app = Flask(__name__)

@app.post("/freshdesk-hook")
def freshdesk_hook():
    if request.headers.get("X-Webhook-Secret") != os.environ["FRESHDESK_WEBHOOK_SECRET"]:
        return "", 401

    data = request.json
    phone = data.get("requester_phone")
    if not phone:
        return "", 200

    status = data.get("status")
    subject = data.get("subject")
    ticket_id = data.get("ticket_id")

    if status == "Resolved":
        text = f'Votre ticket "{subject}" (#{ticket_id}) a été résolu. Répondez ici si vous avez encore besoin d’aide.'
    else:
        text = f'Nous attendons votre réponse pour le ticket "{subject}" (#{ticket_id}).'

    requests.post(
        "https://api.textmeflow.eu/v1/messages",
        headers={"Authorization": f'Bearer {os.environ["TEXTMEFLOW_TOKEN"]}'},
        json={"to": phone, "text": text},
    )
    return "", 200

La même requête fonctionne depuis PHP ou Node avec n'importe quel client HTTP : voir les exemples PHP, Python et Node si Python n'est pas votre stack.

Étape 4 : normalisez d'abord le numéro de téléphone

Freshdesk n'impose aucun format de téléphone sur la fiche contact : mobile peut valoir 0470 12 34 56, +32470123456, ou être simplement vide. L'API de TextMeFlow exige strictement le format E.164 et rejette tout le reste avec 400 invalid_recipient. Passez le numéro dans un normaliseur avant l'envoi, et ne faites pas l'envoi (sans deviner d'indicatif pays) quand le champ est vide ou n'est manifestement pas un numéro de téléphone. Le guide de validation des numéros de téléphone détaille davantage l'étape de normalisation.

Étape 5 : n'envoyez pas de message à chaque réponse

Un ticket avec de longs échanges peut déclencher plusieurs fois par heure la condition « le statut change » si un agent le fait basculer entre Open et Pending pendant le diagnostic. Cadrez la règle de près (résolu, ou réellement en attente du client) plutôt que de réagir à chaque changement de statut. Le pipeline anti-spam de TextMeFlow ralentit un numéro qui reçoit des rafales de messages d'apparence automatisée : cela protège votre numéro WhatsApp, mais signifie aussi qu'une règle trop bavarde verra une partie de ses messages retardés plutôt que livrés instantanément.

Des alertes aussi pour les agents

La même structure de règle fonctionne pour les notifications internes : une condition sur « SLA échu dans 30 minutes » ou « ticket qui m'est réaffecté » qui écrit au numéro WhatsApp de l'agent plutôt qu'à celui du demandeur. Ce trafic est individuel et interne, sans question de consentement, ce qui en fait une première intégration sûre pour tester votre récepteur avant de pointer le webhook vers des numéros de clients.

Démarrez gratuitement sur TextMeFlow : 50 messages par mois, sans limite de durée, de quoi mettre en place une automatisation Freshdesk de bout en bout avant de choisir un plan payant.

Envie d'envoyer des messages WhatsApp via API ?

Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.

Gratuit pour toujours