Créer des tickets de support depuis votre application avec une API REST

Votre produit est souvent au courant d’un problème avant même que votre client ne vous écrive. Un paiement échoue, une tâche de synchronisation plante, un utilisateur appuie sur « Signaler un problème ». Si ces événements arrivent dans la même file que les e-mails de vos clients, votre équipe n’a qu’un seul endroit à surveiller, et vos clients reçoivent de l’aide avant même d’avoir à la demander.

Ce guide explique comment créer des tickets de support depuis votre propre code avec l’API REST Uplio.

Ce dont vous avez besoin

• Un compte Uplio avec un espace de travail
• Une clé API, créée dans les paramètres de votre compte
• Votre ID d’espace de travail, affiché dans le tableau de bord avec un bouton pour le copier

Créer un ticket avec curl

L’API parle JSON via HTTPS et s’authentifie avec un jeton Bearer :

curl -X POST "https://app.uplio.io/api/v1/tickets?workspaceId=YOUR_WORKSPACE_ID" \
  -H "Authorization: Bearer $UPLIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Échec du paiement pour la commande n°1042",
    "description": "Stripe a renvoyé card_declined lors du paiement.",
    "priority": "high",
    "userId": "[email protected]"
  }'

Seul title est obligatoire. userId est l’e-mail (ou l’identifiant utilisateur) de la personne concernée par le ticket, et priority vaut low, normal ou high. Le nouveau ticket apparaît dans la colonne « Ouvert » de votre tableau, et les responsables de votre espace de travail reçoivent une alerte par e-mail.

Créer un ticket en JavaScript

La même requête depuis un backend Node.js :

async function createTicket({ title, description, email, priority = "normal" }) {
  const res = await fetch(
    `https://app.uplio.io/api/v1/tickets?workspaceId=${process.env.UPLIO_WORKSPACE_ID}`,
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${process.env.UPLIO_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ title, description, priority, userId: email }),
    },
  );
  if (!res.ok) throw new Error(`Erreur de l'API Uplio : ${res.status}`);
  return res.json();
}

Conservez la clé API sur votre serveur. Ne l’embarquez jamais dans du code navigateur ou mobile : envoyez d’abord les signalements in-app à votre propre backend, puis créez le ticket depuis celui-ci.

Trois approches à reprendre

1. Le bouton « Signaler un problème » dans l’application

Recueillez une courte description dans votre interface, ajoutez le contexte que l’utilisateur ne saisirait jamais lui-même (ID de compte, version de l’application, page en cours) et créez un ticket avec ces informations. Votre équipe démarre avec tout ce dont elle a besoin.

2. La remontée automatique des échecs

Lorsqu’une tâche en arrière-plan échoue d’une manière qui affecte un client, ouvrez un ticket de priorité high. Le support peut alors contacter le client de façon proactive, ce que les clients remarquent et apprécient.

3. Garder le design de votre propre formulaire

Si vous avez déjà un formulaire de contact soigneusement conçu, gardez-le. Envoyez ses soumissions à l’API plutôt qu’à une adresse e-mail : elles arriveront sous forme de tickets structurés.

Pour aller plus loin

Les tickets prennent aussi en charge les messages : vous pouvez ajouter un message à un ticket avec POST /api/v1/tickets/{id}/messages, et modifier le statut ou la priorité avec PATCH /api/v1/tickets/{id}. La liste complète des endpoints et des schémas se trouve dans la référence interactive de l’API.