Cria um departamento em sua empresa.
📌 Por que criar um departamento?
O departamento é uma área específica de atendimento dentro da empresa, organizando um grupo de atendentes por função ou tipo de serviço prestado.
💡Dica de uso: departamento para Suporte Técnico, departamento para Vendas ou Financeiro.
🔗 Endpoint:
Método: POST
URL: https://api.nuvidio.com/v1/api/department
📦 Corpo da Requisição:
{
"name": "Novo departamento",
"identifier": "novo-departamento",
"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 }]
},
"priority": 1,
"type": 3,
"settings": {
"blockDirectLink": true,
"allowMissedCalls": true,
"blockWorkOvertime": true
},
"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"
},
"address": {
"location": {
"types": "Point",
"coordinates": [-19.814294, -44.0129921]
},
"line1": "Av. Amazonas - 200, Centro",
"line2": "Apt. 500",
"district": "Centro",
"city": "Belo Horizonte",
"state": "MG",
"countryCode": "BR",
"postalCode": "30120050"
}
}
🔎 Parâmetros da Requisição:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| name | string | ✅ | Nome do departamento |
| identifier | string | ✅ | Identificador único utilizado na integração |
| businessTime | objeto | ❌ | Descrição do horário de funcionamento do departamento |
| priority | number | ❌ | Número que representa a prioridade do departamento |
| settings.blockDirectLink | boolean | ❌ | Bloqueia o acesso ao departamento através do link da NuVidio, permitindo somente o acesso via integração |
| settings.allowMissedCalls | boolean | ❌ | Permite que os atendentes vinculados vejam as chamadas perdidas desse departamento |
| settings.blockWorkOvertime | boolean | ❌ | Bloqueia horas extras |
| type | number | ❌ | Número que representa a prioridade do departamento |
| style | objeto | ❌ | Estilização específica do departamento, caso não seja enviada será utilizada a da empresa |
| address | objeto | ❌ | Informações de localização de um departamento |
O identifier deve ser um ID único, portanto, não poderá haver dois departamentos com o mesmo valor
✅ Resposta de Sucesso:
{
"id": "6112a89e34a436171f05be96",
"name": "Novo departamento",
"identifier": "novo-departamento",
"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 }]
},
"priority": 1,
"type": 3,
"settings": {
"blockDirectLink": true,
"allowMissedCalls": true,
"blockWorkOvertime": true
},
"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"
},
"address": {
"location": {
"types": "Point",
"coordinates": [-19.814294, -44.0129921]
},
"line1": "Av. Amazonas - 200, Centro",
"line2": "Apt. 500",
"district": "Centro",
"city": "Belo Horizonte",
"state": "MG",
"countryCode": "BR",
"postalCode": "30120050"
}
}
❌ Respostas de erro:
| Código | Mensagem |
|---|---|
| 404 | Empresa não encontrada |
| 409 | Identificador já em uso |
| 500 | Erro interno |