Recent Articles

Transferir Chamado

Este método permite realizar a transferência de um chamado entre atendentes e/ou departamentos.Endpointhttps://api.tomticket.com/v2.0/ticket/transferMétodo HTTPPOSTContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros de RequisiçãoChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximoticket_idIdentificador do chamado.Sim-String512department_idIdentificador do departamento.Não-String512operator_idIdentificador do atendente.Não-String512RetornoDescrição do retorno em JSON.ColunaDescrição da ColunaTipoerrorInforma se ocorreu um erro na operação. Se…

Não consigo excluir um atendente

Descrição do ErroCaso esteja vendo o erro "Este atendente não pode ser removido por haver atendimentos/chamados vinculados." ao tentar excluir um atendente, significa que este atendente não pode ser excluído por algum dos seguintes motivos:Este atendente possui chamados vinculadosEste atendente…

Uso da API com Postman

Para facilitar a compreensão de nossa API e gerar exemplos de código para diversas linguagens, fornecemos o download de uma Collection do Postman.Esta Collection contém os métodos da versão mais recente da API, permitindo que seja gerado de modo rápido…

Vincular Atendente em um Chamado

Este método permite vincular um atendente em um chamado.Endpointhttps://api.tomticket.com/v2.0/ticket/operator/linkMétodo HTTPPOSTContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros de RequisiçãoChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximoticket_idIdentificador do chamado.Sim-String250operator_idIdentificador do atendente.Sim-String250RetornoDescrição do retorno em JSON.ColunaDescrição da ColunaTipoerrorInforma se ocorreu um erro na operação. Se o retorno for false, então significa…

Consultar Chamado - Individualmente

Este método permite consultar os detalhes de um chamado.Endpointhttps://api.tomticket.com/v2.0/ticket/detailMétodo HTTPGETContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros Query StringOs parâmetros Query String são enviadas diretamente na URL após o símbolo de "?" ao final do endpoint. Cada parâmetro e valor deve ser enviado com…

Status de Chamado - Iniciar

Este método permite realizar a abertura de um status em um chamado.Endpointhttps://api.tomticket.com/v2.0/ticket/status/openMétodo HTTPPOSTContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros de RequisiçãoChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximoticket_idIdentificador do chamado.Sim-String512status_idIdentificador do status.Sim-String512commentObservação sobre a abertura do status.Não-String-RetornoDescrição do retorno em JSON.ColunaDescrição da ColunaTipoerrorInforma se ocorreu um erro na…

Status de Chamado - Encerrar

Este método permite realizar o encerramento de um status aberto em um chamado.Endpointhttps://api.tomticket.com/v2.0/ticket/status/closeMétodo HTTPPOSTContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros de RequisiçãoChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximoticket_idIdentificador do chamado.Sim-String512RetornoDescrição do retorno em JSON.ColunaDescrição da ColunaTipoerrorInforma se ocorreu um erro na operação. Se o retorno for false,…

Responder Chamado - Atendente

Este método permite responder um chamado como o atendente responsável.Somente será possível realizar essa operação se houver um atendente vinculado.Endpointhttps://api.tomticket.com/v2.0/ticket/reply/operatorMétodo HTTPPOSTContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros de RequisiçãoChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximoticket_idIdentificador do chamado.Sim-String250messageConteúdo da mensagem de resposta do chamado. Esta mensagem é enviada…

Responder Chamado - Cliente

Este método permite responder um chamado como cliente.Endpointhttps://api.tomticket.com/v2.0/ticket/reply/customerMétodo HTTPPOSTContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros de RequisiçãoChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximoticket_idIdentificador do chamado.Sim-String250messageConteúdo da mensagem de resposta do chamado. Esta mensagem é enviada no formato text/plain (texto puro).Sim-String512attachmentLista com todos os anexos do tipo FILES.…

Criar Chamado

Este método permite criar um novo chamado.Endpointhttps://api.tomticket.com/v2.0/ticket/newMétodo HTTPPOSTContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros de RequisiçãoChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximocustomer_idIdentificador interno ou e-mail do clienteSim-String250customer_id_typeTipo de identificador utilizado, sendo:I - Identificador internoE - EmailNãoIString1department_idIdentificador do departamento.Sim-String250subjectTítulo do chamado.Sim-String250messageConteúdo da mensagem de abertura do chamado. Esta…

Finalizar Chamado

Este método permite finalizar um chamado.Endpointhttps://api.tomticket.com/v2.0/ticket/finishMétodo HTTPPOSTContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros de RequisiçãoChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximoticket_idIdentificador do chamado.Sim-String250messageConteúdo da mensagem de finalização do chamado. Esta mensagem é enviada no formato text/plain (texto puro).Sim-String-attachmentLista com todos os anexos do tipo FILES. O tamanho…

Comentar Chamado

Este método permite adicionar um comentário em um chamado.Endpointhttps://api.tomticket.com/v2.0/ticket/commentMétodo HTTPPOSTContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros de RequisiçãoChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximoticket_idIdentificador do chamado.Sim-String250commentMensagem do comentário.Sim-String512attachmentLista com todos os anexos do tipo FILES. O tamanho máximo da requisição (com anexos) tem um limite de 25…

Consultar Chamados

Este método permite consultar todos os chamados criados em sua conta.A consulta de chamados exibe 50 itens por página, sendo necessário navegar entre as páginas para consultar outros resultados.Endpointhttps://api.tomticket.com/v2.0/ticket/listMétodo HTTPGETContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros Query StringOs parâmetros Query String são enviadas…

Consultar Chat - Individualmente

Este método permite obter informações de um chat de forma individual.Endpointhttps://api.tomticket.com/v2.0/chat/detailMétodo HTTPGETContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros Query StringOs parâmetros Query String são enviadas diretamente na URL após o símbolo de "?" ao final do endpoint. Cada parâmetro e valor deve ser…

Consultar Chats

Este método permite listar todos os atendimentos de chat que sua conta possui.A consulta de chats exibe 50 itens por página, sendo necessário navegar entre as páginas para consultar outros resultados.Endpointhttps://api.tomticket.com/v2.0/chat/listMétodo HTTPGETContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros Query StringOs parâmetros Query String…

Pesquisar Artigos da Base de Conhecimento

Este método permite pesquisar artigos existente em sua base de conhecimento.Endpointhttps://api.tomticket.com/v2.0/kb/searchMétodo HTTPGETContent Typeform-dataAutenticaçãoAuthorization: Bearer {SEU-TOKEN-AQUI}Parâmetros Query StringOs parâmetros Query String são enviadas diretamente na URL após o símbolo de "?" ao final do endpoint. Cada parâmetro e valor deve ser…