Handoff alerts
Notify the owner or an office webhook when AI cannot continue a conversation
Handoff alerts notify your team when the AI cannot continue a conversation and human attention is required. They are not sent merely because a teammate turns on manual takeover.
Open Organization → Handoff alerts. Owners and Admins can change the channels; other active Members can review their status but cannot save changes.
When an alert is sent
Bubblo sends one alert for each continuous AI-unavailable incident. If the same incident produces more internal attempts, it does not repeatedly notify the team. A human reply or another incident-clearing transition ends that incident; a later independent AI failure can send a new alert.
The alert includes the organization, a content-free conversation code, the failure reason, and a dashboard link. It never includes the visitor’s message content.
Email alerts
Turn on Email the organization owner to send AI handoff alerts to the organization’s Owner. Delivery requires the deployment’s email service to be configured.
Webhook alerts
Turn on webhook alerts and select a destination:
| Destination | Payload and signing |
|---|---|
| Generic webhook | Stable JSON. An optional secret adds an X-Bubblo-Signature HMAC header. |
| Feishu group bot | Feishu custom-bot text payload with optional signature verification. |
| DingTalk group bot | DingTalk custom-bot Markdown payload with support for signed bots. |
Enter a public HTTPS webhook URL and, when the destination uses one, its signing secret. Private and local endpoints are blocked. Save the settings before selecting Send test alert. The page shows the most recent test and delivery result to help diagnose a rejected or unreachable destination.
Webhook credentials require the deployment’s notification-encryption secret. If webhook encryption is unavailable, webhook settings cannot be saved or tested; email alerts are unaffected. Temporary webhook failures are retried within the service’s retry window.
Alerted conversations appear under Needs human in Inbox. For the AI source that attempted the reply, see AI providers.