Editar departamento

Permite atualizar os dados de um departamento existente com base nas informações fornecidas na requisição enviada.

📌 Por que editar um departamento?

Essencial para manter os dados atualizados de um departamento.

Ajuste de dados.
Melhoria de organização dos departamentos.

🔗 Endpoint:

Método: PUT

URL: https://api.nuvidio.com/v1/api/department/:id

🔎 Parâmetros da URL:

Parâmetro	Tipo	Obrigatório	Descrição
`:id`	string	✅	ID do departamento a ser editado

📦 Corpo da Requisição:

{
  "id": "6112a89e34a436171f05be96",
  "name": "Novo departamento",
  "identifier": "novo-departamento",
  "disabled": false,
  "disabledContent": {
    "title": "titulo",
    "message": "mensagem",
    "action": {
      "type": {
        "link": "https://nuvidio.com.br/contato",
        "text": "Clique aqui para enviar uma mensagem"
      }
    }
  },
  "businessTime": {
    "timezone": -3,
    "monday": [
      {
        "opening": 540,
        "closing": 1080
      }
    ],
    "tuesday": [
      {
        "opening": 540,
        "closing": 1080
      }
    ],
    "wednesday": [
      {
        "opening": 540,
        "closing": 1080
      }
    ],
    "thursday": [
      {
        "opening": 540,
        "closing": 1080
      }
    ],
    "friday": [
      {
        "opening": 540,
        "closing": 1080
      }
    ]
  },
  "address": {
    "line1": "Av. Amazonas - 200",
    "line2": "Apt. 500",
    "district": "Centro",
    "city": "Belo Horizonte",
    "state": "MG",
    "countryCode": "BR",
    "postalCode": "30120050",
    "location": {
      "type": "Point",
      "coordinates": [-1947875241, 208715658]
    }
  },
  "settings": {
    "allowMissedCalls": true,
    "blockDirectLink": false,
    "record": "full",
    "showAccessLink": false,
    "blockWorkOvertime": false,
    "scheduleConfigs": {
      "behindScheduleText": ""
    }
  },
  "style": {
    "logo": "https://www.nuvidio.com.br/wp-content/uploads/2020/06/nuvidio_horizontal_positivo-768x324.png",
    "colors": {
      "primary": "#bcb3b3",
      "secondary": "#ff9500",
      "background": "#ff9500"
    },
    "videos": {
      "intro": "https://youtube.com/watch?v=ase231S12df",
      "queue": "https://youtube.com/watch?v=ase231S12df"
    },
    "font": "Segoe UI",
    "fontSize": 10,
    "borderRadius": 10,
    "textColor": "#ff9500"
  }
}

🔎 Parâmetros da Requisição:

Parâmetro	Tipo	Obrigatório	Descrição
name	string	✅	Nome do departamento
identifier	string	✅	Identificador único usado na integração
disabled	boolean	❌	Ativa ou desativa o departamento
disabledContent	objeto	❌	Conteúdo exibido quando o departamento estiver desativado
businessTime	objeto	❌	Horário de funcionamento por dia da semana
address	objeto	❌	Endereço do departamento (linha, cidade, coordenadas etc.)
settings.allowMissedCalls	boolean	❌	Permite visualização de chamadas perdidas
settings.blockDirectLink	boolean	❌	Bloqueia acesso via link direto (apenas via integração)
settings.record	string	❌	Gravação de chamadas (`full`, `partial`, `disabled`)
settings.showAccessLink	boolean	❌	Exibe link de acesso ao departamento
settings.blockWorkOvertime	boolean	❌	Bloqueia funcionamento fora do expediente
style	objeto	❌	Personalização visual (logo, cores, vídeos etc.)

⚠️
O campo identifier deve ser único. Caso já exista um departamento com o mesmo identificador, a requisição será rejeitada.

🎥 Valores para `settings.record`:

Valor	Descrição
`full`	Todas as chamadas são gravadas
`partial`	Atendente escolhe quando iniciar a gravação e pausar durante a chamada
`disabled`	Gravação desativada

✅ Exemplo de Resposta:

{
  "id": "6112a89e34a436171f05be96",
  "name": "Novo departamento",
  "identifier": "novo-departamento",
  "disabled": true,
  "disabledContent": {
    "title": "titulo",
    "message": "mensagem",
    "action": {
      "link": "https://nuvidio.com.br/contato",
      "text": "Clique aqui para enviar uma mensagem"
    }
  },
  "businessTime": {
    "timezone": -3,
    "monday": [{ "opening": 540, "closing": 1080 }],
    "tuesday": [{ "opening": 540, "closing": 1080 }],
    "wednesday": [{ "opening": 540, "closing": 1080 }],
    "thursday": [{ "opening": 540, "closing": 1080 }],
    "friday": [{ "opening": 540, "closing": 1080 }]
  },
  "address": {
    "line1": "Av. Amazonas - 200",
    "line2": "Apt. 500",
    "district": "Centro",
    "city": "Belo Horizonte",
    "state": "MG",
    "countryCode": "BR",
    "postalCode": "30120050",
    "location": {
      "type": "Point",
      "coordenates": [-19.9197907, -43.939615]
    }
  },
  "settings": {
    "allowMissedCalls": true,
    "blockDirectLink": false,
    "record": "full",
    "showAccessLink": false,
    "blockWorkOvertime": false,
    "scheduleConfigs": {
      "behindScheduleText": ""
    }
  },
  "style": {
    "logo": "https://www.nuvidio.com.br/wp-content/uploads/2020/06/nuvidio_horizontal_positivo-768x324.png",
    "colors": {
      "primary": "#bcb3b3",
      "secondary": "#ff9500",
      "background": "#ff9500"
    },
    "videos": {
      "intro": "https://youtube.com/watch?v=ase231S12df",
      "queue": "https://youtube.com/watch?v=ase231S12df"
    },
    "font": "Segoe UI",
    "fontSize": 10,
    "borderRadius": 10,
    "textColor": "#ff9500"
  },
}

❌ Respostas de Erro:

Código	Mensagem
`404`	Departamento não encontrado
`409`	Identificador já em uso
`500`	Erro interno

💡
Ainda não criou um departamento? Clique aqui para informações de como criá-lo.