https://discord.gg/botpress logo
Human Handoff configuration
# 🤝help
w
Hi, I'm reaching out for support regarding the Human Handoff configuration on my Plus plan ($79/month). Issue 1: Botpress Desk not available According to the documentation, new workspaces should use Botpress Desk instead of the legacy HITL integration. However, in the Human Handoff section of my dashboard, there is no reference to Botpress Desk: only the option to install the HITL integration is shown. Issue 2: Error during HITL setup After installing the HITL integration and clicking "Set up", I receive the following error: "*Failed to set up Human Handoff – request/query must have required property 'interfaces'*" Based on the documentation, I understand this error is related to the missing HITL Plugin (step 2 of the guide), but this plugin does not appear to be available in my Hub. How can I complete the legacy configuration without the HITL Plugin? Alternatively, how can I activate Botpress Desk on my current Plus plan? According to the pricing page, it is included in the new Plus plan pricing. Thank you https://cdn.discordapp.com/attachments/1505881156602560634/1505881157294755952/image.png?ex=6a0c3c9d&is=6a0aeb1d&hm=c0f9da5e9c342314369735f0e3e7e2d895b1c930adfaca184bbd365407f3457e& https://cdn.discordapp.com/attachments/1505881156602560634/1505881157873696878/Screenshot_2026-05-18_123142.png?ex=6a0c3c9d&is=6a0aeb1d&hm=1b093ae49fd24db5231a2e8687d1251577791c604b86884498320c7190cac49a&
a
@white-rainbow-17368 Hi, thank you for the detailed explanation. I understand the issue clearly. I have experience working with Botpress configurations, integrations, and Human Handoff setups. From your description, it seems your workspace may still be tied to the legacy HITL architecture, while the required HITL Plugin or Botpress Desk access has not been provisioned correctly on the account. Before proceeding, I’d like to confirm: 1. Is your workspace running on Botpress Cloud or a self-hosted environment? 2. Have you already contacted Botpress support regarding enabling Botpress Desk on your Plus plan, or would you like me to investigate and guide the full setup process? Looking forward to helping you resolve this quickly.
@white-rainbow-17368 Thank you for the clarification. Since you’re using Botpress Cloud and support has not responded yet, I can help you troubleshoot the issue directly. From what you described, this appears to be related to the migration between the legacy HITL system and the newer Botpress Desk setup, which may not have been fully enabled on your workspace despite the Plus plan access. To continue, could you please share: 1. A screenshot of the Human Handoff section showing the HITL integration option and the error message. 2. Whether your workspace was created recently or before Botpress Desk was introduced. This will help me identify the best workaround or configuration path quickly.
You have to create a new workspace to get Desk @white-rainbow-17368
w
Hi Ross, thanks for your reply. When I try to create a new workspace, it creates it under the Free plan and correctly shows me the section related to Botpress Desk. But does this mean I’m forced to switch to the new $150/month plan? Also, the documentation states that it is still possible to use the legacy HITL integration (screenshot HITL-docs.png): https://botpress.com/docs/integrations/integration-guides/hitl/introduction I’d also like to add that support replied by pointing me to the same steps I had already followed, which are the ones that result in an error for me (screenshot HITL-error.png). https://cdn.discordapp.com/attachments/1505881156602560634/1506563975758872707/HITL-docs.png?ex=6a0eb88a&is=6a0d670a&hm=a0690aeab3b6a35dcc9937b46a2e072f6e3485b6dc8188fa17e81b39c1271cad& https://cdn.discordapp.com/attachments/1505881156602560634/1506563976237158541/HITL-error.png?ex=6a0eb88a&is=6a0d670a&hm=fbe554080c9d2e433957a72290ca17cb64371f9d8ed79df233d9b6820cfe7907&
l
Hey @white-rainbow-17368 I think were better off leaving this to the solutions architects
click the headset icon to begin a conversation with them!
2 Views