Tickets

Vue d'ensemblePoints de terminaison

Dans HubSpot, les tickets représentent des demandes d'aide des clients. Les tickets sont suivis tout au long de votre processus d'assistance avec des statuts de pipeline jusqu'à leur fermeture. Les points de terminaison des tickets vous permettent de créer et de gérer des fiches d'informations de ticket ainsi que de synchroniser des données de ticket entre HubSpot et d'autres systèmes. 

Découvrez-en davantage sur les API d'objets, de fiches d'informations, de propriétés et d'associations dans le guide Comprendre le CRM. Pour plus d'informations générales sur les objets et les fiches d'informations dans HubSpot, découvrez comment gérer votre base de données CRM.

Créer des tickets

Pour créer de nouveaux tickets, effectuez une demande de POST à /crm/v3/objects/tickets.

Dans votre demande, incluez les données de votre ticket dans un objet de propriétés. Vous pouvez également ajouter un objet d'association pour associer votre nouveau ticket à des fiches d'informations existantes (par exemple, des contacts ou des entreprises) ou à des activités (par exemple, des réunions ou des notes).

Propriétés

Les détails du ticket sont stockés dans des propriétés de ticket. Il existe des propriétés de ticket HubSpot par défaut, mais vous pouvez également créer des propriétés personnalisées.

Lorsque vous créez un nouveau ticket, vous devez inclure les propriétés suivantes dans votre demande : subject (le nom du ticket), hs_pipeline_stage (le statut du ticket) et, si vous avez plusieurs pipelines, hs_pipeline. Si aucun pipeline n'est spécifié, le pipeline par défaut sera utilisé.

Pour afficher toutes les propriétés disponibles, vous pouvez récupérer une liste des propriétés de ticket de votre compte en effectuant une demande GET à /crm/v3/properties/tickets. Découvrez-en davantage sur l'API des propriétés.

Remarque : Vous devez utiliser l'ID interne d'un statut de ticket ou d'un pipeline lors de la création d'un ticket via l'API. L'ID interne est un numéro, qui sera également retourné lorsque vous récupérerez des tickets via l'API. Vous pouvez trouver le statut de ticket ou l'ID interne d'un pipeline dans les paramètres de votre pipeline de tickets.

Par exemple, pour créer un nouveau ticket, votre demande peut ressembler à ce qui suit :

///Example request body { "properties": { "hs_pipeline": "0", "hs_pipeline_stage": "1", "hs_ticket_priority": "HIGH", "subject": "troubleshoot report" } }

Associations

Lorsque vous créez un nouveau ticket, vous pouvez également associer le ticket à des fiches d'informations ou activités existantes. Dans l'objet d'association, ajoutez les champs suivants :

Use this table to describe parameters / fields
ParameterDescription
toObjectId

L'ID de la fiche d'informations ou de l'activité à laquelle vous souhaitez associer le ticket.

associationTypeId

Un identifiant unique pour indiquer le type d'association entre le ticket et l'autre objet ou activité. Les types d'association par défaut sont répertoriés ici, ou vous pouvez récupérer la valeur en effectuant une demande GET à /crm/v4/associations/{fromObjectType}/{toObjectType}/labels. Découvrez-en davantage sur l'API des associations.

Vous pouvez également inclure le champ label pour attribuer un libellé d'association défini qui décrit l'association. Découvrez-en davantage sur l'association de fiches d'informations via l'API des associations.

Par exemple, pour associer un nouveau ticket à un contact et à une entreprise existants, votre demande ressemblerait à ce qui suit :

///Example request body { "properties": { "hs_pipeline": "0", "hs_pipeline_stage": "1", "hs_ticket_priority": "HIGH", "subject": "troubleshoot report" }, "associations": [ { "to": { "id": 201 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 16 } ] }, { "to": { "id": 301 }, "types": [ { "associationCategory": "HUBSPOT_DEFINED", "associationTypeId": 26 } ] }] }

Récupérer des tickets

Vous pouvez récupérer des tickets individuellement ou par lots. Pour récupérer un ticket individuel, effectuez une demande GET à /crm/v3/objects/tickets/{ticketId}.

Pour demander une liste de tous les tickets, effectuez une demande GET à /crm/v3/objects/tickets.

Pour les deux points de terminaison, vous pouvez inclure les paramètres suivants dans l'URL de la requête : 

Use this table to describe parameters / fields
ParameterDescription
properties

Une liste séparée par des virgules des propriétés à renvoyer dans la réponse. Si le ticket demandé n'a pas de valeur pour une propriété, il n'apparaîtra pas dans la réponse.

associations

Une liste séparée par des virgules des objets pour lesquels récupérer les ID associés. Les associations spécifiées qui n'existent pas ne seront pas renvoyées dans la réponse. Découvrez-en davantage sur l'API des associations.

Pour en savoir plus sur la récupération de tickets par lots, cliquez sur l'onglet Points de terminaison en haut de cet article.

Mettre à jour des tickets

Vous pouvez mettre à jour des tickets individuellement ou par lots. Pour les ticket existants, l'ID de ticket est une valeur unique que vous pouvez utiliser pour mettre à jour le ticket via l'API.

Pour mettre à jour un ticket individuel avec son ID de ticket, effectuez une demande PATCH à /crm/v3/objects/tickets/{ticketId} et incluez les données que vous souhaitez mettre à jour.

Associer des tickets existants à des fiches d'informations ou activités

Pour associer un ticket à d'autres fiches d'informations de CRM ou à une activité, effectuez une demande PUT à /crm/v3/objects/tickets/{ticketId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}.

Pour récupérer la valeur associationTypeId, reportez-vous à cette liste de valeurs par défaut ou effectuez une demande GET à/crm/v4/associations/{fromObjectType}/{toObjectType}/labels. 

Découvrez-en davantage sur l'API des associations.

Supprimer une association

Pour supprimer une association entre un ticket et une fiche d'informations ou une activité, effectuez une demande DELETE à l'URL suivante : /crm/v3/objects/tickets/{ticketId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}.

Supprimer des tickets

Vous pouvez supprimer des tickets individuellement ou par lots, ce qui placera le ticket dans la corbeille dans HubSpot. Vous pourrez ensuite restaurer le ticket dans HubSpot.

Pour supprimer un ticket avec son ID, effectuez une demande DELETE vers /crm/v3/objects/tickets/{ticketId}.

Pour en savoir plus sur la suppression de tickets par lots, cliquez sur l'onglet Points de terminaison en haut de cet article.

Cet article vous a-t-il été utile ?
Ce formulaire est destiné à recueillir les avis sur la documentation pour les développeurs. Si vous souhaitez faire part de votre avis sur les produits HubSpot, veuillez le partager sur le forum des idéesde la communauté.