Encaminhar tarefas pendentes

Como encaminhar atividades pendentes utilizando API's do Zeev?

Em algumas circunstâncias pode ser necessário encaminhar atividades para outra pessoa.

Ao utilizar a API do Zeev para encaminhamento de atividades, lembre-se que:

• No caso de encaminhamento de diversas tarefas em lote, caso 1 tenha sucesso, será retornado objeto de sucesso. Eventuais problemas de encaminhamento em outras atividades serão explicitados através do parâmetro de warnings no corpo da resposta.

• O usuário dono do token de autenticação deve ser superadministrador ou o dono das tarefas a serem encaminhadas.

• Um e-mail será enviado ao usuário destinatário no caso de sucesso.

Para realizar o encaminhamento utilizando API, siga os passos abaixo:

1. Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;

2. Obtenha os identificadores das atividades: Obtenha os Id's de atribuição das atividades que deseja encaminhar. Existem muitas formas de fazer isso, você pode conferir algumas delas como descrito nesta página.

3. Enviar a Requisição: Utilize o endpoint Encaminhar tarefas pendentes para enviar a requisição conforme modelo e exemplo (Troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev);

4. Rate limit: Se for encaminhar tarefas em lote, respeite os limites máximos de solicitações;

Encaminhar tarefas pendentes de um usuário para outro usuário (Auth)

post

Autorizações

Bearer

AuthorizationstringObrigatório

Utilize um token válido de usuário para realizar a requisição

Corpo

application/json

newUserIdinteger · int32Obrigatório

Identificador do usuário que receberá as atividades

assignmentsIdsinteger · int64[]Obrigatório

Identificadores de atribuição de responsabilidade a serem encaminhados

messagestringOpcional

Mensagem a ser adicionada na instância sobre o encaminhamento

Respostas

200

Sucesso

application/jsontext/jsontext/xml

400

Solicitação ou dados da solicitação são inválidas

application/jsontext/jsontext/xml

401

Pessoa não autorizada

application/jsontext/jsontext/xml

403

Pessoa não tem permissão de executar essa operação

application/jsontext/jsontext/xml

404

O registro não foi encontrado

application/jsontext/jsontext/xml

429

Muitas requisições em um determinado período de tempo

application/jsontext/jsontext/xml

500

Ocorreu algum erro interno no servidor

application/jsontext/jsontext/xml

post

/api/2/assignments/forward

HTTPcURLJavaScriptPython

POST /api/2/assignments/forward HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "newUserId": 1,
  "assignmentsIds": [
    1
  ],
  "message": "text"
}

{
  "numberOfForwardedTasks": 1,
  "warnings": [
    {
      "message": "text",
      "vars": "text"
    }
  ]
}

Node.js

let assignementIdList = [51303907,34099698]; // Lista de Ids a serem encaminhados

const myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer TOKEN_DO_USUARIO");

const raw = JSON.stringify({
  "newUserId": 52607061,
  "assignmentsIds": assignementIdList,
  "message": "Mensagem incluida no encaminhamento de tarefa"
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw
};

try {
  const response = await fetch("https://seu_endereco.do.zeev/api/2/assignments/forward", requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};

---

Links relacionados:

• O que é preciso para fazer integrações do Zeev para outros sistemas?

• Como autenticar nas APIs do Zeev

• Como controlar o volume máximo de requisições à APIs

• Como acessar o Swagger / OpenAPI

• Como executar tarefas