Imobzi Webhook

Recebe eventos da API Imobzi via Webhook

Overview

This node implements a webhook trigger for the Imobzi API, designed to receive various event notifications from Imobzi via HTTP POST requests. It listens for specific types of events configured by the user and triggers workflows when those events occur. This is useful for automating processes in response to changes or actions within the Imobzi platform, such as updates to contracts, leads, properties, tasks, or other entities.

Practical examples include:

  • Automatically updating a CRM system when a new lead is created in Imobzi.
  • Triggering notifications or follow-up tasks when a contract is canceled.
  • Syncing property data with external databases upon property updates or deletions.

Properties

Name Meaning
Eventos Select one or more event types that will trigger the webhook. Options include:
- Atualização De Campo Personalizado (Custom Field Update)
- Atualização De Contrato (Contract Update)
- Atualização De Documento (Document Update)
- Atualização De Evento De Agenda (Agenda Event Update)
- Atualização De Imóvel (Property Update)
- Atualização De Integração (Integration Update)
- Atualização De Lead (Lead Update)
- Atualização De Tarefa (Task Update)
- Atualização De Usuário (User Update)
- Cancelamento De Contrato (Contract Cancellation)
- Exclusão De Imóvel (Property Deletion)
- Nova Integração (New Integration)
- Novo Campo Personalizado (New Custom Field)
- Novo Contrato (New Contract)
- Novo Documento (New Document)
- Novo Evento De Agenda (New Agenda Event)
- Novo Imóvel (New Property)
- Novo Lead (New Lead)
- Novo Tarefa (New Task)
- Novo Usuário (New User)
- Outro (Other)

Output

The node outputs the webhook payload received from Imobzi as JSON data under the json field. The structure of this JSON depends on the event type but generally contains detailed information about the event that triggered the webhook, such as updated entity data or identifiers.

No binary data output is produced by this node.

Example output JSON structure (simplified):

{
  "eventType": "contrato_update",
  "data": {
    "contractId": "12345",
    "status": "active",
    "updatedFields": {
      "endDate": "2024-12-31"
    }
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Imobzi API.
  • The node must be configured with a webhook URL accessible by Imobzi to send event notifications.
  • No additional external dependencies are required beyond standard n8n webhook capabilities.

Troubleshooting

  • Webhook not triggering: Ensure that the webhook URL provided to Imobzi is correct and publicly accessible. Verify that the selected event types match those sent by Imobzi.
  • Authentication errors: Confirm that the API key credential is valid and has sufficient permissions to receive webhook events.
  • Unexpected payload format: Since the node passes through the raw webhook body, if the workflow expects certain fields, verify the event type and payload structure matches expectations.
  • Multiple events not firing: Check that multiple event types are properly selected in the node configuration.

Links and References

Discussion