Skip to main content

Agent Takeover

Overview

·Event key:
renter.automated-communication-disabled
⚠️
Legacy Webhook - DeprecatedThis webhook is part of the legacy webhook system. For new integrations, we recommend using the modern webhooks v2 system.

Also known as "agent takeover" — this webhook fires when Funnel's virtual leasing agent stops automatically handling a renter's conversation because a human agent (or a third-party system) has taken over.

When this event fires

This event fires when automated communication handling is disabled for a renter's conversation — for example, when a leasing agent takes over a virtual-agent-handled conversation, or when handling is handed off to a third-party system. It carries no detail about the reason, only the renter and community affected.

Event Payload

Example payloadJSON200 · application/json
{
  "event": "renter.automated-communication-disabled",
  "data": {
    "funnel_renter_id": 456678,
    "funnel_community_id": 1234
  }
}

What counts as a successful delivery: Funnel treats any 2xx HTTP status code as success — it does not check the response body at all, so returning any content (or none) with a 2xx status is sufficient. If your endpoint returns a non-2xx status or is unreachable, Funnel retries the delivery up to 2 more times (3 attempts total), waiting roughly 60 seconds and then 120 seconds before each retry, so your handler must be idempotent.

Migration to Webhooks v2

This legacy webhook is deprecated. For new integrations, we recommend using the modern webhooks v2 system, which provides:

  • Better event structure with consistent formatting
  • More granular events for different activities
  • A dedicated delivery pipeline — see the Webhooks Walkthrough for what's documented about its delivery behavior
  • Enhanced security features