Not every API call ends the same way. When your chatbot interacts with external systems using a Webhook block, you often expect different types of responses. Some API calls are successful, like when the system finds a customer’s data, while others return errors due to invalid input, missing data, or server issues.
Instead of treating every response the same, your Guided Conversation can become smarter and more helpful by handling each response type differently. That’s where Multipath comes in.
What is multipath in the Webhook Block?
Multipath is a feature in the Webhook block of Guided Conversations that allows your chatbot to follow different paths based on the HTTP response status codes returned by an API call.
For example:
- If the response is 200 (OK), the chatbot might continue to show subscription details.
- If the response is 404 (Not Found), it can gently ask the user to double-check their input.
- If it gets a 500 (Server Error), it can apologize and suggest trying again later.
This ability to branch out into different flows based on what happens in the API response is what makes Multipath so valuable.
How does Multipath work?
The best part about Multipath is that you don’t need to enable anything manually. It's automatically activated when you define more than one expected response code in the Response List of the Webhook block.
Here’s a step-by-step breakdown of how it works:
- Add a Webhook Block
- Configure it to connect with your API.
- Define Multiple Response Status Codes
- In the Response List section, enter all the response codes your API might return, for example: 200, 400, 404, and 500.
- Multipath is Automatically Enabled
- As soon as you list multiple response codes, the Webhook block understands that different outcomes are possible. It activates the Multipath feature and shows separate paths for each response code.
- Customize Each Path.
- You can now add specific conversation blocks under each path. For example:
- Under 200: Add a Message block that shows the customer’s subscription details.
- Under 404: Add a block that says “We couldn’t find that. Could you double-check your email?”
- Under 500: Display a polite error message and offer a retry.
Example use case
Let’s say you’ve built a chatbot that helps users check their subscription status for a product. You use a Webhook block to connect with your subscription system’s API.
You configure these status codes:
- 200: Everything is good. The user exists and has an active subscription.
- 404: The email provided doesn’t match any customer records.
- 401: The authentication token is missing or expired.
- 500: Something went wrong on the server side.
Here’s how your chatbot can handle each:
- 200 Shows a message: “Great! You have an active subscription until September 30.”
- 404 Asks the user: “We couldn’t find any subscription under that email. Want to try a different one?”
- 401 Suggests: “Looks like there’s a login issue. Let’s reauthenticate first.”
- 500 Displays: “Oops, looks like our system is having a hiccup. Please try again in a few minutes.”
Benefits of using Multipath
Personalized Responses
Each user gets a message that matches their situation, reducing confusion and improving clarity
Smoother Error Handling
Instead of showing vague or technical error messages, you guide users calmly through alternate options
Professional Experience
It makes your chatbot feel polished, intelligent, and attentive, like a real support agent
Saves Time
When users are guided correctly, they don’t need to reach out to support manually, saving time for both them and your agents
Scalable Design
As your API evolves or new response codes are added, you can expand the paths easily without disrupting your existing flows
Tips
Focus on handling the most likely responses first, usually 200 (success), 404 (not found), and 500 (error).
If multiple errors (like 400 or 401) lead to the same action (like asking to re-login), you can reuse the same block across paths.
Don’t overload users with technical details. Keep responses simple, helpful, and reassuring.
Use the Preview and Test feature to simulate different API responses and ensure each path works as expected.