Compartilhar via

Minhas horas (versão prévia)

Acompanhe o tempo e gerencie projetos, tarefas, clientes e marcas com seletores dinâmicos. Esse conector expõe pontos de extremidade para criar e localizar entidades.

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Minhas Horas
URL https://myhours.com
Email support@myhours.com
Metadados do conector
Publicador Spica International
Site da Web https://myhours.com
Política de privacidade https://myhours.com/legal/personal-data-processing-addendum-for-my-hours-cloud-services
Categorias Produtividade

Minhas Horas – Introdução ao Conector

Acompanhe o tempo e gerencie projetos, tarefas, clientes e marcas usando o conector Minhas Horas.

Authentication

Tipo: Chave de API (cabeçalho)

Ao criar uma conexão, insira o valor completo no único campo chamado Autorização usando este formato exato:

Exemplo: apikey 123abcXYZ

O conector envia esse valor como o Authorization cabeçalho em cada solicitação.

Onde obter a chave: Nas configurações da sua conta minhas horas. Criar ou copiar uma chave de API. Mantenha-o em segredo e gire-o se exposto.

Ações com suporte

  • Criar Cliente – Criar um novo cliente.
  • Localizar Cliente por Nome – Retornar clientes que correspondam ao nome fornecido.
  • Criar Projeto – Criar um novo projeto.
  • Localizar Projeto por Nome – localizar um projeto pelo nome.
  • Adicionar Tarefa ao Projeto – Criar uma tarefa em um projeto selecionado.
  • Localizar Tarefa por Nome – localizar uma tarefa de projeto por nome e ID do projeto.
  • Criar Marca – Criar uma nova marca (com cor hex).
  • Localizar Marca por Nome – localizar uma marca por nome.
  • Criar Log de Tempo – Criar um novo log de tempo.
  • Obter logs de tempo – recuperar logs de atividade/hora detalhados para um intervalo de datas.

Gatilhos com suporte

  • Quando um novo Projeto é criado – é acionado quando um novo projeto é exibido.
  • Quando uma nova tarefa é criada – é acionada quando uma nova tarefa de projeto é exibida.
  • Quando um novo Log de Tempo é criado – é acionado quando um novo log de horários é exibido.

Notas de uso & limites

  • Formato de autorização – a conexão requer o prefixo apikey literal seguido pela sua chave. Se você omitir o prefixo ou adicionar caracteres extras, as solicitações poderão falhar com 400 ou 401.
  • Formatos de data/hora – as datas são YYYY-MM-DD. Os valores de data/hora são ISO 8601 (por exemplo, 2025-09-05T08:30:00Z ou um deslocamento local).
  • Criando logs de tempo– forneçaduration (segundos) ou ambos start e end. Fornecer os três é inválido.
  • Seletores dinâmicos – os campos Projeto, Tarefa, Marcação e Usuário usam listas dinâmicas; verifique se sua conta tem permissão para ler essas entidades ou as listas podem estar vazias.
  • Ambiente – há suporte apenas para o host da API de produção: https://api2.myhours.com.

Tratamento de erros

O conector retorna códigos de status HTTP padrão:

Code Meaning Causas típicas
200 Êxito Operações de leitura/lista.
201 Criado Operações de criação bem-sucedidas.
400 Solicitação incorreta Entradas ausentes/inválidas, formato de cabeçalho incorreto, campos de corpo conflitantes.
500 Erro do servidor Problema de back-end temporário ou erro inesperado.

Solução de problemas

  1. Verifique se o valor de Autorização usa o formato exato apikey YOUR_API_KEY .
  2. Verifique se os campos necessários estão presentes e são válidos.
  3. Para Criar Log de Tempo, confirme se você passouduration (start e end).

Log de alterações

  • 1.0.0 – Envio inicial para certificação.

Support

Criando uma conexão

O conector dá suporte aos seguintes tipos de autenticação:
Default Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: todas as regiões

Parâmetros para criar conexão.

Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Authorization secureString A autorização para essa api Verdade

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Adicionar tarefa ao Project

Crie uma tarefa em um projeto selecionado.
Criar cliente

Crie um novo registro de cliente.
Criar log de tempo

Criar um log de tempo. O campo "duração" ou os campos "hora de início" e "hora de término" devem ser preenchidos. No caso de todos os três serem preenchidos, você receberá um erro
Criar projeto

Crie um novo projeto.
Criar Tag

Crie uma nova marca.
Localizar cliente por nome

Retornar clientes que correspondam ao nome fornecido.
Localizar marca por nome

Localize uma marca pelo nome.
Localizar Projeto por Nome

Localize um projeto pelo nome.
Localizar tarefa por nome

Localize uma tarefa de projeto por nome e ID do projeto.
Obter logs de tempo

Obtenha atividades detalhadas ou logs de tempo para um intervalo de datas.

Adicionar tarefa ao Project

ID da operação:
CreateProjectTask

Crie uma tarefa em um projeto selecionado.

Parâmetros

Nome Chave Obrigatório Tipo Description
ID do projeto
 projectId True integer

ID do projeto.
Nome da Lista
 listName string

Nome da lista de tarefas.
Nome
 name True string

Nome da tarefa.
Description
 description string

Descrição.

Retornos

Corpo
ProjectTask

Criar cliente

ID da operação:
CreateClient

Crie um novo registro de cliente.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome
 Name True string

Nome do cliente.

Retornos

Corpo
Client

Criar log de tempo

ID da operação:
CreateLog

Criar um log de tempo. O campo "duração" ou os campos "hora de início" e "hora de término" devem ser preenchidos. No caso de todos os três serem preenchidos, você receberá um erro

Parâmetros

Nome Chave Obrigatório Tipo Description
Date
 date True date

Data no formato YYYY-MM-DD.
Hora de início
 start date-time

Hora de início no formato UTC ou ISO 8601 local.
Hora de término
 end date-time

Hora de término no formato UTC ou ISO 8601 local.
Duração
 duration integer

Duração em segundos.
Description
 Note string

Nota.
ID do projeto
 ProjectId integer

ID do projeto.
ID da tarefa
 TaskId integer

ID da tarefa.
ID da marca
 TagId integer

ID da marca.

Retornos

Corpo
TimeLog

Criar projeto

ID da operação:
CreateProject

Crie um novo projeto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome
 name True string

Nome do projeto.
ID do cliente
 clientId integer

ID do cliente.
Anotações
 notes string

Anotações.
Usuário Atribuído
 autoAssignUserId integer

Usuário atribuído ao projeto.

Retornos

Corpo
Project

Criar Tag

ID da operação:
CreateTag

Crie uma nova marca.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da etiqueta
 name True string

Nome da marca.
Cor hexáxe
 hexColor True string

Cor hexáxe em

Retornos

Corpo
Tag

Localizar cliente por nome

ID da operação:
FindClient

Retornar clientes que correspondam ao nome fornecido.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do cliente
 clientName True string

Nome do cliente com correspondência exata ou parcial.

Retornos

response
array of Client

Localizar marca por nome

ID da operação:
FindTag

Localize uma marca pelo nome.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da etiqueta
 tagName True string

Nome da marca.

Retornos

Corpo
Tag

Localizar Projeto por Nome

ID da operação:
FindProject

Localize um projeto pelo nome.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome do projeto
 projectName True string

Nome do projeto.

Retornos

Corpo
Project

Localizar tarefa por nome

ID da operação:
FindTask

Localize uma tarefa de projeto por nome e ID do projeto.

Parâmetros

Nome Chave Obrigatório Tipo Description
Nome da tarefa
 projectTaskName True string

Nome da tarefa.
ID do projeto
 projectId True integer

ID do projeto.

Retornos

Corpo
ProjectTask

Obter logs de tempo

ID da operação:
GetTimeLogs

Obtenha atividades detalhadas ou logs de tempo para um intervalo de datas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Data de
 dateFrom True date

Data de início no formato YYYY-MM-DD.
Data para
 dateTo True date

Data de término no formato YYYY-MM-DD.

Retornos

Corpo
ActivityReportResponse

Gatilhos

Quando um novo Log de Tempo é criado

Dispare quando um novo log de horários for criado.
Quando um novo projeto é criado

Dispare quando um novo projeto for criado.
Quando uma nova tarefa é criada

Dispare quando uma nova tarefa de projeto for criada.

Quando um novo Log de Tempo é criado

ID da operação:
NewTimeLog

Dispare quando um novo log de horários for criado.

Retornos

Corpo
TriggerLogsEnvelope

Quando um novo projeto é criado

ID da operação:
NewProject

Dispare quando um novo projeto for criado.

Retornos

Corpo
TriggerProjectsEnvelope

Quando uma nova tarefa é criada

ID da operação:
NewTask

Dispare quando uma nova tarefa de projeto for criada.

Retornos

Corpo
TriggerProjectTasksEnvelope

Definições

TimeSlice

Nome Caminho Tipo Description
id
 id integer
duration
 duration integer
startTime
 startTime string
endTime
 endTime string
em execução
 running boolean
excluído
 deleted boolean

Anexo

Nome Caminho Tipo Description
fileName
 fileName string
fileUrl
 fileUrl string
id
 id integer

Etiqueta

Nome Caminho Tipo Description
nome
 name string
hexColor
 hexColor string
Arquivados
 archived boolean
dateArchived
 dateArchived string
id
 id integer

Cliente

Nome Caminho Tipo Description
nome
 name string
nome do contato
 contactName string
contatoE-mail
 contactEmail string
contatoTelefone
 contactPhone string
address
 address string
customId
 customId string
customFieldValues
 customFieldValues string
id
 id integer

Projeto

Nome Caminho Tipo Description
invoiceMethod
 invoiceMethod integer
taxa
 rate float
budgetType
 budgetType integer
budgetValue
 budgetValue integer
budgetAlertPercent
 budgetAlertPercent integer
notas
 notes string
aprovado
 approved boolean
roundType
 roundType integer
roundInterval
 roundInterval integer
firstLogDate
 firstLogDate string
budgetTarget
 budgetTarget integer
budgetPeriodType
 budgetPeriodType string
startDate
 startDate string
data de vencimento
 dueDate string
dateCreated
 dateCreated string
createdByUserId
 createdByUserId integer
createdByUserName
 createdByUserName string
Faturável
 billable boolean
customFieldValues
 customFieldValues string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
nome
 name string
Arquivados
 archived boolean
customId
 customId string
id
 id integer

ProjectTask

Nome Caminho Tipo Description
nome
 name string
orderNo
 orderNo integer
descrição
 description string
concluído
 completed boolean
Arquivados
 archived boolean
startDate
 startDate string
data de vencimento
 dueDate string
taxa
 rate float
billableByDefault
 billableByDefault boolean
budgetValue
 budgetValue float
budgetSpent
 budgetSpent float
budgetSpentPercentage
 budgetSpentPercentage float
projectBudgetType
 projectBudgetType integer
projectTaskUserIds
 projectTaskUserIds array of integer
customFieldValues
 customFieldValues string
customId
 customId string
projectCustomId
 projectCustomId string
clientCustomId
 clientCustomId string
id
 id integer

TimeLog

Nome Caminho Tipo Description
nota
 note string
date
 date string
duration
 duration integer
userName
 userName string
nome_do_projeto
 projectName string
taskName
 taskName string
clientName
 clientName string
em execução
 running boolean
startTime
 startTime string
endTime
 endTime string
vezes
 times array of TimeSlice
status
 status integer
projectId
 projectId integer
taskId
 taskId integer
Faturável
 billable boolean
despesa
 expense float
userId
 userId integer
billableRate
 billableRate float
billableAmount
 billableAmount float
laborRate
 laborRate float
laborCost
 laborCost float
customField1Name
 customField1Name string
customField2Name
 customField2Name string
customField3Name
 customField3Name string
customField1Value
 customField1Value string
customField2Value
 customField2Value string
customField3Value
 customField3Value string
tags
 tags string
durationInHours
 durationInHours float
id
 id integer
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment

ActivityLogRow

Nome Caminho Tipo Description
logId
 logId integer
userId
 userId integer
date
 date string
teamsNames
 teamsNames string
userName
 userName string
userCustomId
 userCustomId string
clientId
 clientId integer
clientName
 clientName string
clientCustomId
 clientCustomId string
projectId
 projectId integer
nome_do_projeto
 projectName string
projectCustomId
 projectCustomId string
projectStartDate
 projectStartDate string
projectDueDate
 projectDueDate string
projectBudgetType
 projectBudgetType string
projectBudgetTarget
 projectBudgetTarget string
projectBudgetPeriodType
 projectBudgetPeriodType string
projectBudgetValue
 projectBudgetValue integer
taskListName
 taskListName string
taskId
 taskId integer
taskName
 taskName string
taskCustomId
 taskCustomId string
taskStartDate
 taskStartDate string
taskDueDate
 taskDueDate string
taskCompleted
 taskCompleted boolean
userCustomFieldValues
 userCustomFieldValues string
projectCustomFieldValues
 projectCustomFieldValues string
clientCustomFieldValues
 clientCustomFieldValues string
taskCustomFieldValues
 taskCustomFieldValues string
tags
 tags string
taxa
 rate float
Faturável
 billable boolean
inLockedPeriod
 inLockedPeriod boolean
billableAmount
 billableAmount float
quantidade
 amount float
laborCost
 laborCost float
laborRate
 laborRate float
logDuration
 logDuration integer
logDurationBillable
 logDurationBillable integer
laborDuration
 laborDuration integer
startEndTime
 startEndTime string
despesa
 expense float
billableExpense
 billableExpense float
custar
 cost float
nota
 note string
status
 status string
Id da Fatura
 invoiceId integer
Facturado
 invoiced boolean
billableHours
 billableHours integer
billableHoursLogBillable
 billableHoursLogBillable integer
laborHours
 laborHours integer
customField1
 customField1 integer
customField2
 customField2 integer
customField3
 customField3 integer
saldo
 balance integer
monthOfYear
 monthOfYear string
weekNo
 weekNo integer
weekOfYear
 weekOfYear string
equipes
 teams array of string
em execução
 running boolean
startTime
 startTime string
endTime
 endTime string
vezes
 times array of TimeSlice
tagsData
 tagsData array of Tag
attachments
 attachments array of Attachment
roundType
 roundType string
invoicedAmount
 invoicedAmount float
uninvoicedAmount
 uninvoicedAmount float

ActivityReportResponse

Nome Caminho Tipo Description
body
 body array of ActivityLogRow

TriggerLogsEnvelope

Nome Caminho Tipo Description
logs
 logs array of TimeLog

TriggerProjectsEnvelope

Nome Caminho Tipo Description
projects
 projects array of object
clientId
 projects.clientId integer
clientName
 projects.clientName string
clientCustomId
 projects.clientCustomId string
nome
 projects.name string
customId
 projects.customId string
id
 projects.id integer

TriggerProjectTasksEnvelope

Nome Caminho Tipo Description
projectTasks
 projectTasks array of object
projectId
 projectTasks.projectId integer
listName
 projectTasks.listName string
listOrderNo
 projectTasks.listOrderNo integer
nome
 projectTasks.name string
orderNo
 projectTasks.orderNo integer
descrição
 projectTasks.description string
taxa
 projectTasks.rate float
budgetValue
 projectTasks.budgetValue float
projectBudgetType
 projectTasks.projectBudgetType integer
customId
 projectTasks.customId string
billableByDefault
 projectTasks.billableByDefault boolean
projectCustomId
 projectTasks.projectCustomId string
clientCustomId
 projectTasks.clientCustomId string
id
 projectTasks.id integer