# Horário errado na integração: como conferir data e fuso

Investigue um horário errado na integração, confira o contrato de data e fuso e compare o mesmo instante entre origem, destino e exibição.

Autoria: Angelo Sebastião Silva Goncalves
Publicado: 2026-10-24T00:03:41.499Z
Revisado: 2026-10-24T00:03:41.499Z
URL canônica: https://nextags.com.br/blog/integracao-horario-agendamento-data-fuso/

Para investigar um horário errado na integração, confira o contrato do campo e compare os instantes. A tela sozinha não comprova uma alteração.

## Descubra o que o campo representa

Identifique se o campo representa data civil, data/hora local ou instante; consulte seu contrato.

Na [API do Google Calendar](https://developers.google.com/workspace/calendar/api/v3/reference/events), `date` registra a data de um evento de dia inteiro; `dateTime` exige offset, salvo quando `timeZone` é explicitado. É um contrato dessa API, não um formato universal de integrações.

Considere **AG29**, compromisso administrativo em **26/10/2026, 9h, America/Sao_Paulo**, UTC−03. A origem envia `2026-10-26T09:00:00`; acordo e contrato confirmam hora local nesse fuso. Sem confirmação, não adivinhe o fuso.

Localize quem mantém essa definição: o sistema responsável pelo compromisso e a documentação da passagem. Uma preferência escrita no chat ou o idioma de uma tela não substituem a conferência com a origem autorizada.

## Compare o mesmo compromisso ao atravessar os sistemas

A [RFC 3339](https://www.rfc-editor.org/rfc/rfc3339.html) usa `Z` para UTC e offsets numéricos para relacionar hora local e UTC. No caso AG29:

| Representação | Interpretação neste caso |
| --- | --- |
| `2026-10-26T09:00:00-03:00` | Instante acordado |
| `2026-10-26T12:00:00Z` | Mesmo instante em UTC |
| `2026-10-26T09:00:00Z` | Equivale a 6h no fuso acordado, três horas antes |

Em AG29, a evidência liga a entrada local à saída `2026-10-26T09:00:00Z` e ao objeto de destino com esse valor, exibido às 6h no fuso acordado. Acrescentar `Z` sem converter mudou o instante; não aplique ajustes globais de três horas.

Para localizar a ocorrência, use a referência AG29 para relacionar os registros do percurso. Reúna a entrada original, a saída da transformação e o valor efetivamente recebido e armazenado no destino. Guarde também qual objeto foi localizado e como sua tela o apresentou.

Essas evidências precisam pertencer à mesma passagem. Um horário parecido em outro registro, uma captura final isolada ou uma mensagem de erro genérica não identificam onde ocorreu a alteração. Se faltar uma das provas, registre a pendência e encaminhe ao responsável pelo componente, sem atribuir culpa ao produto.

## Corrija a fronteira demonstrada e acompanhe o resultado

O responsável técnico deve indicar o ponto da alteração e o alcance da correção antes de executá-la. Combine ambiente, acesso, dados permitidos e quem confere a mudança. Não crie compromissos ou envie mensagens a clientes como tentativa exploratória de diagnóstico.

O registro de AG29 pode reunir: referência da origem, contrato consultado, evidências de entrada e saída, objeto de destino, achado, responsável e próxima conferência. Separe o resultado esperado do que foi observado. A liberação depende de conferir o destino e a apresentação pertinente após a correção autorizada.

Nas [integrações por API e webhooks da Nextags](/integracoes/api-webhooks/), confirme os dados e as operações documentados para a conta. O [guia de adaptação de modelos entre clientes](/blog/modelo-automacao-agencia-adaptar-outro-cliente/) ajuda a localizar parâmetros do projeto; AG29 aprofunda apenas a passagem temporal.

Mantenha na [caixa de entrada](/recursos/caixa-de-entrada/) o contexto necessário para a equipe continuar: compromisso localizado, análise em andamento e pessoa responsável pelo retorno. Enquanto a divergência não estiver resolvida, uma mensagem reescrita não comprova que o registro foi corrigido. Preserve o horário acordado como referência da análise, sem anunciar uma remarcação que o cliente não solicitou.

## Fontes
- [Google Calendar API — Events](https://developers.google.com/workspace/calendar/api/v3/reference/events)
- [RFC 3339 — Date and Time on the Internet: Timestamps](https://www.rfc-editor.org/rfc/rfc3339.html)