A visitor asked for a person, or the chatbot handed the conversation over. The event names the request; read it with the handover requests endpoint.

Sent as POST to the account webhook URL. Headers: X-Smartwebchat-Event, X-Smartwebchat-Timestamp, X-Smartwebchat-Signature (HMAC over timestamp and body). For backward compatibility, data carries the full request under data.handoverRequest (the example is shortened); the feed carries only handoverRequestId.

postWebhookhandover.requested

Payload

event'handover.requested' required

timestampstring date-time required

dataobject required

For backward compatibility, data carries the full request under data.handoverRequest (the example is shortened); the feed carries only handoverRequestId.

Response

Received. Any other status is logged; delivery to the account webhook URL is not retried.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.