Criar operador
Método#
POST https://api.plugchat.com.br/integrator/account/[ID_DA_CONTA]/operators
Conceituação#
Neste método você pode criar um novo operador de chat e vincular a departamentos, caso tenha dúvidas de onde pegar os IDS dos departamentos, você pode utilizar a API de listar departamentos.
Observe também que ao criar um operador é retornado o atributo accessToken, utilizado para fazer o login automático, esse token é importante ser armazenado do seu lado, para que quando o cliente fizer login no seu sistema, automaticamente faça login no chat de atendimento sem a necessidade de digitar login e senha do operador.
Sobre a URL da API
Observe que a URL da API é composta pelo id da conta do cliente, o mesmo retornado na criação da conta, isso é necessário para que o Plug Chat crie o operador na conta correta do seu cliente.
Atributos#
Obrigatórios#
| Atributos | Tipo | Descrição |
|---|---|---|
| name | string | Nome do operador |
| active | boolean | Informa se o operador está ativo ou não |
| departments | string[] | Lista de IDS dos departamentos que o operador possui acesso |
Opcionais#
| Atributos | Tipo | Descrição |
|---|---|---|
| login | string | Login que será usado para acesso ao chat |
| password | string | Senha do operador para acesso ao chat |
| isAdmin | boolean | Define se esse operador possui permissões de administrador, podendo deletar chats entre outros... |
Obs: O login e senha são opcionais pois em alguns casos o integrador opta por utilizar o login automático, então o operador não precisa se preocupar em digitar os dados de acesso.
Request Body#
Response#
200#
| Atributos | Tipo | Descrição |
|---|---|---|
| success | boolean | Informa se a criação teve succeso ou falha |
| id | string | Identificador do operador criado |
| accessToken | string | Token de acesso ao chat que pode ser utilizado na SDK para que não seja necessário o operador fazer login a todo momento. |
Exemplo
405#
Neste caso certifique que esteja enviando o corretamente a especificação do método, ou seja verifique se você enviou o POST ou GET conforme especificado no inicio deste tópico.
415#
Caso você receba um erro 415, certifique de adicionar na headers da requisição o "Content-Type" do objeto que você está enviando, em sua grande maioria "application/json"