Atualizar Informações do Cliente

Este método permite atualizar os dados de um cliente. 


Endpoint

https://api.tomticket.com/v2.0/customer/update


Método HTTP

POST


Content Type

form-data


Autenticação

Authorization: Bearer {SEU-TOKEN-AQUI}


Parâmetros de Requisição

ChaveDescriçãoObrigatórioValor PadrãoTipoTamanho Máximo
customer_idIdentificador interno do cliente para realizar a busca e atualização das informações. Pode ser o endereço de email do cadastro ou identificador interno utilizado.
Sim-String250
customer_type_id
Tipo de identificador utilizado para localizar o cliente, sendo:
I - Identificador interno
E - Email
Não
I
String
1
nameNome do cliente.Não
-String250
emailEndereço de email do cliente. Caso preenchido, pode ser usado pelo cliente para acessar o Painel do Cliente.Não-String250
phoneNúmero de telefone do cliente.Não-String20
create_tickets Permissão para criar chamados.
Opções disponíveis:

  • 1: Poderá criar chamados
  • 0: Criação de chamados desativada
Não1Int-
organization_idIdentificador da organização do cliente.Não-String512
languageIdioma do cliente ao acessar o Painel do Cliente.
Idiomas disponíveis:
  • pt-BR (português do Brasil)
  • es_ES (español)
  • en-US (english)
Nãopt-BR
String5
portfolio_idIdentificador da carteira de clientes.
Este recurso somente está disponíveis para contas Enterprise.
Não-String512
custom_field[id]Campo personalizado para cadastro de cliente.

O campo poderá ser obrigatório dependendo da configuração do cadastro do campo personalizado.

Exemplo:

  • custom_field[ID-DO-CAMPO-01]: Valor Campo 01
  • custom_field[ID-DO-CAMPO-02]: Valor Campo 02
  • custom_field[ID-DO-CAMPO-N]: Valor Campo N
Variável-String1
internal_id
Identificador interno do cliente. Só poderá ser informado se o customer_type_id informado for E (Email).




Retorno

Descrição do retorno em JSON.

ColunaDescrição da ColunaTipo
errorInforma se ocorreu um erro na operação. Se o retorno for false, então significa que a operação ocorreu com sucesso e não ocorreram problemas. Caso o retorno seja true, ocorreu um erro e será necessário verificar o campo mensagem para identificar o problema.Boolean
messageDetalhes da operação, caso tenha ocorrido ou não um problema.String
successRetorna true caso a operação tenha sido concluída com sucesso.Boolean

Código de Retorno

Descrição do código HTTP de retorno.

CódigoDescrição
200Operação realizada com sucesso.
401Token ou valores enviados não autorizados para uso.
403Recurso não disponível.
404Recurso não encontrado.

⚠️ Importante:

Qualquer propriedade que for enviada de forma vazia, será alterada no cadastro do cliente.

Se uma propriedade não for enviada, ela não será modificada.


Disponibilidade

Recurso Premium Recurso Enterprise


Was this article helpful?  
We appreciate your review.