Listar ou adicionar mensagens em solicitação

Como adicionar mensagens em uma solicitação ou tarefa utilizando as API's do Zeev?

Para adicionar mensagens em uma instância de solicitação utilizando as API's do Zeev, siga os seguintes passos:

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

  2. Identificar a solicitação: O Id é o código único da solicitação, você pode encontrar ele buscando em monitorar -> solicitações, ou utilizando o endpoint para consultar instâncias através de filtros conforme descrito nesta em Listar todas as solicitações do sistema;

  3. Enviar a Requisição: Utilize o endpoint Listar ou adicionar mensagens em solicitação para enviar a requisição conforme modelo e exemplo (troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev):

Adicionar mensagem a uma instância de solicitação por código identificador da instância da solicitação. (Auth)

post
Corpo
instanceIdinteger · int32 · mín: 1 · máx: 2147483647Obrigatório

Número identificador da instância de solicitação

messageBodystringObrigatório

Mensagem a ser inserida na instância

requesterCanSeebooleanOpcional

Indicador se a pessoa solicitante pode ver essa mensagem

Respostas
200

Sucesso

post
POST /api/2/messages HTTP/1.1
Host: seu_endereco.do.zeev
Content-Type: application/json
Accept: */*
Content-Length: 60

{
  "instanceId": 1,
  "messageBody": "text",
  "requesterCanSee": true
}
{
  "id": 1
}

Exemplos de requisição do para adicionar mensagens em uma instância de solicitação

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({
  "instanceId": 890360388, //Id da solicitação
  "messageBody": "Sou uma mensagem de texto que será incluida na instancia",
  "requesterCanSee": true
});

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

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

Como adicionar mensagens em uma solicitação utilizando API e código identificador da tarefa?

Para adicionar mensagens em uma instância de solicitação utilizando as API's do Zeev, siga os seguintes passos:

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

  2. Identificar da tarefa: O instanceTaskId é o código único de uma atividade da solicitação. Você pode encontrar-lo utilizando o endpoint para consultar instâncias através de filtros conforme descrito nesta em Listar todas as solicitações do sistema;

  3. Enviar a Requisição: Utilize o endpoint Listar ou adicionar mensagens em solicitação para enviar a requisição conforme modelo e exemplo (troque seu_endereco.do.zeev pelo endereço que você usa para acessar o Zeev):

Adicionar mensagem a uma instância de tarefa por código identificador da instância da tarefa (Auth)

post
Corpo
instanceTaskIdinteger · int32 · mín: 1 · máx: 2147483647Obrigatório

Número identificador da instância de tarefa

messageBodystringObrigatório

Mensagem a ser inserida na instância

requesterCanSeebooleanOpcional

Indicador se a pessoa solicitante pode ver essa mensagem

Respostas
200

Sucesso

post
POST /api/2/messages/instance-task HTTP/1.1
Host: seu_endereco.do.zeev
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "instanceTaskId": 1,
  "messageBody": "text",
  "requesterCanSee": true
}
{
  "id": 1
}

Como listar mensagens de instâncias do Zeev utilizando API's?

Para consultar mensagens de uma instância utilizando as API's do Zeev, siga os seguintes passos:

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

  2. Identificar a Solicitação: O Id é o código único da solicitação, você pode encontrar ele buscando em monitorar -> solicitações, ou utilizando o endpoint de API do Zeev para

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

Listar mensagems de uma instância de solicitação (Auth)

get
Parâmetros de rota
instanceIdinteger · int32Obrigatório

Código identificador da instância da solicitação

Parâmetros de consulta
useCachebooleanOpcional

Indicação se a consulta pode vir do cache

Respostas
200

Sucesso

get
GET /api/2/messages/instance/{instanceid} HTTP/1.1
Host: seu_endereco.do.zeev
Accept: */*

{
  "id": 1,
  "body": "text",
  "requesterCanSee": true,
  "dateTime": "2025-08-06T20:11:49.650Z",
  "instance": {
    "id": 1,
    "name": "text",
    "instanceTask": {
      "id": 1,
      "task": {
        "id": 1,
        "name": "text"
      }
    }
  },
  "author": {
    "id": 1,
    "name": "text",
    "email": "text",
    "username": "text",
    "original": {
      "id": 1,
      "name": "text"
    }
  }
}

Exemplo de requisição para listar mensagens de uma solicitação

let instanceId = 1234;

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

const requestOptions = {
  method: "GET",
  headers: myHeaders
};

try {
  const response = await fetch(`https://seu_endereco.do.zeev/api/2/messages/instance/${instanceId}?useCache=true`, requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
}

Links relacionados:

AnteriorModificar dados do formulário de solicitaçõesPróximoAdicionar anexos a uma solicitação

Atualizado