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
| Chave | Descrição | Obrigatório | Valor Padrão | Tipo | Tamanho Máximo |
|---|---|---|---|---|---|
customer_id | Identificador 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 | - | String | 250 |
customer_type_id | Tipo de identificador utilizado para localizar o cliente, sendo:I - Identificador internoE - Email | Não | I | String | 1 |
name | Nome do cliente. | Não | - | String | 250 |
email | Endereço de email do cliente. Caso preenchido, pode ser usado pelo cliente para acessar o Painel do Cliente. | Não | - | String | 250 |
phone | Número de telefone do cliente. | Não | - | String | 20 |
create_tickets | Permissão para criar chamados. Opções disponíveis:
| Não | 1 | Int | - |
organization_id | Identificador da organização do cliente. | Não | - | String | 512 |
language | Idioma do cliente ao acessar o Painel do Cliente. Idiomas disponíveis:
| Não | pt-BR | String | 5 |
portfolio_id | Identificador da carteira de clientes. Este recurso somente está disponíveis para contas Enterprise. | Não | - | String | 512 |
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:
| Variável | - | String | 1 |
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.
| Coluna | Descrição da Coluna | Tipo |
|---|---|---|
error | Informa 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 |
message | Detalhes da operação, caso tenha ocorrido ou não um problema. | String |
success | Retorna 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ódigo | Descrição |
|---|---|
| 200 | Operação realizada com sucesso. |
| 401 | Token ou valores enviados não autorizados para uso. |
| 403 | Recurso não disponível. |
| 404 | Recurso 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
