Integração com o Zapier

Introdução Primeiros passos Temporizador — Registo de tempo de trabalho Dashboard Tabela mensal Estatísticas anuais Adicionar e editar registos Projetos Atividades Modelos Perfil e definições salariais Exportação e relatórios de trabalho Geofencing Definições da aplicação Sincronização e cópias de segurança Modo kiosk (Terminal) Notificações e lembretes Solicitacoes de Trabalho Arquivos e Armazenamento Premium e Assinaturas Integração com o Zapier

Integração com o Zapier

Ligue o Working Timer a milhares de aplicações através do Zapier. Pode, por exemplo, criar um registo de trabalho a partir de um evento de calendário, formulário, linha de folha de cálculo ou tarefa concluída.

A integração utiliza a API pública do Working Timer. Não precisa de partilhar a sua palavra-passe com o Zapier.

Requisitos

  • Uma conta Working Timer com plano ou teste Public API ativo
  • Um plano pago do Zapier com API by Zapier ou Webhooks by Zapier
  • O ID do perfil Working Timer que receberá os registos

Importante: Trate a chave API como uma palavra-passe. Não a coloque no nome, notas, URL ou campos do Zap que possam aparecer no histórico.

1. Criar uma chave API

  1. Abra o portal da API do Working Timer, selecione Sign In e inicie sessão.
  2. No API Dashboard, em API Keys, selecione New Key.
  3. Introduza um nome como Zapier e selecione Create.
  4. Copie imediatamente a chave iniciada por wt_ak_. Esta é apresentada apenas uma vez.

Se perder a chave, revogue-a e crie uma nova.

2. Encontrar o ID do perfil

  1. Abra a referência da API.
  2. Selecione Authorize e introduza a chave no campo ApiKey.
  3. Abra GET /api/v1/Profile, selecione Try it out e depois Execute.
  4. Encontre o perfil na resposta e copie o respetivo id.

O ID é um GUID semelhante a a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Ligar através do API by Zapier

  1. No Zapier, abra Apps, selecione Add connection e escolha API by Zapier.
  2. Em Authentication type, escolha Static Headers (API key).
  3. Em Headers, adicione uma linha:
X-Api-Key: wt_ak_a_sua_chave
  1. Defina Connection name como Working Timer.
  2. Defina Domain filter como api.workingtimer.com.
  3. Utilize como Test URL https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Selecione Yes, Continue to API by Zapier.

O API by Zapier é uma funcionalidade beta. Se não estiver disponível, utilize o método Webhooks abaixo.

4. Criar o primeiro Zap

  1. Crie um Zap e escolha um acionador, como um novo evento, tarefa, formulário ou linha.
  2. Adicione API by Zapier, escolha API Request e a ligação Working Timer.
  3. Defina Method como POST e URL como https://api.workingtimer.com/api/v1/WorkRecord.
  4. Em Body, introduza:
{
  "profileId": "ID_DO_PERFIL",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Criado pelo Zapier"
}
  1. Substitua ID_DO_PERFIL, associe valores do acionador e utilize primeiro Formatter by Zapier se precisar de os converter.
  2. Selecione Test step. Um pedido bem-sucedido devolve 201. Confirme o registo no Working Timer e publique o Zap.

clockIn e clockOut são minutos desde a meia-noite: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Em turnos noturnos, clockOut pode exceder 1440.

Alternativa: Webhooks by Zapier

Adicione Webhooks by Zapier com o evento POST. Defina o URL como https://api.workingtimer.com/api/v1/WorkRecord, Payload Type como JSON, adicione os dados acima e os cabeçalhos X-Api-Key com a sua chave e Content-Type com application/json. Um teste correto devolve 201.

Outros pedidos úteis

  • Perfis: GET https://api.workingtimer.com/api/v1/Profile
  • Registos: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Atualizar: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Eliminar: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Consulte a referência da API para outros endpoints.

Resolução de problemas

  • 401 Unauthorized — a chave está ausente, incompleta ou revogada. O cabeçalho deve chamar-se exatamente X-Api-Key.
  • 403 Forbidden — ative ou renove o plano ou teste Public API.
  • 400 Bad Request — verifique o JSON, a data e os valores numéricos em minutos.
  • Profile was not found — confirme que profileId pertence à mesma conta.
  • 429 Too Many Requests — foi atingido um limite; tente mais tarde e consulte a utilização.
  • Registos duplicados — consulte o histórico do Zapier e use um filtro ou ID de origem único antes da ação.

Para remover o acesso, selecione Revoke junto à chave Zapier no API Dashboard.

Anterior Premium e Assinaturas