Customers
Eventos de Customers: 7 no total. Ver o envelope comum.
account.created
A service account was created.
Recurso: account
Disparar na CLI: gotactl events trigger account.created
{
"id": "wev_8XwXWh2q7gP6Ksui6Wt8Rew45Yr",
"type": "account.created",
"api_version": "v1",
"tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
"created_at": "2026-11-19T09:30:00Z",
"data": {
"resource_type": "account",
"resource_id": "act_8XwXWh2cdNwsn5LEq2UKWu9b4aq",
"resource": {
"type": "account",
"id": "act_8XwXWh2cdNwsn5LEq2UKWu9b4aq",
"sequence": 1
}
}
}account.link_rejected
A consumer's request to link an account was rejected.
Recurso: account
Não suportado por `events trigger` (use o fluxo normal da API).
{
"id": "wev_8XwXWh2qyjWcaHLAuS6eNRuagKv",
"type": "account.link_rejected",
"api_version": "v1",
"tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
"created_at": "2026-11-19T09:30:00Z",
"data": {
"resource_type": "account",
"resource_id": "act_8XwXWh2cdNwsn5LahRi2yBnwUuH",
"resource": {
"type": "account",
"id": "act_8XwXWh2cdNwsn5LahRi2yBnwUuH",
"sequence": 1
}
}
}account.linked
A consumer gained access to an account.
Recurso: account
Não suportado por `events trigger` (use o fluxo normal da API).
{
"id": "wev_8XwXWh2qyjWcRvtNxUDFJ6z2cab",
"type": "account.linked",
"api_version": "v1",
"tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
"created_at": "2026-11-19T09:30:00Z",
"data": {
"resource_type": "account",
"resource_id": "act_8XwXWh2cdNwsn5LahRimZok9brr",
"resource": {
"type": "account",
"id": "act_8XwXWh2cdNwsn5LahRimZok9brr",
"sequence": 1
}
}
}account.membership_revoked
A consumer's access to an account was revoked.
Recurso: account
Não suportado por `events trigger` (use o fluxo normal da API).
{
"id": "wev_8XwXWh2qBZT7QdJP2oeBKsXbbxE",
"type": "account.membership_revoked",
"api_version": "v1",
"tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
"created_at": "2026-11-19T09:30:00Z",
"data": {
"resource_type": "account",
"resource_id": "act_8XwXWh2cdNwsn5LPDx4pAmNx7Cr",
"resource": {
"type": "account",
"id": "act_8XwXWh2cdNwsn5LPDx4pAmNx7Cr",
"sequence": 1
}
}
}customer.created
A customer was created.
Recurso: customer
Disparar na CLI: gotactl events trigger customer.created
{
"id": "wev_WNxqQehDFtFd8HshBsiiraSxGaS",
"type": "customer.created",
"api_version": "v1",
"tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
"created_at": "2026-11-19T09:30:00Z",
"data": {
"resource_type": "customer",
"resource_id": "cus_WNxqQehDe7QFfsrfEZKBiY4SGJ6",
"resource": {
"type": "customer",
"id": "cus_WNxqQehDe7QFfsrfEZKBiY4SGJ6",
"sequence": 1
}
}
}property.created
A property was created.
Recurso: property
Não suportado por `events trigger` (use o fluxo normal da API).
{
"id": "wev_QBY25Lrni4wUBWSWMbmU2CXRMSM",
"type": "property.created",
"api_version": "v1",
"tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
"created_at": "2026-11-19T09:30:00Z",
"data": {
"resource_type": "property",
"resource_id": "prp_QBY25LrnDX7VWLNvLvrZCPqmDMp",
"resource": {
"type": "property",
"id": "prp_QBY25LrnDX7VWLNvLvrZCPqmDMp",
"sequence": 1
}
}
}property.transferred
A property moved to another customer.
Recurso: property
Não suportado por `events trigger` (use o fluxo normal da API).
{
"id": "wev_QBY25LrnimTwaDADdguQbHowWMW",
"type": "property.transferred",
"api_version": "v1",
"tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
"created_at": "2026-11-19T09:30:00Z",
"data": {
"resource_type": "property",
"resource_id": "prp_QBY25LrnDX7VWLNvLfbrQckZ85z",
"resource": {
"type": "property",
"id": "prp_QBY25LrnDX7VWLNvLfbrQckZ85z",
"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.
| Campo | Tipo | Significado |
|---|---|---|
id | string | Identificador do evento; o mesmo em todas as tentativas de entrega. |
type | string | O nome do evento, por exemplo invoice.issued. |
api_version | string | A versão da API em que o corpo é escrito. |
tenant_id | string | A empresa (espaço de trabalho) onde o evento aconteceu. |
created_at | string (RFC 3339) | Quando o evento foi registado. |
request_id | string | O pedido à API que causou a mudança, quando houve um; liga ao registo de pedidos. |
data.resource_type | string | O tipo do recurso que mudou. |
data.resource_id | string | O identificador desse recurso, para o ler na API. |
data.attributes | object | Campos próprios de cada evento; podem não existir. Leia o recurso na API para o estado completo. |
data.resource.sequence | integer | Conta os eventos do mesmo recurso; ignore um evento que não seja mais recente do que o último que aplicou. |
Outras categorias de eventos
- Automationautomation.created, automation.deleted, automation.disabled, automation.enabled, automation.updated
- Billingbilling_run.executed, billing_schedule.created, billing_schedule.updated, invoice.adjusted, invoice.issued, invoice.paid, invoice.reconciled, invoice.status_changed, invoice.voided, invoice.written_off, tariff.activated, tariff.created
- Collectionscollection.case_settled, collection.cutoff_order_generated, collection.payment_plan_created, collection_case.status_changed, collection_case_dunning.status_changed
- Connectionsconnection.application_created, connection.application_reviewed, connection.application_submitted, connection.installation_scheduled, connection.installed, connection.reconnected, connection.retired, connection.status_changed, connection.suspended, connection.updated
- Developerwebhook.test
- Metadatametadata.updated
- Metersmeter.created, meter.exchanged, meter.installed, meter.reset, meter.status_changed, meter_device.status_changed, reading.accepted, reading.corrected, reading.flagged, reading.rejected
- Notificationsnotification_preference.updated
- Onboardingonboarding.approved, onboarding.information_requested, onboarding.rejected, onboarding.submitted
- Operationscrew.created, incident.reported, incident.resolved, interruption.completed, interruption.created, work_order.assigned, work_order.completed, work_order.created, work_order.dispatched, work_order.executed, work_order.status_changed
- Paymentsbank_statement.imported, cashier.shift_closed, cashier.shift_opened, payment.allocated, payment.received, payment.reversed, payment.status_changed
- Readingsreading.status_changed
- Subscriptionplatform_invoice.issued, platform_invoice.paid, subscription.plan_changed
- Supportticket.assigned, ticket.closed, ticket.commented, ticket.created, ticket.resolved