Ações Zendesk

As ações Zendesk permitem interações com tickets e outros recursos através da API do Zendesk.

Todas as ações do Zendesk devem usar a instância de conexão Zendesk criada pela ação connect.

Ações

zendesk.connect

Estabelece uma conexão com a API do Zendesk usando as credenciais fornecidas.

Parâmetros:

email (opcional) - Email da conta Zendesk.
password (opcional) - Senha da conta Zendesk.
subdomain (opcional) - Subdomínio da instância Zendesk.
token (opcional) - Token de API para autenticação.
oauth_token (opcional) - Token OAuth para autenticação.

Retorno:

zendesk - Instância de conexão com a API do Zendesk.

Exceções:

Esta ação não retorna exceções.

zendesk.search

Busca tickets no Zendesk com base nos critérios fornecidos.

Parâmetros:

zendesk - Instância de conexão Zendesk retornada por zendesk.connect.
kwargs - Filtros e critérios para a busca no Zendesk.

Retorno:

tickets - Lista de tickets que correspondem aos critérios, cada um representado como um dicionário.

Exceções:

Esta ação não retorna exceções.

zendesk.add_tags

Adiciona tags a um ticket específico do Zendesk.

Parâmetros:

zendesk - Instância de conexão Zendesk retornada por zendesk.connect.
ticket_id - ID do ticket a ser atualizado.
tags - Lista de tags ou uma única tag em string a ser adicionada.

Retorno:

Esta ação não retorna nada.

Exceções:

ValueError - se o parâmetro tags não for string nem lista.

zendesk.change_status

Altera o status de um ticket específico do Zendesk.

Parâmetros:

zendesk - Instância de conexão Zendesk retornada por zendesk.connect.
ticket_id - ID do ticket a ser atualizado.
new_status - Status a ser atribuído ao ticket (ex.: "solved", "open").

Retorno:

Esta ação não retorna nada.

Exceções:

Esta ação não retorna exceções.