Cria um novo atendente baseado em um identificador único (geralmente o e-mail, mas pode ser utilizado outras chaves). Pode ou não enviar uma senha de acesso para a plataforma de atendimento da NuVidio através de um e-mail.
📌 Por que criar um atendente?
O atendente realiza o atendimento das vídeo chamadas e por isso é muito importante que seja criado e vinculado à um departamento.
- Atendimento de vídeo chamadas.
- Atendimento de chamadas.
🔗 Endpoint:
Método: POST
URL: https://api.nuvidio.com/v1/api/attendant
📦 Corpo da Requisição:
{
"name": "João",
"lastName": "Luiz",
"email": "[email protected]",
"profilePhoto": "https://exemplo.com.br/foto/joao-luiz.png",
"sendPassword": true,
"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 }]
}
}
🔎 Parâmetros da Requisição:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| name | string | ✅ | Nome do atendente |
| lastName | string | ✅ | Sobrenome do atendente |
| string | ✅ | E-mail ou chave única para autenticação do atendente | |
| sendPassword | boolean | ✅ | Flag para determinar o envio de um e-mail de primeiro acesso para o atendente |
| profilePhoto | string | ❌ | URL da foto de perfil do atendente |
| businessTime | object | ❌ | Descrição do horário em que o atendente poderá atender |
Lembre-se que o e-mail deve ser único por atendente, caso não seja único, retornará o erro 409.
✅ Resposta de Sucesso:
{
"id": "6112a89e34a436171f05be96",
"name": "João",
"lastName": "Luiz",
"email": "[email protected]",
"identifier": "nuvidio-atendimento",
"profilePhoto": "https://exemplo.com.br/foto/joao-luiz.png",
"timezone": -3,
"resetPasswordLink": "https://portal.nuvidio.com/redefinir-senha?token=PYGYn4MMMmOBCyGSmes43ZHaYZqlNTKOOsTlHmdbU2",
"firstAccessPassword": "xylwea",
"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 }]
}
}
❌ Respostas de erro:
| Código | Mensagem |
|---|---|
404 | Empresa não encontrada |
403 | Limite máximo de atendentes criados atingido |
422 | Conteúdo inválido |
409 | Atendente já existe |
500 | Erro interno |