PT EN

Meters

Eventos de Meters: 10 no total. Ver o envelope comum.

meter.created

A meter was created.

Recurso: meter

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_tzyJD3zdyanVv92U3fNQLJnXFjH",
  "type": "meter.created",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "meter",
    "resource_id": "mtr_tzyJDaAeeYS5cCeALpdocEbScJR",
    "resource": {
      "type": "meter",
      "id": "mtr_tzyJDaAeeYS5cCeALpdocEbScJR",
      "sequence": 1
    }
  }
}

meter.exchanged

A meter was exchanged on a connection.

Recurso: meter

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_tzyJD3q4PmxJMBKyyaKUs3kQZkx",
  "type": "meter.exchanged",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "meter",
    "resource_id": "mtr_tzyJDaAeeYSgMeSvSTUwXvUuXW5",
    "resource": {
      "type": "meter",
      "id": "mtr_tzyJDaAeeYSgMeSvSTUwXvUuXW5",
      "sequence": 1
    }
  }
}

meter.installed

A meter was installed on a connection.

Recurso: meter

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_tzyJD35tNgP3W8AXQyecXNcdjmC",
  "type": "meter.installed",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "meter",
    "resource_id": "mtr_tzyJDaAeeYSujtzgNudiXy9dcCb",
    "resource": {
      "type": "meter",
      "id": "mtr_tzyJDaAeeYSujtzgNudiXy9dcCb",
      "sequence": 1
    }
  }
}

meter.reset

A meter was reset.

Recurso: meter

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_tzyJD3HTNhBaE4Dc8KfSf4bkwxj",
  "type": "meter.reset",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "meter",
    "resource_id": "mtr_tzyJDaAeeYSMFGqmBZmmYCQRy3i",
    "resource": {
      "type": "meter",
      "id": "mtr_tzyJDaAeeYSMFGqmBZmmYCQRy3i",
      "sequence": 1
    }
  }
}

meter.status_changed

A meter changed status.

Recurso: meter

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_tzyJD36EqvBa7CGKk8vRjAKinSZ",
  "type": "meter.status_changed",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "meter",
    "resource_id": "mtr_tzyJDaAeeYSAkPJRbSih8WGBzwu",
    "resource": {
      "type": "meter",
      "id": "mtr_tzyJDaAeeYSAkPJRbSih8WGBzwu",
      "sequence": 1
    }
  }
}

meter_device.status_changed

A meter device moved through its physical lifecycle.

Recurso: meter_device

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_tzyJDTFinRkPHMaHg6uDHF2whTf",
  "type": "meter_device.status_changed",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "meter_device",
    "resource": {
      "type": "meter_device",
      "sequence": 1
    }
  }
}

reading.accepted

A reading was accepted.

Recurso: reading

Disparar na CLI: gotactl events trigger reading.accepted

Exemplo de payload
{
  "id": "wev_nQ53eaDhNTyx3u8WKqKHnWsfG2A",
  "type": "reading.accepted",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "reading",
    "resource_id": "rdg_nQ53eaDawviFnootDbzHWi6EeHX",
    "resource": {
      "type": "reading",
      "id": "rdg_nQ53eaDawviFnootDbzHWi6EeHX",
      "sequence": 1
    }
  }
}

reading.corrected

A reading was corrected.

Recurso: reading

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_nQ53eaDhyzaLar4JzWHtvQMGWp4",
  "type": "reading.corrected",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "reading",
    "resource_id": "rdg_nQ53eaDawviFnooH8hpZcEJoAu4",
    "resource": {
      "type": "reading",
      "id": "rdg_nQ53eaDawviFnooH8hpZcEJoAu4",
      "sequence": 1
    }
  }
}

reading.flagged

A reading was flagged by the plausibility check.

Recurso: reading

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_nQ53eaDhwXEAGHoXhHbYuy7Andr",
  "type": "reading.flagged",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "reading",
    "resource_id": "rdg_nQ53eaDawviFnooh6w32HBjDuBq",
    "resource": {
      "type": "reading",
      "id": "rdg_nQ53eaDawviFnooh6w32HBjDuBq",
      "sequence": 1
    }
  }
}

reading.rejected

A reading was rejected.

Recurso: reading

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_nQ53eaDhGb2iUJtLWmfPxCDqijh",
  "type": "reading.rejected",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "reading",
    "resource_id": "rdg_nQ53eaDawviFnooP4rYuB9UUgjv",
    "resource": {
      "type": "reading",
      "id": "rdg_nQ53eaDawviFnooP4rYuB9UUgjv",
      "sequence": 1
    }
  }
}

Receber estes eventos

O seu endpoint de webhook recebe cada um destes eventos num POST com o envelope comum, descrito na tabela abaixo. Verifique a assinatura antes de agir, responda depressa com um código 2xx e faça o trabalho depois: uma resposta lenta ou falhada é enviada outra vez. O mesmo evento pode chegar mais de uma vez, por isso use o seu id para ignorar repetições.

CampoTipoSignificado
idstringIdentificador do evento; o mesmo em todas as tentativas de entrega.
typestringO nome do evento, por exemplo invoice.issued.
api_versionstringA versão da API em que o corpo é escrito.
tenant_idstringA empresa (espaço de trabalho) onde o evento aconteceu.
created_atstring (RFC 3339)Quando o evento foi registado.
request_idstringO pedido à API que causou a mudança, quando houve um; liga ao registo de pedidos.
data.resource_typestringO tipo do recurso que mudou.
data.resource_idstringO identificador desse recurso, para o ler na API.
data.attributesobjectCampos próprios de cada evento; podem não existir. Leia o recurso na API para o estado completo.
data.resource.sequenceintegerConta os eventos do mesmo recurso; ignore um evento que não seja mais recente do que o último que aplicou.

Outras categorias de eventos