Créer un ticket

Les développeurs peuvent créer des tickets via l'API. Après la création du ticket, l'identifiant du ticket sera renvoyé.

Méthode de requête

POST

URL de requête

https://livedesk-api.engagelab.com/api/v2/accounts/tickets

Authentification

Consultez la description de l'authentification dans Présentation de l'API pour plus de détails.

Requête

Exemple de requête

curl -X POST 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets' \ -H 'Content-Type: application/json' \ -H 'Authorization: Basic base64(api_key:api_secret)' \ -d '{ "title": "Bourrage papier imprimante, impossible d'imprimer", "description": "Le client signale un bourrage de papier A4 au niveau du bac de sortie, nécessite une intervention urgente.", "attachments": [ { "file_url": "https://example.com/files/error.jpg" } ], "requester": { "euid": "contact_12345", "channel_contacts": { "channel_id": "inbox_100", "contact_id": "-1001234567890", "sub_contact_id": "23232323", "followers": [ { "id": "7562646527", "name": "Zhang San" } ] } }, "submitter": { "id": "u_12345" }, "assignment_team": "Support informatique", "priority": "haute", "ticket_type": "incident", "custom_fields": { "device_sn": "PRN-2024-001", "location": "Siège Pékin - Salle d'impression 3e étage" } }'

              
              curl -X POST 'https://livedesk-api.engagelab.com/api/v2/accounts/tickets' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
  "title": "Bourrage papier imprimante, impossible d'imprimer",
  "description": "Le client signale un bourrage de papier A4 au niveau du bac de sortie, nécessite une intervention urgente.",
  "attachments": [
    {
      "file_url": "https://example.com/files/error.jpg"
    }
  ],
  "requester": {
    "euid": "contact_12345",
    "channel_contacts": {
      "channel_id": "inbox_100",
      "contact_id": "-1001234567890",
      "sub_contact_id": "23232323",
      "followers": [
        {
          "id": "7562646527",
          "name": "Zhang San"
        }
      ]
    }
  },
  "submitter": {
    "id": "u_12345"
  },
  "assignment_team": "Support informatique",
  "priority": "haute",
  "ticket_type": "incident",
  "custom_fields": {
    "device_sn": "PRN-2024-001",
    "location": "Siège Pékin - Salle d'impression 3e étage"
  }
}'

Afficher ce bloc de code dans la fenêtre flottante

En-têtes de requête

Champ	Type	Description
Authorization	string	Utilisez `Authorization: Basic base64(API Key:API Secret)` pour l'authentification. Rendez-vous sur la page de la clé API pour obtenir la clé API et le secret, puis reliez-les par deux-points avant l'encodage Base64.
Content-Type	application/json	Type de données, la valeur est application/json.

Paramètres du corps de la requête

Champ	Type	Obligatoire	Description
title	String	Oui	Titre du ticket.
description	String	Non	Description du contenu du ticket, prend en charge le format md.
attachments	Array	Non	Tableau de pièces jointes, à téléverser d'abord via /upload.
file_url	String	Oui	Adresse du fichier.
requester	Object	Oui	Informations sur le demandeur.
euid	String	Non	Identifiant unique du contact.
channel_contacts	Object	Non	Mappage des contacts du canal (au moins un euid doit exister).
channel_id	String	Oui	Identifiant du canal.
contact_id	String	Oui	Identifiant du contact du canal (ex : TG chat_id).
sub_contact_id	String	Non	Identifiant du sous-contact du canal (ex : TG topic_id / Email thread_id).
followers	Array	Non	Informations sur les abonnés (pour notification/push dans le canal), inclut les champs id et name. id : Identifiant de l'abonné. name : Nom de l'abonné.
submitter	Object	Non	ID du soumissionnaire (ID de compte membre interne), inclut le champ id. id : ID du soumissionnaire.
assignment_team	String	Non	Nom de l'équipe assignée (doit exister).
priority	String	Non	Priorité : haute/moyenne/faible, la valeur par défaut est moyenne si non précisé.
ticket_type	String	Non	Type de ticket : problème/incident/question/tâche/Aucun, la valeur par défaut est Aucun si non précisé.
custom_fields	Object	Non	Champs personnalisés (informations de source, etc.), au format clé-valeur.

Exemple de réponse

Réponse en cas de succès

{ "code": 0, "message": "Succès", "data": { "ticket_id": "tk_20251104_789abc", "message": "Ticket créé avec succès" } }

              
              {
  "code": 0,
  "message": "Succès",
  "data": {
    "ticket_id": "tk_20251104_789abc",
    "message": "Ticket créé avec succès"
  }
}

Afficher ce bloc de code dans la fenêtre flottante

Paramètres de la réponse

Champ	Type	Obligatoire	Description
ticket_id	String	Non	Identifiant du ticket.
message	String	Non	Message de retour, ex : "Ticket créé avec succès"