Tickets

Visão geralEndpoints

No HubSpot, os tickets representam as solicitações de ajuda feitas por clientes. Os tickets são rastreados durante o processo de suporte nos status de pipeline até que sejam fechados. Os endpoints de tickets permitem controlar a criação e o gerenciamento de registros de tickets, bem como sincronizar os dados de tickets entre o HubSpot e outros sistemas. 

Saiba mais sobre objetos, registros, propriedades e APIs de associações no guia Noções básicas do CRM. Para obter informações mais gerais sobre objetos e registros no HubSpot, saiba como gerenciar seu banco de dados do CRM.

Criar tickets

Para criar novos tickets, faça uma solicitação POST para /crm/v3/objects/tickets.

Na solicitação, inclua os dados do ticket em um objeto de propriedades. Você também pode adicionar um objeto de associações para associar seu novo ticket a registros (por exemplo, contatos, empresas) ou atividades (por exemplo, reuniões, observações) existentes.

Propriedades

Os detalhes do ticket são armazenados nas propriedades do ticket. Existem propriedades de ticket padrão do HubSpot, mas você também pode criar propriedades personalizadas.

Ao criar um novo ticket, você deve incluir as seguintes propriedades na solicitação: subject (o nome do ticket), hs_pipeline_stage (o status do ticket) e, caso tenha vários pipelines, hs_pipeline. Se um pipeline não for especificado, o pipeline padrão será usado.

Para exibir todas as propriedades disponíveis, você pode recuperar uma lista das propriedades do ticket da sua conta, fazendo uma solicitação GET para /crm/v3/properties/tickets. Saiba mais sobre a API de propriedades.

Please note: you must use the internal ID of a ticket status or pipeline when creating a ticket via the API. The internal ID is a number, which will also be returned when you retrieve tickets via the API. You can find a ticket status or pipeline's internal ID in your ticket pipeline settings.

Por exemplo, para criar um novo ticket, a solicitação pode ser semelhante à seguinte:

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

Associações

Ao criar um novo ticket, você também pode associá-lo a registros ou atividades existentes. No objeto de associações, inclua os seguintes campos:

Use this table to describe parameters / fields
ParameterDescription
toObjectId

O ID do registro ou da atividade com o qual você deseja associar o ticket.

associationTypeId

Um identificador exclusivo para indicar o tipo de associação entre o ticket e o outro objeto ou atividade. Você pode recuperar o valor, fazendo uma solicitação GET para /crm/v4/associations/{fromObjectType}/{toObjectType}/labels. Saiba mais sobre a API de associações.

Você também pode incluir o campo label para atribuir um rótulo de associação definido que descreve a associação. Saiba mais sobre como associar registros por meio da API de associações.

Por exemplo, para associar um novo ticket a um contato e uma empresa existentes, a solicitação seria parecida com a seguinte:

///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 } ] }] }

Recuperar tickets

Você pode recuperar tickets individualmente ou em lotes. Para recuperar um ticket individual, faça uma solicitação GET para /crm/v3/objects/tickets/{ticketId}.

Para solicitar uma lista de todos os tickets, faça uma solicitação GET para /crm/v3/objects/tickets.

Para ambos os endpoints, você pode incluir os seguintes parâmetros de consulta no URL da solicitação: 

Use this table to describe parameters / fields
ParameterDescription
propriedades

Uma lista separada por vírgulas das propriedades a serem retornadas em resposta. Se o ticket solicitado não tiver um valor para uma propriedade, ele não será exibido na resposta.

associações

Uma lista separada por vírgulas de objetos para recuperar IDs associados. Todas as associações especificadas que não existem não serão retornadas na resposta. Saiba mais sobre a API de associações.

Saiba mais sobre a recuperação de tickets, clicando na guia Endpoints na parte superior deste artigo.

Atualizar tickets

Você pode atualizar tickets individualmente ou em massa. Para tickets existentes, o ID do ticket é um valor exclusivo que você pode usar para atualizar o ticket por meio da API.

Para atualizar um ticket individual por seu ID de ticket, faça uma solicitação PATCH para /crm/v3/objects/tickets/{ticketId} e inclua os dados que você deseja atualizar.

Associar tickets existentes a registros ou atividades

Para associar um ticket a outros registros do CRM ou a uma atividade, faça uma solicitação PUT para  /crm/v3/objects/tickets/{ticketId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}. 

To retrieve the associationTypeId value, make a GET request to /crm/v4/associations/{fromObjectType}/{toObjectType}/labels.

Saiba mais sobre a API de associações.

Remover uma associação

Para remover uma associação entre um ticket e um registro ou uma atividade, faça uma solicitação DELETE para o seguinte URL: /crm/v3/objects/tickets/{ticketId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}.

Excluir tickets

Você pode excluir tickets individualmente ou em massa, o que adicionará o ticket à lixeira no HubSpot. Posteriormente, você pode restaurar o ticket no HubSpot.

Para excluir um ticket individual por seu ID, faça uma solicitação  DELETE para /crm/v3/objects/tickets/{ticketId}.

Saiba mais sobre a exclusão em massa de tickets na guia Endpoints na parte superior deste artigo.

Este artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot..