---
title: "Criar convite"
method: POST
path: "/v1/api/invite/department/{id}"
---

# Criar convite

`POST /v1/api/invite/department/{id}`

## Request

- Base URL: `https://api.nuvidio.com`
- URL: `https://api.nuvidio.com/v1/api/invite/department/{id}`
- Auth: none required

Cria um link de convite para realização de uma chamada.

## Path parameters

- `id` string, required

## Request body

- object
  - `expirationDate` string, date: Data final de validade do link em UTC, se não for enviado será utilizado o tempo máximo de validade configurado no portal da empresa
  - `initialDate` string, date: Data inicial para que o link seja acessível em UTC, se não for enviado é utilizado a data atual
  - `push` boolean: Define se o cliente será redirecionado automaticamente para a fila de atendimento ao abrir o link
  - `schedule` boolean: Define se o link criado será para agendamento, caso true o link terá o formato "nuvidio.com/agendamento/:departamento" (default false)
  - `customerData` object[]: Dados do cliente para que ele não precise preencher novamente ao entrar na chamada
    - `label` string, required: O label do campo cadastrado no formulário do departamento
    - `value` string, required: O valor do campo enviado, pode ser enviada uma string em formato Base64 ou um URL para anexar um arquivo de imagem
    - `type` string: Caso seja enviado um arquivo deve ser identificado o tipo desse arquivo para o tratamento correto do dado (valores válidos: 'image' e 'pdf')
    - `private` boolean: Identifica se o campo é uma informação sensível que deve ser exibida somente para o atendente e não para o cliente
  - `issues` object[]: Dados dos diferentes atendimentos que serão realizados na mesma chamada (Multiatendimento). Cada atendimento terá dados individuais e uma tabulação individual.
    - `key` string, required: Chave que será utilizada para identificar cada atendimento (Issue).
    - `name` string, required: Titulo que será exibido para o atendente, identificando cada atendimento.
    - `data` object[]: Dados únicos de cada atendimento.
      - `label` string, required: O label do campo cadastrado no formulário do departamento
      - `value` string, required: O valor do campo enviado, pode ser enviada uma string em formato Base64 ou um URL para anexar um arquivo de imagem
      - `type` string: Caso seja enviado um arquivo deve ser identificado o tipo desse arquivo para o tratamento correto do dado (valores válidos: 'image' e 'pdf')
      - `private` boolean: Identifica se o campo é uma informação sensível que deve ser exibida somente para o atendente e não para o cliente

## Response `200`

200

- object
  - `token` string
  - `shortLink` string
  - `link` string
  - `id` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `89c4a530a05e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nuvidio/apis/nuvidio-openapi/changes/v1/api/invite/department/:id/post.md)

---

[API](https://skmtc.dev/nuvidio/apis/nuvidio-openapi.md) - [All operations](https://skmtc.dev/nuvidio/apis/nuvidio-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/nuvidio/apis/nuvidio-openapi/revisions/89c4a530a05e?raw)