Criar Cliente

Recurso Premium Recurso Enterprise

Este método permite criar um novo cliente.

Endpoint

MétodoRotaContent-Type
POSThttps://api.tomticket.com/v2.0/customer/newform-data

Autenticação

Este endpoint utiliza autenticação Bearer Token.

Authorization: Bearer SEU_TOKEN_AQUI

Caso ainda não possua um Token de Acesso, consulte o artigo Criação do Token de Acesso.

Parâmetros da requisição

Parâmetros da requisição - Criar Cliente

CampoTipoObrigatórioTamanho máximoDescrição
customer_idstringSim250Identificador interno do cliente. Recomendamos utilizar um identificador que seja fácil associar aos dados de sua empresa, como uma chave primária em sistema, CPF ou CNPJ do cliente.
namestringSim250Nome do cliente.
emailstringNão250Endereço de email do cliente. Caso preenchido, pode ser usado pelo cliente para acessar o Painel do Cliente.
phonestringNão20Número de telefone do cliente.
create_ticketsintegerNão-Permissão para criar chamados. Opções disponíveis: 1: poderá criar chamados; 0: criação de chamados desativada.
organization_idstringNão512Identificador da organização do cliente.
languagestringNão5Idioma do cliente ao acessar o Painel do Cliente. Idiomas disponíveis: pt-BR (português do Brasil), es_ES (español), en-US (english).
portfolio_idstringNão512Identificador da carteira de clientes. Este recurso somente está disponível para contas Enterprise.
custom_field[id]stringNão1Campo personalizado para cadastro de cliente. O campo poderá ser obrigatório dependendo da configuração do cadastro do campo personalizado.
passwordstringNão250Atualiza a senha do cliente.

JSON de saída

JSON de saída - Criar Cliente

CampoTipoDescrição
errorbooleanInforma se ocorreu um erro na operação.
messagestringDetalhes da operação, caso tenha ocorrido ou não um problema.
successbooleanRetorna true caso a operação tenha sido concluída com sucesso.

Possíveis erros

Status HTTPMensagemQuando ocorre
200Operação realizada com sucesso.Quando a operação é concluída com sucesso.
401Token ou valores enviados não autorizados para uso.Quando o token ou os valores enviados não são autorizados para uso.
403Recurso não disponível.Quando o recurso não está disponível.
404Recurso não encontrado.Quando o recurso não é encontrado.

Este artigo foi útil?  
Agradecemos sua avaliação.